轉移營業地點

透過 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。回應 account.admins.create 呼叫或步驟 1 中的 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 接受正確的邀請。