必须在 2026 年 6 月之前注册开发者，才能满足 CSS API 要求。为了提高 API 的稳定性和安全性，我们将为 CSS API 引入强制性的一次性注册。如果您在激活 Merchant API 时已为 Google Cloud 项目完成此注册，则无需重复执行这些步骤。您可以在我们的 Merchant API 开发者网站上找到更详细的说明，如果您需要更多帮助，可以联系我们的 API 支持团队。

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Package google.shopping.css.v1

索引

AccountLabelsService（界面）
AccountsService（界面）
CssProductInputsService（界面）
CssProductsService（界面）
QuotaService（界面）
Account（消息）
Account.AccountType（枚举）
AccountLabel（消息）
AccountLabel.LabelType（枚举）
Attributes（消息）
Certification（消息）
CreateAccountLabelRequest（消息）
CssProduct（消息）
CssProductInput（消息）
CssProductStatus（消息）
CssProductStatus.DestinationStatus（消息）
CssProductStatus.ItemLevelIssue（消息）
DeleteAccountLabelRequest（消息）
DeleteCssProductInputRequest（消息）
GetAccountRequest（消息）
GetCssProductRequest（消息）
HeadlineOfferInstallment（消息）
HeadlineOfferSubscriptionCost（消息）
InsertCssProductInputRequest（消息）
ListAccountLabelsRequest（消息）
ListAccountLabelsResponse（消息）
ListChildAccountsRequest（消息）
ListChildAccountsResponse（消息）
ListCssProductsRequest（消息）
ListCssProductsResponse（消息）
ListQuotaGroupsRequest（消息）
ListQuotaGroupsResponse（消息）
MethodDetails（消息）
ProductDetail（消息）
ProductDimension（消息）
ProductWeight（消息）
QuotaGroup（消息）
SubscriptionPeriod（枚举）
UpdateAccountLabelRequest（消息）
UpdateAccountLabelsRequest（消息）
UpdateCssProductInputRequest（消息）

AccountLabelsService

管理 Merchant Center 和 CSS 账号标签。

CreateAccountLabel

CreateAccountLabel
`rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)` 创建未分配给任何账号的新标签。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

创建未分配给任何账号的新标签。

授权范围

需要以下 OAuth 范围：

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

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

DeleteAccountLabel

DeleteAccountLabel
`rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)` 删除标签并将其从分配到的所有账号中移除。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

删除标签并将其从分配到的所有账号中移除。

授权范围

需要以下 OAuth 范围：

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

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

ListAccountLabels

ListAccountLabels
`rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)` 列出账号拥有的标签。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

列出账号拥有的标签。

授权范围

需要以下 OAuth 范围：

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

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

UpdateAccountLabel

UpdateAccountLabel
`rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)` 更新标签。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

更新标签。

授权范围

需要以下 OAuth 范围：

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

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

AccountsService

用于管理 CSS/MC 账号信息的服务。

GetAccount

GetAccount
`rpc GetAccount(GetAccountRequest) returns (Account)` 根据 ID 检索单个 CSS/MC 账号。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc GetAccount(GetAccountRequest) returns (Account)

根据 ID 检索单个 CSS/MC 账号。

授权范围

需要以下 OAuth 范围：

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

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

ListChildAccounts

ListChildAccounts
`rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)` 列出指定 CSS 账号 ID 下的所有账号，并可选择按标签 ID 和账号名称进行过滤。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

列出指定 CSS 账号 ID 下的所有账号，并可选择按标签 ID 和账号名称进行过滤。

授权范围

需要以下 OAuth 范围：

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

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

UpdateLabels

UpdateLabels
`rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)` 更新由 CSS 网域分配给 CSS/MC 账号的标签。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

更新由 CSS 网域分配给 CSS/MC 账号的标签。

授权范围

需要以下 OAuth 范围：

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

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

CssProductInputsService

用于使用 CssProductInput 资源的服务。此服务有助于插入/更新/删除 CSS 商品。

DeleteCssProductInput

DeleteCssProductInput
`rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)` 从您的 CSS Center 账号中删除 CSS 商品输入。删除后，可能需要过几分钟，输入源才会不再可用。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

