InstagramグラフAPI

コメント

IGメディアオブジェクトに関するIGコメントのコレクションを表します。

非オーガニックコメント

IGメディアを含む広告のコメント(つまり非オーガニックコメント)はタイプが異なり、サポートされません。非オーガニックコメントを取得するには、マーケティングAPIを使用して広告のeffective_instagram_story_idをリクエストします。次に、返されたIDの/commentsエッジをクエリすれば、非オーガニックInstagramコメントのコレクションを取得できます。詳細については、マーケティングAPIの投稿のモデレーションガイドを参照してください。

作成

メディアオブジェクトのコメントを作成する

POST /{ig-media-id}/comments?message={message}

IGメディアオブジェクトに対するIGコメントを作成します。

制限

ライブ動画IGメディアへのコメントはサポートされていません。

クエリ文字列パラメーター

必須として指定されていない限り、クエリ文字列パラメーターは任意です。

  • {message} (必須) — コメントに含めるテキスト。

アクセス許可

IGメディアオブジェクトを作成したユーザーのアクセストークンであり、次のアクセス許可を含みます:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

ビジネスマネージャを介してページの管理権限を付与されたユーザーのトークンの場合、次のいずれかのアクセス許可が必要です。

  • ads_management
  • pages_read_engagement
  • business_management

リクエストの例

POST graph.facebook.com
  /17895695668004550/comments?message=This%20is%20awesome!

応答の例

{
  "id": "17870913679156914"
}

読み取り

メディアオブジェクトのコメントを取得する

GET /{ig-media-id}/comments

IGメディアオブジェクトに関するIGコメントのリストが返されます。

制限

  • APIバージョン3.1以前を使用して発行されたリクエストの結果は時系列順で返されます。バージョン3.2以降を使用して発行されたリクエストの結果は逆時系列順で返されます。
  • トップレベルのコメントのみ返されます。コメントへの返信は含まれません。ただし、フィールド拡張機能を使用してrepliesフィールドをリクエストした場合は例外です。
  • 1回のクエリで最大50件のコメントが返されます。

アクセス許可

IGメディアオブジェクトを作成したユーザーのアクセストークンであり、次のアクセス許可を含みます:

  • instagram_basic
  • pages_show_list
  • pages_read_engagement

ビジネスマネージャを介してページの管理権限を付与されたユーザーのトークンの場合、次のいずれかのアクセス許可が必要です。

  • ads_management
  • pages_read_engagement
  • business_management

リクエストの例

GET graph.facebook.com
  /17895695668004550/comments

応答の例

{
  "data": [
    {
      "timestamp": "2017-08-31T19:16:02+0000",
      "text": "This is awesome!",
      "id": "17870913679156914"
    },
    {
      "timestamp": "2017-08-31T18:10:30+0000",
      "text": "*Sniff*",
      "id": "17873440459141021"
    }
  ]
}

アップデート

この操作はサポートされていません。

削除

この操作はサポートされていません。