コメントと返信 API

コメント機能は、接続されている SNS プラットフォームの機能スコープと現在のアカウント権限に依存します。

コメントのエンドポイント

メソッド	パス	目的
`GET`	`/v1/brand/comments`	コメントの一覧表示
`GET`	`/v1/brand/comments/{comment_id}`	コメント詳細の取得
`POST`	`/v1/brand/comments`	投稿にトップレベルのコメントを投稿
`POST`	`/v1/brand/comment-refresh-jobs`	コメントの更新をリクエスト
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	更新ジョブのステータスを確認
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	非表示または削除アクションをリクエスト

トップレベルのコメントの投稿:

{
  "idempotency_key": "comment-001",
  "target": { "content_id": "<content_id>" },
  "text": "Thank you for checking out our post."
}

モデレーションの現在の action 値は hide または delete です。実際の実行はプラットフォームとコメントの状態に依存します。

メソッド	パス	目的
`POST`	`/v1/brand/reply-jobs`	返信ジョブの作成
`GET`	`/v1/brand/reply-jobs`	返信ジョブの一覧表示
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	返信ジョブのステータス取得

{
  "comment_id": "<comment_id>",
  "idempotency_key": "reply-001",
  "text": "Thank you for reaching out."
}

返信作成時に HTTP 202 が返された場合は、ジョブが検証され、保存され、キューに入れられたことを意味します。最終的なステータスは reply_job_id を介して確認してください。

レスポンスには、以下の可用性およびリカバリのインジケータが含まれる場合があります。