轉移地點

您可以使用「My Business Account Management」API，將地點轉移至不同的帳戶或地點群組。請按照本文說明操作，瞭解如何進行這項操作。

注意： 如要轉移地點，呼叫端必須是該地點的擁有者，而目標帳戶持有人至少必須是該地點的管理員。如要進一步瞭解如何授予商家資訊擁有權，請參閱「管理帳戶和地點的管理員」。

開始使用

轉移地點時，必須提供下列項目：

來源帳戶：來源帳戶是指商店擁有者的帳戶。這個帳戶可以是個人帳戶或營業地點群組。轉移完成後，來源帳戶就無法再存取該位置。
目標帳戶：目標帳戶是指要轉移位置的帳戶。這個帳戶可以是個人帳戶或地點群組。轉移完成後，目標帳戶將成為該地點的主要擁有者。
OAuth2 重新整理/存取權杖：如要呼叫 API，每個帳戶都需要來源和目的地帳戶的 OAuth2 重新整理/存取權杖。

轉移位置

注意： 商家檔案的地點管理員須經過一段試用期。將使用者新增為商家檔案的擁有者或管理員後，他們在 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 來接受正確的邀請。