Attributes

商品的属性。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116。

JSON 表示法
{
  "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
}
字段
gtin[]

string

商品的全球贸易项目代码 (GTIN)。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#gtin。

mpn

string

商品的制造商部件号 (MPN)。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#mpn。

title

string

商品的名称。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#title。

brand

string

商品的品牌名称。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#brand。

productName

string

商品的规范名称。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#productname。

productLine

string

与商品相关的一组商品的名称。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#productline。

productType[]

string

商品的类型或类别。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#producttype。

description

string

商品说明。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#description。

featureDescription[]

object (FeatureDescription)

商品的富文本格式说明。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#featuredesc。

productPageUrl

string

商品详情页面的网址。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#productpage。

disclosureDate

string

商品的公开宣传日期。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#disclosure。

releaseDate

string

商品的发布日期。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#release。

suggestedRetailPrice

object (Price)

商品的建议零售价格 (MSRP)。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#price。

productDetail[]

object (ProductDetail)

商品详情。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#productdetail。

itemGroupId

string

商品的商品组 ID。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#itemgroupid。

scent

string

商品的香味。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#scent。

flavor

string

商品的口味。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#flavor。

format

string

商品的格式。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#format。

capacity

object (Capacity)

产品的容量。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#capacity。

gender

string

商品的目标适用性别。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#gender。

ageGroup

string

商品的目标年龄段。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#agegroup。

size

string

商品的尺码。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#size。

sizeType[]

string

商品的尺码类型。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#sizetype。

sizeSystem

string

商品的尺码体系。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#sizesystem。

color

string

商品的颜色。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#color。

theme

string

商品的主题。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#theme。

pattern

string

商品的图案。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#pattern。

material

string

商品的材质。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#material。

count

object (Count)

商品的数量。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#count。

targetClientId

string

目标客户 ID。应仅在数据合作伙伴的账号中使用。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/10857344

excludedDestination[]

string

禁止的目标平台列表,例如“ClientExport”“ClientShoppingCatalog”或“PartnerShoppingCatalog”。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/7443550

includedDestination[]

string

允许的目标平台列表,例如“ClientExport”“ClientShoppingCatalog”或“PartnerShoppingCatalog”。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/7443550

productHighlight[]

string

商品亮点。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/10066942

richProductContent[]

string

富媒体商品内容。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/9389865

nutrition

object (Nutrition)

营养属性。如需了解详情,请访问 https://support.google.com/manufacturers/answer/12098458#food-servings。

grocery

object (Grocery)

杂货属性。如需了解详情,请访问 https://support.google.com/manufacturers/answer/12098458#grocery。

certification[]

object (Certification)

可选。此商品声称获得的认证列表。

intendedCountry[]

string

可选。展示此商品的国家/地区列表。此属性中提供的国家/地区将覆盖在 Feed 级别配置的所有国家/地区。值应为:此商品将展示的国家/地区的 CLDR 地区代码。

questionAndAnswer[]

object (QuestionAndAnswer)

可选。有关商品的常见问题解答。

itemGroupTitle

string

可选。此款式/规格所属商品组的共享名称。

variantOption[]

object (VariantOption)

可选。商品的所有标识款式/规格的选项列表。

relatedProduct[]

object (RelatedProduct)

可选。与此商品相关的商品,例如配件或替代品。

popularityRank

number

可选。商品的受欢迎程度排名,从 0.0(最低)到 100.0(最高)。

FeatureDescription

商品的功能说明。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#featuredesc。

JSON 表示法
{
  "headline": string,
  "text": string,
  "image": {
    object (Image)
  }
}
字段
headline

string

对该功能的简短说明。

text

string

对该功能的详细说明。

image

object (Image)

用于描述该功能的可选图片。

映像

图片。

JSON 表示法
{
  "type": enum (Type),
  "status": enum (Status),
  "imageUrl": string
}
字段
type

enum (Type)

图片类型,即抓取或上传。

注意:此字段只能在响应中使用。请求中指定的任何值都会被忽略。

status

enum (Status)

图片的状态。

注意:此字段只能在响应中使用。请求中指定的任何值都会被忽略。

imageUrl

string

图片的网址。对于抓取的图片,这是提供的网址。对于上传的图片,如果图片已成功处理,则此字段为 Google 提供的投放网址。

类型

图片类型,即抓取或上传。

枚举
TYPE_UNSPECIFIED 类型未指定。不应使用。
CRAWLED 图片是从提供的网址中抓取的。
UPLOADED 图片已上传。

状态

图片的状态。