从您的 CSS Center 账号中删除 CSS 商品输入。

删除后，可能需要过几分钟，输入源才会不再可用。

授权范围

需要以下 OAuth 范围：

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

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

InsertCssProductInput

InsertCssProductInput
`rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)` 将 CssProductInput 上传到您的 CSS Center 账号。如果已存在具有相同 contentLanguage、identity、feedLabel 和 feedId 的输入，此方法会替换该条目。插入、更新或删除 CSS 商品输入后，可能需要等待几分钟才能检索到处理后的 CSS 商品。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

将 CssProductInput 上传到您的 CSS Center 账号。如果已存在具有相同 contentLanguage、identity、feedLabel 和 feedId 的输入，此方法会替换该条目。

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

授权范围

需要以下 OAuth 范围：

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

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

UpdateCssProductInput

UpdateCssProductInput
`rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)` 更新 CSS Center 账号中现有的 CSS 商品输入。插入、更新或删除 CSS 商品输入后，可能需要几分钟时间才能检索到处理后的 CSS 商品。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

更新 CSS Center 账号中现有的 CSS 商品输入。

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

授权范围

需要以下 OAuth 范围：

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

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

CssProductsService

用于对 CSS 商品（内部称为“汇总商品”）执行获取和列出操作的服务。

GetCssProduct

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

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

从您的 CSS Center 账号检索已处理的 CSS 商品。插入、更新或删除商品输入后，可能需要几分钟时间才能检索到更新后的最终商品。

授权范围

需要以下 OAuth 范围：

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

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

ListCssProducts

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

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

列出 CSS Center 账号中已处理的 CSS 商品。响应中包含的商品数量可能少于 pageSize 指定的数量。依靠 pageToken 来确定是否还有更多项目要请求。

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

授权范围

需要以下 OAuth 范围：

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

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

QuotaService

用于获取每个 CSS API 方法的方法调用配额信息的服务。

ListQuotaGroups

ListQuotaGroups
`rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)` 列出 CSS Center 账号的每日调用配额和每个群组的用量。授权范围需要以下 OAuth 范围： `https://www.googleapis.com/auth/content` 如需了解详情，请参阅 OAuth 2.0 Overview。

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

列出 CSS Center 账号的每日调用配额和每个群组的用量。

授权范围

需要以下 OAuth 范围：

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

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

账号

有关 CSS/MC 账号的信息。

字段
`name`	`string` 标签资源名称。格式：accounts/{account}
`full_name`	`string` 仅限输出。不可变。CSS/MC 账号的全名。
`label_ids[]`	`int64` 由 CSS 父级账号分配给 CSS/MC 账号的手动创建的标签 ID。
`automatic_label_ids[]`	`int64` 由 CSS Center 自动创建并分配给 MC 账号的标签 ID。
`account_type`	`AccountType` 仅限输出。相应账号的类型。
`display_name`	`string` CSS/MC 账号的简短显示名称。
`homepage_uri`	`string` 仅限输出。不可变。CSS/MC 账号的首页。
`parent`	`string` CSS/MC 账号的父资源。CSS 网域的 CSS 组；MCA 账号的 CSS 网域。仅当用户有权访问父账号时才会返回。注意：对于 MCA 子账号，这也是 MCA 账号的父级资源 CSS 网域，因为我们实际上是在扁平化层次结构。”

AccountType

账号类型。

枚举
`ACCOUNT_TYPE_UNSPECIFIED`	未知账号类型。
`CSS_GROUP`	CSS 组账号。
`CSS_DOMAIN`	CSS 网域账号。
`MC_PRIMARY_CSS_MCA`	MC 主要 CSS MCA 账号。
`MC_CSS_MCA`	MC CSS MCA 账号。
`MC_MARKETPLACE_MCA`	MC 购物平台 MCA 账号。
`MC_OTHER_MCA`	MC 其他 MCA 账号。
`MC_STANDALONE`	MC 独立账号。
`MC_MCA_SUBACCOUNT`	MC MCA 子账号。

AccountLabel

由 CSS 网域或 CSS 组分配给其子账号的标签。

