Package google.shopping.merchant.products.v1beta

string

商品图片的其他网址。

Timestamp

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

Timestamp

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

Timestamp

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

string

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

Price

商品的价格。

Installment

分期付款的期数和金额。

SubscriptionCost

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

LoyaltyPoints

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

LoyaltyProgram

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

string

商品的类别（格式应遵循商品数据规范）。

Price

商品的广告宣传促销价。

Interval

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

ProductDimension

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

ProductDimension

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

ProductDimension

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

ProductWeight

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

Shipping

配送规则。

FreeShippingThreshold

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

ShippingWeight

要寄送的商品的重量。

ShippingDimension

物品包装长度。

ShippingDimension

物品包装后的宽度。

ShippingDimension

物品包装后的高度。

string

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

Tax

税务信息。

UnitPricingMeasure

商品的计量单位和尺寸。

UnitPricingBaseMeasure

单价分母的偏好设置。

string

与 ads_grouping 类似，但仅适用于每次点击费用出价策略。

Price

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

ProductDetail

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

string

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

string

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

string

促销活动的唯一 ID。

string

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

string

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

string

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

string

商品的附加生活方式图片网址，用于明确标识在真实环境中展示商品的图片。如需了解详情，请参阅这篇帮助中心文章。

CloudExportAdditionalProperties

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

Certification

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

Price

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

ProductSustainabilityIncentive

可持续发展奖励计划列表。

bool

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

bool

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

string

商品名。

string

商品的说明。

string

直接链接到您网店中商品页面的网址。

string

商品着陆页的针对移动设备进行了优化的版本的网址。

string

商品着陆页规范版本的网址。

string

商品图片的网址。

bool

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

string

商品的目标年龄段。

string

商品的库存状况。

string

商品的品牌。

string

商品的颜色。

string

商品的使用情况或状态。

string

商品的目标性别。

string

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

string

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

string

商品的材质。

string

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

string

商品的图案（例如圆点花纹）。

int64

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

int64

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

int64

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

string

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

string

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

string

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

string

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

string

商品的税种。

string

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

string

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

string

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

int64

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

string

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

string

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

string

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

string

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

string

为动态再营销广告系列提供的直达商品着陆页的网址。

double

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

string

商品的自提选项。

string

商品的商店自提时间表。

string

商家自管的本地店面页面的链接模板。

string

针对移动设备优化的商家自管的本地店面页面的链接模板。

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

商品的 3D 图片的网址。如需了解详情，请参阅帮助中心文章。

ProductStructuredTitle

结构化商品名，适用于算法（AI）生成的商品名。

ProductStructuredDescription

结构化说明，适用于算法（AI）生成的说明。

string

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

string

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

string

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

string

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

string

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

int64

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

float

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

string

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

bool

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

float

给定属性的最小浮点值。例如，对于电视产品，请使用 1.00。

float

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

string

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

string

必需。要删除的商品输入资源的名称。格式：accounts/{account}/productInputs/{product}，其中最后一个部分 product 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品名称示例为“accounts/123/productInputs/online~en~US~sku123”

string

必需。应从中删除商品输入的主要数据源或补充数据源。格式：accounts/{account}/dataSources/{datasource}。

string

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

Price

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

string

必需。要检索的商品的名称。格式：accounts/{account}/products/{product}，其中最后一个部分 product 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品名称示例为“accounts/123/products/online~en~US~sku123”

string

必需。要插入此商品的账号。格式：accounts/{account}

ProductInput

必需。要插入的商品输入内容。

string

必需。主要或补充商品数据源名称。如果商品已存在，并且提供的数据源不同，则该商品将移至新数据源。

仅支持 API 数据源。

格式：accounts/{account}/dataSources/{datasource}。

int64

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

Price

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

Price

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

string

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

string

必需。要为其列出已处理商品的账号。格式：accounts/{account}

int32

要返回的商品数量上限。服务返回的值可能小于此值。最大值为 250；大于 250 的值将被强制转换为 250。如果未指定，则会返回最大数量的商品。

string

从之前的 ListProducts 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 ListProducts 的所有其他参数必须与提供页面令牌的调用匹配。

Product

指定账号中已处理的商品。这些是应用规则和补充数据源后处理的产品。

string

可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

string

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

int64

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

double

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

