CSS 标签管理

在支持 CSS 计划的国家/地区，购物比较服务 (CSS) 可以代表商家在 Google 上投放购物广告。Content API 允许 CSS 网域和 CSS 组使用标签整理其关联的账号。CSS 网域可以列出、标记和过滤与该网域相关联的 Merchant Center 账号。CSS 组可以标记并列出与该组关联的 CSS 网域。这些 Content API 服务以程序化方式提供 Comparison Shopping Service Center 中的部分功能。

如需详细了解 CSS，请参阅购物比较服务。 如需了解如何在 CSS Center 中使用标签，请参阅在 Comparison Shopping Service Center 中使用账号标签。

CSS 账号类型

CSS 使用以下三种类型的账号：

  • CSS 组是顶级账号，可以包含一个或多个 CSS 网域。
  • CSS 网域是 CSS 本身的账号，用于代表商家投放购物广告。每个 CSS 网域只能属于一个 CSS 组。
  • Merchant Center 账号是指 CSS 网域为其投放购物广告的商家。CSS 可以与多种不同类型的 Merchant Center 账号相关联，包括多客户账号 (MCA) 和各个商家账号。每个 Merchant Center 账号只能与一个 CSS 网域相关联。如需详细了解不同类型的 Merchant Center 账号，请参阅 Comparison Shopping Service Center 中的账号类型。

CSS 标签类型

CSS 使用两种类型的标签：

  • 人工标签由 CSS 网域创建并分配给 Merchant Center 账号，由 CSS 组创建并分配给 CSS 网域。
  • 自动标签由 CSS Center 自动创建并分配给 Merchant Center 账号。自动标签适用于不同类型的账号指标，可帮助您识别重要账号和重大账号活动。

如需详细了解标签类型（包括可用的自动标签），请参阅在 Comparison Shopping Service Center 中使用账号标签。

CSS 的 Content API 功能和端点

Content API 为 CSS 提供以下端点：

以 CSS 网域身份调用 accounts 端点时，请注意以下要求：

  • CSS 网域必须提供 cssId，而不是 merchantId。
  • CSS 网域必须提供 view=CSS 查询参数。
  • CSS 网域必须提供其关联的 Merchant Center 账号 ID 作为 accountId。

示例：创建标签

您可以使用 accounts.labels.create 方法创建新标签。标签可应用于 CSS 网域和 Merchant Center 账号。不过，不同账号类型的标签是分开的，不能互换使用。如需创建网域级标签（可应用于与网域相关联的 Merchant Center 账号），请在创建标签时使用 CSS 网域 ID 作为 accountId。如需创建可应用于与群组相关联的 CSS 网域的群组级标签，请在创建标签时使用 CSS 群组 ID 作为 accountId。

以下示例演示了如何创建网域级“重要客户”标签，然后将其应用于与该网域相关联的 Merchant Center 账号。如需创建标签，请使用以下网址和请求正文发出 POST 请求：

https://shoppingcontent.googleapis.com/content/v2.1/accounts/accountId/labels

{
 "name": "key-accounts",
 "description": "All accounts with over a million products"
}

示例：为 Merchant Center 账号应用标签

您可以使用 accounts.updatelabels 方法为与 CSS 网域相关联的 Merchant Center 账号分配标签。以下示例展示了如何将上一个示例中创建的 key-accounts 标签应用于您最重要的 Merchant Center 账号之一。

如需应用标签，请使用以下网址和请求正文发出 POST 请求：

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/

{
 "labelIds": [‘123’] // ‘key-accounts’
}

示例：使用标签过滤 Merchant Center 账号

为与 CSS 网域相关联的 Merchant Center 账号创建标签并应用标签后，您可以使用 accounts.list 方法，并在请求中传递标签查询参数，以仅返回具有该标签的账号。以下示例演示了如何使用创建标签示例中创建的 key-accounts 标签的 id (123) 过滤与 CSS 网域相关联的 Merchant Center 账号。如需检索账号，请使用以下网址发出 GET 请求：

https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123

无需请求正文。

示例：向 CSS 网域应用标签

您还可以使用 csses.updatelabels 方法为与 CSS 组相关联的 CSS 网域分配标签。以下示例演示了如何将使用 accounts.labels.create 方法创建的 key-domains 群组级标签应用于最重要的 CSS 网域账号之一。请注意，CSS 网域和 Merchant Center 账号的标签是分开的。必须使用 CSS 组 ID 作为其 accountId 来创建组级标签。

如需应用标签，请使用以下网址和请求正文发出 POST 请求：

https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/

{
 "labelIds": [‘456’] // ‘key-domains’
}