此页面由 Cloud Translation API 翻译。

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

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

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

从 Merchant Center 帐号中删除输入的商品。

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

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/content

如需了解详情，请参阅 OAuth 2.0 概览。

InsertProductInput

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

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

将输入的产品上传至 Merchant Center 帐号。如果已存在具有相同 contentLanguage、offerId 和 dataSource 的输入，此方法将替换该条目。

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

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/content

如需了解详情，请参阅 OAuth 2.0 概览。

ProductsService

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

GetProduct

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

rpc GetProduct(GetProductRequest) returns (Product)

从您的 Merchant Center 帐号中检索已处理的产品。

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

授权范围

需要以下 OAuth 范围：

https://www.googleapis.com/auth/content

如需了解详情，请参阅 OAuth 2.0 概览。

ListProducts

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

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

DeleteProductInputRequest

DeleteProductInput 方法的请求消息。

字段

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

name

string

必需。要删除的商品输入资源的名称。格式：accounts/{account}/productInputs/{product}

data_source

string

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

FreeShippingThreshold

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

字段

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

country

string

商品要运达的国家/地区的 CLDR 地区代码。

price_threshold

Price

使运费变为免费所需的最低商品价格。以数字表示。

GetProductRequest

GetProduct 方法的请求消息。

字段

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

name

string

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

InsertProductInputRequest

InsertProductInput 方法的请求消息。

字段

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

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` 的所有其他参数必须与提供页面令牌的调用匹配。

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` 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

products[]

Product

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

next_page_token

string

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

LoyaltyPoints

表示积分的消息。

字段

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

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` 购物时获得的积分数。

产品

已处理的商品，在应用规则和补充数据源后根据多项 [商品输入][[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` 商品详情的值。

section_name

string

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

attribute_name

string

商品详情的名称。

attribute_value

string

商品详情的值。

ProductDimension

产品的维度。

字段

字段
`value`	`double` 必需。以数字表示的维度值。值的最高精度可精确到小数点后四位。
`unit`	`string` 必需。维度单位。可接受的值为：“`in`”“`cm`”

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 个字符

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 个字符

digital_source_type

string

数字源类型，例如“trained_algorithmic_media”。已关注 IPTC。长度上限为 40 个字符。

content

string

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

ProductWeight

商品的重量。

字段

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

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` 值的单位。

value

double

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

unit

string

值的单位。

ShippingWeight

商品的 ShippingWeight。

字段

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

value

double

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

unit

string

值的单位。

SubscriptionCost

产品的 SubscriptionCost。

字段

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

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` 分母的单位。

value

int64

单价的分母。

unit

string

分母的单位。

UnitPricingMeasure

商品的 UnitPricingMeasure 。

字段

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

value

double

商品的计量单位。

unit

string

计量单位。