Catatan perubahan ini merujuk pada perubahan yang dilakukan pada Instagram Graph API.
Applies to v18.0+. Will apply to all versions on December 11, 2023.
Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
AUDIENCE_GENDER_AGE
AUDIENCE_LOCALE
AUDIENCE_COUNTRY
AUDIENCE_CITY
GET /{ig-media-id}/insights
CAROUSEL_ALBUM_IMPRESSIONS
CAROUSEL_ALBUM_REACH
CAROUSEL_ALBUM_ENGAGEMENT
CAROUSEL_ALBUM_SAVED
CAROUSEL_ALBUM_VIDEO_VIEWS
TAPS_FORWARD
TAPS_BACK
EXITS
ENGAGEMENT
Note: total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.total_interactions
, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement
metric.
Berlaku untuk semua versi.
ad_id
dan ad_title
akan ditampilkan dalam objek value
dari objek media
kolom comments
saat seseorang berkomentar di postingan Instagram yang dipromosikan atau postingan iklan Instagram.
Berlaku untuk semua versi.
API Pelabelan Produk Instagram untuk Reels tersedia. Anda dapat menandai hingga 30 produk saat menerbitkan satu reel.
Berlaku untuk semua versi.
Reels sekarang didukung. Untuk menerbitkan video sebagai reel, atur parameter media_type
ke REELS
ketika membuat kontainer postingan media tunggal. Lihat referensi POST /ig-user/media endpoint
untuk mempelajari parameter mana yang dapat digunakan dengan reel serta persyaratan untuk video reel.
Berlaku untuk semua versi.
Dokumentasi developer API Instagram legasi telah dihapus dan sekarang diarahkan ke dokumentasi developer Platform Instagram.
Berlaku untuk semua versi.
Anda sekarang dapat membuat dan mengelola Label Produk Instagram Shop di media yang diterbitkan oleh Instagram Business. Baca panduan Pelabelan Produk untuk mempelajari caranya.
Berlaku untuk semua versi.
Untuk partner di Pelabelan Produk versi beta, semua varian produk yang cocok dengan kriteria pencarian kueri sekarang akan ditampilkan ketika mencari produk di katalog.
Berlaku untuk semua versi.
Anda sekarang dapat menggunakan Instagram API untuk menerbitkan postingan yang berisi banyak gambar dan video (postingan carousel). Baca panduan Penerbitan Konten untuk menyelesaikan langkah penerbitan.
Jika aplikasi Anda telah disetujui untuk izin yang diperlukan dalam penerbitan konten, aplikasi tidak perlu menjalani Tinjauan Aplikasi lagi untuk memanfaatkan fungsi ini.
Berlaku untuk semua versi.
API Instagram sekarang dapat digunakan untuk mendapatkan Media Instagram video siaran langsung yang disiarkan oleh pengguna aplikasi Anda, mendapatkan komentar pada video tersebut, dan menggunakan API Messaging Instagram untuk mengirim balasan pribadi (pesan direct) ke penulis komentar. Untuk mendukung fungsi ini, perubahan berikut telah dibuat:
media
pada Komentar Instagram sekarang memberikan objek berisi ID (id
) dan lokasi (media_product_type
) media yang diterbitkan setelah komentar ditulislive_comments
baru dapat mengirim notifikasi yang berisi komentar siaran langsung yang dibuat pada video siaran langsung pengguna aplikasi Anda saat sedang disiarkanBuka dokumentasi balasan pribadi API Messaging Instagram untuk mempelajari cara mengirimkan balasan pribadi kepada pengguna yang telah berkomentar di Media Instagram video siaran langsung milik pengguna aplikasi Anda.
Berlaku untuk semua versi.
Dua kolom baru telah ditambahkan ke Komentar Instagram:
parent_id
— menampilkan ID Komentar Instagram induk jika komentar ini dibuat di Komentar Instagram lain (yaitu balasan untuk komentar lain).Berlaku untuk semua versi.
Kolom Webhooks comments
Instagram sekarang mencakup properti berikut dalam objek kolom value
:
from.id
— IGSID pengguna Instagram yang menulis komentar tersebut.from.username
— Nama pengguna Instagram yang menulis komentar tersebutmedia.id
— ID Media Instagram yang dikomentari.media.media_product_type
— Permukaan (lokasi penerbitan) Media Instagram yang dikomentari.parent_id
— ID Komentar Instagram induk jika komentar ini dibuat di Komentar Instagram lain (yaitu balasan untuk komentar lain).Perubahan berikut berlaku untuk video Instagram TV yang dibuat pada atau setelah 5 Oktober 2021. Video Instagram TV yang dibuat sebelum tanggal ini dikecualikan dari perubahan ini.
video_title
tidak akan dikembalikanMulai 3 Januari 2022, perubahan di atas akan berlaku untuk semua versi API dan semua video Instagram TV, terlepas dari tanggal pembuatan video. Ini berarti bahwa mulai 3 Januari 2022, aplikasi yang menggunakan versi API lama akan dapat meng-kueri video Instagram TV (dukungan baca diperkenalkan di v10.0 dan terbatas pada v10.0+).
Mulai v14.0, kolom video_title
tidak akan didukung lagi dan API akan memunculkan kesalahan jika kolom diminta.
Berlaku untuk v11.0+. Akan berlaku untuk semua versi mulai 7 September 2021.
Jika secara tidak langsung mengirim kueri Media Instagram melalui endpoint lain atau perluasan kolom, kolom like_count
akan dihilangkan dari tanggapan API jika pemilik media menyembunyikan jumlah suka. Meng-kueri langsung ke Media Instagram (yang hanya dapat dilakukan oleh pemilik Media Instagram) akan memberikan jumlah suka yang sebenarnya, meskipun jumlah suka telah disembunyikan.
Berlaku untuk v11.0+.
Menambahkan parameter since
dan until
ke endpoint GET /{ig-user-id}/media
untuk mendukung paginasi berbasis waktu.
Jika secara tidak langsung mengirim kueri Media Instagram melalui endpoint lain, kolom like_count sekarang akan mengembalikan 0
jika pengguna aplikasi tidak memiliki media dan pemilik media telah menyembunyikan jumlah suka. Mengirim kueri langsung Media Instagram, yang hanya dapat dilakukan oleh pemilik Media Instagram, akan mengembalikan jumlah suka yang sebenarnya, meskipun pemilik telah menyembunyikan jumlah suka di media.
Ada perubahan kecil dalam cara kami menghitung metrik online_followers
pada Pengguna Instagram.
Interaksi Media Instagram Cerita yang dilakukan oleh pengguna di Jepang tidak lagi termasuk dalam beberapa perhitungan metrik replies
:
replies
sekarang akan mengembalikan nilai 0
.replies
akan mengembalikan jumlah balasan, tetapi balasan yang dibuat oleh pengguna di Jepang tidak akan disertakan dalam penghitungan.Perbaikan bug kecil dengan metrik jangkauan di Media Instagram cerita.
status
di Kontainer Instagram sekarang mengembalikan subkode kesalahan jika nilai kolom error_code
kontainer adalah ERROR
.video_views
sekarang mendukung album dan akan mengembalikan jumlah video_views
di semua video dalam album dan bukan 0
.Media IGTV sekarang didukung di v10.0+. Ini berlaku untuk semua endpoint kecuali yang digunakan untuk penerbitan konten dan webhooks. Untuk mendukung perubahan ini, kolom media_product_type
dan video_title
yang baru telah ditambahkan ke node Media Instagram. Media IGTV harus dibagikan di Instagram saat penerbitan (Posting Pratinjau atau Bagikan Pratinjau ke Beranda diaktifkan) agar dapat diakses melalui API.
Penerbitan Konten versi beta telah berakhir dan semua developer sekarang dapat menerbitkan media di akun Profesional Instagram. Baca panduan Penerbitan Konten untuk detail penggunaannya.
Sesuai dengan Pedoman Privasi Elektronik Uni Eropa, interaksi Media Instagram Cerita terkait berkirim pesan yang dilakukan oleh pengguna di Wilayah Ekonomi Eropa (EEA) setelah 1 Desember 2020, tidak akan lagi disertakan dalam beberapa penghitungan metrik:
replies
sekarang akan memberikan nilai 0
.replies
akan memberikan jumlah balasan, tetapi balasan yang dibuat oleh pengguna di dalam EEA tidak akan disertakan dalam penghitungannya.Perubahan ini berlaku untuk semua versi.
follower_count
sekarang selaras lebih dekat dengan nilai terkait yang ditampilkan di aplikasi Instagram. Selain itu, follower_count
kini memberikan data maksimum 30 hari dan bukan 2 tahun. Perubahan ini berlaku untuk v9.0 + dan akan berlaku untuk semua versi mulai 9 Mei 2021.timestamp
di Media Instagram dikembalikan oleh kueri Pencarian TagarGET /{ig-hashtag-id}/top_media
dan GET /{ig-hashtag-id}/recent_media
. Contoh: GET /{ig-hashtag-id}/top_media?fields=timestamp
.story_insights
sekarang mewajibkan izin instagram_manage_insights
dan bukan instagram_manage_comments
.#spooky
!/{ig-media-id}/comments
— Permintaan GET
yang dibuat menggunakan API versi 3.1 atau yang lebih lama akan memberikan hasil dalam urutan kronologis. Permintaan yang dibuat menggunakan versi 3.2+ akan memberikan hasil dalam urutan kronologis terbalik. /{ig-media-id}
— Sekarang Anda dapat menggunakan perluasan kolom untuk mendapatkan kolom permalink
pada objek media./{ig-comment-id}
:
username
baru.GET
, kolom user
tidak akan disertakan dalam tanggapan kecuali Pengguna yang membuat permintaan adalah pemilik Komentar; kami akan memberikan username
untuk semua komentator. Ini juga berlaku untuk kueri tentang Komentar yang dibuat melalui API lain, seperti API Sebutan./{ig-media-id}
:
username
baru.GET
, kolom owner
tidak akan disertakan dalam tanggapan kecuali Pengguna yang membuat permintaan adalah pemilik objek media; kami akan memberikan username
untuk semua komentator. Ini juga berlaku untuk kueri pada objek media yang dibuat melalui API lain, seperti API Sebutan.Insights API — Insight sekarang akan menyertakan aktivitas iklan yang dihasilkan melalui API, antarmuka iklan Facebook, dan fitur Promosi Instagram. Ini berdampak pada metrik berikut:
impressions
reach
timestamp
di node /{ig-media-id}
sekarang adalah kolom publik dan dapat ditampilkan melalui perluasan kolom./{ig-user-id}
, /{ig-comment-id}
, dan /{ig-media-id}
sekarang akan memberikan semua kolom publik saat diakses melalui edge melalui perluasan kolom. Baca dokumen referensi setiap node untuk melihat kolom mana yang bersifat publik./{ig-user-id}/media
. #crazywildebeest
FTW!