转移营业地点

借助 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 可以是个人帐号，也可以是营业地点组。

3. 使用您在第 2 步中检索到的帐号 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 以接受正确的邀请。