string

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

string

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

Price

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

Price

返现金可用于日后购物。

int64

每次购买交易可赚取的积分数。

Interval

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

string

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

string

产品的名称。格式："{product.name=accounts/{account}/products/{product}}"，其中最后一个部分 product 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品名称示例为“accounts/123/products/online~en~US~sku123”

ChannelEnum

仅限输出。商品的渠道。

string

仅限输出。商品的唯一标识符。商品输入和处理后的商品也是如此。提交后，系统会移除前导和尾随空格，并将多个空格替换为单个空格。如需了解详情，请参阅商品数据规范。

string

仅限输出。商品的双字母 ISO 639-1 语言代码。

string

仅限输出。商品的 Feed 标签。

string

仅限输出。商品的主要数据源。

Attributes

仅限输出。商品属性列表。

CustomAttribute

仅限输出。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。

ProductStatus

仅限输出。商品的状态、数据验证问题，即异步计算的商品相关信息。

int64

仅限输出。表示商品的现有版本（新鲜度），可用于在同时进行多项更新时保持正确的顺序。

如果设置，则当版本号低于现有商品的当前版本号时，系统会阻止插入。可以使用当前的 version_number 执行重新插入（例如，在 30 天后刷新商品）。

仅支持向主要数据源插入数据。

如果操作被阻止，系统会抛出中止异常。

string

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

string

商品详情的名称。

string

商品详情的值。

double

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

string

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

string

标识符。商品输入的名称。格式："{productinput.name=accounts/{account}/productInputs/{productinput}}"，其中最后一个部分 productinput 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品输入名称示例为“accounts/123/productInputs/online~en~US~sku123”

string

仅限输出。处理的商品的名称。格式："{product.name=accounts/{account}/products/{product}}"

ChannelEnum

不可变。商品的渠道。

string

必需。不可变。商品的唯一标识符。商品输入和处理后的商品也是如此。提交后，系统会移除前导和尾随空格，并将多个空格替换为单个空格。如需了解详情，请参阅商品数据规范。

string

必需。不可变。商品的双字母 ISO 639-1 语言代码。

string

必需。不可变。商品的 Feed 标签。

Attributes

可选。商品属性列表。

CustomAttribute

可选。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。每个自定义属性允许的字符数上限为 10240 个（表示名称和值的字符数总和）。每个商品最多可设置 2500 个自定义属性，总大小不得超过 102.4KB。自定义属性名称中的下划线会在插入时替换为空格。

int64

可选。表示商品的现有版本（新鲜度），可用于在同时进行多项更新时保持正确的顺序。

如果设置，则当版本号低于现有商品的当前版本号时，系统会阻止插入。可以使用当前的 version_number 执行重新插入（例如，在 30 天后刷新商品）。

仅支持向主要数据源插入数据。

如果操作被阻止，系统会抛出中止异常。

DestinationStatus

商品的预期目的地。

ItemLevelIssue

与商品关联的所有问题的列表。

Timestamp

商品的创建日期，采用 ISO 8601 格式。

Timestamp

商品的上次更新日期，采用 ISO 8601 格式。

Timestamp

商品的到期日期，采用 ISO 8601 格式。

ReportingContextEnum

报告上下文的名称。

string

优惠已获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

string

优惠待批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

string

优惠未获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

string

问题的错误代码。

Severity

此问题对提供服务有何影响。

string

商家是否可以解决此问题。

string

属性的名称（如果此问题是由单个属性引发的）。

ReportingContextEnum

问题适用的报告上下文。

string

以英文编写的简短问题说明。

string

以英文编写的详细问题说明。

string

帮助解决此问题的网页的网址。

string

问题适用的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

string

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

string

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

string

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

string

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

Price

奖励的固定金额。

double

奖励金额占促销价的百分比。

Type

可持续发展激励计划。

double

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

string

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

Price

固定运费，以数字表示。

string

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

string

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

string

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

int64

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

string

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

string

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

int64

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

int64

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

int64

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

int64

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

double

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

string

值的单位。

double

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

string

值的单位。

SubscriptionPeriod

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

int64

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

Price

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

double

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

string

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

string

税率适用的地理区域。

bool

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

int64

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

string

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

int64

单价的分母。

string

分母的单位。

double

商品的尺寸。

string

测量单位。