Platform Instagram
Kembali ke Bahasa Indonesia
Dokumen ini sudah diperbarui.
Terjemahan ke Bahasa Indonesia belum selesai.
Bahasa Inggris diperbarui: 4 Sep

Media Instagram

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

Mulai 3 Juni 2024, Anda bisa menggunakan kolom boost_eligibility_info untuk secara mudah dan efisien menentukan apakah media memenuhi syarat untuk dipromosikan sebagai iklan. Selain itu, kolom boost_ads_list bisa digunakan untuk melacak informasi iklan Instagram sebelumnya yang terkait dengan iklan tersebut. Lihat blog untuk informasi selengkapnya. Hanya tersedia untuk Instagram Graph API.

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 video siaran langsung hanya dapat dibaca saat sedang disiarkan.
  • API ini hanya menampilkan data untuk media yang dimiliki oleh akun profesional Instagram. Ini tidak bisa digunakan untuk mendapatkan data untuk media yang dimiliki oleh akun Instagram pribadi.

Sintaksis Permintaan

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parameter Jalur

PlaceholderNilai

<API_VERSION>

Versi API.

<IG_MEDIA_ID>

Wajib. ID untuk media yang akan diterbitkan.

Parameter String Kueri

KodePlaceholderNilai

access_token

<ACCESS_TOKEN>

Wajib. Token akses pengguna aplikasi

fields

<LIST_OF_FIELDS>

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

Kolom

Kolom publik dapat dibaca melalui perluasan kolom.

KolomDeskripsi

boost_ads_list

Menawarkan gambaran umum tentang semua informasi iklan Instagram yang terkait dengan media organik. Ini termasuk ID iklan relatif dan status penayangan iklan. Hanya tersedia untuk Instagram Graph API.

boost_eligibility_info

Kolom ini menyediakan informasi tentang meningkatkan kelayakan media instagram IG sebagai iklan dan detail tambahan jika tidak memenuhi syarat. Hanya tersedia untuk Instagram Graph API.

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 (hanya Instragram Graph API).

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.

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 ekstensi kolom lain, kolom like_count akan dihilangkan jika pemilik media memiliki jumlah suka tersembunyi.

media_product_type
Publik

Permukaan tempat media diterbitkan. Dapat berupa AD, FEED, STORY, atau REELS. Hanya tersedia untuk Instagram Graph API.

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 dalam UTC (default-nya adalah UTC ±00:00).

username
Publik

Nama pengguna yang membuat media.

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. Hanya tersedia untuk Instagram Graph API.

comments

Mewakili koleksi Komentar Instagram pada objek Media Instagram.

insights

Mewakili metrik interaksi sosial di objek Media Instagram. Hanya tersedia untuk Instagram Graph API.

Contoh cURL

Contoh permintaan

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

Contoh 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.

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
  • pages_show_list

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
  • business_management

Sintaksis Permintaan

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &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

<BOOL>

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

Contoh cURL

Contoh permintaan

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

Contoh tanggapan

{
  "success": true
}

Menghapus

Operasi ini tidak didukung.