Platform Instagram

Media Instagram

Mewakili album, foto, reel, cerita, atau video Instagram (video yang diunggah, video siaran langsung, video yang dibuat dengan aplikasi Instagram TV, reel, atau cerita).

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-media-id}

Mendapatkan kolom dan edge pada Media Instagram.

Batasan

  • Kolom yang memberikan nilai agregat tidak akan menyertakan data berbasis iklan. Sebagai contoh, comments_count akan menghitung komentar pada foto, tetapi tidak menghitung komentar pada iklan yang berisi foto tersebut.
  • Keterangan tidak akan menyertakan simbol @ kecuali pengguna aplikasi juga dapat melakukan Tugas setara Admin pada aplikasi.
  • Beberapa kolom seperti permalink, tidak dapat digunakan pada foto dalam album (turunan).
  • Media Instagram TV harus dibagikan di Instagram saat penerbitan (Posting Pratinjau atau Bagikan Pratinjau ke Kabar diaktifkan) agar dapat diakses melalui API.
  • Media Instagram video siaran langsung hanya dapat dibaca saat sedang disiarkan.

Persyaratan

JenisDeskripsi

Token Akses

Pengguna.

Izin

instagram_basic
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

Sintaksis Permintaan

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

Parameter Jalur

PlaceholderNilai

{api-version}

Versi API.

{ig-media-id}

Wajib. ID Media Instagram.

Parameter String Kueri

KodePlaceholderNilai

access_token

{access-token}

Wajib.Token akses pengguna aplikasi.

fields

{fields}

Daftar yang dipisahkan koma berisi kolom-kolom yang Anda ingin ditampilkan.

Kolom

Kolom publik dapat dibaca melalui perluasan kolom.

KolomDeskripsi

caption
Publik

Keterangan. Mengecualikan turunan album. Simbol @ tidak disertakan, kecuali pengguna aplikasi dapat melakukan tugas setara admin di Halaman Facebook yang terhubung ke akun Instagram yang digunakan untuk membuat keterangan.

comments_count
Publik

Jumlah komentar pada media. Mengecualikan komentar di media turunan album dan keterangan media. Mencakup balasan pada komentar.

copyright_check_information.status

Menampilkan objek status dan matches_found

objek statusDeskripsi

status

  • completed – proses deteksi telah selesai
  • error – terjadi kesalahan selama proses deteksi
  • in_progress – proses deteksi sedang berlangsung
  • not_started – proses deteksi belum dimulai

matches_found

Atur ke salah satu dari berikut ini:

  • false jika video tidak melanggar hak cipta,
  • true jika video melanggar hak cipta

Jika video melanggar hak cipta, copyright_matches ditampilkan dengan berbagai objek tentang materi berhak cipta, kapan pelanggaran terjadi dalam video, dan tindakan yang diambil untuk memitigasi pelanggaran.

objek copyright_matchesDeskripsi

author

pembuat video berhak cipta

content_title

nama video berhak cipta

matched_segments

Susunan objek dengan pasangan kode-nilai berikut: * duration_in_seconds – jumlah detik konten melanggar hak cipta * segment_type – AUDIO atau VIDEO * start_time_in_seconds – diatur ke waktu mulai video

owner_copyright_policy

Objek yang ditampilkan meliputi:

  • name – Nama untuk kebijakan pemilik hak cipta

  • actions – Array objek action dengan pengambilan langkah mitigasi yang ditentukan oleh kebijakan pemilik hak cipta. Mungkin mencakup langkah-langkah mitigasi yang berbeda untuk lokasi yang berbeda.

    • action – Tindakan mitigasi yang dilakukan terhadap video yang melanggar hak cipta. Langkah-langkah mitigasi yang berbeda dapat diambil untuk berbagai negara. Dapat berupa salah satu dari nilai berikut ini:
      • BLOCK – Video diblokir dari pemirsa yang tercantum di array geos
      • MUTE - Video dibisukan untuk pemirsa yang tercantum di array geos

