- JSON 表示法
- 分期付款
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- 运费
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- 税费
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- 认证
- ProductStructuredTitle
- ProductStructuredDescription
属性。
JSON 表示法 |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
字段 | |
---|---|
additional |
商品图片的其他网址。 |
expiration |
商品过期的日期(在插入时指定),采用 ISO 8601 格式。实际到期日期在 |
disclosure |
商品出现在 Google 的 YouTube 平台上的搜索结果中的日期时间,采用 ISO 8601 格式。如需了解详情,请参阅 [披露日期]( https://support.google.com/merchants/answer/13034208)。 |
availability |
预订商品的最早发货日期,采用 ISO 8601 格式。 |
gtin[] |
商品的全球贸易项目代码 (GTIN)。您最多可以提供 10 个 GTIN。 |
price |
商品的价格。 |
installment |
分期付款的期数和金额。 |
subscription |
具有关联订阅合约的商品的付款周期(月或年)数和每个周期的付款金额。 |
loyalty |
用户购买商品后获得的积分。仅限日本。 |
loyalty |
会员回馈活动信息列表,用于向此商品的用户显示会员福利(例如更优惠的价格、积分等)。 |
product |
商品的类别(格式应遵循商品数据规范)。 |
sale |
商品的广告宣传促销价。 |
sale |
商品促销的日期范围(请参阅商品数据规范)。 |
product |
商品的高度(采用所提供的单位)。该值必须介于 0(不含)到 3000(含)之间。 |
product |
产品的长度(以所提供的单位表示)。该值必须介于 0(不含)到 3000(含)之间。 |
product |
产品的宽度(采用所提供的单位)。该值必须介于 0(不含)到 3000(含)之间。 |
product |
产品的重量(以所提供的单位表示)。该值必须介于 0(不含)到 2000(含)之间。 |
shipping[] |
配送规则。 |
free |
商品需满足哪些条件才能享受免运费。 |
shipping |
要寄送的商品的重量。 |
shipping |
物品包装长度。 |
shipping |
要寄送的商品的宽度。 |
shipping |
物品包装后的高度。 |
size |
商品的剪裁方式。它可用于表示服饰商品的组合尺寸类型。最多可以提供两种尺码类型(请参阅 [https://support.google.com/merchants/answer/6324497](尺码类型))。 |
taxes[] |
税务信息。 |
unit |
商品的计量单位和尺寸。 |
unit |
单价分母的偏好设置。 |
ads |
与 adsGrouping 类似,但仅适用于每次点击费用。 |
cost |
销货成本。用于毛利润报告。 |
product |
技术规范或其他商品详情。 |
product |
用于描述商品最重要的亮点的要点。 |
display |
广告客户指定的推荐商品。 |
promotion |
促销活动的唯一 ID。 |
included |
为此定位目标添加的目标平台列表(对应于 Merchant Center 中选中的复选框)。除非在 |
excluded |
为此定位目标排除的目标平台列表(对应于 Merchant Center 中未选中的复选框)。 |
shopping |
要从购物广告目标平台中排除商品,请提供国家/地区代码 (ISO 3166-1 alpha-2) 列表。此列表中的国家/地区会从数据源设置中配置的国家/地区中移除。 |
lifestyle |
商品生活方式图片的其他网址,用于明确标识在真实环境中展示商品的图片。如需了解详情,请参阅帮助中心文章。 |
cloud |
要导出到 Cloud Retail 计划的额外字段。 |
certifications[] |
|
auto |
“自动折扣”(https://support.google.com/merchants/answer/10295759) 和“动态促销”(https://support.google.com/merchants/answer/13949249) 项目中的一项保护措施,可确保商家商品的折扣不低于此值,从而维护商品的价值和盈利能力。 |
identifier |
如果商品没有与其类别相符的唯一商品标识码(例如 GTIN、MPN 和品牌),请将此值设为 false。如果未提供,则默认为 true。 |
is |
商品是否为商家定义的套装。套装是商家以单一价格销售的不同商品的自定义组合。 |
title |
商品名。 |
description |
商品的说明。 |
link |
直接链接到您网店中商品页面的网址。 |
mobile |
商品着陆页的针对移动设备进行了优化的版本的网址。 |
canonical |
商品着陆页规范版本的网址。 |
image |
商品图片的网址。 |
adult |
如果商品的定位为成人商品,则设置为 true。 |
age |
商品的目标年龄段。 |
availability |
商品的库存状况。 |
brand |
商品的品牌。 |
color |
商品的颜色。 |
condition |
商品的使用情况或状态。 |
gender |
商品的目标性别。 |
google |
商品在 Google 中的类别(请参阅 Google 商品类目)。查询商品时,此字段将包含用户提供的值。目前无法通过 API 恢复自动分配的 Google 商品类别。 |
item |
同一商品所有款式的共用标识符。 |
material |
商品的材质。 |
mpn |
商品的制造商部件号 (MPN)。 |
pattern |
商品的图案(例如圆点花纹)。 |
sell |
可在 Google 上销售的商品数量。仅适用于线上商品。 |
max |
商品最长订单处理时间(以工作日计)。 |
min |
商品最短订单处理时间(以工作日计)。 |
shipping |
商品的配送标签,用于在账号级配送规则中对商品进行分组。 |
transit |
商品的运送时间标签,用于在账号级运送时间表中对商品进行分组。 |
size |
商品的尺寸。仅允许设置一个值。对于不同尺寸的款式/规格,请为每种尺寸插入一个单独的商品,并为其使用相同的 |
size |
指定尺寸的系统。建议为服饰商品提供。 |
tax |
商品的税种,用于在账号级税费设置中配置详细的税收关联。 |
energy |
欧盟指令 2010/30/EU 中定义的能效等级。 |
min |
欧盟指令 2010/30/EU 中定义的能效等级。 |
max |
欧盟指令 2010/30/EU 中定义的能效等级。 |
multipack |
商家定义的多件组合装中相同商品的数量。 |
ads |
用于以任意方式对项进行分组。仅适用于每次转化费用百分比,不建议用于其他类型。 |
ads |
允许广告客户在商品在商品广告上下文中展示时替换商品网址。 |
display |
为动态再营销广告系列提供的商品标识符。 |
display |
为动态再营销广告系列提供的商品名。 |
display |
为动态再营销广告系列提供的直达商品着陆页的网址。 |
display |
为动态再营销广告系列提供的利润值。 |
pickup |
商品的自提选项。 |
pickup |
商品的商店自提时间表。 |
link |
商家自管的本地店面页面的链接模板。 |
mobile |
针对移动设备优化的商家自管的本地店面页面的链接模板。 |
custom |
自定义标签 0,用于自定义购物广告系列中的商品分组。 |
custom |
自定义标签 1,用于自定义购物广告系列中的商品分组。 |
custom |
自定义标签 2,用于自定义购物广告系列中的商品分组。 |
custom |
自定义标签 3,用于自定义购物广告系列中的商品分组。 |
custom |
自定义标签 4,用于自定义购物广告系列中的商品分组。 |
external |
对于多卖家账号,此属性是必需属性。如果您是购物平台且想将多个卖家的商品上传到您的多卖家账号,请使用此属性。 |
pause |
此项内容的发布将暂时暂停。 |
virtual |
商品的 3D 图片的网址。如需了解详情,请参阅帮助中心文章。 |
structured |
结构化商品名,适用于算法(AI)生成的商品名。 |
structured |
结构化说明,适用于算法(AI)生成的说明。 |
分期付款
表示分期付款的消息。
JSON 表示法 |
---|
{ "months": string, "amount": { object ( |
字段 | |
---|---|
months |
买家必须支付的分期付款期数。 |
amount |
买家每月需要支付的金额。 |
downpayment |
买家必须支付的预付首付款金额。 |
credit |
分期付款类型。支持的值包括:*“ |
SubscriptionCost
商品的 SubscriptionCost。
JSON 表示法 |
---|
{ "period": enum ( |
字段 | |
---|---|
period |
订阅期的类型。支持的值包括:*“ |
period |
买家必须支付的订阅期数。 |
amount |
买家每个订阅期需要支付的金额。 |
SubscriptionPeriod
商品的订阅期。
枚举 | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
表示未指定订阅期。 |
MONTH |
表示订阅期为月。 |
YEAR |
表示订阅期为年。 |
LoyaltyPoints
表示会员积分的消息。
JSON 表示法 |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
字段 | |
---|---|
name |
积分计划的名称。建议将名称限制为 12 个全角字符或 24 个罗马字符。 |
points |
零售商的绝对值忠诚度积分。 |
ratio |
积分与货币的兑换比率。Google 会根据 Merchant Center 设置假定币种。如果省略比率,则默认为 1.0。 |
LoyaltyProgram
表示会员回馈活动的消息。
JSON 表示法 |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
字段 | |
---|---|
program |
会员回馈活动的标签。这是一个内部标签,用于唯一标识商家实体与会员回馈活动实体之间的关系。必须提供此标签,以便系统将以下素材资源(例如价格和积分)与商家相关联。相应的计划必须与商家账号相关联。 |
tier |
会员回馈活动中的等级标签。必须与计划中的某个标签匹配。 |
price |
指定层级的会员享受的价格,即即时折扣价。必须小于或等于常规价格。 |
cashback |
返现金可用于日后购物。 |
loyalty |
每次购买交易可获得的积分数。 |
member |
商品享受会员价的日期范围。如果未指定,则始终应用会员价格。日期范围由一对 ISO 8601 日期表示,相应日期之间用空格、英文逗号或正斜线分隔。 |
shipping |
配送福利的标签。如果此字段有值,则表示此商品提供会员配送福利。如果未提供此字段值,则商品不符合指定会员层级的会员配送条件。 |
ProductDimension
商品的尺寸。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
字段 | |
---|---|
value |
必需。以数字表示的维度值。此值最多可精确到小数点后 4 位。 |
unit |
必需。尺寸单位。可接受的值包括:*“ |
ProductWeight
商品的重量。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
字段 | |
---|---|
value |
必需。权重,以数字表示。权重最多可精确到小数点后 4 位。 |
unit |
必需。重量单位。可接受的值包括:* " |
运费
商品的配送信息。
JSON 表示法 |
---|
{
"price": {
object ( |
字段 | |
---|---|
price |
固定运费,以数字表示。 |
country |
商品将配送到的国家/地区的 CLDR 地区代码。 |
region |
适用于配送费率的地理区域。如需了解详情,请参阅 region。 |
service |
服务级别或送货速度的自由形式说明。 |
location |
适用于配送费率的地理位置的数字 ID(如 AdWords API 中所定义)。 |
location |
适用配送方式的地理位置,由营业地点组名称表示。 |
postal |
配送费率适用的邮政编码范围,表示为邮政编码、邮政编码前缀后跟 * 通配符、两个邮政编码之间的范围,或两个长度相同的邮政编码前缀。 |
min |
从收到订单到发货所需的最短工作日(包括这两天)。0 表示订单在收到后当天发货(如果是在截止时间之前收到的)。 |
max |
从收到订单到发货所需的最长工作日(包括这两天)。0 表示订单在收到后当天发货(如果是在截止时间之前收到的)。如果提供配送速度,则必须提供 |
min |
从订单发货到送达所需的最短工作日(包括这两天)。0 表示订单会在发货当天送达。 |
max |
从订单发货到送达所需的最长运送时间(以工作日计算,包括这段时间)。0 表示订单会在发货当天送达。如果提供配送速度,则必须提供 |
FreeShippingThreshold
商品需满足哪些条件才能享受免运费。
JSON 表示法 |
---|
{
"country": string,
"priceThreshold": {
object ( |
字段 | |
---|---|
country |
商品将配送到的国家/地区的 CLDR 地区代码。 |
price |
商品价格达到此最低金额时,运费即免。以数字表示。 |
ShippingWeight
商品的 ShippingWeight。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
字段 | |
---|---|
value |
用于计算商品运费的商品重量。 |
unit |
值的单位。 |
ShippingDimension
商品的 ShippingDimension。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
字段 | |
---|---|
value |
商品的尺寸,用于计算商品的运费。 |
unit |
值的单位。 |
税费
商品的税费。
JSON 表示法 |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
字段 | |
---|---|
rate |
适用于商品价格的税率百分比。 |
country |
商品在哪个国家/地区纳税,以 CLDR 地区代码指定。 |
region |
税率适用的地理区域。 |
tax |
如果对运费收税,请将此属性设为 true。 |
location |
税率适用的地理位置的数字 ID(如 AdWords API 中所定义)。 |
postal |
税率适用的邮政编码范围,表示为邮政编码、使用通配符“*”的邮政编码前缀、两个邮政编码之间的范围,或两个长度相同的邮政编码前缀。示例:94114、94*、94002-95460、94*-95*。 |
UnitPricingMeasure
商品的 UnitPricingMeasure。
JSON 表示法 |
---|
{ "value": number, "unit": string } |
字段 | |
---|---|
value |
商品的尺寸。 |
unit |
测量单位。 |
UnitPricingBaseMeasure
商品的 UnitPricingBaseMeasure。
JSON 表示法 |
---|
{ "value": string, "unit": string } |
字段 | |
---|---|
value |
单价的分母。 |
unit |
分母的单位。 |
ProductDetail
商品详情。
JSON 表示法 |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
字段 | |
---|---|
section |
用于对一组商品详情进行分组的部分标题。 |
attribute |
商品详情的名称。 |
attribute |
商品详情的值。 |
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 } |
字段 | |
---|---|
text |
给定属性的文本值。例如,“8K(UHD)”可以是电视产品的文本值。此值的最大重复次数为 400。值以任意但一致的顺序存储。字符串大小上限为 256 个字符。 |
int |
给定属性的整数值。例如,电视产品的屏幕分辨率为 1080。此值的最大重复次数为 400。值以任意但一致的顺序存储。 |
float |
给定属性的浮点值。例如,电视产品的价格为 1.2345。此值的最大重复次数为 400。值以任意但一致的顺序存储。 |
property |
给定媒体资源的名称。例如,电视产品的“屏幕分辨率”。字符串大小上限为 256 个字符。 |
bool |
给定属性的布尔值。例如,对于电视产品,如果屏幕是 UHD,则为“True”或“False”。 |
min |
给定属性的最小浮点值。例如,对于电视产品,版本号为 1.00。 |
max |
给定属性的最大浮点值。例如,电视产品的价格为 100.00。 |
unit |
指定媒体资源的单位。例如,电视产品的“像素”。字符串大小上限为 256B。 |
认证
商品认证,最初是为了使用欧盟 EPREL 数据库确保商品符合欧盟能效标识要求而引入的。
JSON 表示法 |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
字段 | |
---|---|
certification |
认证授权机构,例如“European_Commission”。长度上限为 2000 个字符。 |
certification |
认证的名称,例如“EPREL”。长度上限为 2000 个字符。 |
certification |
认证代码。长度上限为 2000 个字符。 |
certification |
认证值(也称为类别、等级或评分),例如“A+”“C”“黄金”。长度上限为 2000 个字符。 |
ProductStructuredTitle
结构化商品名,适用于算法(AI)生成的商品名。
JSON 表示法 |
---|
{ "digitalSourceType": string, "content": string } |
字段 | |
---|---|
digital |
数字来源类型,例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。 |
content |
标题文本的长度上限为 150 个字符 |
ProductStructuredDescription
结构化说明,适用于算法(AI)生成的说明。
JSON 表示法 |
---|
{ "digitalSourceType": string, "content": string } |
字段 | |
---|---|
digital |
数字来源类型,例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。 |
content |
说明文本的长度上限为 5,000 个字符 |