Facebookアカウントを接続する

ユーザーがアクセスして、Listings APIによるFacebookページの一括管理を承認するための、有効期間の短いOAuth URLを生成します。返されたurlにユーザーをリダイレクトしてください。このフローの中で、ユーザーはFacebookの利用規約を確認して同意し、Listings APIが必要とするページ管理権限を付与します。リンクは24時間有効です。

リクエストの形式。 リクエストボディは、2つの必須フィールドsuccessUrlとerrorUrlを含むinputオブジェクトでラップする必要があります。これらは、ユーザーがFacebookの認可フローを完了した場合、または途中で中止した場合に戻る先の絶対https URLであり、成功時にはオンボーディングを再開し、エラー時には再試行できるようにする、自社アプリケーション内のエンドポイントを指定してください。accountIdフィールドは存在せず、接続リンクのスコープは常にAPIキーを所有するアカウントに限定され、accountIdまたはラップされていないフラットなリクエストボディを送信すると、HTTP 400で拒否されます。

これはconnect-googleエンドポイントのFacebook版であり、一括接続ワークフローの最初の手順です。認可が完了すると、アカウントがGET /connected-accountsに表示され、照合と同期に使用するconnectedAccountIdが付与されます。

ユースケース：クライアントのFacebookページのオンボーディング。 クライアントがFacebookへのアクセスを許可した後、返されたurlにリダイレクトしてください。クライアントが手続きを完了したら、POST /connected-accounts/trigger-matchesを実行し、GET /connected-accounts/{connectedAccountId}/connection-suggestionsで結果を確認して、POST /connected-accounts/confirm-matchesで対応付けを確定すると、Facebookページのデータと対応するListings APIの拠点との同期が始まります。

ユースケース：権限の付与が拒否された後の再認可。 ユーザーがFacebookの必須権限の付与をスキップすると、その接続では同期できません。リンクを再発行し、すべての権限を付与したうえで再認可してもらってください。

Googleの場合は、connect-googleエンドポイントを使用してください。success: trueでurlがnullでなければ、リンクが生成されたことを意味し、errorsには生成に失敗した場合にのみ値が設定されます。