Instagramプラットフォーム

Instagram (IG)コメント

Instagramメディアオブジェクトに付けられたコメントを表します。

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

以下のフィールドを紹介します。

  • legacy_instagram_comment_id

以下のフィールドはサポート対象外です。

  • comment_type
  • mentioned_instagram_users

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

作成

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

読み取り

GET <HOST_URL>/<IG_COMMENT_ID>?fields=<LIST_OF_FIELDS>

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

制限

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

リクエストの構文

GET https://<HOST_URL>/<API_VERSION>/<IG_COMMENT_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

パスパラメーター

プレースホルダー値

<API_VERSION>

APIのバージョン。

<HOST_URL>

APIのバージョン。

<IG_COMMENT_ID>

必須。IGコメントのID。

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

キープレースホルダー値

access_token

<ACCESS_TOKEN>

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

fields

<LIST_OF_FIELDS>

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

フィールド

フィールド名説明

from

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

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

hidden

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

id

IGコメントのID。

like_count

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

legacy_instagram_comment_id

v21.0以前のマーケティングAPIエンドポイント用に作成されたInstagramコメントのID。

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ユーザーのユーザーネーム。

2024年8月27日より、アプリユーザーのInstagramプロアカウントのメディアにコメントしたInstagramユーザーのusernameフィールドにアクセスするには、instagram_manage_commentsアクセス許可(アプリでFacebookログインを使用する場合)とinstagram_business_manage_commentsアクセス許可(アプリでInstagramログインを使用する場合)が必要になります。

エッジ

エッジ説明

replies

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

応答

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

{
  "<FIELD>":"<VALUE>",
  ...
}

cURLの例

リクエスト

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

応答

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

更新

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

POST <HOST_URL>/<IG_COMMENT_ID>?hide=<BOOLEAN>

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

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

制限

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

アクセストークン

コメントされたメディアオブジェクトを所有するユーザーからのアクセストークン。

リクエストの例

コメントを非表示にする

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

応答の例

{
  "success": true
}

削除

コメントを削除する

DELETE <HOST_URL>/<IG_COMMENT_ID>

アクセストークン

コメントを作成したユーザーのユーザーアクセストークン。

制限

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

リクエストの例

DELETE graph.instagram.com
  /17873440459141021

応答の例

{
  "success": true
}