Introducing Facebook Graph API v12.0 and Marketing API v12.0
Hari ini kami merilis Graph API v12.0 dan Marketing API v12.0 Facebook. Di bawah ini, kami telah menyoroti perubahan yang akan memengaruhi sebagian komunitas developer kami. Perubahan ini mencakup pengumuman dan pembaruan produk, pengingat dari peluncuran sebelumnya, dan notifikasi tentang penghentian skala besar yang dapat memengaruhi integrasi aplikasi Anda dengan platform kami.
Untuk daftar lengkap semua perubahan dan detailnya, kunjungi catatan perubahan kami.
Pengumuman dan Pembaruan Umum
Conversions API: Memperluas versi minimum yang dapat dipanggil
Kompatibilitas Mundur Graph API untuk Aplikasi yang Dibuat dengan Token Akses Satu Klik Dimulai dengan v12.0, token akses yang baru dibuat yang dihasilkan di bawah tab pengaturan Conversions API di Pengelola Peristiwa kini didukung oleh semua versi Graph API yang tersedia (lihat versi yang didukung di sini).
Harap perhatikan bahwa panggilan yang dilakukan dengan token ini ke versi Graph API yang tidak digunakan lagi akan secara otomatis diselesaikan ke versi terlama yang tersedia. Perilaku ini hanya berlaku untuk endpoint Graph API. Endpoint Marketing API, termasuk Conversions API, tidak mendukung perilaku peningkatan otomatis dan akan memunculkan pengecualian.
API Profil Pengguna untuk Berkirim Pesan di Instagram: Kolom baru
Kami membuat peningkatan pada API Profil Pengguna untuk berkirim pesan di Instagram. Sebelumnya, API Profil Pengguna untuk Instagram mendukung dua kolom: 1) Nama dan 2) URL gambar profil. Untuk memungkinkan bisnis mempersonalisasi dan memprioritaskan pesan dengan lebih baik berdasarkan informasi pengguna yang tersedia untuk umum, kami telah memperbarui API untuk juga menyertakan informasi berikut:
1. Jumlah pengikut
2. Lencana Terverifikasi
3. Bisnis mengikuti akun Pengguna [Ya/Tidak]
4. Akun pengguna mengikuti akun Bisnis [Ya/Tidak]
Silakan buka dokumentasi developer untuk detailnya.
Penargetan Mendetail Peluang Baru
Untuk membantu pengiklan menemukan peluang tambahan yang awalnya tidak tersedia bagi mereka, saat pengiklan memanfaatkan Penargetan Mendetail dan mengoptimalkan konversi, nilai, atau peristiwa aplikasi menggunakan tujuan konversi, itu semua akan secara otomatis dimasukkan ke dalam Perluasan Penargetan. Untuk informasi selengkapnya, buka artikel Pusat Bantuan Perluasan Penargetan Mendetail.
Video API: Kolom baru
Kami telah menambahkan dua kolom baru, tampilan dan post_views, ke node [Video]. Lihat dokumentasi developer Video API untuk mempelajari selengkapnya.
Penghentian & Perubahan Sela
Transparansi Kesalahan
Perilaku default Graph API dan Marketing API adalah memunculkan kesalahan saat aplikasi meminta kolom atau edge pada node yang mengembalikan node atau node terkait, tetapi tidak memiliki izin yang sesuai yang diperlukan oleh node terkait. Namun, sejumlah kolom dan edge ini tidak mengikuti protokol ini dan malah dihilangkan begitu saja dari tanggapan API jika aplikasi pemanggil tidak memiliki izin yang sesuai.
Dimulai dengan v12.0 kolom dan edge ini akan sesuai dengan perilaku default. Perubahan ini akan diterapkan ke semua versi lainnya mulai 13 Desember 2021.
Pengguna sistem dan peran aplikasi
Kami menghentikan kemampuan pengguna sistem untuk diberikan peran di aplikasi kecuali pengguna dan aplikasi keduanya milik bisnis yang sama. Untuk mencegah gangguan pada aplikasi dan bisnis Anda, sebaiknya pengguna sistem ini dihapus dari aplikasi Anda dan gunakan API Bisnis Atas Nama sebagai gantinya. Perubahan sela ini akan mulai berlaku mulai 13 Desember 2021.
Siaran Langsung Terjadwal
Kami tidak lagi menggunakan parameter plan_start_time dalam kemampuan Penjadwalan di Live API dan perubahan sela akan berlaku mulai 13 Desember 2021. Parameter baru akan diumumkan di masa mendatang.
Platform Messenger: Conversation API
Kami tidak lagi menggunakan kolom user_id dari metadata utas di Conversation API. Semua developer perlu memigrasikan referensi apa pun ke user_id (IGID) dan sepenuhnya mengandalkan IGSID sebagai pengidentifikasi utama utas antara pengguna dan bisnis.
Perubahan sela ini akan berlaku pada versi Graph API sebelumnya mulai 13 Desember 2021. Lihat dokumentasi developer Conversation API untuk mempelajari selengkapnya.
Platform Messenger: Webhooks Instagram
Kami memperbarui Messenger API untuk Webhooks reaksi Instagram untuk mendukung reaksi emoji dengan lebih baik. Versi saat ini mengembalikan kolom emoji sebagai string - dengan pembaruan ini, Webhooks reaksi akan mengembalikan format unicode baru. Perhatikan bahwa kolom "reaksi" hanya akan mendukung emoji default. Untuk semua emoji lainnya, kolom reaksi akan menampilkan "lainnya", sama seperti MSGR.
Perubahan sela ini akan berlaku pada versi Graph API sebelumnya mulai 13 Desember 2021. Untuk terus mendukung reaksi emoji, semua developer harus bermigrasi ke unicode baru yang kami kembalikan paling lambat 13 Desember 2021. Silakan buka dokumentasi developer Webhooks untuk detailnya.
Penghentian Versi API:
Sebagai bagian dari jadwal versi Facebook untuk Graph API dan Marketing API, harap perhatikan penghentian yang akan datang:
Graph API
- 2 November 2021: Graph API v4.0 tidak berlaku lagi dan dihapus dari platform
- 3 Februari 2022: Graph API v5.0 tidak berlaku lagi dan dihapus dari platform
- 22 Mei 2022: Graph API v6.0 tidak berlaku lagi dan dihapus dari platform
Untuk menghindari gangguan pada bisnis Anda, kami rekomendasikan memigrasi semua panggilan ke API versi terbaru yang diluncurkan hari ini.
Marketing API
- Marketing API v10.0 akan tidak berlaku lagi mulai 4 Oktober 2021
- Marketing API v11.0 akan tidak berlaku lagi mulai 23 Februari 2022
Untuk menghindari gangguan pada bisnis Anda, sebaiknya migrasikan semua panggilan ke Marketing API versi terbaru yang diluncurkan hari ini. (Kunjungi catatan perubahan untuk detail selengkapnya).
Platform Facebook SDK
- Tanggal 19 Januari 2021, kami mengumumkan jadwal penghentian 2 tahun untuk Platform Facebook SDK v8.x ke bawah. Versi ini akan tidak berlaku lagi mulai Januari 2023.
- Tanggal 8 Juni 2021, kami merilis Platform Facebook SDK v11.0, yang memulai penghentian 2 tahun Platform Facebook SDK v9.0. SDK v9.0 akan tidak berlaku lagi mulai Juni 2023.
Penghentian Umum
Penghentian Endpoint Promo Native
Tanggal 8 Juni 2021, kami mengumumkan penghentian API Iklan Promo. Ini akan segera berlaku dengan rilis Graph API v12.0.
Platform Messenger - Template Maskapai
Tanggal 8 Juni 2021, kami mengumumkan penghentian template maskapai. Ini akan mulai berlaku mulai 6 Desember 2021.
