购物比较服务 (CSS) 可以代表在 Google 上投放购物广告 在支持 CSS 计划的国家/地区的商家。Content API CSS 网域和 CSS 组可以使用 标签。CSS 网域可以列出、过滤 Merchant Center 账号和为其添加标签 与网域相关联CSS 组可以标记和列出 CSS 网域 和群组相关联。这些 Content API 服务 相当于购物比较工具 服务中心。
如需详细了解 CSS,请参阅 购物比较服务。 如需了解如何在 CSS Center 中使用标签,请参阅 在 Comparison Shopping Service Center 中使用账号标签。
CSS 账号类型
CSS 提供商使用以下三种类型的账号:
- CSS 组是可包含一个或多个 CSS 的顶级账号 网域。
- CSS 网域是 CSS 本身的账号,用于将 Google 购物 代表商家投放广告。每个 CSS 网域只能属于一个 CSS 组。
- Merchant Center 账号是 CSS 网域所放置的商家 购物广告。CSS 可以与多种不同类型的商家相关联, 中心账号,包括多客户账号 (MCA) 和个人商家账号 账号。每个 Merchant Center 账号只能与一家 CSS 提供商相关联 网域。如需详细了解不同类型的 Merchant Center 账号, 请参阅 Comparison Shopping Service Center 中的账号类型。
CSS 标签类型
CSS 使用两种类型的标签:
- 人工标签由 CSS 创建并分配给 Merchant Center 账号 CSS 网域,而 CSS 组按 CSS 网域配置 CSS 网域。
- 自动创建自动标签并将其分配给 Merchant Center 与 CSS Center 关联的账号。自动标签适用于不同类型的 有助于您识别重要账号和重要的 账号活动。
如需详细了解标签类型,包括 标签, 请参阅 在 Comparison Shopping Service Center 中使用账号标签。
适用于 CSS 的 Content API 功能和端点
Content API 为 CSS 提供了以下端点:
accounts.labels
:允许 您可以创建、检索和修改要应用于 CSS 网域和商家的标签 中心账号。如需查看示例,请参阅创建标签。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 网域相关联的中心账号。以下示例演示了
如何将上一个示例中创建的 key-accounts 标签应用于
对您最重要的 Merchant Center 账号而言
如需应用标签,请使用以下网址发出 POST
请求
正文:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts/subaccountId/updatelabels/
{
"labelIds": [‘123’] // ‘key-accounts’
}
示例:使用标签过滤 Merchant Center 账号
创建标签并将其应用于关联的 Merchant Center 账号后
对于 CSS 网域,您可以使用 accounts.list
方法并将标签
查询参数,以仅返回带有该标签的账号。通过
以下示例演示了如何过滤 Merchant Center 账号
使用键值对的 id
(123
) 与 CSS 网域相关联
创建标签示例中创建的标签。要检索
账号,请使用以下网址发出 GET
请求:
https://shoppingcontent.googleapis.com/content/v2.1/cssId/accounts?view=CSS&label=123
无需请求正文。
示例:将标签应用于 CSS 网域
您还可以使用 csses.updatelabels
方法为 CSS 分配标签
与 CSS 组关联的网域。以下示例演示了如何
应用key-domains使用
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’
}