My Business Account Management API を使用すると、ビジネス情報を別のアカウントやビジネス グループに移管できます。このドキュメントでは、その方法について説明します。
使ってみる
ビジネス情報を移管するには、次のものが必要です。
移管元のアカウント: 移管元のアカウントとは、ビジネスのオーナーであるアカウントです。このアカウントは、個人アカウントまたはビジネス グループのいずれかです。移管が完了すると、移行元のアカウントはビジネス情報にアクセスできなくなります。
移管先のアカウント: 移管先のアカウントは、ビジネス情報の移管先となるアカウントです。このアカウントは、個人アカウントでもビジネス グループでもかまいません。移管が完了すると、移管先のアカウントがビジネスのメインのオーナーになります。
OAuth2 の更新トークンとアクセス トークン: API を呼び出すには、移行元と移行先のアカウントの OAuth2 の更新トークンとアクセス トークンがアカウントごとに必要です。
ビジネス情報の移管
ビジネス情報を移管する手順は次のとおりです。
ビジネスのオーナーでない場合は、オーナーになる必要があります。現在のビジネス オーナーの OAuth 認証情報を使用して
account.admins.createを呼び出し、リスティングのオーナーとしてユーザーを招待します。次に、招待したユーザーの OAuth 認証情報を使用してaccounts.invitations.listを呼び出し、招待 ID を取得します。この招待を受諾するには、accounts.invitations.acceptを呼び出します。移行先アカウントの OAuth 認証情報を使用して、
accounts.listを呼び出します。次に、ビジネス情報の移管先となるアカウント ID をリスト内で見つけます。アカウント ID として、account.admins.create呼び出しまたはステップ 1 のaccounts.invitations.list呼び出しのレスポンス内の管理者 ID も使用できます。このアカウント ID は、個人アカウントまたはビジネス グループを参照します。手順 2 で取得したアカウント ID を移行先アカウントとして使用します。これはリクエストの本文の destinationAccount フィールドで、
locations.transferの呼び出しに使用できます。
移管先のアカウントの OAuth 認証情報を使用して accounts.locations.list を呼び出し、移管されたビジネス情報が結果に表示されることを確認します。移行元アカウントで accounts.locations.list エンドポイントを呼び出した場合、移管されたビジネス情報は結果に含まれません。
ビジネス グループに転送する
組織内の location group にビジネス情報を移管するには、OAuth 認証情報 merchant を使用して locations.admins.create を呼び出します。Admin リソースの account フィールドを使用して、location group account ID を適切な role と一緒に渡します。location group に関連する招待状を取得するには、location group の管理者認証情報を使用して、parent 引数にビジネス グループのアカウント ID を指定して accounts.invitations.list を呼び出す必要があります。正しい対象地域が設定された招待を見つけ、accounts.invitations.accept を呼び出して正しい招待を受諾します。