Package google.shopping.merchant.products.v1beta

索引

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 概览

属性

属性。

字段
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)。此列表中的国家/地区会从数据源设置中配置的国家/地区中移除。

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

商品的说明。

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_value

double

为动态再营销广告系列提供利润数据。

pickup_method

string

商品的自提选项。

pickup_sla

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

此项目的发布将暂停

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

计量单位。