Instagramプラットフォーム

IGコメント

IGメディアへのコメントを表します。

作成

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

読み取り

GET /{ig-comment-id}?fields={fields}

IGコメントのフィールドとエッジを取得します。

制限

  • コメント所有者がリクエストした場合を除き、メンションAPIで検出されたコメントにリクエストを行うことはできません。代わりに、メンションされたコメントノードを使用してください。
  • 年齢制限のあるメディアへのコメントは返されません。
  • アプリユーザーによって制限されているIGユーザーが作成したコメントは、そのIGユーザーの制限が解除されてコメントが承認された場合を除いて、返されません。
  • ライブ動画IGメディアへのコメントを読み取ることができるのは、作成されたコメントの対象となるIGメディアが配信中の場合のみです。

要件

型要件

アクセストークン

ユーザー

アクセス許可

instagram_basic
pages_read_engagement
pages_show_list


ターゲットのIGユーザーに接続されたページ上でビジネスマネージャを介してアプリユーザーに役割が付与されている場合は、次のうちのいずれか1つも必要です。


ads_management
business_management

リクエストの構文

GET https://graph.facebook.com/{api-version}/{ig-comment-id}
  ?fields={fields}
  &access_token={access-token}

パスパラメーター

プレースホルダー値

{api-version}

APIのバージョン。

{ig-comment-id}

必須。IGコメントのID。

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

キープレースホルダー値

access_token

{access-token}

必須。アプリユーザーのユーザーアクセストークン。

fields

{fields}

各IGコメントについて戻り値として結果セットに入れる、IGコメントのフィールドのコンマ区切りリスト。

フィールド

フィールド名説明

from

次のものを含むオブジェクト。


  • id — IGコメントを作成したInstagramユーザーのIGSID。
  • username — IGコメントを作成したInstagramユーザーのユーザーネーム。

hidden

コメントが非表示にされているか(true)、いないか(false)を示します。

id

IGコメントのID。

like_count

IGコメントに対する「いいね！」の数。

media

次のものを含むオブジェクト。


  • id — IGコメントが付けられたIGメディアのID。
  • media_product_type — IGコメントが付けられたIGメディアが公開されるサーフェス(IGメディアが表示される場所)。

parent_id

コメントが別のIGコメントに対して作成されている(つまり別のコメントに対する返信である)場合、親IGコメントのID。

replies

IGコメントに対する返信(IGコメント)のリスト。

text

IGコメントのテキスト。

timestamp

IGコメントがいつ作成されたかを示すISO 8601形式のタイムスタンプ。


例: 2017-05-19T23:27:28+0000

user

IGメディアを作成したIGユーザーのID。アプリユーザーがIGコメントを作成した場合のみ返されます。それ以外の場合は、代わりにusernameが返されます。

username

IGコメントを作成したInstagramユーザーのユーザーネーム。

エッジ

エッジ説明

replies

IGコメントに対するIGコメントのリストを取得します。IGコメントに対するIGコメントを作成します。

応答

デフォルトとリクエストのフィールドおよびエッジを含む、JSON形式のオブジェクト。

{
  "{field}":"{value}",
  ...
}

cURLの例

リクエスト

curl -i -X GET \
 "https://graph.facebook.com/v19.0/17881770991003328?fields=hidden%2Cmedia%2Ctimestamp&access_token=EAAOc..."

応答

{
  "hidden": false,
  "media": {
    "id": "17856134461174448"
  },
  "timestamp": "2017-05-19T23:27:28+0000",
  "id": "17881770991003328"
}

更新

コメントを非表示にする/表示する

POST /{ig-comment-id}?hide={hide}

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

  • {hide} (必須) — コメントを非表示するにはtrueに設定し、コメントを表示するにはfalseに設定します。

制限

  • メディアオブジェクト所有者が自分のメディアオブジェクトに書き込んだコメントは、コメントがhide=trueに設定されていても、常に表示されます。
  • ライブ動画IGメディアへのコメントはサポートされていません。

アクセス許可

次のアクセス許可を持つ、コメントを作成したFacebookユーザーからのユーザーアクセストークン:

  • instagram_basic
  • instagram_manage_comments
  • pages_show_list
  • pages_read_engagement

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

  • ads_management
  • pages_read_engagement
  • business_management

リクエストの例

コメントを非表示にする:

POST graph.facebook.com
  /17873440459141021?hide=true

応答の例

{
  "success": true
}

削除

コメントを削除する

DELETE /{ig-comment-id}

アクセス許可

次のアクセス許可を付与された、コメントを作成したユーザーからのユーザーアクセストークン:

  • instagram_basic
  • instagram_manage_comments

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

  • ads_management
  • pages_read_engagement
  • business_management

制限

  • コメントを削除できるのは、コメントが作成されたオブジェクトの所有者のみです。コメントを作成した本人であっても削除することはできません。
  • ライブ動画IGメディアへのコメントはサポートされていません。

リクエストの例

DELETE graph.facebook.com
  /17873440459141021

応答の例

{
  "success": true
}