字段
`name`	`string` 标识符。标签的资源名称。格式：accounts/{account}/labels/{label}
`label_id`	`int64` 仅限输出。标签的 ID。
`account_id`	`int64` 仅限输出。相应标签所属的账号的 ID。
`label_type`	`LabelType` 仅限输出。相应标签的类型。
`display_name`	`string` 相应标签的显示名称。
`description`	`string` 相应标签的说明。

LabelType

标签类型。

枚举
`LABEL_TYPE_UNSPECIFIED`	标签类型未知。
`MANUAL`	表示标签是手动创建的。
`AUTOMATIC`	表示相应标签是由 CSS Center 自动创建的。

属性

CSS 商品的属性。

字段
`low_price`	`Price` CSS 商品的低价。
`high_price`	`Price` CSS 商品的较高价格。
`headline_offer_price`	`Price` CSS 商品的主推价格。
`headline_offer_shipping_price`	`Price` CSS 商品的主推价格。
`additional_image_links[]`	`string` 商品图片的其他网址。
`product_types[]`	`string` 商品的类别（格式如商品数据规范中所述）。
`size_types[]`	`string` 商品的剪裁。可用于表示服装商品的组合尺寸类型。最多可以提供两种尺码类型（请参阅尺码类型）。
`product_details[]`	`ProductDetail` 技术规范或其他商品详情。
`product_weight`	`ProductWeight` 相应单位下的产品重量。该值必须介于 0（不含）到 2000（含）之间。
`product_length`	`ProductDimension` 商品的长度（以提供的单位为准）。该值必须介于 0（不含）到 3000（含）之间。
`product_width`	`ProductDimension` 商品的宽度（以提供的单位为准）。该值必须介于 0（不含）到 3000（含）之间。
`product_height`	`ProductDimension` 商品的高度（以提供的单位为准）。该值必须介于 0（不含）到 3000（含）之间。
`product_highlights[]`	`string` 描述商品最相关亮点的项目符号。
`certifications[]`	`Certification` CSS 为指定商品声明的证书列表。
`expiration_date`	`Timestamp` 商品过期的日期，在插入时指定，采用 ISO 8601 格式。实际失效日期在 `productstatuses` 中以 googleExpirationDate 的形式公开，如果 `expirationDate` 离现在太远，实际失效日期可能会更早。注意：商品可能需要 2 天或更长时间才能在失效日期过后实际删除。
`included_destinations[]`	`string` 为此定位目标添加的平台列表（对应于 Merchant Center 中选中的复选框）。除非在 `excludedDestinations` 中加入了默认平台，否则将始终为定位目标添加默认平台。
`excluded_destinations[]`	`string` 为此定位目标排除的平台列表（对应于 Merchant Center 中未选中的复选框）。
`headline_offer_installment`	`HeadlineOfferInstallment` 商品的付款期数和金额。
`headline_offer_subscription_cost`	`HeadlineOfferSubscriptionCost` 与订阅合同相关联的商品的周期数（月数或年数）和每个周期的付款金额。
`cpp_link`	`string` 直接链接到 CSS 商品详情页面的网址。
`cpp_mobile_link`	`string` CSS 的商品详情页面的针对移动设备进行了优化版本网址。
`cpp_ads_redirect`	`string` 允许广告客户在商品广告的上下文中展示商品时替换商品网址。
`number_of_offers`	`int64` CSS 商品的数量。
`headline_offer_condition`	`string` 主推优惠的商品使用情况。
`headline_offer_link`	`string` 指向主推优惠的链接。
`headline_offer_mobile_link`	`string` 指向主推优惠的移动版链接。
`title`	`string` 商品名。
`image_link`	`string` 商品图片的网址。
`description`	`string` 商品的说明。
`brand`	`string` 与商品相关的属性。[14-36] 商品的品牌。
`mpn`	`string` 商品的制造商部件号 (MPN)。
`gtin`	`string` 商品的全球贸易项目代码 (GTIN)。
`google_product_category`	`string` 商品的 Google 类别（请参阅 Google 商品类目）。查询商品时，此字段将包含用户提供的值。目前，无法通过 API 恢复自动分配的 Google 商品类别。
`adult`	`bool` 如果商品的定位为成人商品，则设置为 true。
`multipack`	`int64` 商家定义的多件组合装中相同商品的数量。
`is_bundle`	`bool` 商品是否为商家定义的套装。套装是商家以单一价格销售的不同商品的自定义组合。
`age_group`	`string` 商品的目标年龄段。
`color`	`string` 商品的颜色。
`gender`	`string` 商品的适用性别。
`material`	`string` 商品的材质。
`pattern`	`string` 商品的图案（例如圆点花纹）。
`size`	`string` 商品尺寸。只能设置一个值。对于不同尺寸的款式，请为每种尺寸插入单独的商品，并使用相同的 `itemGroupId` 值（请参阅 [https://support.google.com/merchants/answer/6324492](尺寸定义)）。
`size_system`	`string` 指定尺码所用的体系。建议为服饰商品提供。
`item_group_id`	`string` 同一商品所有款式的共用标识符。
`pause`	`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，用于自定义购物广告系列中的商品分组。
`review_count`	`int64` 商品的评价数量。如果提供了 `rating`，则必须提供此值。此字段用于即将推出的功能，目前尚未使用。
`min_rating`	`int64` 商品的最低评分。如果提供了 `rating`，则必须提供此值。此字段用于即将推出的功能，目前尚未使用。
`max_rating`	`int64` 商品的最高评分。如果提供了 `rating`，则必须提供此值。此字段用于即将推出的功能，目前尚未使用。
`rating`	`double` 商品的平均评分。值必须在 [`min_rating`, `max_rating`] 范围内（含边界值）。当显示在商品页面上时，此评分会归一化为 [1, 5] 范围内的值，并保留一位小数。如果提供，则还必须提供 `review_count`、`min_rating` 和 `max_rating`。此字段用于即将推出的功能，目前尚未使用。

认证

商品的认证。您可以使用此属性来描述与商品相关的认证，例如能效等级。

字段

字段
`name`	`string` 认证的名称。目前，最常见的值是“EPREL”，表示欧盟的欧洲产品能效标签注册中心 (EPREL) 数据库中的能效认证。
`authority`	`string` 负责颁发认证的权威机构或认证机构。目前，最常见的值是“EC”或“European_Commission”，表示欧盟的能效标识。
`code`	`string` 认证代码。例如，如果 EPREL 认证的链接为 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456，则代码为 123456。对于欧洲能效标识，必须提供此代码。

name

string

认证的名称。目前，最常见的值是“EPREL”，表示欧盟的欧洲产品能效标签注册中心 (EPREL) 数据库中的能效认证。

authority

string

负责颁发认证的权威机构或认证机构。目前，最常见的值是“EC”或“European_Commission”，表示欧盟的能效标识。

code

string

认证代码。例如，如果 EPREL 认证的链接为 https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456，则代码为 123456。对于欧洲能效标识，必须提供此代码。

CreateAccountLabelRequest

针对“CreateAccountLanel”方法的请求消息。

字段

字段
`parent`	`string` 必需。父级账号。格式：accounts/{account}
`account_label`	`AccountLabel` 必需。要创建的标签。

parent

string

必需。父级账号。格式：accounts/{account}

account_label

AccountLabel

必需。要创建的标签。

CssProduct

处理后的 CSS 商品。

字段
`name`	`string` CSS 商品的名称。格式：`"accounts/{account}/cssProducts/{css_product}"`
`raw_provided_id`	`string` 仅限输出。商品的唯一原始标识符。
`content_language`	`string` 仅限输出。商品的双字母 ISO 639-1 语言代码。
`feed_label`	`string` 仅限输出。商品的 Feed 标签。
`attributes`	`Attributes` 仅限输出。商品属性列表。
`custom_attributes[]`	`CustomAttribute` 仅限输出。自定义（由 CSS 提供）属性的列表。它还可用于以通用形式（例如 `{ "name": "size type", "value": "regular" }`）提交 Feed 规范的任何属性。这对于提交 API 未明确公开的属性（例如用于 Google 易购的其他属性）非常有用。
`css_product_status`	`CssProductStatus` 仅限输出。商品的状态、数据验证问题，即异步计算的商品相关信息。

CssProductInput

此资源表示您为 CSS 商品提交的输入数据，而不是您在 CSS Center、购物广告或 Google 平台呈现中看到的已处理的 CSS 商品。

字段
`name`	`string` 标识符。CSS 商品输入源的名称。格式：`accounts/{account}/cssProductInputs/{css_product_input}`，其中最后一部分 `css_product_input` 由 3 部分组成：contentLanguage~feedLabel~offerId。示例：accounts/123/cssProductInputs/de~DE~rawProvidedId123
`final_name`	`string` 仅限输出。已处理的 CSS 商品的名称。格式：`accounts/{account}/cssProducts/{css_product}` "
`raw_provided_id`	`string` 必需。CSS 商品的唯一标识符。CSS 商品输入和处理后的 CSS 商品也是如此。我们仅允许使用包含字母数字、下划线和短划线的 ID。如需了解详情，请参阅商品 Feed 规范。
`content_language`	`string` 必需。CSS 商品的双字母 ISO 639-1 语言代码。
`feed_label`	`string` 必需。CSS 商品的Feed 标签。Feed 标签与“目标国家/地区”同义，因此应始终为有效的区域代码。例如：'DE' 表示德国，'FR' 表示法国。
`freshness_time (deprecated)`	`Timestamp` 此项已弃用！已弃用。请改用 expiration_date。表示 CSS 商品的现有版本（新鲜度），可用于在同时进行多次更新时保持正确的顺序。此字段不得设置为未来的时间。如果设置了此属性，则当我们的系统中已存在较新版本的商品时，系统会阻止更新（即现有 CSS 产品的上次更新时间晚于更新中设置的新鲜度时间）。如果发生更新，则将上次更新时间设置为此新鲜度时间。如果未设置，则不会阻止更新，并且上次更新时间将默认为 CSS API 收到此请求的时间。如果操作被阻止，系统会抛出中止异常。
`attributes`	`Attributes` CSS 商品属性列表。
`custom_attributes[]`	`CustomAttribute` 自定义（由 CSS 提供）属性的列表。它还可用于以通用形式提交 Feed 规范的任何属性（例如：`{ "name": "size type", "value": "regular" }`）。这对于提交 API 未明确公开的属性（例如用于“Google 易购”的其他属性）非常有用。

CssProductStatus

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

字段
`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

商品状态的目标平台状态。

字段
`destination`	`string` 目的地的名称
`approved_countries[]`	`string` CSS 商品获得批准的国家/地区代码（ISO 3166-1 alpha-2）。
`pending_countries[]`	`string` CSS 商品正在等待审批的国家/地区代码（ISO 3166-1 alpha-2）。
`disapproved_countries[]`	`string` CSS 商品未获批准的国家/地区代码 (ISO 3166-1 alpha-2) 列表。

ItemLevelIssue

商品状态的 ItemLevelIssue。

字段
`code`	`string` 问题的错误代码。
`servability`	`string` 此问题对 CSS 商品的展示有何影响。
`resolution`	`string` 商家是否可以解决此问题。
`attribute`	`string` 属性的名称（如果此问题是由单个属性引发的）。
`destination`	`string` 问题适用的目标平台。
`description`	`string` 以英文编写的简短问题说明。
`detail`	`string` 以英文编写的详细问题说明。
`documentation`	`string` 有助于解决此问题的网页的网址。
`applicable_countries[]`	`string` 问题所适用的 CSS 商品的国家/地区代码（ISO 3166-1 alpha-2）列表。

DeleteAccountLabelRequest

针对“DeleteAccountLabel”方法的请求消息。

字段

字段
`name`	`string` 必需。要删除的标签的名称。格式：accounts/{account}/labels/{label}

name

string

必需。要删除的标签的名称。格式：accounts/{account}/labels/{label}

DeleteCssProductInputRequest

针对 DeleteCssProductInput 方法的请求消息。

字段

字段
`name`	`string` 必需。要删除的 CSS 商品输入资源的名称。格式：accounts/{account}/cssProductInputs/{css_product_input}，其中最后一部分 `css_product_input` 由 3 部分组成：contentLanguage~feedLabel~offerId。示例：accounts/123/cssProductInputs/de~DE~rawProvidedId123
`supplemental_feed_id`	`int64` Content API 补充 Feed ID。如果操作应用于主要 Feed，则不得设置此字段。如果设置了该字段，则商品操作会应用于补充 Feed，而不是主要 Content API Feed。

name

string

必需。要删除的 CSS 商品输入资源的名称。格式：accounts/{account}/cssProductInputs/{css_product_input}，其中最后一部分 css_product_input 由 3 部分组成：contentLanguage~feedLabel~offerId。示例：accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

Content API 补充 Feed ID。如果操作应用于主要 Feed，则不得设置此字段。如果设置了该字段，则商品操作会应用于补充 Feed，而不是主要 Content API Feed。

GetAccountRequest

GetAccount 方法的请求消息。

字段

字段
`name`	`string` 必需。受管理的 CSS/MC 账号的名称。格式：accounts/{account}
`parent`	`string` 可选。仅在检索 MC 账号信息时需要。作为 MC 账号的父级资源的 CSS 网域。格式：accounts/{account}

name

string

必需。受管理的 CSS/MC 账号的名称。格式：accounts/{account}

parent

string

可选。仅在检索 MC 账号信息时需要。作为 MC 账号的父级资源的 CSS 网域。格式：accounts/{account}

GetCssProductRequest

GetCssProduct 方法的请求消息。

字段

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

name

string

必需。要检索的 CSS 商品的名称。格式：accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

表示分期付款的消息。

字段

字段
`months`	`int64` 买家需要支付的分期付款期数。
`amount`	`Price` 买家每月需要支付的金额。
`downpayment`	`Price` 买家需要预付的首付款金额。

months

int64

买家需要支付的分期付款期数。

amount

Price

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

downpayment

Price

买家需要预付的首付款金额。

HeadlineOfferSubscriptionCost

商品的 SubscriptionCost。

字段

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

period

SubscriptionPeriod

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

period_length

int64

买家需要支付的订阅期数。

amount

Price

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

InsertCssProductInputRequest

针对 InsertCssProductInput 方法的请求消息。

字段

字段
`parent`	`string` 必需。要插入相应 CSS 商品的账号。格式：accounts/{account}
`css_product_input`	`CssProductInput` 必需。要插入的 CSS 商品输入。
`feed_id (deprecated)`	`int64` 此项已弃用！可选。已弃用。CSS 商品不需要 Feed ID。主要 Feed 或补充 Feed 的 ID。如果 CSS 商品已存在，但提供的 Feed ID 不同，则 CSS 商品将移至新的 Feed。注意：目前，CSS 无需提供 Feed ID，因为我们会动态创建 Feed。我们尚不支持 CSS 商品的补充 Feed。

parent

string

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

css_product_input

CssProductInput

必需。要插入的 CSS 商品输入。

feed_id
(deprecated)

int64

可选。已弃用。CSS 商品不需要 Feed ID。主要 Feed 或补充 Feed 的 ID。如果 CSS 商品已存在，但提供的 Feed ID 不同，则 CSS 商品将移至新的 Feed。注意：目前，CSS 无需提供 Feed ID，因为我们会动态创建 Feed。我们尚不支持 CSS 商品的补充 Feed。

ListAccountLabelsRequest

对 ListAccountLabels 方法的请求消息。

字段

字段
`parent`	`string` 必需。父级账号。格式：accounts/{account}
`page_size`	`int32` 要返回的标签数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个标签。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。
`page_token`	`string` 从之前的 `ListAccountLabels` 调用接收的页面令牌。利用其进行后续页面检索。进行分页时，提供给 `ListAccountLabels` 的所有其他参数必须与提供页面令牌的调用匹配。

parent

string

必需。父级账号。格式：accounts/{account}

page_size

int32

要返回的标签数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个标签。最大值为 1,000；大于 1,000 的值将被强制转换为 1,000。

page_token

string

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

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

ListAccountLabelsResponse

ListAccountLabels 方法的响应消息。

字段

字段
`account_labels[]`	`AccountLabel` 指定账号中的标签。
`next_page_token`	`string` 可作为 `page_token` 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

account_labels[]

AccountLabel

指定账号中的标签。

next_page_token

string

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

ListChildAccountsRequest

ListChildAccounts 方法的请求消息。

字段
`parent`	`string` 必需。父级账号。必须是 CSS 组或网域。格式：accounts/{account}
`page_size`	`int32` 可选。要返回的账号数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 50 个账号。最大值为 100；大于 100 的值将被强制转换为 100。
`page_token`	`string` 可选。从之前的 `ListChildAccounts` 调用接收的页面令牌。利用其进行后续页面检索。进行分页时，提供给 `ListChildAccounts` 的所有其他参数必须与提供页面令牌的调用匹配。
`label_id`	`int64` 如果设置，则仅返回具有指定标签 ID 的 MC 账号。
`full_name`	`string` 如果设置，则仅返回具有指定名称（区分大小写）的 MC 账号。

ListChildAccountsResponse

ListChildAccounts 方法的响应消息。

字段

字段
`accounts[]`	`Account` 为指定 CSS 父级账号返回的 CSS/Merchant Center 账号。
`next_page_token`	`string` 可作为 `page_token` 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

accounts[]

Account

为指定 CSS 父级账号返回的 CSS/Merchant Center 账号。

next_page_token

string

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

ListCssProductsRequest

针对 ListCssProducts 方法的请求消息。

字段

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

parent

string

必需。用于列出已处理的 CSS 商品的账号/网域。格式：accounts/{account}

page_size

int32

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

page_token

string

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

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

ListCssProductsResponse

针对 ListCssProducts 方法的响应消息。

字段

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

css_products[]

CssProduct

指定账号中已处理的 CSS 商品。这些是应用规则和补充 Feed 后处理的 CSS 商品。

next_page_token

string

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

ListQuotaGroupsRequest

针对 ListQuotaGroups 方法的请求消息。

字段

字段
`parent`	`string` 必需。拥有方法配额和资源集合的 CSS 账号。在大多数情况下，这是 CSS 网域。格式：accounts/{account}
`page_size`	`int32` 可选。响应中要返回的配额数量上限，用于分页。默认值为 500；大于 1,000 的值会强制转换为 1,000。
`page_token`	`string` 可选。用于检索后续页面的令牌（如果提供）。所有其他参数必须与提供页面令牌的原始调用相一致。

parent

string

必需。拥有方法配额和资源集合的 CSS 账号。在大多数情况下，这是 CSS 网域。格式：accounts/{account}

page_size

int32

可选。响应中要返回的配额数量上限，用于分页。默认值为 500；大于 1,000 的值会强制转换为 1,000。

page_token

string

可选。用于检索后续页面的令牌（如果提供）。所有其他参数必须与提供页面令牌的原始调用相一致。

ListQuotaGroupsResponse

ListMethodGroups 方法的响应消息。

字段

字段
`quota_groups[]`	`QuotaGroup` 方法、每个群组的当前配额用量和限制。配额在组中的所有方法之间共享。各组按 `quota_usage` 降序排序。
`next_page_token`	`string` 可作为 `page_token` 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。

quota_groups[]

QuotaGroup

方法、每个群组的当前配额用量和限制。配额在组中的所有方法之间共享。各组按 quota_usage 降序排序。

next_page_token

string

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

MethodDetails

CSS API 中每个方法的详细信息。

字段
`method`	`string` 仅限输出。方法的名称，例如 `cssproductsservice.listcssproducts`。
`version`	`string` 仅限输出。相应方法所属的 API 版本。
`subapi`	`string` 仅限输出。方法所属的子 API。在 CSS API 中，此值始终为 `css`。
`path`	`string` 仅限输出。方法的路径，例如 `v1/cssproductsservice.listcssproducts`。

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”

ProductWeight

商品的重量。

字段

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

value

double

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

unit

string

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

QuotaGroup

CSS API 中方法的组信息。配额在组中的所有方法之间共享。即使群组中没有任何方法有使用情况，系统也会返回该群组的使用情况信息。

字段
`name`	`string` 标识符。配额组的资源名称。格式：accounts/{account}/配额/{group} 示例：`accounts/12345678/quotas/css-products-insert` 注意：{group} 部分不一定遵循特定模式。
`quota_usage`	`int64` 仅限输出。当前配额用量，即在给定日期已对相应组中的方法进行的调用次数。每日配额限额会在世界协调时间 (UTC) 中午 12:00 重置。
`quota_limit`	`int64` 仅限输出。相应群组每天允许的通话次数上限。
`quota_minute_limit`	`int64` 仅限输出。相应群组每分钟允许的调用次数上限。
`method_details[]`	`MethodDetails` 仅限输出。方法组配额适用的所有方法的列表。

SubscriptionPeriod

商品的订阅周期。

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

UpdateAccountLabelRequest

对 UpdateAccountLabel 方法的请求消息。

字段

字段
`account_label`	`AccountLabel` 必需。更新后的标签。必须提供所有字段。

account_label

AccountLabel

必需。更新后的标签。必须提供所有字段。

UpdateAccountLabelsRequest

UpdateLabels 方法的请求消息。

字段

字段
`name`	`string` 必需。标签资源名称。格式：accounts/{account}
`label_ids[]`	`int64` 用于覆盖现有账号标签 ID 的标签 ID 列表。如果列表为空，则系统会删除所有当前分配的标签 ID。
`parent`	`string` 可选。仅在更新 MC 账号标签时需要。作为 MC 账号的父级资源的 CSS 网域。格式：accounts/{account}

name

string

必需。标签资源名称。格式：accounts/{account}

label_ids[]

int64

用于覆盖现有账号标签 ID 的标签 ID 列表。如果列表为空，则系统会删除所有当前分配的标签 ID。

parent

string

可选。仅在更新 MC 账号标签时需要。作为 MC 账号的父级资源的 CSS 网域。格式：accounts/{account}

UpdateCssProductInputRequest

针对 UpdateCssProductInput 方法的请求消息。

字段

字段
`css_product_input`	`CssProductInput` 必需。要更新的 CSS 商品输入资源。您提交的信息也会应用于处理后的 CSS 商品。
`update_mask`	`FieldMask` 要更新的 CSS 商品属性的列表。如果省略更新掩码，则将其视为隐含的字段掩码，相当于所有已填充（具有非空值）的字段。如果更新掩码中指定的属性在正文中未指定值，则会从 CSS 商品中删除。只能为属性和自定义属性中的顶级字段指定更新掩码。如需为自定义属性指定更新掩码，您需要添加 `custom_attribute.` 前缀。不支持为完全替换 CSS 产品提供特殊值“*”。

css_product_input

CssProductInput

必需。要更新的 CSS 商品输入资源。您提交的信息也会应用于处理后的 CSS 商品。

update_mask

FieldMask

要更新的 CSS 商品属性的列表。

如果省略更新掩码，则将其视为隐含的字段掩码，相当于所有已填充（具有非空值）的字段。

如果更新掩码中指定的属性在正文中未指定值，则会从 CSS 商品中删除。

只能为属性和自定义属性中的顶级字段指定更新掩码。

如需为自定义属性指定更新掩码，您需要添加 custom_attribute. 前缀。

不支持为完全替换 CSS 产品提供特殊值“*”。

Package google.shopping.css.v1 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

索引

AccountLabelsService

AccountsService

CssProductInputsService

CssProductsService

QuotaService

账号

AccountType

AccountLabel

LabelType

属性

认证

CreateAccountLabelRequest

CssProduct

CssProductInput

CssProductStatus

DestinationStatus

ItemLevelIssue

DeleteAccountLabelRequest

DeleteCssProductInputRequest

GetAccountRequest

GetCssProductRequest

HeadlineOfferInstallment

HeadlineOfferSubscriptionCost

InsertCssProductInputRequest

ListAccountLabelsRequest

ListAccountLabelsResponse

ListChildAccountsRequest

ListChildAccountsResponse

ListCssProductsRequest

ListCssProductsResponse

ListQuotaGroupsRequest

ListQuotaGroupsResponse

MethodDetails

ProductDetail

ProductDimension

ProductWeight

QuotaGroup

SubscriptionPeriod

UpdateAccountLabelRequest

UpdateAccountLabelsRequest

UpdateCssProductInputRequest

Package google.shopping.css.v1