转移营业地点

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

注意：如要转移某个营业地点，调用方必须是该营业地点的所有者，并且目标账号持有人必须至少是该营业地点的管理员。如需详细了解如何授予某商家信息的所有权，请参阅管理账号和营业地点的管理员。

开始使用

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

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

转移营业地点

注意：商家资料设有营业地点管理员试用期。当用户以所有者或管理员身份添加到商家资料后，他们可以对营业地点的其他用户和营业地点本身执行的操作将受到限制，限制期限为 7 天。在此期间，处于试用期的用户将无法把商家资料的主要所有权转移给自己或其他用户。

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

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。

   注意：转移完成后，目标账号即成为与该商家信息所有者相关联的主要账号。如果这不是您预期的结果，请另用一个新用户来重复第 1-3 步。然后，将相应的营业地点转回至原始主要账号。您可以使用 accounts.admins.patch 端点对原始目标账号的管理员角色进行降级。

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