id
Publik

ID Media.

ig_id
Publik

ID media Instagram. Digunakan dengan API Instagram Legasi, sekarang tidak digunakan. Gunakan id sebagai gantinya.

is_comment_enabled

Menandai apakah komentar diaktifkan atau dinonaktifkan. Mengecualikan turunan album.

is_shared_to_feed
Publik

Hanya untuk Reels. Jika true, menunjukkan reel dapat muncul baik di tab Kabar maupun Reels. Jika false, menunjukkan reel hanya dapat muncul di tab Reels.

Tidak ada nilai yang menentukan apakah reel benar-benar muncul di tab Reels karena reel mungkin tidak memenuhi syarat kelayakan atau mungkin tidak dipilih oleh algoritma kami. Lihat spesifikasi reel untuk kriteria persyaratan.

like_count

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


Jika di-kueri secara tidak langsung melalui endpoint atau perluasan kolom lain:


  • Panggilan v10.0 atau versi sebelumnya: Nilainya adalah 0 jika pemilik media telah menyembunyikan jumlah suka.
  • Panggilan v11.0+: Kolom like_count dihapus jika pemilik media telah menyembunyikan jumlah suka.

media_product_type
Publik

Permukaan tempat media diterbitkan. Dapat berupa AD, FEED, STORY, atau REELS.

media_type
Publik

Jenis media. Dapat berupa CAROUSEL_ALBUM, IMAGE, atau VIDEO.

media_url
Publik

URL untuk media.

Kolom media_url akan dihapus dari tanggapan jika media berisi materi berhak cipta atau telah ditandai sebagai pelanggaran hak cipta. Contoh materi berhak cipta dapat mencakup audio di reel.

owner
Publik

ID pengguna Instagram yang membuat media. Hanya ditampilkan jika pengguna aplikasi yang membuat kueri juga membuat media, jika tidak, kolom username akan ditampilkan.

permalink
Publik

URL Permanen untuk media.

shortcode
Publik

Kode singkat untuk media.

thumbnail_url
Publik

URL gambar mini media. Hanya tersedia di media VIDEO.

timestamp
Publik

Tanggal pembuatan berformat ISO 8601 di UTC (default-nya adalah UTC ±00:00).

username
Publik

Nama pengguna yang membuat media.

video_title
Publik

Tidak berlaku lagi. Dihilangkan dari tanggapan.

Edge

Edge publik dapat ditampilkan melalui perluasan kolom.

EdgeDeskripsi

children
Publik.

Mewakili koleksi objek Media Instagram di Media Instagram album.

collaborators

Mewakili daftar pengguna yang ditambahkan sebagai kolaborator di objek Media Instagram.

comments

Mewakili koleksi Komentar Instagram pada objek Media Instagram.

insights

Mewakili metrik interaksi sosial di objek Media Instagram.

Contoh cURL

Permintaan

curl -X GET \
  'https://graph.facebook.com/v19.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Tanggapan

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Memperbarui

POST /{ig-media-id}

Mengaktifkan atau menonaktifkan komentar di Media Instagram.

Batasan

Video siaran langsung di Media Instagram tidak didukung.

Persyaratan

JenisDeskripsi

Token Akses

Pengguna.

Izin

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

Sintaksis Permintaan

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

Parameter Jalur

PlaceholderNilai

{api-version}

Versi API.

{ig-media-id}

Wajib. ID Media Instagram.

Parameter String Kueri

KodePlaceholderNilai

access_token

{access-token}

Wajib.Token akses pengguna aplikasi.

comment_enabled

{comment-enabled}

Wajib. Atur ke true untuk mengaktifkan komentar atau false untuk menonaktifkan komentar.

Contoh cURL

Permintaan

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Tanggapan

{
  "success": true
}

Menghapus

Operasi ini tidak didukung.