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 账号。如果已存在具有相同 contentLanguage、offerId 和 dataSource 的输入，此方法将替换该条目。 插入、更新或删除输入的商品后，可能需要几分钟才能检索到已处理的商品。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/content 如需了解详情，请参阅 OAuth 2.0 概览。

ProductsService

使用 Product 资源的服务。此服务仅适用于通过在线渠道销售的商品。

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 格式。
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](size type)）。
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 商品认证，例如在欧盟 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 商品类别。
gtin	string 商品的全球贸易项目代码 (GTIN)。
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”或“屏幕尺寸”。

字段
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 给定属性的布尔值。例如，对于电视产品，则为“True”或“False”如果屏幕是超高清。
min_value	float 指定属性的最小浮点值。例如，电视产品 1.00.
max_value	float 指定属性的最大浮点值。例如，电视产品 100.00。
unit_code	string 指定属性的单位。例如，“Pixels”。字符串大小上限为 256B。

DeleteProductInputRequest

DeleteProductInput 方法的请求消息。

字段
name	string 必需。要删除的商品输入资源的名称。格式：accounts/{account}/productInputs/{product}
data_source	string 必需。主要数据源或补充数据源，应从中删除输入的商品。格式：accounts/{account}/dataSources/{datasource}。

FreeShippingThreshold

商品免运费需满足的条件。

字段
country	string 商品要运达的国家/地区的 CLDR 地区代码。
price_threshold	Price 使运费变为免费所需的最低商品价格。以数字表示。

GetProductRequest

GetProduct 方法的请求消息。

字段
name	string 必需。要检索的商品的名称。格式：accounts/{account}/products/{product}

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 要返回的商品数量上限。服务返回的值可能小于此值。最大值为 1000；高于 1000 的值将被强制转换为 1000。如果未指定，则返回的商品数量上限为 。
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 会根据 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 日期（用空格、英文逗号或正斜线分隔）表示。

产品

已处理的商品，在应用规则和补充数据源后根据多项 [商品输入][[google.shopping.content.bundles.Products.ProductInput] 构建而成。处理后的商品与您的 Merchant Center 账号、购物广告和其他“Google 平台呈现”中显示的商品一致。每个产品都基于一个主要数据源产品输入和多个补充数据源输入。插入、更新或删除输入的商品后，可能需要几分钟才能检索到更新后的已处理商品。

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

字段
name	string 产品的名称。格式："{product.name=accounts/{account}/products/{product}}"
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 必需。以数字表示的维度值。值的最高精度可精确到小数点后四位。
unit	string 必需。维度单位。可接受的值为：*“in”*“cm”

ProductInput

此资源表示您为商品提交的输入数据，而不是您在 Merchant Center、购物广告或各个 Google 平台上看到的已处理商品。系统会合并商品输入、规则和补充数据源数据，以创建已处理的 [product][google.shopping.content.bundles.Products.Product]。

通过数据验证检查所必需的商品输入属性主要在商品数据规范中进行了定义。

以下属性是必需属性：[feedLabel][google.shopping.content.bundles.Products.feed_label]、[contentLanguage][google.shopping.content.bundles.Products.content_language] 和 [offerId][google.shopping.content.bundles.Products.offer_id]。

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

商品输入及其子消息中的所有字段均与行业规范中相应属性的英文名称相匹配，但有一些例外情况。

字段
name	string 标识符。输入的商品名称。格式："{productinput.name=accounts/{account}/productInputs/{productinput}}"
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 广告内容描述的文字长度上限为 5000 个字符

ProductStructuredTitle

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

字段
digital_source_type	string 数字源类型，例如“trained_algorithmic_media”。已关注 IPTC。长度上限为 40 个字符。
content	string 标题文字的长度上限为 150 个字符

ProductWeight

商品的重量。

字段
value	double 必需。以数字表示的权重。权重的最大精度可精确到小数点后四位。
unit	string 必需。重量单位。可接受的值为：*“g”*“kg”*“oz”*“lb”

运费

商品的运费。

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

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 AdWords API 中定义的税率所适用的地理位置的数字 ID。
postal_code	string 税率所适用的邮政编码范围，由邮政编码、使用 * 通配符的邮政编码前缀表示，即两个邮政编码前缀或长度相等的两个邮政编码前缀之间的范围。例如：94114、94*、94002-95460、94*-95*。

UnitPricingBaseMeasure

商品的 UnitPricingBaseMeasure。

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

UnitPricingMeasure

商品的 UnitPricingMeasure 。

字段
value	double 商品的计量单位。
unit	string 计量单位。