借助 My Business Account Management API,您可以将营业地点转移到不同的帐号或营业地点组。请按照本文档中的说明了解如何操作。
开始使用
要转让营业地点,您必须具备以下资源:
源帐号:源帐号是营业地点所有者的帐号。此帐号可以是个人帐号,也可以是营业地点组。转移完成后,源帐号将无法再访问该营业地点。
目标帐号:目标帐号是营业地点应转移到的帐号。此帐号可以是个人帐号,也可以是营业地点组。转移完成后,目标帐号将成为该营业地点的主要所有者。
OAuth2 刷新/访问令牌:每个帐号都需要源帐号和目标帐号的 OAuth2 刷新/访问令牌,才能调用 API。
转让营业地点
要转移营业地点,请完成以下步骤:
您必须成为相应营业地点的所有者,才能成为所有者。使用当前企业主的 OAuth 凭据调用
account.admins.create
,并邀请用户拥有该商家信息。然后,使用受邀用户的 OAuth 凭据调用accounts.invitations.list
以获取邀请 ID。调用accounts.invitations.accept
以接受此邀请。使用预期目标帐号的 OAuth 凭据调用
accounts.list
。然后,在列表中找到要将营业地点转移到的目标帐号 ID。第 1 步中account.admins.create
调用或accounts.invitations.list
调用的响应中的管理员 ID 也可用作帐号 ID。此帐号 ID 可以是个人帐号,也可以是营业地点组。使用您在第 2 步中检索到的帐号 ID 作为目标帐号。这是请求正文中的“destinationAccount”字段,可用于调用
locations.transfer
。destinationAccount
使用目标帐号的 OAuth 凭据调用 accounts.locations.list
,并验证转移后的营业地点是否显示在结果中。如果您使用源帐号调用 accounts.locations.list
端点,则转移后的营业地点不会包含在结果中。
转移到营业地点组
如需将营业地点转移到组织中的 location group
,请使用 merchant
OAuth 凭据调用 locations.admins.create
。使用 Admin
资源中的 account
字段传递 location group account ID
以及相应的 role
。您应该使用 location group
管理员凭据调用 accounts.invitations.list
,并将营业地点组的帐号 ID 用作 parent
参数,以检索与 location group
相关的邀请。找到具有正确目标位置的邀请,然后调用 accounts.invitations.accept
以接受正确的邀请。