Platform Instagram

Komentar Instagram (IG)

Mewakili komentar pada objek media Instagram.

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

Memperkenalkan kolom berikut:

  • legacy_instagram_comment_id

Kolom berikut ini tidak didukung:

  • 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

Membuat

Operasi ini tidak didukung.

Membaca

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

Mendapatkan kolom dan edge pada Komentar Instagram.

Batasan

  • Permintaan tidak dapat dilakukan pada komentar yang ditemukan melalui Mentions API kecuali permintaan diminta oleh pemilik komentar. Sebaliknya, gunakan node Komentar yang Disebutkan.
  • Komentar di media yang dibatasi usia tidak ditampilkan.
  • Komentar yang dibuat oleh Pengguna Instagram yang telah dibatasi oleh pengguna aplikasi tidak akan ditampilkan kecuali Pengguna Instagram tidak lagi dibatasi dan Komentar tersebut disetujui.
  • Komentar pada Media Instagram video siaran langsung hanya dapat dibaca saat Media Instagram tempat komentar dibuat sedang disiarkan.

Sintaksis Permintaan

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

Parameter Jalur

PlaceholderNilai

<API_VERSION>

Versi API.

<HOST_URL>

Versi API.

<IG_COMMENT_ID>

Wajib. ID Komentar Instagram.

Parameter String Kueri

KodePlaceholderNilai

access_token

<ACCESS_TOKEN>

Wajib. Token akses Pengguna aplikasi.

fields

<LIST_OF_FIELDS>

Daftar Kolom Komentar Instagram yang dipisahkan koma yang ingin Anda tampilkan untuk setiap Komentar Instagram di set hasil.

Kolom

Nama KolomDeskripsi

from

Objek berisi:

  • id — ID Lingkup Instagram (IGSID) milik pengguna Instagram yang menulis Komentar Instagram tersebut.
  • username — Nama pengguna Instagram yang menulis Komentar Instagram tersebut.

hidden

Menunjukkan apakah komentar telah disembunyikan (true) atau tidak (false).

id

ID Komentar Instagram.

like_count

Jumlah suka pada Komentar Instagram.

legacy_instagram_comment_id

ID untuk komentar Instagram yang dibuat untuk endpoint Marketing API untuk v21.0 dan sebelumnya.

media

Objek berisi:


  • id — ID dari Media Instagram tempat Komentar Instagram dibuat.
  • media_product_type — Permukaan penerbitan Media Instagram (yaitu lokasi munculnya Media Instagram) tempat Komentar Instagram dibuat.

parent_id

ID Komentar Instagram induk jika komentar ini dibuat di Komentar Instagram lain (yaitu balasan untuk komentar lain).

replies

Daftar balasan (Komentar Instagram) pada Komentar Instagram tersebut.

text

Teks Komentar Instagram.

timestamp

Cap waktu berformat ISO 8601 yang menunjukkan kapan Komentar Instagram ditulis.


Contoh: 2017-05-19T23:27:28+0000.

user

ID Pengguna Instagram yang menulis Komentar Instagram. Hanya dikembalikan jika pengguna aplikasi menulis Komentar Instagram, jika tidak, username akan dikembalikan.

username

Nama pengguna milik pengguna Instagram yang membuat Komentar Instagram.

Mulai 27 Agustus 2024, izin instagram_manage_comments (jika aplikasi Anda menggunakan login Facebook) dan izin instagram_business_manage_comments (jika aplikasi Anda menggunakan login Instagram) akan diwajibkan untuk mengakses kolom username pengguna Instagram yang mengomentari media akun profesional Instagram milik pengguna aplikasi.

Edge

EdgeDeskripsi

replies

Mendapatkan daftar Komentar Instagram pada Komentar Instagram; Menulis Komentar Instagram pada suatu Komentar Instagram.

Tanggapan

Objek berformat JSON yang berisi kolom dan edge default dan yang diminta.

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

Contoh cURL

Permintaan

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

Tanggapan

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

Memperbarui

Menyembunyikan/Menampilkan Komentar

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

Parameter String Kueri

  • hide (wajib) — Atur ke true untuk menyembunyikan komentar, atau false untuk menampilkan komentar.

Batasan

  • Komentar yang dibuat oleh pemilik objek media pada objek medianya sendiri akan selalu ditampilkan, meskipun komentar tersebut telah diatur ke hide=true.
  • Komentar di Media Instagram video siaran langsung tidak didukung.

Token akses

Token akses pengguna dari pengguna yang memiliki objek media yang dikomentari.

Contoh Permintaan

Menyembunyikan komentar:

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

Contoh Tanggapan

{
  "success": true
}

Menghapus

Menghapus Komentar

DELETE <HOST_URL>/<IG_COMMENT_ID>

Token akses

Token akses pengguna dari Pengguna yang membuat komentar.

Batasan

  • Komentar hanya dapat dihapus oleh pemilik objek tempat komentar tersebut dibuat, meskipun pengguna yang mencoba menghapus komentar tersebut adalah penulis komentar tersebut.
  • Komentar di Media Instagram video siaran langsung tidak didukung.

Contoh Permintaan

DELETE graph.instagram.com
  /17873440459141021

Contoh Tanggapan

{
  "success": true
}