Guides Reference Samples

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
  ]
}
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.

excludedDestination[]

string

A list of excluded destinations.

includedDestination[]

string

A list of included destinations.

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.