Platform Instagram

Catatan Perubahan untuk Platform Instagram

Catatan perubahan ini mengacu pada perubahan yang dibuat untuk API Instagram.

Catatan Perubahan Terkait

3 Oktober 2024

Alur Pesan Sambutan kini tersedia untuk Instagram API dengan Instagram Login. Pelajari selengkapnya.

2 Oktober 2024

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

17 September 2024

Nilai scope baru

Berlaku untuk semua versi.

Untuk memastikan konsistensi antara nilai scope dan nama izin, kami memperkenalkan nilai scope baru untuk Instagram API dengan login Instagram. Nilai scope baru adalah:

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

Ini akan menggantikan masing-masing nilai business_basic, business_content_publish, business_manage_comments dan business_manage_messages yang ada.

Harap perhatikan bahwa nilai scope lama akan dihentikan pada 27 Januari 2025. Sangat penting untuk memperbarui kode Anda sebelum tanggal ini untuk menghindari gangguan pada fungsionalitas aplikasi Anda. Kegagalan melakukannya akan mengakibatkan aplikasi Anda tidak dapat memanggil endpoint Instagram.

Koreksi: Tanggal penghentian diubah dari 17 Desember 2024 menjadi 27 Januari 2025.

23 Juli 2024

Peluncuran API Instagram baru dengan Instagram Login

Komponen API Instagram baru ini:

  • Halaman Facebook tidak lagi diperlukan
  • URL host untuk panggilan API adalah graph.instagram.com
  • Izin baru untuk API ini:
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • Messenger API tidak akan lagi digunakan untuk mengirim pesan Instagram
  • Aplikasi baru akan menambahkan produk Instagram baru saat membuat aplikasi Meta
  • Aplikasi yang ada dapat menambahkan produk Instagram baru di Dasbor Aplikasi

Kunjungi panduan migrasi kami untuk mempelajari apakah API Instagram baru dengan Instagram Login ini tepat bagi Anda.

11 Juni 2024

Webhooks Komentar Instagram

Berlaku untuk semua versi.

Selain ad_id dan ad_title, original_media_id akan ditampilkan dalam objek media dari objek comments kolom value saat seseorang berkomentar di postingan Instagram atau iklan Instagram yang dipromosikan. Untuk informasi selengkapnya, lihat Siapkan Webhooks untuk Instagram.

21 Mei 2024

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

12 September 2023

Deprecation of Media and User Insights

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.

9 November 2022

Webhooks Instagram

Berlaku untuk semua versi.

ad_id dan ad_title akan dikembalikan dalam objek media dari objek value kolom comments saat seseorang berkomentar di postingan Instagram atau iklan Instagram yang dipromosikan.

31 Oktober

Reels – Label Produk

Berlaku untuk semua versi.

API Pelabelan Produk Instagram untuk Reels tersedia. Anda dapat menandai hingga 30 produk saat menerbitkan satu reel.

28 Juni 2022

Reels

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.

27 Juni 2022

Dokumen API Instagram Legasi

Berlaku untuk semua versi.

Dokumentasi developer API Instagram legasi telah dihapus dan sekarang diarahkan ke dokumentasi developer Platform Instagram.

20 Juni 2022

Pelabelan Produk

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.

27 Mei 2022

Varian Produk

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.

15 Maret 2022

Postingan Carousel

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.

9 November 2021

Video Siaran Langsung

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:

  • Edge GET /ig-user/live_media ini dapat memberikan Media Instagram video siaran langsung yang sedang disiarkan oleh pengguna aplikasi Anda pada saat permintaan
  • Kolom media pada Komentar Instagram sekarang memberikan objek berisi ID (id) dan lokasi (media_product_type) media yang diterbitkan setelah komentar ditulis
  • Kolom Webhooks Instagram live_comments baru dapat mengirim notifikasi yang berisi komentar siaran langsung yang dibuat pada video siaran langsung pengguna aplikasi Anda saat sedang disiarkan

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

20 Oktober 2021

Komentar Instagram

Berlaku untuk semua versi.

Dua kolom baru telah ditambahkan ke Komentar Instagram:

  • from — mengembalikan objek berisi IGSID (id) dan nama pengguna (username) si kreator komentar.
  • parent_id — menampilkan ID Komentar Instagram induk jika komentar ini dibuat di Komentar Instagram lain (yaitu balasan untuk komentar lain).

Webhooks Instagram

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 tersebut
  • media.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).

5 Oktober 2021

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.

  • Kolommedia_product_type akan menampilkan FEED dan bukan IGTV
  • Kolomvideo_title tidak akan dikembalikan
  • Kolom comments dan mentionsWebhooks Instagram sekarang didukung

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

