Attributes

    Attributes of the product. For more information, see https://support.google.com/manufacturers/answer/6124116 .

    JSON representation 
     { 
 "gtin" 
 : 
 [ 
 string 
 ] 
 , 
 "mpn" 
 : 
 string 
 , 
 "title" 
 : 
 string 
 , 
 "brand" 
 : 
 string 
 , 
 "productName" 
 : 
 string 
 , 
 "productLine" 
 : 
 string 
 , 
 "productType" 
 : 
 [ 
 string 
 ] 
 , 
 "description" 
 : 
 string 
 , 
 "featureDescription" 
 : 
 [ 
 { 
 object (  FeatureDescription 
 
) 
 } 
 ] 
 , 
 "imageLink" 
 : 
 { 
 object (  Image 
 
) 
 } 
 , 
 "additionalImageLink" 
 : 
 [ 
 { 
 object (  Image 
 
) 
 } 
 ] 
 , 
 "videoLink" 
 : 
 [ 
 string 
 ] 
 , 
 "productPageUrl" 
 : 
 string 
 , 
 "disclosureDate" 
 : 
 string 
 , 
 "releaseDate" 
 : 
 string 
 , 
 "suggestedRetailPrice" 
 : 
 { 
 object (  Price 
 
) 
 } 
 , 
 "productDetail" 
 : 
 [ 
 { 
 object (  ProductDetail 
 
) 
 } 
 ] 
 , 
 "itemGroupId" 
 : 
 string 
 , 
 "scent" 
 : 
 string 
 , 
 "flavor" 
 : 
 string 
 , 
 "format" 
 : 
 string 
 , 
 "capacity" 
 : 
 { 
 object (  Capacity 
 
) 
 } 
 , 
 "gender" 
 : 
 string 
 , 
 "ageGroup" 
 : 
 string 
 , 
 "size" 
 : 
 string 
 , 
 "sizeType" 
 : 
 [ 
 string 
 ] 
 , 
 "sizeSystem" 
 : 
 string 
 , 
 "color" 
 : 
 string 
 , 
 "theme" 
 : 
 string 
 , 
 "pattern" 
 : 
 string 
 , 
 "material" 
 : 
 string 
 , 
 "count" 
 : 
 { 
 object (  Count 
 
) 
 } 
 , 
 "targetClientId" 
 : 
 string 
 , 
 "excludedDestination" 
 : 
 [ 
 string 
 ] 
 , 
 "includedDestination" 
 : 
 [ 
 string 
 ] 
 , 
 "productHighlight" 
 : 
 [ 
 string 
 ] 
 , 
 "richProductContent" 
 : 
 [ 
 string 
 ] 
 , 
 "nutrition" 
 : 
 { 
 object (  Nutrition 
 
) 
 } 
 , 
 "grocery" 
 : 
 { 
 object (  Grocery 
 
) 
 } 
 , 
 "virtualModelLink" 
 : 
 string 
 , 
 "certification" 
 : 
 [ 
 { 
 object (  Certification 
 
) 
 } 
 ] 
 , 
 "intendedCountry" 
 : 
 [ 
 string 
 ] 
 }
    Fields
    gtin[]

    string

    The Global Trade Item Number (GTIN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gtin .
    mpn

    string

    The Manufacturer Part Number (MPN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#mpn .
    title

    string

    The title of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#title .
    brand

    string

    The brand name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#brand .
    productName

    string

    The canonical name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productname .
    productLine

    string

    The name of the group of products related to the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productline .
    productType[]

    string

    The type or category of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#producttype .
    description

    string

    The description of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#description .
    featureDescription[]

    object ( FeatureDescription )

    The rich format description of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#featuredesc .
    productPageUrl

    string

    The URL of the detail page of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productpage .
    disclosureDate

    string

    The disclosure date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#disclosure .
    releaseDate

    string

    The release date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#release .
    suggestedRetailPrice

    object ( Price )

    The suggested retail price (MSRP) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#price .
    productDetail[]

    object ( ProductDetail )

    The details of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productdetail .
    itemGroupId

    string

    The item group id of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#itemgroupid .
    scent

    string

    The scent of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#scent .
    flavor

    string

    The flavor of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#flavor .
    format

    string

    The format of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#format .
    capacity

    object ( Capacity )

    The capacity of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#capacity .
    gender

    string

    The target gender of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gender .
    ageGroup

    string

    The target age group of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#agegroup .
    size

    string

    The size of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#size .
    sizeType[]

    string

    The size type of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizetype .
    sizeSystem

    string

    The size system of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizesystem .
    color

    string

    The color of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#color .
    theme

    string

    The theme of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#theme .
    pattern

    string

    The pattern of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#pattern .
    material

    string

    The material of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#material .
    count

    object ( Count )

    The count of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#count .
    targetClientId

    string

    The target client id. Should only be used in the accounts of the data partners. For more information, see https://support.google.com/manufacturers/answer/10857344

    excludedDestination[]

    string

    A list of excluded destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550

    includedDestination[]

    string

    A list of included destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550

    productHighlight[]

    string

    The product highlights. For more information, see https://support.google.com/manufacturers/answer/10066942

    richProductContent[]

    string

    Rich product content. For more information, see https://support.google.com/manufacturers/answer/9389865

    nutrition

    object ( Nutrition )

    Nutrition Attributes. See more at https://support.google.com/manufacturers/answer/12098458#food-servings .
    grocery

    object ( Grocery )

    Grocery Attributes. See more at https://support.google.com/manufacturers/answer/12098458#grocery .
    certification[]

    object ( Certification )

    Optional. List of certifications claimed by this product.
    intendedCountry[]

    string

    Optional. List of countries to show this product in. Countries provided in this attribute will override any of the countries configured at feed level. The values should be: the CLDR territory code of the countries in which this item will be shown.

    FeatureDescription

    A feature description of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#featuredesc .

    JSON representation 
     { 
 "headline" 
 : 
 string 
 , 
 "text" 
 : 
 string 
 , 
 "image" 
 : 
 { 
 object (  Image 
 
) 
 } 
 }
    Fields
    headline

    string

    A short description of the feature.
    text

    string

    A detailed description of the feature.
    image

    object ( Image )

    An optional image describing the feature.

    Image

    An image.

    JSON representation 
     { 
 "type" 
 : 
 enum (  Type 
 
) 
 , 
 "status" 
 : 
 enum (  Status 
 
) 
 , 
 "imageUrl" 
 : 
 string 
 }
    Fields
    type

    enum ( Type )

    The type of the image, i.e., crawled or uploaded.

    Note: This field is used in responses only. Any value specified here in a request is ignored.
    status

    enum ( Status )

    The status of the image.

    Note: This field is used in responses only. Any value specified here in a request is ignored.
    imageUrl

    string

    The URL of the image. For crawled images, this is the provided URL. For uploaded images, this is a serving URL from Google if the image has been processed successfully.

    Type

    The type of image, i.e., crawled or uploaded.

    Enums
    TYPE_UNSPECIFIED Type is unspecified. Should not be used.
    CRAWLED The image was crawled from a provided URL.
    UPLOADED The image was uploaded.

    Status

    The status of the image.

    Enums
    STATUS_UNSPECIFIED The image status is unspecified. Should not be used.
    PENDING_PROCESSING The image was uploaded and is being processed.
    PENDING_CRAWL The image crawl is still pending.
    OK The image was processed and it meets the requirements.
    ROBOTED The image URL is protected by robots.txt file and cannot be crawled.
    XROBOTED The image URL is protected by X-Robots-Tag and cannot be crawled.
    CRAWL_ERROR There was an error while crawling the image.
    PROCESSING_ERROR The image cannot be processed.
    DECODING_ERROR The image cannot be decoded.
    TOO_BIG The image is too big.
    CRAWL_SKIPPED The image was manually overridden and will not be crawled.
    HOSTLOADED The image crawl was postponed to avoid overloading the host.
    HTTP_404 The image URL returned a "404 Not Found" error.

    Price

    A price.

    JSON representation 
     { 
 "amount" 
 : 
 string 
 , 
 "currency" 
 : 
 string 
 }
    Fields
    amount

    string

    The numeric value of the price.
    currency

    string

    The currency in which the price is denoted.

    ProductDetail

    A product detail of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productdetail .

    JSON representation 
     { 
 "sectionName" 
 : 
 string 
 , 
 "attributeName" 
 : 
 string 
 , 
 "attributeValue" 
 : 
 string 
 }
    Fields
    sectionName

    string

    A short section name that can be reused between multiple product details.
    attributeName

    string

    The name of the attribute.
    attributeValue

    string

    The value of the attribute.

    Capacity

    The capacity of a product. For more information, see https://support.google.com/manufacturers/answer/6124116#capacity .

    JSON representation 
     { 
 "value" 
 : 
 string 
 , 
 "unit" 
 : 
 string 
 }
    Fields
    value

    string ( int64 format)

    The numeric value of the capacity.
    unit

    string

    The unit of the capacity, i.e., MB, GB, or TB.

    Count

    The number of products in a single package. For more information, see https://support.google.com/manufacturers/answer/6124116#count .

    JSON representation 
     { 
 "value" 
 : 
 string 
 , 
 "unit" 
 : 
 string 
 }
    Fields
    value

    string ( int64 format)

    The numeric value of the number of products in a package.
    unit

    string

    The unit in which these products are counted.

    Nutrition

    JSON representation 
     { 
 "servingSizeDescription" 
 : 
 string 
 , 
 "servingsPerContainer" 
 : 
 string 
 , 
 "servingSizeMeasure" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "preparedSizeDescription" 
 : 
 string 
 , 
 "nutritionFactMeasure" 
 : 
 string 
 , 
 "energy" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "energyFromFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "totalFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "totalFatDailyPercentage" 
 : 
 number 
 , 
 "saturatedFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "saturatedFatDailyPercentage" 
 : 
 number 
 , 
 "monounsaturatedFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "polyunsaturatedFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "transFat" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "transFatDailyPercentage" 
 : 
 number 
 , 
 "cholesterol" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "cholesterolDailyPercentage" 
 : 
 number 
 , 
 "sodium" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "sodiumDailyPercentage" 
 : 
 number 
 , 
 "totalCarbohydrate" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "totalCarbohydrateDailyPercentage" 
 : 
 number 
 , 
 "dietaryFiber" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "dietaryFiberDailyPercentage" 
 : 
 number 
 , 
 "totalSugars" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "totalSugarsDailyPercentage" 
 : 
 number 
 , 
 "addedSugars" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "addedSugarsDailyPercentage" 
 : 
 number 
 , 
 "protein" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "proteinDailyPercentage" 
 : 
 number 
 , 
 "polyols" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "starch" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "vitaminD" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "vitaminDDailyPercentage" 
 : 
 number 
 , 
 "calcium" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "calciumDailyPercentage" 
 : 
 number 
 , 
 "iron" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "ironDailyPercentage" 
 : 
 number 
 , 
 "potassium" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "potassiumDailyPercentage" 
 : 
 number 
 , 
 "folateMcgDfe" 
 : 
 number 
 , 
 "folateDailyPercentage" 
 : 
 number 
 , 
 "folateFolicAcid" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "voluntaryNutritionFact" 
 : 
 [ 
 { 
 object (  VoluntaryNutritionFact 
 
) 
 } 
 ] 
 }
    Fields
    servingSizeDescription

    string

    Food Serving Size. Serving size description.
    servingsPerContainer

    string

    Servings per container.
    servingSizeMeasure

    object ( FloatUnit )

    Serving size measure.
    preparedSizeDescription

    string

    Prepared size description.
    nutritionFactMeasure

    string

    Nutrition fact measure.
    energy

    object ( FloatUnit )

    Mandatory Nutrition Facts. Energy.
    energyFromFat

    object ( FloatUnit )

    Energy from fat.
    totalFat

    object ( FloatUnit )

    Total fat.
    totalFatDailyPercentage

    number

    Total fat daily percentage.
    saturatedFat

    object ( FloatUnit )

    Saturated fat.
    saturatedFatDailyPercentage

    number

    Saturated fat daily percentage.
    monounsaturatedFat

    object ( FloatUnit )

    Monounsaturated fat.
    polyunsaturatedFat

    object ( FloatUnit )

    Polyunsaturated fat.
    transFat

    object ( FloatUnit )

    Trans fat.
    transFatDailyPercentage

    number

    Trans fat daily percentage.
    cholesterol

    object ( FloatUnit )

    Cholesterol.
    cholesterolDailyPercentage

    number

    Cholesterol daily percentage.
    sodium

    object ( FloatUnit )

    Sodium.
    sodiumDailyPercentage

    number

    Sodium daily percentage.
    totalCarbohydrate

    object ( FloatUnit )

    Total carbohydrate.
    totalCarbohydrateDailyPercentage

    number

    Total carbohydrate daily percentage.
    dietaryFiber

    object ( FloatUnit )

    Dietary fiber.
    dietaryFiberDailyPercentage

    number

    Dietary fiber daily percentage.
    totalSugars

    object ( FloatUnit )

    Total sugars.
    totalSugarsDailyPercentage

    number

    Total sugars daily percentage.
    addedSugars

    object ( FloatUnit )

    Added sugars.
    addedSugarsDailyPercentage

    number

    Added sugars daily percentage.
    protein

    object ( FloatUnit )

    Protein.
    proteinDailyPercentage

    number

    Protein daily percentage.
    polyols

    object ( FloatUnit )

    Polyols.
    starch

    object ( FloatUnit )

    Starch.
    vitaminD

    object ( FloatUnit )

    Vitamin D.
    vitaminDDailyPercentage

    number

    Vitamin D daily percentage.
    calcium

    object ( FloatUnit )

    Calcium.
    calciumDailyPercentage

    number

    Calcium daily percentage.
    iron

    object ( FloatUnit )

    Iron.
    ironDailyPercentage

    number

    Iron daily percentage.
    potassium

    object ( FloatUnit )

    Potassium.
    potassiumDailyPercentage

    number

    Potassium daily percentage.
    folateMcgDfe

    number

    Folate mcg DFE.
    folateDailyPercentage

    number

    Folate daily percentage.
    folateFolicAcid

    object ( FloatUnit )

    Folate folic acid.
    voluntaryNutritionFact[]

    object ( VoluntaryNutritionFact )

    Voluntary nutrition fact.

    FloatUnit

    Combination of float amount and unit.

    JSON representation 
     { 
 "amount" 
 : 
 number 
 , 
 "unit" 
 : 
 string 
 }
    Fields
    amount

    number

    amount.
    unit

    string

    unit.

    VoluntaryNutritionFact

    Voluntary Nutrition Facts.

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "value" 
 : 
 { 
 object (  FloatUnit 
 
) 
 } 
 , 
 "dailyPercentage" 
 : 
 number 
 }
    Fields
    name

    string

    Name.
    value

    object ( FloatUnit )

    Value.
    dailyPercentage

    number

    Daily percentage.

    Grocery

    JSON representation 
     { 
 "ingredients" 
 : 
 string 
 , 
 "activeIngredients" 
 : 
 string 
 , 
 "allergens" 
 : 
 string 
 , 
 "directions" 
 : 
 string 
 , 
 "storageInstructions" 
 : 
 string 
 , 
 "indications" 
 : 
 string 
 , 
 "nutritionClaim" 
 : 
 [ 
 string 
 ] 
 , 
 "derivedNutritionClaim" 
 : 
 [ 
 string 
 ] 
 , 
 "alcoholByVolume" 
 : 
 number 
 }
    Fields
    ingredients

    string

    Ingredients.
    activeIngredients

    string

    Active ingredients.
    allergens

    string

    Allergens.
    directions

    string

    Directions.
    storageInstructions

    string

    Storage instructions.
    indications

    string

    Indications.
    nutritionClaim[]

    string

    Nutrition claim.
    derivedNutritionClaim[]

    string

    Derived nutrition claim.
    alcoholByVolume

    number

    Alcohol by volume.

    Certification

    Description of a certification.

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "authority" 
 : 
 string 
 , 
 "code" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 , 
 "link" 
 : 
 string 
 , 
 "logo" 
 : 
 string 
 , 
 "validUntil" 
 : 
 string 
 }
    Fields
    name

    string

    Required. Name of the certification.
    authority

    string

    Required. Name of the certification body.
    code

    string

    Optional. A unique code to identify the certification.
    value

    string

    Optional. A custom value of the certification.
    validUntil

    string

    Optional. The expiration date (UTC).
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: