轉移地點

透過「我的商家帳戶管理 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 接受正確的邀請。