枚举
STATUS_UNSPECIFIED 图片状态未指定。不应使用。
PENDING_PROCESSING 图片已上传,正在处理。
PENDING_CRAWL 图片抓取仍处于待处理状态。
OK 图片已处理完毕,符合要求。
ROBOTED 图片网址受 robots.txt 文件保护,无法抓取。
XROBOTED 图片网址受 X-Robots-Tag 保护,无法抓取。
CRAWL_ERROR 抓取图片时出错。
PROCESSING_ERROR 无法处理该图片。
DECODING_ERROR 无法解码图片。
TOO_BIG 图片过大。
CRAWL_SKIPPED 该图片已被手动覆盖,不会被抓取。
HOSTLOADED 图片抓取已推迟,以免主机过载。
HTTP_404 图片网址返回了“404 未找到”错误。

价格

价格。

JSON 表示法
{
  "amount": string,
  "currency": string
}
字段
amount

string

价格的数值。

currency

string

价格采用的币种。

ProductDetail

商品的商品详情。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#productdetail。

JSON 表示法
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
字段
sectionName

string

一个简短的部件名称,可在多个商品详情之间重复使用。

attributeName

string

属性的名称。

attributeValue

string

属性的值。

容量

产品的容量。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#capacity。

JSON 表示法
{
  "value": string,
  "unit": string
}
字段
value

string (int64 format)

容量的数值。

unit

string

容量单位,即MB、GB 或 TB。

计数

单个包装中的商品数量。如需了解详情,请参阅 https://support.google.com/manufacturers/answer/6124116#count。

JSON 表示法
{
  "value": string,
  "unit": string
}
字段
value

string (int64 format)

一个包装中商品数量的数值。

unit

string

这些商品的计数单位。

营养

JSON 表示法
{
  "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)
    }
  ]
}
字段
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)

维生素 D。

vitaminDDailyPercentage

number

维生素 D 每日百分比。

calcium

object (FloatUnit)

钙。

calciumDailyPercentage

number

钙每日百分比。

iron

object (FloatUnit)

铁。

ironDailyPercentage

number

铁每日百分比。

potassium

object (FloatUnit)

钾。

potassiumDailyPercentage

number

钾每日百分比。

folateMcgDfe

number

叶酸(微克 DFE)。

folateDailyPercentage

number

叶酸每日百分比。

folateFolicAcid

object (FloatUnit)

叶酸。

voluntaryNutritionFact[]

object (VoluntaryNutritionFact)

自愿提供的营养成分。

FloatUnit

浮点数金额和单位的组合。

JSON 表示法
{
  "amount": number,
  "unit": string
}
字段
amount

number

amount。

unit

string

单位。

VoluntaryNutritionFact

自愿性营养成分。

JSON 表示法
{
  "name": string,
  "value": {
    object (FloatUnit)
  },
  "dailyPercentage": number
}
字段
name

string

名称。

value

object (FloatUnit)

价值”。

dailyPercentage

number

每日百分比。

杂货店

JSON 表示法
{
  "ingredients": string,
  "activeIngredients": string,
  "allergens": string,
  "directions": string,
  "storageInstructions": string,
  "indications": string,
  "nutritionClaim": [
    string
  ],
  "derivedNutritionClaim": [
    string
  ],
  "alcoholByVolume": number
}
字段
ingredients

string

说到“食材”

activeIngredients

string

有效成分。

allergens

string

过敏原。

directions

string

路线。

storageInstructions

string

存储说明。

indications

string

适应症。

nutritionClaim[]

string

营养声称。

derivedNutritionClaim[]

string

推导出的营养成分声明。

alcoholByVolume

number

酒精度。

认证

认证说明。

JSON 表示法
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string,
  "labelLink": string,
  "documentLink": string
}
字段
name

string

必需。认证名称。

authority

string

必需。认证机构的名称。

code

string

可选。用于标识认证的唯一代码。

value

string

可选。认证的自定义值。

validUntil

string

可选。失效日期(世界协调时间 [UTC])。

QuestionAndAnswer

关于商品的问题和回答。

JSON 表示法
{
  "question": string,
  "answer": string
}
字段
question

string

必需。问题文本。

answer

string

必需。回答文本。

VariantOption

商品的款式/规格标识选项。

JSON 表示法
{
  "name": string,
  "value": string
}
字段
name

string

必需。变体选项的名称,例如“颜色”或“表带款式”。

value

string

必需。款式/规格选项的值,例如“红色”或“米兰尼斯表带”。

RelatedProduct

与此商品相关的商品。

JSON 表示法
{
  "relationshipType": string,
  "identifierType": string,
  "identifier": string
}
字段
relationshipType

string

必需。与相关产品(例如“ACCESSORY”(配件)、“PART_OF_SET”(套装的一部分)、“REQUIRED_PART”(必需部件)、“OFTEN_BOUGHT_WITH”(经常一起购买)、“SUBSTITUTE”(替代品)或“DIFFERENT_BRAND”(不同品牌))的关系。

identifierType

string

必需。相关产品的标识符类型,例如“GTIN”或“ID”。

identifier

string

必需。相关产品的标识符。