Package google.shopping.merchant.products.v1beta

索引

• ProductInputsService（界面）
• ProductsService（界面）
• Attributes（消息）
• Certification（消息）
• CloudExportAdditionalProperties（消息）
• DeleteProductInputRequest（消息）
• FreeShippingThreshold（消息）
• GetProductRequest（消息）
• InsertProductInputRequest（消息）
• Installment（消息）
• ListProductsRequest（消息）
• ListProductsResponse（消息）
• LoyaltyPoints（消息）
• LoyaltyProgram（消息）
• Product（消息）
• ProductDetail（消息）
• ProductDimension（消息）
• ProductInput（消息）
• ProductStatus（消息）
• ProductStatus.DestinationStatus（消息）
• ProductStatus.ItemLevelIssue（消息）
• ProductStatus.ItemLevelIssue.Severity（枚举）
• ProductStructuredDescription（消息）
• ProductStructuredTitle（消息）
• ProductWeight（消息）
• Shipping（消息）
• ShippingDimension（消息）
• ShippingWeight（消息）
• SubscriptionCost（消息）
• SubscriptionPeriod（枚举）
• Tax（消息）
• UnitPricingBaseMeasure（消息）
• UnitPricingMeasure（消息）

ProductInputsService

用于使用 ProductInput 资源的服务。此服务仅适用于有线上渠道的产品。

DeleteProductInput
rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty) 从 Merchant Center 账号中删除商品输入信息。 插入、更新或删除商品输入后，可能需要几分钟才能检索到处理后的商品。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

InsertProductInput
rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput) 将商品信息上传到您的 Merchant Center 账号。如果已存在内容语言、offerId 和 dataSource 相同的输入，此方法会替换该条目。 插入、更新或删除商品输入后，可能需要几分钟才能检索到处理后的商品。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ProductsService

用于使用商品资源的服务。此服务仅适用于有线上渠道的产品。

GetProduct
rpc GetProduct(GetProductRequest) returns (Product) 从您的 Merchant Center 账号检索已处理的产品。 插入、更新或删除商品输入后，可能需要几分钟才能检索到更新后的最终商品。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ListProducts
rpc ListProducts(ListProductsRequest) returns (ListProductsResponse) 列出 Merchant Center 账号中已处理的商品。响应中包含的项目数量可能少于 pageSize 指定的数量。依赖于 pageToken 来确定是否有更多要请求的项。 插入、更新或删除商品输入后，可能需要几分钟才能检索到更新后的处理商品。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

属性

属性。

