您可以使用 Accounts API 管理 Merchant Center 账号与其他服务提供商之间的关系。关系是一种正式连接,可让提供商向您的商家提供特定服务。服务定义了授予提供方的权限和功能,例如商品管理或广告系列管理。例如,将 Merchant Center 账号与 Google Ads 账号相关联后,Ads 账号便可以使用您的商品数据来投放广告系列。
关系由以下属性组成:
- 接收服务的 Merchant Center 账号
- 服务提供商
- 提供给 Merchant Center 账号的服务或一组服务
别名
服务提供商可以将别名与他们服务的账号相关联(这相当于 Content API for Shopping 中
账号
资源中的 seller_id 字段)。可以使用 AccountRelationship 资源中的可选 account_id_alias 字段分配别名,并将其用作自定义标识符。别名必须包含 1 到 50 个字符,这些字符可以从 ASCII 字母、十进制数字、连字符、下划线、句点或波浪号 ([A-Za-z0-9_~.-]{1,50}) 中选择。
使用别名访问账号的网址结构为 GET /accounts/v1/accounts/{provider}~{account_id_alias}。
服务
在 Accounts API 中,账号可以接收以下服务。您可以在 创建 账号时添加许多此类服务。
账号汇总:此服务会将 高级账号与其他 账号相关联,从而授予高级账号不受限制的完整访问权限。 它通常由需要集中控制嵌套账号的市场、多品牌零售商或国际零售商使用。 如果您是电子商务平台或渠道合作伙伴,我们建议您改用
accountManagement。使用账号汇总创建账号时,必须省略externalAccountId。广告系列管理:此服务对 Merchant Center 账号与 Google Ads 账号之间的关联进行建模,从而让 Ads 账号 可以访问投放广告系列所需的商品和账号数据。在这种情况下,服务提供商为
GOOGLE_ADS,externalAccountId为 Google Ads 账号的 ID。此服务也可以向现有账号提出。
比价购物:这表示与运营 Merchant Center 账号的比价 购物服务 (CSS) 的关系。
本地商家信息管理:这表示与商店经理的关系,用于使用 Google 商家资料管理本地商品目录和商家信息。
账号管理:此服务让提供方能够对 Merchant Center 账号执行管理操作,例如配置账号设置、管理用户或更新商家信息。商家还可以限制授予的访问权限。在创建账号期间使用时,此服务会创建一个与提供方相关联的账号,这是电子商务平台和渠道合作伙伴的推荐方法。此服务也可以向现有账号提出。
商品管理:此服务允许提供商管理商品 和相关功能,例如数据源和规则。在创建账号期间添加时,它通常与
accountManagement或accountAggregation结合使用。此服务也可以向现有账号提出。
握手
如需建立服务,提供服务的账号和接收服务的账号都必须授权连接。此授权过程称为握手。
握手是一个两步过程:
- 一方提出服务关联。
- 另一方批准或拒绝提案。
提案被接受后,服务即获批准并被视为已完全建立。授予服务提供商的任何访问权限 现在都将授予符合条件的用户(请参阅下文的访问权限)。
请注意,创建、拒绝或批准提案的用户必须对发起该过程的账号拥有
ADMIN 访问
权限
。因此,如果服务提供商提出服务,则提出提案的用户必须是服务提供商账号的 ADMIN,而接受或拒绝提案的用户必须是接收账号的 ADMIN。
特定于服务的握手行为
以下是针对每项服务的特定握手要求的说明:
账号汇总:此服务只能在 创建账号时建立。服务提供商应为高级账号,并且由于高级账号的用户对正在创建的账号拥有完整的
ADMIN访问权限,因此服务会自动获得批准。比价购物:使用
createAndConfigure在创建账号期间添加此服务时,该服务会自动获得批准。广告系列管理:虽然此服务遵循正常的握手流程,但提案在一个系统(例如 Google Ads)中提出,批准在另一个系统(例如在 Merchant Center 中或通过 Merchant API)中完成。
本地商家信息管理:对于此服务,握手是在 专用方法中提出的,批准在另一个系统(例如 Google 商家资料)中完成。如需了解详细步骤,请参阅 关联 Google 商家资料指南。
账号管理:对于此服务,使用
propose时,系统会应用常规握手流程 。如果使用createAndConfigure在创建账号期间添加此服务,则该服务会自动获得批准。商品管理:对于此服务,系统会应用常规握手流程 (一方提出,另一方接受)。
访问权限
每种服务类型都为服务提供商的用户提供对所服务账号的特定访问权限级别:
账号汇总:此服务提供完整的
ADMIN权限。广告系列管理:此服务提供受限的访问权限, 允许关联的 Ads 账号访问商品和基本账号 信息。
比价购物:默认情况下,此服务提供完整的
ADMIN权限。不过,商家可以在 Merchant Center 中限制授予的访问权限。本地商家信息管理:此服务不提供直接访问权限。 相反,它允许商品详情将其商品与 Merchant Center 账号同步。
重要提示:以下服务类型所述的访问权限
仅适用于已获批准的服务提供商。如果您是
服务提供商并想使用此功能,请与我们的支持
团队联系。如果您之前已获批准使用 Content API for Shopping 中的 accounts.link 方法进行商品管理,则可以在 Merchant API 中使用此服务,而无需进一步批准。
账号管理:默认情况下,此服务提供完整的
ADMIN权限。商品管理:此服务提供完整的
ADMIN权限。请注意,将来此权限将仅限于与商品相关的访问权限。
关系如何应用于第三方平台
如果您是代表其他商家管理账号的第三方平台,则以下内容说明了不同的概念如何映射到您的账号结构:
- 服务提供商:您的高级 账号。
- 接收服务的账号:代表您管理的商家的 Merchant Center 账号。
- 服务:
accountManagement:这是电子商务平台和渠道合作伙伴代表商家创建新账号的推荐服务。它会创建一个由商家拥有的账号,并与您相关联以进行管理。这与此用例的首选 Merchant Center 结构一致。accountAggregation:此服务会将您的高级账号与其他账号相关联。虽然受支持,但不建议电子商务平台和渠道合作伙伴使用。