Attributes

属性。

JSON 表示法
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "gtin": [
    string
  ],
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
字段
expirationDate

string (Timestamp format)

商品过期的日期(在插入时指定),采用 ISO 8601 格式。实际到期日期在 productstatuses 中以 googleExpirationDate 的形式公开显示,如果 expirationDate 太过遥远,则可能会提前。

disclosureDate

string (Timestamp format)

商品出现在 Google 的 YouTube 平台上的搜索结果中的日期时间,采用 ISO 8601 格式。如需了解详情,请参阅 [披露日期]( https://support.google.com/merchants/answer/13034208)。

availabilityDate

string (Timestamp format)

预订商品的最早发货日期,采用 ISO 8601 格式。

gtin[]

string

商品的全球贸易项目代码 (GTIN)。您最多可以提供 10 个 GTIN。

price

object (Price)

商品的价格。

installment

object (Installment)

分期付款的期数和金额。

subscriptionCost

object (SubscriptionCost)

具有关联订阅合约的商品的付款周期(月或年)数和每个周期的付款金额。

loyaltyPoints

object (LoyaltyPoints)

用户购买商品后获得的积分。仅限日本。

loyaltyPrograms[]

object (LoyaltyProgram)

会员回馈活动信息列表,用于向此商品的用户显示会员福利(例如更优惠的价格、积分等)。

productTypes[]

string

商品的类别(格式应遵循商品数据规范)。

salePrice

object (Price)

商品的广告宣传促销价。

salePriceEffectiveDate

object (Interval)

商品促销的日期范围(请参阅商品数据规范)。

productHeight

object (ProductDimension)

商品的高度(采用所提供的单位)。该值必须介于 0(不含)到 3000(含)之间。

productLength

object (ProductDimension)

产品的长度(以所提供的单位表示)。该值必须介于 0(不含)到 3000(含)之间。

productWidth

object (ProductDimension)

产品的宽度(采用所提供的单位)。该值必须介于 0(不含)到 3000(含)之间。

productWeight

object (ProductWeight)

产品的重量(以所提供的单位表示)。该值必须介于 0(不含)到 2000(含)之间。

shipping[]

object (Shipping)

配送规则。

freeShippingThreshold[]

object (FreeShippingThreshold)

商品需满足哪些条件才能享受免运费。

shippingWeight

object (ShippingWeight)

要寄送的商品的重量。

shippingLength

object (ShippingDimension)

物品包装长度。

shippingWidth

object (ShippingDimension)

要寄送的商品的宽度。

shippingHeight

object (ShippingDimension)

物品包装后的高度。

sizeTypes[]

string

商品的剪裁方式。它可用于表示服饰商品的组合尺寸类型。最多可以提供两种尺码类型(请参阅 [https://support.google.com/merchants/answer/6324497](尺码类型))。

taxes[]

object (Tax)

税务信息。

unitPricingMeasure

object (UnitPricingMeasure)

商品的计量单位和尺寸。

unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

单价分母的偏好设置。

adsLabels[]

string

与 adsGrouping 类似,但仅适用于每次点击费用。

costOfGoodsSold

object (Price)

销货成本。用于毛利润报告。

productDetails[]

object (ProductDetail)

技术规范或其他商品详情。

productHighlights[]

string

用于描述商品最重要的亮点的要点。

displayAdsSimilarIds[]

string

广告客户指定的推荐商品。

promotionIds[]

string

促销活动的唯一 ID。

includedDestinations[]

string

为此定位目标添加的目标平台列表(对应于 Merchant Center 中选中的复选框)。除非在 excludedDestinations 中加入了默认平台,否则将始终为定位目标添加默认平台。

excludedDestinations[]

string

为此定位目标排除的目标平台列表(对应于 Merchant Center 中未选中的复选框)。

shoppingAdsExcludedCountries[]

string

要从购物广告目标平台中排除商品,请提供国家/地区代码 (ISO 3166-1 alpha-2) 列表。此列表中的国家/地区会从数据源设置中配置的国家/地区中移除。

cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

要导出到 Cloud Retail 计划的额外字段。

certifications[]

object (Certification)

商品认证,例如 EU EPREL 数据库中记录的商品的能效标识。如需了解详情,请参阅帮助中心文章。

autoPricingMinPrice

object (Price)

“自动折扣”(https://support.google.com/merchants/answer/10295759) 和“动态促销”(https://support.google.com/merchants/answer/13949249) 项目中的一项保护措施,可确保商家商品的折扣不低于此值,从而维护商品的价值和盈利能力。

identifierExists

boolean

如果商品没有与其类别相符的唯一商品标识码(例如 GTIN、MPN 和品牌),请将此值设为 false。如果未提供,则默认为 true。

isBundle

boolean

商品是否为商家定义的套装。套装是商家以单一价格销售的不同商品的自定义组合。

title

string

商品名。

description

string

商品的说明。

adult

boolean

如果商品的定位为成人商品,则设置为 true。

ageGroup

string

商品的目标年龄段

availability

string

商品的库存状况。

brand

string

商品的品牌。

color

string

商品的颜色。

condition

string

商品的使用情况或状态。

gender

string

商品的目标性别。

googleProductCategory

string

商品在 Google 中的类别(请参阅 Google 商品类目)。查询商品时,此字段将包含用户提供的值。目前无法通过 API 恢复自动分配的 Google 商品类别。

itemGroupId

string

同一商品所有款式的共用标识符。

material

string

商品的材质。

mpn

string

商品的制造商部件号 (MPN)。

pattern

string

商品的图案(例如圆点花纹)。

sellOnGoogleQuantity

string (int64 format)

可在 Google 上销售的商品数量。仅适用于线上商品。

maxHandlingTime

string (int64 format)

商品最长订单处理时间(以工作日计)。

minHandlingTime

string (int64 format)

商品最短订单处理时间(以工作日计)。

shippingLabel

string

商品的配送标签,用于在账号级配送规则中对商品进行分组。

transitTimeLabel

string

商品的运送时间标签,用于在账号级运送时间表中对商品进行分组。

size

string

商品的尺寸。仅允许设置一个值。对于不同尺寸的款式/规格,请为每种尺寸插入一个单独的商品,并为其使用相同的 itemGroupId 值(请参阅 [https://support.google.com/merchants/answer/6324492](尺寸定义))。

sizeSystem

string

指定尺寸的系统。建议为服饰商品提供。

taxCategory

string

商品的税种,用于在账号级税费设置中配置详细的税收关联。

energyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

minEnergyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

maxEnergyEfficiencyClass

string

欧盟指令 2010/30/EU 中定义的能效等级。

multipack

string (int64 format)

商家定义的多件组合装中相同商品的数量。

adsGrouping

string

用于以任意方式对项进行分组。仅适用于每次转化费用百分比,不建议用于其他类型。

adsRedirect

string

允许广告客户在商品在商品广告上下文中展示时替换商品网址。

displayAdsId

string

为动态再营销广告系列提供的商品标识符。

displayAdsTitle

string

为动态再营销广告系列提供的商品名。

displayAdsValue

number

为动态再营销广告系列提供的利润值。

pickupMethod

string

商品的自提选项。

pickupSla

string

商品的商店自提时间表。

customLabel0

string

自定义标签 0,用于自定义购物广告系列中的商品分组。

customLabel1

string

自定义标签 1,用于自定义购物广告系列中的商品分组。

customLabel2

string

自定义标签 2,用于自定义购物广告系列中的商品分组。

customLabel3

string

自定义标签 3,用于自定义购物广告系列中的商品分组。

customLabel4

string

自定义标签 4,用于自定义购物广告系列中的商品分组。

externalSellerId

string

对于多卖家账号,此属性是必需属性。如果您是购物平台且想将多个卖家的商品上传到您的多卖家账号,请使用此属性。

pause

string

此项内容的发布将暂时暂停

structuredTitle

object (ProductStructuredTitle)

结构化商品名,适用于算法(AI)生成的商品名。

structuredDescription

object (ProductStructuredDescription)

结构化说明,适用于算法(AI)生成的说明。

分期付款

表示分期付款的消息。

JSON 表示法
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
字段
months

string (int64 format)

买家必须支付的分期付款期数。

amount

object (Price)

买家每月需要支付的金额。

downpayment

object (Price)

买家必须支付的预付首付款金额。

creditType

string

分期付款类型。支持的值包括:*“finance”*“lease

SubscriptionCost

商品的 SubscriptionCost。

JSON 表示法
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
字段
period

enum (SubscriptionPeriod)

订阅期的类型。支持的值包括:*“month”*“year

periodLength

string (int64 format)

买家必须支付的订阅期数。

amount

object (Price)

买家每个订阅期需要支付的金额。

SubscriptionPeriod

商品的订阅期。

枚举
SUBSCRIPTION_PERIOD_UNSPECIFIED 表示未指定订阅期。
MONTH 表示订阅期为月。
YEAR 表示订阅期为年。

LoyaltyPoints

表示会员积分的消息。

JSON 表示法
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
字段
name

string

积分计划的名称。建议将名称限制为 12 个全角字符或 24 个罗马字符。

pointsValue

string (int64 format)

零售商的绝对值忠诚度积分。

ratio

number

积分与货币的兑换比率。Google 会根据 Merchant Center 设置假定币种。如果省略比率,则默认为 1.0。

LoyaltyProgram

表示会员回馈活动的消息。

JSON 表示法
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string,
  "memberPriceEffectiveDate": {
    object (Interval)
  },
  "shippingLabel": string
}
字段
programLabel

string

会员回馈活动的标签。这是一个内部标签,用于唯一标识商家实体与会员回馈活动实体之间的关系。必须提供此标签,以便系统将以下素材资源(例如价格和积分)与商家相关联。相应的计划必须与商家账号相关联。

tierLabel

string

会员回馈活动中的等级标签。必须与计划中的某个标签匹配。

price

object (Price)

指定层级的会员享受的价格,即即时折扣价。必须小于或等于常规价格。

cashbackForFutureUse

object (Price)

返现金可用于日后购物。

loyaltyPoints

string (int64 format)

每次购买交易可获得的积分数。

memberPriceEffectiveDate

object (Interval)

商品享受会员价的日期范围。如果未指定,则始终应用会员价格。日期范围由一对 ISO 8601 日期表示,相应日期之间用空格、英文逗号或正斜线分隔。

shippingLabel

string

配送福利的标签。如果此字段有值,则表示此商品提供会员配送福利。如果未提供此字段值,则商品不符合指定会员层级的会员配送条件。

ProductDimension

商品的尺寸。

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

number

必需。以数字表示的维度值。此值最多可精确到小数点后 4 位。

unit

string

必需。尺寸单位。可接受的值包括:*“in”*“cm

ProductWeight

商品的重量。

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

number

必需。权重,以数字表示。权重最多可精确到小数点后 4 位。

unit

string

必需。重量单位。可接受的值包括:* "g" * "kg" * "oz" * "lb"

运费

商品的配送信息。

JSON 表示法
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
字段
price

object (Price)

固定运费,以数字表示。

country

string

商品将配送到的国家/地区的 CLDR 地区代码

region

string

适用于配送费率的地理区域。如需了解详情,请参阅 region

service

string

服务级别或送货速度的自由形式说明。

locationId

string (int64 format)

适用于配送费率的地理位置的数字 ID(如 AdWords API 中所定义)。

locationGroupName

string

适用配送方式的地理位置,由营业地点组名称表示。

postalCode

string

配送费率适用的邮政编码范围,表示为邮政编码、邮政编码前缀后跟 * 通配符、两个邮政编码之间的范围,或两个长度相同的邮政编码前缀。

minHandlingTime

string (int64 format)

从收到订单到发货所需的最短工作日(包括这两天)。0 表示订单在收到后当天发货(如果是在截止时间之前收到的)。minHandlingTime 只能与 maxHandlingTime 一起使用;但如果存在 maxHandlingTime,则不需要 minHandlingTime

maxHandlingTime

string (int64 format)

从收到订单到发货所需的最长工作日(包括这两天)。0 表示订单在收到后当天发货(如果是在截止时间之前收到的)。如果提供配送速度,则必须提供 maxHandlingTimemaxTransitTime。如果存在 maxHandlingTime,则 minHandlingTime 为可选项。

minTransitTime

string (int64 format)

从订单发货到送达所需的最短工作日(包括这两天)。0 表示订单会在发货当天送达。minTransitTime 只能与 maxTransitTime 一起使用;但如果存在 maxTransitTime,则不需要 minTransitTime

maxTransitTime

string (int64 format)

从订单发货到送达所需的最长运送时间(以工作日计算,包括这段时间)。0 表示订单会在发货当天送达。如果提供配送速度,则必须提供 maxHandlingTimemaxTransitTime。如果存在 maxTransitTime,则 minTransitTime 为可选项。

FreeShippingThreshold

商品需满足哪些条件才能享受免运费。

JSON 表示法
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
字段
country

string

商品将配送到的国家/地区的 CLDR 地区代码

priceThreshold

object (Price)

商品价格达到此最低金额时,运费即免。以数字表示。

ShippingWeight

商品的 ShippingWeight。

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

number

用于计算商品运费的商品重量。

unit

string

值的单位。

ShippingDimension

商品的 ShippingDimension。

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

number

商品的尺寸,用于计算商品的运费。

unit

string

值的单位。

税费

商品的税费。

JSON 表示法
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
字段
rate

number

适用于商品价格的税率百分比。

country

string

商品在哪个国家/地区纳税,以 CLDR 地区代码指定。

region

string

税率适用的地理区域。

taxShip

boolean

如果对运费收税,请将此属性设为 true。

locationId

string (int64 format)

税率适用的地理位置的数字 ID(如 AdWords API 中所定义)。

postalCode

string

税率适用的邮政编码范围,表示为邮政编码、使用通配符“*”的邮政编码前缀、两个邮政编码之间的范围,或两个长度相同的邮政编码前缀。示例:94114、94*、94002-95460、94*-95*。

UnitPricingMeasure

商品的 UnitPricingMeasure。

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

number

商品的尺寸。

unit

string

测量单位。

UnitPricingBaseMeasure

商品的 UnitPricingBaseMeasure。

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

string (int64 format)

单价的分母。

unit

string

分母的单位。

ProductDetail

商品详情。

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

string

用于对一组商品详情进行分组的部分标题。

attributeName

string

商品详情的名称。

attributeValue

string

商品详情的值。

CloudExportAdditionalProperties

Cloud Retail API 的商品属性。例如,电视产品的属性可以是“Screen-Resolution”(屏幕分辨率)或“Screen-Size”(屏幕尺寸)。

JSON 表示法
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
字段
textValue[]

string

给定属性的文本值。例如,“8K(UHD)”可以是电视产品的文本值。此值的最大重复次数为 400。值以任意但一致的顺序存储。字符串大小上限为 256 个字符。

intValue[]

string (int64 format)

给定属性的整数值。例如,电视产品的屏幕分辨率为 1080。此值的最大重复次数为 400。值以任意但一致的顺序存储。

floatValue[]

number

给定属性的浮点值。例如,电视产品的价格为 1.2345。此值的最大重复次数为 400。值以任意但一致的顺序存储。

propertyName

string

给定媒体资源的名称。例如,电视产品的“屏幕分辨率”。字符串大小上限为 256 个字符。

boolValue

boolean

给定属性的布尔值。例如,对于电视产品,如果屏幕是 UHD,则为“True”或“False”。

minValue

number

给定属性的最小浮点值。例如,对于电视产品,版本号为 1.00。

maxValue

number

给定属性的最大浮点值。例如,电视产品的价格为 100.00。

unitCode

string

指定媒体资源的单位。例如,电视产品的“像素”。字符串大小上限为 256B。

认证

商品认证,最初是为了使用欧盟 EPREL 数据库确保商品符合欧盟能效标识要求而引入的。

JSON 表示法
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
字段
certificationAuthority

string

认证授权机构,例如“European_Commission”。长度上限为 2000 个字符。

certificationName

string

认证的名称,例如“EPREL”。长度上限为 2000 个字符。

certificationCode

string

认证代码。长度上限为 2000 个字符。

certificationValue

string

认证值(也称为类别、等级或评分),例如“A+”“C”“黄金”。长度上限为 2000 个字符。

ProductStructuredTitle

结构化商品名,适用于算法(AI)生成的商品名。

JSON 表示法
{
  "digitalSourceType": string,
  "content": string
}
字段
digitalSourceType

string

数字来源类型,例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。

content

string

标题文本的长度上限为 150 个字符

ProductStructuredDescription

结构化说明,适用于算法(AI)生成的说明。

JSON 表示法
{
  "digitalSourceType": string,
  "content": string
}
字段
digitalSourceType

string

数字来源类型,例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。

content

string

说明文本的长度上限为 5,000 个字符