Instagram Graph API

Media dengan Sebutan

Mengembalikan data pada Media Instagram yang pengguna lain telah @menyebut si Pengguna Instagram dalam keterangan.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}?fields=mentioned_media.media_id

Mengembalikan data pada Media Instagram di mana seorang Pengguna Instagram telah @disebut oleh pengguna Instagram lain dalam keterangan.

Batasan

  • Sebutan di Cerita tidak didukung.
  • Berkomentar di foto yang Anda ditandai tidak didukung.
  • Webhooks tidak akan dikirim jika Media tempat munculnya komentar atau @penyebutan dibuat oleh akun yang dikunci jadi pribadi.

Persyaratan

Jenis Deskripsi

Token Akses

Pengguna

Izin

instagram_basic
instagram_manage_comments
pages_read_engagement
pages_show_list


Jika pengguna aplikasi diberikan peran di Halaman melalui Pengelola Bisnis, Anda juga akan memerlukan salah satu:


ads_management
business_management

Tugas

MANAGE, CREATE_CONTENT, atau MODERATE

Sintaksis Permintaan

GET https://graph.facebook.com/v19.0/{ig-user-id}
  ?fields=mentioned_media.media_id({media-id}){{fields}}
  &access_token={access-token}

Parameter String Kueri

ParameterNilai

{access-token}
Wajib
String

Token Akses Pengguna milik pengguna aplikasi.

{fields}
Daftar yang dipisahkan koma

Daftar yang dipisahkan koma berisi Kolom-kolom Media Instagram yang Anda ingin dikembalikan. Jika tidak ada, kolom default akan dikembalikan.

{media-id}
Wajib
String

ID Media Instagram yang telah @menyebut si Pengguna Instagram dalam keterangan. ID yang disertakan dalam muatan notifikasi Webhook.

Kolom

KolomDeskripsi

caption
String

Teks keterangan. Keterangan yang @menyebut Pengguna Instagram tidak akan menyertakan simbol @ kecuali pengguna aplikasi membuat objek Media Instagram tempat keterangan itu dibuat.

comments
Objek

Daftar Komentar Instagram pada Media Instagram. Jika menggunakan Perluasan Kolom untuk mendapatkan teks komentar, teks yang @menyebut seorang Pengguna Instagram tidak akan menyertakan simbol @ kecuali pengguna aplikasi membuat objek Media Instagram tempat keterangan itu dibuat.

comments_count
String

Jumlah Komentar Instagram pada Media Instagram.

id
Default
String

ID Media Instagram.

like_count
String

Jumlah suka pada media. Mengecualikan suka pada media turunan album dan suka pada postingan promosi yang dibuat dari media. Mencakup balasan pada komentar.


  • Panggilan v10.0 atau versi sebelumnya: nilainya 0 jika pemilik media telah menyembunyikan jumlah suka.
  • Panggilan v11.0+: Kolom akan dihilangkan jika pemilik media telah menyembunyikan jumlah suka. Nilainya 0 jika pemilik media telah menyembunyikan jumlah suka.

media_type
String

Jenis Media Instagram: CAROUSEL_ALBUM, IMAGE, STORY, atau VIDEO.

media_url
String

URL Media Instagram yang diterbitkan.

owner
String

ID Pengguna Instagram yang membuat Media Instagram. Hanya dikembalikan jika pengguna aplikasi membuat objek Media Instagram, jika tidak, kolom username akan dikembalikan.

timestamp
String

Tanggal pembuatan Media Instagram diformat dalam ISO 8601.

username
String

Nama pengguna Instagram yang membuat Media Instagram.

Contoh Permintaan

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405309211844?fields=mentioned_media.media_id(17873440459141021){caption,media_type}&access_token=IGQVJ...'

Contoh Tanggapan

{
  "mentioned_media": {
    "caption": "metricsaurus headquarters!",
    "media_type": "IMAGE",
    "id": "17873440459141021"
  },
  "id": "17841405309211844"
}

Perhatikan bahwa dalam contoh di atas, API telah menghilangkan simbol @ symbol di depan dari keterangan asli (@metricsaurus headquarters!) karena pengguna aplikasi tidak membuat keterangan itu.

Paginasi

Jika Anda menggunakan perluasan kolom untuk mengakses edge yang mendukung paginasi berbasis kursor, tanggapan akan menyertakan kursor before dan after jika tanggapan berisi beberapa halaman data. Namun, tidak seperti paginasi berbasis kursor standar, tanggapan tersebut tidak akan menyertakan kolom previous atau next, jadi Anda harus menggunakan kursor before dan after untuk menyusun string kueri previous dan next secara manual untuk membuka halaman melalui set data yang dikembalikan.

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.