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 提供了以下端点:

accounts 端点作为 CSS 网域调用时,请注意以下要求:

  • 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 方法,并在请求中传递标签查询参数,以便仅返回具有该标签的帐号。以下示例演示了如何使用在创建标签示例中创建的密钥帐号标签的 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’
}