- [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#SCHEMA_REPRESENTATION) - [FeatureDescription](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#FeatureDescription) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#FeatureDescription.SCHEMA_REPRESENTATION) - [Image](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Image) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Image.SCHEMA_REPRESENTATION) - [Type](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Type) - [Status](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Status) - [Price](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Price) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Price.SCHEMA_REPRESENTATION) - [ProductDetail](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#ProductDetail) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#ProductDetail.SCHEMA_REPRESENTATION) - [Capacity](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Capacity) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Capacity.SCHEMA_REPRESENTATION) - [Count](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Count) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Count.SCHEMA_REPRESENTATION) - [Nutrition](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Nutrition) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Nutrition.SCHEMA_REPRESENTATION) - [FloatUnit](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#FloatUnit) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#FloatUnit.SCHEMA_REPRESENTATION) - [VoluntaryNutritionFact](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#VoluntaryNutritionFact) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#VoluntaryNutritionFact.SCHEMA_REPRESENTATION) - [Grocery](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Grocery) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Grocery.SCHEMA_REPRESENTATION) - [Certification](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Certification) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#Certification.SCHEMA_REPRESENTATION) - [QuestionAndAnswer](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#QuestionAndAnswer) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#QuestionAndAnswer.SCHEMA_REPRESENTATION) - [VariantOption](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#VariantOption) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#VariantOption.SCHEMA_REPRESENTATION) - [RelatedProduct](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#RelatedProduct) - [JSON representation](https://developers.google.com/manufacturers/reference/rest/v1/Attributes.md.txt#RelatedProduct.SCHEMA_REPRESENTATION) Attributes of the product. For more information, see . | 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 ], "questionAndAnswer": [ { object (`QuestionAndAnswer`) } ], "itemGroupTitle": string, "documentLink": [ string ], "variantOption": [ { object (`VariantOption`) } ], "relatedProduct": [ { object (`RelatedProduct`) } ], "popularityRank": number } ``` | | Fields || |---|---| | `gtin[]` | `string` The Global Trade Item Number (GTIN) of the product. For more information, see . | | `mpn` | `string` The Manufacturer Part Number (MPN) of the product. For more information, see . | | `title` | `string` The title of the product. For more information, see . | | `brand` | `string` The brand name of the product. For more information, see . | | `productName` | `string` The canonical name of the product. For more information, see . | | `productLine` | `string` The name of the group of products related to the product. For more information, see . | | `productType[]` | `string` The type or category of the product. For more information, see . | | `description` | `string` The description of the product. For more information, see . | | `featureDescription[]` | ``object (`FeatureDescription`)`` The rich format description of the product. For more information, see . | | `imageLink` | ``object (`Image`)`` The image of the product. For more information, see . | | `additionalImageLink[]` | ``object (`Image`)`` The additional images of the product. For more information, see . | | `videoLink[]` | `string` The videos of the product. For more information, see . | | `productPageUrl` | `string` The URL of the detail page of the product. For more information, see . | | `disclosureDate` | `string` The disclosure date of the product. For more information, see . | | `releaseDate` | `string` The release date of the product. For more information, see . | | `suggestedRetailPrice` | ``object (`Price`)`` The suggested retail price (MSRP) of the product. For more information, see . | | `productDetail[]` | ``object (`ProductDetail`)`` The details of the product. For more information, see . | | `itemGroupId` | `string` The item group id of the product. For more information, see . | | `scent` | `string` The scent of the product. For more information, see . | | `flavor` | `string` The flavor of the product. For more information, see . | | `format` | `string` The format of the product. For more information, see . | | `capacity` | ``object (`Capacity`)`` The capacity of the product. For more information, see . | | `gender` | `string` The target gender of the product. For more information, see . | | `ageGroup` | `string` The target age group of the product. For more information, see . | | `size` | `string` The size of the product. For more information, see . | | `sizeType[]` | `string` The size type of the product. For more information, see . | | `sizeSystem` | `string` The size system of the product. For more information, see . | | `color` | `string` The color of the product. For more information, see . | | `theme` | `string` The theme of the product. For more information, see . | | `pattern` | `string` The pattern of the product. For more information, see . | | `material` | `string` The material of the product. For more information, see . | | `count` | ``object (`Count`)`` The count of the product. For more information, see . | | `targetClientId` | `string` The target client id. Should only be used in the accounts of the data partners. For more information, see | | `excludedDestination[]` | `string` A list of excluded destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see | | `includedDestination[]` | `string` A list of included destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see | | `productHighlight[]` | `string` The product highlights. For more information, see | | `richProductContent[]` | `string` Rich product content. For more information, see | | `nutrition` | ``object (`Nutrition`)`` Nutrition Attributes. See more at . | | `grocery` | ``object (`Grocery`)`` Grocery Attributes. See more at . | | `virtualModelLink` | `string` Virtual Model (3d) asset link. | | `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](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the countries in which this item will be shown. | | `questionAndAnswer[]` | ``object (`QuestionAndAnswer`)`` Optional. Frequently asked questions and answers about the product. | | `itemGroupTitle` | `string` Optional. The shared title of the product group that this variant belongs to. | | `documentLink[]` | `string` Optional. URLs of PDF documents for the product, such as user manuals or specifications. | | `variantOption[]` | ``object (`VariantOption`)`` Optional. The list of all variant-identifying options for the product. | | `relatedProduct[]` | ``object (`RelatedProduct`)`` Optional. Products related to this product, such as accessories or substitutes. | | `popularityRank` | `number` Optional. The popularity rank of the product from 0.0 (lowest) to 100.0 (highest). | ## FeatureDescription A feature description of the product. For more information, see . | 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 . | 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 . | 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 . | 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, "labelLink": string, "documentLink": 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. | | `link` | `string` Optional. A URL link to the certification. | | `logo` | `string` Optional. A URL link to the certification logo. | | `validUntil` | `string` Optional. The expiration date (UTC). | | `labelLink` | `string` Optional. A URL to the certification label. For example: | | `documentLink` | `string` Optional. A URL to the (English if \>1 language) certification fiche. For example: | ## QuestionAndAnswer A question and answer about the product. | JSON representation | |---| | ``` { "question": string, "answer": string } ``` | | Fields || |---|---| | `question` | `string` Required. The question text. | | `answer` | `string` Required. The answer text. | ## VariantOption A variant-identifying option for the product. | JSON representation | |---| | ``` { "name": string, "value": string } ``` | | Fields || |---|---| | `name` | `string` Required. The name of the variant option, such as "Color" or "Watch band style". | | `value` | `string` Required. The value of the variant option, such as "Red" or "Milanese loop". | ## RelatedProduct A product related to this product. | JSON representation | |---| | ``` { "relationshipType": string, "identifierType": string, "identifier": string } ``` | | Fields || |---|---| | `relationshipType` | `string` Required. The relationship to the related product, such as "ACCESSORY", "PART_OF_SET", "REQUIRED_PART", "OFTEN_BOUGHT_WITH", "SUBSTITUTE", or "DIFFERENT_BRAND". | | `identifierType` | `string` Required. The identifier type of the related product, such as "GTIN" or "ID". | | `identifier` | `string` Required. The identifier of the related product. |