转移营业地点

借助 My Business Account Management API，您可以将营业地点转移到不同的账号或营业地点组中。如要了解具体操作，请阅读本文档中的说明。

开始使用

您必须具备以下各项才能转移营业地点：

源账号：源账号是拥有营业地点的账号。此账号可以是个人账号，也可以是营业地点组。转移完成后，源账号将无法再访问相应营业地点。
目标账号：目标账号是应将营业地点转移到的账号。此账号可以是个人账号，也可以是营业地点组。转移完成后，目标账号将成为相应营业地点的主要所有者。
OAuth2 刷新/访问令牌：每个源账号和目标账号都必须有 OAuth2 刷新/访问令牌，才能调用该 API。

转移营业地点

如要转移营业地点，请完成以下步骤：

  1. 您必须成为该营业地点的所有者（如果不是的话）。使用当前企业主的 OAuth 凭据来调用 account.admins.create，并邀请一名用户成为其商家信息的所有者。然后，使用受邀用户的 OAuth 凭据来调用 accounts.invitations.list，以获取邀请 ID。调用 accounts.invitations.accept，以接受此邀请。

  2. 使用所需的目标账号的 OAuth 凭据来调用 accounts.list。然后，在列表中找到转移营业地点的目标账号 ID。第 1 步中调用 account.admins.create 或 accounts.invitations.list 后，返回的响应中的管理员 ID 也可用作账号 ID。此账号 ID 可以是个人账号 ID，也可以是营业地点组 ID。

  3. 使用您在第 2 步中检索到的账号 ID 作为目标账号。该账号 ID 包含在请求正文中的“destinationAccount”字段，可用来调用 locations.transfer。

使用目标账号的 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 以接受正确的邀请。