Attributes

  • Products are described using attributes like FeatureDescription, Image, Price, and ProductDetail, which contain specific product information.

  • Nutritional information is captured through various attributes including calories, fats, carbohydrates, protein, vitamins, and minerals, often using the FloatUnit object for values with units.

  • Grocery-specific attributes include ingredients, allergens, storage instructions, and nutrition claims, providing detailed information for food products.

  • Certifications are represented with their name, issuing authority, and unique code to showcase product compliance and quality standards.

  • The data model enables comprehensive product representation, enhancing product listings and improving the shopping experience for customers.

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).