在支持 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.labels
:可让您创建、检索和修改要应用于 CSS 网域和 Merchant Center 帐号的标签。如需查看示例,请参阅创建标签。accounts.updatelabels
:可让您将标签应用于单个 Merchant Center 帐号。如需查看示例,请参阅将标签应用于 Merchant Center 帐号。accounts.list
:可让您检索与 CSS 网域关联的所有 Merchant Center 帐号,包括应用于每个帐号的标签。您还可以按标签id
进行过滤,以获取关联帐号的子集。如需查看示例,请参阅使用标签过滤 Merchant Center 帐号。accounts.get
:可让您检索应用于单个 Merchant Center 帐号的标签。csses
:可让您查看和管理标签与 CSS 网域之间的关联。如需查看示例,请参阅将标签应用于 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’
}