8 Juni 2021

Jumlah Suka

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.


Paginasi Berbasis Waktu

Berlaku untuk v11.0+.

Menambahkan parameter since dan until ke endpoint GET /{ig-user-id}/media untuk mendukung paginasi berbasis waktu.

26 Mei 2021

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.

4 Mei 2021

Ada perubahan kecil dalam cara kami menghitung metrik online_followers pada Pengguna Instagram.

14 April 2021

Interaksi Media Instagram Cerita yang dilakukan oleh pengguna di Jepang tidak lagi termasuk dalam beberapa perhitungan metrik replies:

  • Untuk cerita yang dibuat oleh pengguna di Jepang, metrik replies sekarang akan mengembalikan nilai 0.
  • Untuk cerita yang dibuat oleh pengguna di luar Jepang, metrik replies akan mengembalikan jumlah balasan, tetapi balasan yang dibuat oleh pengguna di Jepang tidak akan disertakan dalam penghitungan.

12 April 2021

Perbaikan bug kecil dengan metrik jangkauan di Media Instagram cerita.

9 April 2021

16 Maret 2021

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.

26 Januari 2021

Penerbitan Konten versi beta telah berakhir dan semua developer sekarang dapat menerbitkan media di akun Profesional Instagram. Baca panduan Penerbitan Konten untuk detail penggunaannya.

2 Desember 2020

Sesuai dengan Panduan Privasi Elektronik Uni Eropa, interaksi Cerita terkait pengiriman pesan Media Instagram yang dilakukan oleh pengguna di Wilayah Ekonomi Eropa (EEA) setelah 1 Desember 2020, tidak lagi disertakan dalam beberapa penghitungan metrik:

  • Untuk Cerita yang dibuat oleh pengguna dalam Wilayah Ekonomi Eropa, metrik replies sekarang akan menampilkan nilai 0.
  • Untuk Cerita yang dibuat oleh pengguna di luar EEA, metrik 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.

10 November 2020

  • Insight Pengguna Instagram — Nilai 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.

5 Mei 2020

3 Desember 2019

  • Insight — Untuk menyelaraskan perilaku API dengan perilaku aplikasi Instagram, insight tentang Pengguna Instagram sekarang hanya tersedia bagi Pengguna Instagram yang memiliki 100 pengikut atau lebih.

13 Agustus 2019

  • Penemuan Bisnis — API Penemuan Bisnis sekarang dapat digunakan untuk mendapatkan data tentang akun Kreator Instagram lainnya.

22 Mei 2019

9 Mei 2019

  • Webhooks — Kolom story_insights sekarang mewajibkan izin instagram_manage_insights dan bukan instagram_manage_comments.

31 Oktober 2018

  • API Pencarian Tagar — Anda sekarang dapat mencari media yang ditandai dengan tagar tertentu menggunakan API Pencarian Tagar baru kami. #spooky!

23 Oktober 2018

  • Edge /{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.

7 Juni 2018

  • Node /{ig-media-id} — Sekarang Anda dapat menggunakan perluasan kolom untuk mendapatkan kolom permalink pada objek media.

1 Mei 2018

  • Verifikasi Bisnis — Untuk menggunakan Instagram Graph API, semua aplikasi harus menjalani Verifikasi Bisnis, yang merupakan bagian dari proses Tinjauan Aplikasi dan sekarang diperlukan untuk semua endpoint Instagram Graph API. Aplikasi yang ditinjau sebelum 1 Mei 2018 harus ditinjau lagi sampai 1 Agustus 2018, jika tidak, maka akses ke API tersebut akan hilang.

24 April 2018

  • Node /{ig-comment-id}:
    • Menambahkan kolom username baru.
    • Untuk permintaan 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.
  • Node /{ig-media-id}:
    • Menambahkan kolom username baru.
    • Untuk permintaan 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.

23 April 2018

  • 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

13 Maret 2018

  • API Penerbitan Konten — Partner beta sekarang dapat menggunakan edge /{ig-user-id}/media untuk menandai lokasi dan pengguna Instagram publik saat menerbitkan foto.

8 Maret 2018

  • Kolom publik — Kolom timestamp di node /{ig-media-id} sekarang adalah kolom publik dan dapat ditampilkan melalui perluasan kolom.

22 Februari 2018

  • Kolom publik — Node /{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.

8 Februari 2018

  • API Penerbitan Konten — Partner beta sekarang dapat menyertakan tagar saat menerbitkan foto melalui edge /{ig-user-id}/media. #crazywildebeest FTW!