接続済みアカウントの詳細を取得

connectedAccountIdで指定した接続済みアカウント1件の完全な詳細レコードを取得します。リストエンドポイントの1件のレコードと同じフィールドを返しますが、対象が1つのアカウントに限定されるため、すでにIDを保持している場合は、リスト全体をページングするよりもコストを抑えられます。

ユースケース：接続直後のアカウントをポーリングする。 顧客がGoogleの接続フローを完了すると、connectedAccountIdを取得できますが、一致候補の取得は非同期で実行されます。このエンドポイントをポーリングしてrequestMatchesStatusを監視します。候補の準備が整うとMATCH_IN_PROGRESSからMATCH_COMPLETEDに変わり、その時点でconnection-suggestionsエンドポイントから候補を読み取れます。

ユースケース：再認証を促す。 アカウントを通じて更新を送信する前に、statusとconnectivityIssueを読み取ります。ステータスがCONNECTED以外であるか、connectivityIssueに値が設定されている場合は、OAuthの認可が期限切れになっていることを意味します。失敗する公開処理を試みる代わりに、アプリ内で顧客に再接続を促します。connectedLocationsCountは、そのアカウントに現在リンクされているListings APIの拠点数を示します。