在支持 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 网域相关联。如需详细了解不同类型的商家中心账号,请参阅 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 网域应用标签。
以 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 账号分配标签。以下示例展示了如何将在上一个示例中创建的关键账号标签应用于您最重要的一个 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
方法创建的关键网域组级标签应用于您最重要的 CSS 网域账号之一。请注意,CSS 网域和 Merchant Center 账号的标签是相互独立的。必须使用 CSS 组 ID 作为其 accountId
来创建组级标签。
如需应用标签,请使用以下网址和请求正文发出 POST
请求:
https://shoppingcontent.googleapis.com/content/v2.1/cssGroupId/csses/cssDomainId/updatelabels/
{
"labelIds": [‘456’] // ‘key-domains’
}