字段
additional_image_links[]	string 商品图片的其他网址。
expiration_date	Timestamp 商品过期的日期（在插入时指定），采用 ISO 8601 格式。实际到期日期在 productstatuses 中以 googleExpirationDate 的形式公开显示，如果 expirationDate 太过遥远，则可能会提前。
disclosure_date	Timestamp 商品出现在 Google 的 YouTube 平台上的搜索结果中的日期时间，采用 ISO 8601 格式。如需了解详情，请参阅 [披露日期]( https://support.google.com/merchants/answer/13034208)。
availability_date	Timestamp 预订商品的最早发货日期，采用 ISO 8601 格式。
gtin[]	string 商品的全球贸易项目代码 (GTIN)。您最多可以提供 10 个 GTIN。
price	Price 商品的价格。
installment	Installment 分期付款的期数和金额。
subscription_cost	SubscriptionCost 具有关联订阅合约的商品的付款周期（月或年）数和每个周期的付款金额。
loyalty_points	LoyaltyPoints 用户购买商品后获得的积分。仅限日本。
loyalty_programs[]	LoyaltyProgram 会员回馈活动信息列表，用于向此商品的用户显示会员福利（例如更优惠的价格、积分等）。
product_types[]	string 商品的类别（格式应遵循商品数据规范）。
sale_price	Price 商品的广告宣传促销价。
sale_price_effective_date	Interval 商品促销的日期范围（请参阅商品数据规范）。
product_height	ProductDimension 商品的高度（采用所提供的单位）。该值必须介于 0（不含）到 3000（含）之间。
product_length	ProductDimension 产品的长度（以所提供的单位表示）。该值必须介于 0（不含）到 3000（含）之间。
product_width	ProductDimension 产品的宽度（采用所提供的单位）。该值必须介于 0（不含）到 3000（含）之间。
product_weight	ProductWeight 产品的重量（以所提供的单位表示）。该值必须介于 0（不含）到 2000（含）之间。
shipping[]	Shipping 配送规则。
free_shipping_threshold[]	FreeShippingThreshold 商品需满足哪些条件才能享受免运费。
shipping_weight	ShippingWeight 要寄送的商品的重量。
shipping_length	ShippingDimension 物品包装长度。
shipping_width	ShippingDimension 要寄送的商品的宽度。
shipping_height	ShippingDimension 物品包装后的高度。
size_types[]	string 商品的剪裁方式。它可用于表示服饰商品的组合尺寸类型。最多可以提供两种尺码类型（请参阅 [https://support.google.com/merchants/answer/6324497](尺码类型)）。
taxes[]	Tax 税务信息。
unit_pricing_measure	UnitPricingMeasure 商品的计量单位和尺寸。
unit_pricing_base_measure	UnitPricingBaseMeasure 单价分母的偏好设置。
ads_labels[]	string 与 ads_grouping 类似，但仅适用于每次点击费用出价策略。
cost_of_goods_sold	Price 销货成本。用于毛利润报告。
product_details[]	ProductDetail 技术规范或其他商品详情。
product_highlights[]	string 用于描述商品最重要的亮点的要点。
display_ads_similar_ids[]	string 广告客户指定的推荐商品。
promotion_ids[]	string 促销活动的唯一 ID。
included_destinations[]	string 为此定位目标添加的目标平台列表（对应于 Merchant Center 中选中的复选框）。除非在 excludedDestinations 中加入了默认平台，否则将始终为定位目标添加默认平台。
excluded_destinations[]	string 为此定位目标排除的目标平台列表（对应于 Merchant Center 中未选中的复选框）。
shopping_ads_excluded_countries[]	string 要从购物广告目标平台中排除商品，请提供国家/地区代码 (ISO 3166-1 alpha-2) 列表。此列表中的国家/地区会从数据源设置中配置的国家/地区中移除。
lifestyle_image_links[]	string 商品生活方式图片的其他网址，用于明确标识在真实环境中展示商品的图片。如需了解详情，请参阅帮助中心文章。
cloud_export_additional_properties[]	CloudExportAdditionalProperties 要导出到 Cloud Retail 计划的额外字段。
certifications[]	Certification 商品认证，例如 EU EPREL 数据库中记录的商品的能效标识。如需了解详情，请参阅帮助中心文章。
auto_pricing_min_price	Price “自动折扣”(https://support.google.com/merchants/answer/10295759) 和“动态促销”(https://support.google.com/merchants/answer/13949249) 项目中的一项保护措施，可确保商家商品的折扣不低于此值，从而维护商品的价值和盈利能力。
identifier_exists	bool 如果商品没有与其类别相符的唯一商品标识码（例如 GTIN、MPN 和品牌），请将此值设为 false。如果未提供，则默认为 true。
is_bundle	bool 商品是否为商家定义的套装。套装是商家以单一价格销售的不同商品的自定义组合。
title	string 商品名。
description	string 商品的说明。
link	string 直接链接到您网店中商品页面的网址。
mobile_link	string 商品着陆页的针对移动设备进行了优化的版本的网址。
canonical_link	string 商品着陆页规范版本的网址。
image_link	string 商品图片的网址。
adult	bool 如果商品的定位为成人商品，则设置为 true。
age_group	string 商品的目标年龄段。
availability	string 商品的库存状况。
brand	string 商品的品牌。
color	string 商品的颜色。
condition	string 商品的使用情况或状态。
gender	string 商品的目标性别。
google_product_category	string 商品在 Google 中的类别（请参阅 Google 商品类目）。查询商品时，此字段将包含用户提供的值。目前无法通过 API 恢复自动分配的 Google 商品类别。
item_group_id	string 同一商品所有款式的共用标识符。
material	string 商品的材质。
mpn	string 商品的制造商部件号 (MPN)。
pattern	string 商品的图案（例如圆点花纹）。
sell_on_google_quantity	int64 可在 Google 上销售的商品数量。仅适用于线上商品。
max_handling_time	int64 商品最长订单处理时间（以工作日计）。
min_handling_time	int64 商品最短订单处理时间（以工作日计）。
shipping_label	string 商品的配送标签，用于在账号级配送规则中对商品进行分组。
transit_time_label	string 商品的运送时间标签，用于在账号级运送时间表中对商品进行分组。
size	string 商品的尺寸。仅允许设置一个值。对于不同尺寸的款式/规格，请为每种尺寸插入一个单独的商品，并为其使用相同的 itemGroupId 值（请参阅 [https://support.google.com/merchants/answer/6324492](尺寸定义)）。
size_system	string 指定尺寸的系统。建议为服饰商品提供。
tax_category	string 商品的税种，用于在账号级税费设置中配置详细的税收关联。
energy_efficiency_class	string 欧盟指令 2010/30/EU 中定义的能效等级。
min_energy_efficiency_class	string 欧盟指令 2010/30/EU 中定义的能效等级。
max_energy_efficiency_class	string 欧盟指令 2010/30/EU 中定义的能效等级。
multipack	int64 商家定义的多件组合装中相同商品的数量。
ads_grouping	string 用于以任意方式对项进行分组。仅适用于每次转化费用百分比，不建议用于其他类型。
ads_redirect	string 允许广告客户在商品在商品广告上下文中展示时替换商品网址。
display_ads_id	string 为动态再营销广告系列提供的商品标识符。
display_ads_title	string 为动态再营销广告系列提供的商品名。
display_ads_link	string 为动态再营销广告系列提供的直达商品着陆页的网址。
display_ads_value	double 为动态再营销广告系列提供的利润值。
pickup_method	string 商品的自提选项。
pickup_sla	string 商品的商店自提时间表。
link_template	string 商家自管的本地店面页面的链接模板。
mobile_link_template	string 针对移动设备优化的商家自管的本地店面页面的链接模板。
custom_label_0	string 自定义标签 0，用于自定义购物广告系列中的商品分组。
custom_label_1	string 自定义标签 1，用于自定义购物广告系列中的商品分组。
custom_label_2	string 自定义标签 2，用于自定义购物广告系列中的商品分组。
custom_label_3	string 自定义标签 3，用于自定义购物广告系列中的商品分组。
custom_label_4	string 自定义标签 4，用于自定义购物广告系列中的商品分组。
external_seller_id	string 对于多卖家账号，此属性是必需属性。如果您是购物平台且想将多个卖家的商品上传到您的多卖家账号，请使用此属性。
pause	string 此项内容的发布将暂时暂停。
virtual_model_link	string 商品的 3D 图片的网址。如需了解详情，请参阅帮助中心文章。
structured_title	ProductStructuredTitle 结构化商品名，适用于算法（AI）生成的商品名。
structured_description	ProductStructuredDescription 结构化说明，适用于算法（AI）生成的说明。

认证

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

字段
certification_authority	string 认证授权机构，例如“European_Commission”。长度上限为 2000 个字符。
certification_name	string 认证的名称，例如“EPREL”。长度上限为 2000 个字符。
certification_code	string 认证代码。长度上限为 2000 个字符。
certification_value	string 认证值（也称为类别、等级或评分），例如“A+”“C”“黄金”。长度上限为 2000 个字符。

CloudExportAdditionalProperties

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

字段
text_value[]	string 给定属性的文本值。例如，“8K(UHD)”可以是电视产品的文本值。此值的最大重复次数为 400。值以任意但一致的顺序存储。字符串大小上限为 256 个字符。
int_value[]	int64 给定属性的整数值。例如，电视产品的屏幕分辨率为 1080。此值的最大重复次数为 400。值以任意但一致的顺序存储。
float_value[]	float 给定属性的浮点值。例如，电视产品的价格为 1.2345。此值的最大重复次数为 400。值以任意但一致的顺序存储。
property_name	string 给定媒体资源的名称。例如，电视产品的“屏幕分辨率”。字符串大小上限为 256 个字符。
bool_value	bool 给定属性的布尔值。例如，对于电视产品，如果屏幕是 UHD，则为“True”或“False”。
min_value	float 给定属性的最小浮点值。例如，对于电视产品，版本号为 1.00。
max_value	float 给定属性的最大浮点值。例如，电视产品的价格为 100.00。
unit_code	string 指定媒体资源的单位。例如，电视产品的“像素”。字符串大小上限为 256B。

DeleteProductInputRequest

DeleteProductInput 方法的请求消息。

字段
name	string 必需。要删除的商品输入资源的名称。格式：accounts/{account}/productInputs/{product}，其中最后一个部分 product 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品名称示例为“accounts/123/productInputs/online~en~US~sku123”
data_source	string 必需。应从中删除商品输入的主要数据源或补充数据源。格式：accounts/{account}/dataSources/{datasource}。

FreeShippingThreshold

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

字段
country	string 商品将配送到的国家/地区的 CLDR 地区代码。
price_threshold	Price 商品价格达到此最低金额时，运费即免。以数字表示。

GetProductRequest

GetProduct 方法的请求消息。

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

InsertProductInputRequest

InsertProductInput 方法的请求消息。

字段
parent	string 必需。要插入此商品的账号。格式：accounts/{account}
product_input	ProductInput 必需。要插入的商品输入内容。
data_source	string 必需。主要或补充商品数据源名称。如果商品已存在，并且提供的数据源不同，则该商品将移至新的数据源。格式：accounts/{account}/dataSources/{datasource}。

分期付款

表示分期付款的消息。

字段
months	int64 买家必须支付的分期付款期数。
amount	Price 买家每月需要支付的金额。
downpayment	Price 买家必须支付的预付首付款金额。
credit_type	string 分期付款类型。支持的值包括：*“finance”*“lease”

ListProductsRequest

ListProducts 方法的请求消息。

字段
parent	string 必需。要为其列出已处理商品的账号。格式：accounts/{account}
page_size	int32 要返回的商品数量上限。服务返回的值可能小于此值。最大值为 250；大于 250 的值将被强制转换为 250。如果未指定，则会返回最大数量的商品。
page_token	string 从之前的 ListProducts 调用接收的页面令牌。利用其进行后续页面检索。 进行分页时，提供给 ListProducts 的所有其他参数必须与提供页面令牌的调用匹配。

ListProductsResponse

ListProducts 方法的响应消息。

字段
products[]	Product 指定账号中已处理的商品。这些是应用规则和补充数据源后处理的产品。
next_page_token	string 可作为 page_token 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

LoyaltyPoints

表示会员积分的消息。

字段
name	string 积分计划的名称。建议将名称限制为 12 个全角字符或 24 个罗马字符。
points_value	int64 零售商的绝对值忠诚度积分。
ratio	double 积分与货币的兑换比率。Google 会根据 Merchant Center 设置假定币种。如果省略比率，则默认为 1.0。

LoyaltyProgram

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

字段
program_label	string 会员回馈活动的标签。这是一个内部标签，用于唯一标识商家实体与会员回馈活动实体之间的关系。必须提供此标签，以便系统将以下素材资源（例如价格和积分）与商家相关联。相应的计划必须与商家账号相关联。
tier_label	string 会员回馈活动中的等级标签。必须与计划中的某个标签匹配。
price	Price 指定层级的会员享受的价格，即即时折扣价。必须小于或等于常规价格。
cashback_for_future_use	Price 返现金可用于日后购物。
loyalty_points	int64 每次购买交易可获得的积分数。
member_price_effective_date	Interval 商品享受会员价的日期范围。如果未指定，则始终应用会员价格。日期范围由一对 ISO 8601 日期表示，相应日期之间用空格、英文逗号或正斜线分隔。
shipping_label	string 配送福利的标签。如果此字段有值，则表示此商品提供会员配送福利。如果未提供此字段值，则商品不符合指定会员层级的会员配送条件。

产品

处理后的产品，在应用规则和补充数据源后，从多个 product inputs 构建而成。经过处理的商品与您的 Merchant Center 账号以及购物广告和 Google 各个平台上的其他位置中显示的商品一致。每个商品都仅由一个主要数据源商品输入和多个补充数据源输入构建而成。插入、更新或删除商品输入后，可能需要几分钟才能检索到更新后的处理商品。

经过处理的商品及其子消息中的所有字段都与商品数据规范中相应属性的名称一致，但存在一些例外情况。

字段
name	string 产品的名称。格式："{product.name=accounts/{account}/products/{product}}"，其中最后一个部分 product 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品名称示例为“accounts/123/products/online~en~US~sku123”
channel	ChannelEnum 仅限输出。商品的渠道。
offer_id	string 仅限输出。商品的唯一标识符。商品输入和处理后的商品也是如此。提交后，系统会移除前导和尾随空格，并将多个空格替换为单个空格。如需了解详情，请参阅商品数据规范。
content_language	string 仅限输出。商品的双字母 ISO 639-1 语言代码。
feed_label	string 仅限输出。商品的 Feed 标签。
data_source	string 仅限输出。商品的主要数据源。
attributes	Attributes 仅限输出。商品属性列表。
custom_attributes[]	CustomAttribute 仅限输出。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。
product_status	ProductStatus 仅限输出。商品的状态、数据验证问题，即异步计算的商品相关信息。
version_number	int64 仅限输出。表示商品的现有版本（新鲜度），可用于在同时进行多项更新时保持正确的顺序。 如果设置，则当版本号低于现有商品的当前版本号时，系统会阻止插入。可以使用当前的 version_number 执行重新插入（例如，在 30 天后刷新商品）。 仅支持将数据插入主要数据源。 如果操作被阻止，系统会抛出中止异常。

ProductDetail

商品详情。

字段
section_name	string 用于对一组商品详情进行分组的部分标题。
attribute_name	string 商品详情的名称。
attribute_value	string 商品详情的值。

ProductDimension

商品的尺寸。

字段
value	double 必需。以数字表示的维度值。此值最多可精确到小数点后 4 位。
unit	string 必需。尺寸单位。可接受的值包括：*“in”*“cm”

ProductInput

此资源代表您为商品提交的输入数据，而不是您在 Merchant Center、购物广告或 Google 各平台上看到的经过处理的商品。系统会将商品输入、规则和补充数据源数据组合起来，以创建经过处理的 Product。

商品数据规范主要定义了必须提供的商品输入属性，以便通过数据验证检查。

以下属性是必需的：feedLabel、contentLanguage 和 offerId。

插入、更新或删除商品输入后，可能需要几分钟才能检索到处理后的商品。

商品输入及其子消息中的所有字段都与相应行业规范中相应属性的英语名称一致，但有少数例外情况。

字段
name	string 标识符。商品输入的名称。格式："{productinput.name=accounts/{account}/productInputs/{productinput}}"，其中最后一个部分 productinput 由 4 个部分组成：channel~content_language~feed_label~offer_id，商品输入名称示例为“accounts/123/productInputs/online~en~US~sku123”
product	string 仅限输出。处理的商品的名称。格式："{product.name=accounts/{account}/products/{product}}"
channel	ChannelEnum 必需。不可变。商品的渠道。
offer_id	string 必需。不可变。商品的唯一标识符。商品输入和处理后的商品也是如此。提交后，系统会移除前导和尾随空格，并将多个空格替换为单个空格。如需了解详情，请参阅商品数据规范。
content_language	string 必需。不可变。商品的双字母 ISO 639-1 语言代码。
feed_label	string 必需。不可变。商品的 Feed 标签。
attributes	Attributes 可选。商品属性列表。
custom_attributes[]	CustomAttribute 可选。自定义（商家提供）属性的列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如用于“在 Google 上购买”的其他属性）非常有用。每个自定义属性允许的字符数上限为 10240 个字符（表示名称和值的字符数总和）。每个商品最多可设置 2500 个自定义属性，总大小不得超过 102.4KB。自定义属性名称中的下划线会在插入时替换为空格。
version_number	int64 可选。表示商品的现有版本（新鲜度），可用于在同时进行多项更新时保持正确的顺序。 如果设置，则当版本号低于现有商品的当前版本号时，系统会阻止插入。可以使用当前的 version_number 执行重新插入（例如，在 30 天后刷新商品）。 仅支持将数据插入主要数据源。 如果操作被阻止，系统会抛出中止异常。

ProductStatus

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

字段
destination_statuses[]	DestinationStatus 商品的预期目的地。
item_level_issues[]	ItemLevelIssue 与商品关联的所有问题的列表。
creation_date	Timestamp 商品的创建日期，采用 ISO 8601 格式。
last_update_date	Timestamp 商品的上次更新日期，采用 ISO 8601 格式。
google_expiration_date	Timestamp 商品的到期日期，采用 ISO 8601 格式。

DestinationStatus

商品状态的目标状态。

字段
reporting_context	ReportingContextEnum 报告上下文的名称。
approved_countries[]	string 优惠已获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
pending_countries[]	string 优惠待批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。
disapproved_countries[]	string 优惠未获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

ItemLevelIssue

商品状态的 ItemLevelIssue。

字段
code	string 问题的错误代码。
severity	Severity 此问题对提供服务有何影响。
resolution	string 商家是否可以解决此问题。
attribute	string 属性的名称（如果此问题是由单个属性引发的）。
reporting_context	ReportingContextEnum 问题适用的报告上下文。
description	string 以英文编写的简短问题说明。
detail	string 以英文编写的详细问题说明。
documentation	string 帮助解决此问题的网页的网址。
applicable_countries[]	string 问题适用的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

严重程度

此问题对商品投放有何影响。

枚举
SEVERITY_UNSPECIFIED	未指定。
NOT_IMPACTED	此问题属于警告性问题，不会对商品产生直接影响。
DEMOTED	商品被降级，在搜索结果中的展示效果很可能受限
DISAPPROVED	问题导致商品被拒批。

ProductStructuredDescription

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

字段
digital_source_type	string 数字来源类型，例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。
content	string 说明文本的长度上限为 5,000 个字符

ProductStructuredTitle

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

字段
digital_source_type	string 数字来源类型，例如“trained_algorithmic_media”。遵循 IPTC 标准。长度上限为 40 个字符。
content	string 标题文本的长度上限为 150 个字符

ProductWeight

商品的重量。

字段
value	double 必需。权重，以数字表示。权重最多可精确到小数点后 4 位。
unit	string 必需。重量单位。可接受的值包括：* "g" * "kg" * "oz" * "lb"

运费

商品的配送信息。

字段
price	Price 固定运费，以数字表示。
country	string 商品将配送到的国家/地区的 CLDR 地区代码。
region	string 适用于配送费率的地理区域。如需了解详情，请参阅 region。
service	string 服务级别或送货速度的自由形式说明。
location_id	int64 适用于配送费率的地理位置的数字 ID（如 AdWords API 中所定义）。
location_group_name	string 适用配送方式的地理位置，由营业地点组名称表示。
postal_code	string 配送费率适用的邮政编码范围，表示为邮政编码、邮政编码前缀后跟 * 通配符、两个邮政编码之间的范围，或两个长度相同的邮政编码前缀。
min_handling_time	int64 从收到订单到发货所需的最短工作日（包括这两天）。0 表示订单在收到后当天发货（如果是在截止时间之前收到的）。minHandlingTime 只能与 maxHandlingTime 一起使用；但如果存在 maxHandlingTime，则不需要 minHandlingTime。
max_handling_time	int64 从收到订单到发货所需的最长工作日（包括这两天）。0 表示订单在收到后当天发货（如果是在截止时间之前收到的）。如果提供配送速度，则必须提供 maxHandlingTime 和 maxTransitTime。如果存在 maxHandlingTime，则 minHandlingTime 为可选项。
min_transit_time	int64 从订单发货到送达所需的最短工作日（包括这两天）。0 表示订单会在发货当天送达。minTransitTime 只能与 maxTransitTime 一起使用；但如果存在 maxTransitTime，则不需要 minTransitTime。
max_transit_time	int64 从订单发货到送达所需的最长运送时间（以工作日计算，包括这段时间）。0 表示订单会在发货当天送达。如果提供配送速度，则必须提供 maxHandlingTime 和 maxTransitTime。如果存在 maxTransitTime，则 minTransitTime 为可选项。

ShippingDimension

商品的 ShippingDimension。

字段
value	double 商品的尺寸，用于计算商品的运费。
unit	string 值的单位。

ShippingWeight

商品的 ShippingWeight。

字段
value	double 用于计算商品运费的商品重量。
unit	string 值的单位。

SubscriptionCost

商品的 SubscriptionCost。

字段
period	SubscriptionPeriod 订阅期的类型。支持的值包括：*“month”*“year”
period_length	int64 买家必须支付的订阅期数。
amount	Price 买家每个订阅期需要支付的金额。

SubscriptionPeriod

商品的订阅期。

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

税费

商品的税费。

字段
rate	double 适用于商品价格的税率百分比。
country	string 商品在哪个国家/地区纳税，以 CLDR 地区代码指定。
region	string 税率适用的地理区域。
tax_ship	bool 如果对运费收税，请将此属性设为 true。
location_id	int64 税率适用的地理位置的数字 ID（如 AdWords API 中所定义）。
postal_code	string 税率适用的邮政编码范围，表示为邮政编码、使用通配符“*”的邮政编码前缀、两个邮政编码之间的范围，或两个长度相同的邮政编码前缀。示例：94114、94*、94002-95460、94*-95*。

UnitPricingBaseMeasure

商品的 UnitPricingBaseMeasure。

字段
value	int64 单价的分母。
unit	string 分母的单位。

UnitPricingMeasure

商品的 UnitPricingMeasure。

字段
value	double 商品的尺寸。
unit	string 测量单位。