接続済みアカウントの一覧取得

Listings API アカウントへの接続が承認されているすべての Google Business Profile および Facebook Pages のアカウントを返します。各レコードには、接続状態（status、connectivityIssue）、リンクされた拠点数（connectedLocationsCount）、前回のマッチ取得の状態（requestMatchesStatus）が含まれます。

ユースケース：同期前に接続状態を確認する。 毎晩実行するジョブの最初にこれを実行し、認証情報の有効期限が切れたアカウントを見つけます。connectivityIssue が null ではないレコード、または status が CONNECTED 以外のレコードについては、顧客が接続フローを通じて再承認する必要があります。無効な認証情報に対して trigger-matches の呼び出しを無駄にしないよう、これらはスキップします。

ユースケース：後続の呼び出しに使用する connectedAccountId を特定する。 trigger-matches、fetch-listings、folders、details の各エンドポイントは、すべて connectedAccountId をキーとして使用します。アカウントの一覧を取得し、email が顧客と一致するアカウントを選び、その connectedAccountId を再利用します。

ページネーションとフィルタリングには、JSON ではなく、ネストされていない通常のクエリパラメーター page、perPage、publisher、status を使用します。pageInfo、filters、sort というパラメーターはなく、並び順を変更する方法もありません。結果は常にアカウントのメールアドレスの昇順に並べられます。それ以外のものを送信しても拒否されずに無視されるため、JSON の pageInfo を送信しても、エラーにならずにページ 1 が返されます。

curl -s 'https://listingsapi.com/api/v4/connected-accounts?page=1&perPage=20&publisher=GoogleAccount&status=Connected' \  -H "Authorization: API $LISTINGSAPI_KEY"

status フィルターと status フィールドでは、使用する値が異なります。 フィルターには Connected、NotConnected、ConnectionIssue のいずれかを指定しますが、返される各レコードの status は CONNECTED、MATCH_IN_PROGRESS、CONNECTIVITY_ISSUE のいずれかです。レコード自体の status をフィルターとして渡すと、無効な列挙値とみなされ、400 が返されます。

レスポンスの pageInfo.hasNextPage と pageInfo.totalPages を確認し、次のページを取得するかどうかを判断します。このエンドポイントの呼び出しはアカウントのレート制限にカウントされ、429 には Retry-After ヘッダーが含まれます。