POST/api/v4/connected-accounts/disconnect-facebook

Facebookアカウントの接続解除

以前に接続したFacebook PagesアカウントをListings APIアカウントから接続解除します。

API キーが必要です。ヘッダーの形式とキーのローテーションについては認証を参照してください。

パラメーター

ボディ

名前型必須説明
inputobject必須Wrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstring必須UUID of the connected Facebook account to disconnect. The whole account is disconnected.

リクエストの例

そのまま貼り付けられるボディです。プレースホルダーの ID と値をご自身のものに置き換えてください。

Request body
{  "input": {    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"  }}

レスポンス

200Request accepted. `success: true` confirms the disconnect was processed.
Response
{  "data": {    "fbBulkDisconnect": {      "success": true    }  }}
400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.

接続済みのFacebook PagesアカウントとListings APIアカウントの連携を解除します。接続を解除すると、そのアカウントを通じて同期されていた掲載情報はListings APIからの更新を受信しなくなり、Facebookでのやり取りもダッシュボードに表示されなくなります。

リクエストの形式。 リクエストボディは、connectedAccountIdのみをフィールドとして持つinputオブジェクトでラップする必要があります。この操作は部分的には実行できず、接続済みアカウント全体の接続が解除されます。locationIdsフィールドはなく、指定するとスキーマによって拒否されます。アカウントの接続を維持したまま単一の拠点の掲載情報を切り離すには、代わりにdisconnect-listingエンドポイントを使用してください。

ユースケース:契約を終了するクライアントの利用終了処理。 クライアントが解約した場合は、そのFacebookアカウントの接続を解除し、Listings APIによるページの管理を停止して、クライアントに代わって投稿や返信がそれ以上送信されないようにします。アカウントを完全に切り離すには、クライアントのconnectedAccountId(GET /connected-accountsから取得)を指定してください。

ユースケース:正常に動作しない接続の再認可。 Facebook接続に再認証では解消できない認証情報のエラーがある場合は、ここで接続を解除し、connect-facebookエンドポイントで新しいリンクを発行してください。success: trueは、接続解除が処理されたことを示します。Googleの場合は、disconnect-googleエンドポイントを使用してください。ただし、不明なconnectedAccountIdに対してもsuccess: trueレスポンスが返されます。成功は「リクエストが処理された」という意味であり、有効な接続が削除された証拠ではありません。確実に確認する必要がある場合は、GET /connected-accountsでアカウントの状態を確認してください。

Request
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"    }  }'