Memperkenalkan Graph API v26.0 dan Marketing API v26.0

29 Juli 2026

Memperkenalkan Graph API v26.0 dan Marketing API v26.0

Oleh Ayyad Farah, Manjari Jain

Graph API v26.0 dan Marketing API v26.0 mencakup kemampuan baru, penghentian, dan perubahan sela. Baca sorotan di bawah ini dan buka catatan perubahan V26.0 untuk daftar lengkap perubahan dan detailnya.

Tanggal dan perubahan penting

Graph API - Pengelolaan Orderan Perdagangan: Panggilan ke endpoint yang terpengaruh pada v26.0 dan setelahnya diblokir mulai 29 Juli 2026. Endpoint dihapus dari semua versi Graph API yang tersisa pada 27 Oktober 2026. Setelah itu, panggilan akan menampilkan kesalahan. Tidak ada API pengganti yang tersedia.
Graph API - Kolom pemilik Pengelola Hak: Dimulai dengan v26.0 pada 29 Juli 2026, kolom pengganti yang mengembalikan jenis RightsHolderOwner tersedia dan kolom pemilik yang dihentikan tidak lagi dikembalikan. Kolom yang dihentikan tetap tersedia di v25.0 dan yang lebih lama selama dua tahun setelah peluncuran v26.0.
Graph API - Fitur protokol lama: Lima perilaku lama akan dihapus dari panggilan v26.0 mulai 29 Juli 2026. Perilaku yang sama berlaku untuk semua versi Graph API yang didukung mulai 27 Oktober 2026.
Marketing API - Iklan di Status WhatsApp: v26.0 menambahkan kemampuan identitas, penargetan, optimasi, dan materi iklan yang diperluas mulai 29 Juli 2026.
Marketing API - Audiens Advantage+ untuk kampanye Perumahan, Lowongan Kerja, dan Produk dan Layanan Keuangan: Dimulai dengan v26.0 pada 29 Juli 2026, set iklan baru atau yang disalin dengan penargetan terbatas harus secara eksplisit mengatur advantage_audience ke 1 atau 0. Penyiapan default atau longgar akan tetap mengatur default-nya ke 1, dan pembaruan set iklan yang ada tidak akan terpengaruh.
Marketing API - Kabar Jelajahi Instagram: Penempatan ini tidak lagi tersedia mulai v26.0 pada 29 Juli 2026. Developer harus menghapus Jelajahi dari konfigurasi penempatan mereka.
Marketing API - Destinasi khusus web untuk kampanye Web+Aplikasi: Dimulai dengan v26.0 pada 29 Juli 2026, iklan tidak bisa menggunakan materi iklan dengan applink_treatment yang diatur ke web_only saat kampanye menggunakan lokasi konversi Situs Web dan Aplikasi. Pembatasan ini berlaku untuk semua versi Marketing API pada 27 Oktober 2026.
Marketing API - Messenger Stories: Dimulai dengan panggilan versi v26.0 pada 29 Juli 2026, nilai story secara diam-diam dihapus dari messenger_positions saat membuat atau memperbarui set iklan. Penghentian ini berlaku untuk semua versi Marketing API, termasuk panggilan yang tidak berversi, pada 27 Oktober 2026.
Marketing API - Pembuatan iklan polling: Dimulai dengan v26.0 pada 29 Juli 2026, permintaan yang membuat materi iklan polling atau mengubah iklan untuk menggunakan polling ditolak. Pembaruan iklan yang tidak mengubah materi iklan tetap didukung. Penghentian ini berlaku untuk semua versi Marketing API pada 27 Oktober 2026.
Graph API dan Marketing API - Kolom Estimasi Penayangan: Kolom tanggapan daily_outcomes_curve, budget_guardrail, dan estimate_dau dihapus dari panggilan v26.0 mulai 29 Juli 2026, dan dari semua versi yang didukung pada 27 Oktober 2026. Tidak ada API pengganti yang tersedia.
Penghentian versi Graph API: Graph API v20.0 dihentikan dan dihapus pada 24 September 2026. Graph API v21.0 dihentikan dan dihapus pada 21 Januari 2027.

Pembaruan Umum

Marketing API: Dukungan Iklan yang Diperluas di Status WhatsApp

Dimulai dengan Marketing API v26.0 pada 29 Juli 2026, Iklan di Status WhatsApp mendukung kemampuan identitas, penargetan, optimasi, dan materi iklan tambahan.

Identitas WhatsApp: Penelepon Marketing API pihak ketiga harus secara eksplisit menyertakan wamo_whatsapp_identity_spec dalam materi iklan yang ditujukan untuk penayangan Iklan di Status WhatsApp. Identitas WhatsApp tidak diatur secara otomatis sebagai default bagi penelepon ini.
Penargetan usia tidak diketahui: Saat penempatan Status WhatsApp dipilih dan user_age_unknown tidak ditetapkan, kolom ini akan diatur secara default ke true, artinya kampanye dapat menjangkau orang di WhatsApp yang usianya tidak diketahui.
Optimasi: Optimasi Konversi untuk konversi di luar situs didukung di seluruh tujuan Penjualan, Prospek, dan Interaksi. Optimasi Tayangan Halaman Tujuan juga didukung.
Format materi iklan: Iklan carousel mendukung hingga 10 kartu.

Lihat dokumentasi penargetan penempatan dan penargetan dasar untuk mengetahui detailnya.

Penghentian & Perubahan Sela

Graph API dan Marketing API: Penghapusan kolom Estimasi Penayangan

Kolom daily_outcomes_curve, budget_guardrail, dan estimate_dau dihapus dari tanggapan endpoint Estimasi Penayangan karena layanan yang mendukung nilai-nilai ini telah dihentikan. Dimulai dengan Graph API v26.0 dan Marketing API v26.0 pada 29 Juli 2026, kolom ini tidak akan dikembalikan lagi. Perubahan ini akan berlaku untuk semua versi Graph API dan Marketing API yang didukung pada 27 Oktober 2026. Tidak ada API pengganti yang tersedia.

Developer harus menghapus setiap penggunaan atau referensi di kolom ini sebelum tanggal penghapusan yang berlaku.

Endpoint terdampak yang mewakili mencakup:

GET /{ad-account-id}/delivery_estimate - Estimasi penayangan akun iklan
GET /{adset-id}/delivery_estimate - Estimasi penayangan set iklan

Daftar lengkap kolom dan endpoint akan tersedia di catatan perubahan V26.0.

Graph API: Penghentian Commerce Order Management API

Aplikasi yang memanggil endpoint ini pada Graph API v26.0 dan yang lebih baru akan diblokir mulai 29 Juli 2026. Endpoint akan dihapus untuk semua versi Graph API yang tersisa pada 27 Oktober 2026. Setelah itu, panggilan akan menampilkan kesalahan.

Pengalaman proses checkout langsung di Facebook dan Instagram untuk Toko telah dihentikan sepenuhnya. Commerce Order Management API memungkinkan platform pihak ketiga untuk membuat daftar orderan, melihat detail orderan, mengelola pengiriman, memproses pembatalan, menangani pengembalian dana, dan melacak retur untuk pengalaman checkout tersebut. Karena infrastruktur pesanan perdagangan yang mendasarinya akan dihentikan, endpoint ini akan dihentikan.

Developer harus berhenti memanggil endpoint ini dan menghapus dependensinya. Tidak ada API pengganti yang tersedia.

Endpoint terdampak yang mewakili mencakup:

GET /{commerce-order-id} - Detail pesanan
GET /{commerce-order-id}/items - Item baris pesanan
GET /{commerce-order-id}/payments - Order payments
GET /{commerce-order-id}/payment_transaction_details - Detail transaksi pembayaran
GET /{commerce-order-id}/refunds - Pengembalian dana orderan
GET /{commerce-order-id}/shipments - Pengiriman pesanan
GET /{commerce-order-shipment-id}/items - Item lini pengiriman
GET /{commerce-return-id} - Return details
GET /{commerce-order-cancellation-id}/items - Cancellation line items
GET /{page-id}/commerce_orders - Daftar pesanan berdasarkan Halaman
GET /{commerce-merchant-settings-id}/commerce_orders - Daftar pesanan berdasarkan Pengaturan Merchant Perdagangan
GET /{commerce-merchant-settings-id}/commerce_returns - Daftar retur berdasarkan Pengaturan Merchant Perdagangan
GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

Daftar lengkap 47 endpoint yang terpengaruh akan tersedia di catatan perubahan Graph API v26.0.

Graph API: Kolom pemilik Pengelola Hak dipindahkan ke RightsHolderOwner

Kolom reference_owner dan matched_reference_owner di AudioVisualReferenceMatch dan ImageReferenceMatch, serta kolom sending_rights_holder dan receiving_rights_holder di CopyrightOwnershipTransfer, akan dihentikan. Dimulai dengan Graph API v26.0, kolom pengganti yang mengembalikan jenis RightsHolderOwner khusus tersedia agar lebih mencerminkan model kepemilikan yang digunakan oleh Rights Manager, dan kolom yang dihentikan tidak lagi ditampilkan dalam tanggapan v26.0 dan yang lebih baru.

Kolom yang dihentikan akan tetap berfungsi di v25.0 dan versi lebih lama selama dua tahun setelah peluncuran v26.0, lalu kolom tersebut akan dihapus. Developer harus beralih ke kolom pengganti selama periode dua tahun ini.

Gunakan kolom pengganti berikut:

Gunakan reference_owner_rh_owner, bukan reference_owner.
Gunakan matched_reference_owner_rh_owner bukannya matched_reference_owner.
Gunakan sending_rights_holder_owner bukannya sending_rights_holder.
Gunakan receiving_rights_holder_owner bukannya receiving_rights_holder.

Endpoint terdampak yang mewakili mencakup:

GET /{audio-visual-reference-match-id} - Detail kecocokan referensi
GET /{image-reference-match-id} - Detail kecocokan referensi gambar
GET /{copyright-ownership-transfer-id} - Ownership transfer details

Daftar kolom lengkap akan tersedia di catatan perubahan Graph API v26.0.

Graph API: Fitur protokol lama dihentikan

Mulai 29 Juli 2026, Graph API v26.0 dan yang lebih baru tidak lagi mendukung lima perilaku protokol lama: pretty, debug, date_format, permintaan root GET /?ids=..., dan penanganan lama If-None-Match / ETag.

Perilaku ini akan dihentikan untuk menyederhanakan tanggapan Graph API dan membuat penanganan permintaan lebih konsisten.

Untuk Graph API v26.0 dan setelahnya:

pretty diabaikan, dan tanggapan JSON menggunakan format ringkas. Format JSON di alat atau kode klien.
debug diabaikan, dan tidak ada envelope tanggapan debug yang ditambahkan. Gunakan alat debugging standar. Endpoint debug_token tidak terpengaruh.
Permintaan yang menyertakan date_format akan menampilkan kesalahan parameter. Gunakan format tanggal default dan konversikan nilai secara lokal jika perlu.
Permintaan root yang menggunakan GET /?ids=... akan mengembalikan kesalahan parameter. Gunakan permintaan per objek atau batching yang didukung.
If-None-Match diabaikan. Header tanggapan ETag dan perilaku 304 Not Modified versi lama dihapus, dan permintaan mengembalikan tanggapan lengkap.

Mulai 27 Oktober 2026, perubahan ini berlaku untuk semua versi Graph API yang didukung. Tinjau catatan permintaan runtime dan catatan perubahan Graph API v26.0 untuk detail migrasi.

Penghentian kolom Halaman lama untuk Pengalaman Halaman Baru (Graph API v26.0)

Draf postingan blog developer. Rilis target: Graph API v26.0. Jenis perubahan: Penghentian (90 hari).

Ringkasan

Untuk halaman Pengalaman Halaman Baru, lima kolom node Halaman lama (current_location, genre, network, parking, start_info) dan pengaturan Halaman auto_publish_page_info_updates tidak akan berlaku lagi mulai Graph API v26.0. Kolom ini tidak lagi dikelola dan tidak boleh diakses untuk halaman Pengalaman Halaman Baru.

Jadwal

29 Juli 2026: Kolom ini diblokir dan pengaturannya dihapus di versi v26.0 dan yang lebih baru untuk halaman Pengalaman Halaman Baru.
Sekitar 90 hari setelah peluncuran: Perubahan yang sama berlaku untuk semua versi yang tersisa. Tanggal pastinya pada akhir Oktober 2026 akan segera dikonfirmasi.

Apa yang berubah

Di v26.0 dan setelahnya, meminta salah satu dari lima kolom ini di halaman Pengalaman Halaman Baru akan menampilkan kesalahan versi, dan pengaturan auto_publish_page_info_updates tidak akan muncul lagi di tanggapan pengaturan Halaman. Pada versi sebelumnya, perilaku tidak berubah hingga periode migrasi 90 hari berakhir. Setelah itu, hal yang sama berlaku untuk semua versi.

Endpoint yang terpengaruh:

GET /{page-id}?fields=current_location
GET /{page-id}?fields=genre
GET /{page-id}?fields=network
GET /{page-id}?fields=parking
GET /{page-id}?fields=start_info
GET /{page-id}?fields=settings - pengaturan auto_publish_page_info_updates dihapus dari daftar pengaturan yang dikembalikan

Yang harus dilakukan developer

Hapus kolom ini dan pengaturan auto_publish_page_info_updates dari permintaan Halaman Anda.
Periksa penggunaan kolom ini di halaman Pengalaman Halaman Baru pada log permintaan, integrasi klien, dan dasbor Anda.
Lihat catatan perubahan Graph API v26.0 untuk daftar lengkap dan terbaru.

Referensi

Referensi node halaman

Marketing API: Persyaratan Audiens Advantage+ untuk kampanye Perumahan, Lowongan Kerja, dan Produk dan Layanan Keuangan

Mulai 29 Juli 2026, dengan Marketing API v26.0, parameter advantage_audience dalam targeting_automation akan secara otomatis diatur default ke 1 untuk penyiapan audiens yang sepenuhnya default atau longgar. Untuk penyiapan audiens yang dibatasi, developer harus secara eksplisit mengatur advantage_audience ke 1 atau 0 untuk kampanye dalam kategori iklan khusus Perumahan, Lowongan Kerja, atau Produk dan Layanan Keuangan.

Perilaku ini berlaku hanya saat membuat set iklan baru. Memperbarui set iklan yang ada tidak akan menampilkan perilaku ini pada versi API apa pun.

Ini adalah perilaku yang sama yang diperkenalkan untuk kampanye di luar Kategori Iklan Khusus di Marketing API v23.0. Lihat dokumentasi pemecahan masalah Audiens Advantage+ untuk detailnya.

Endpoint API berikut terpengaruh:

POST /{ad-account-id}/adsets
POST /{adset-id}
POST /{adset-id}/copies

Marketing API: Penempatan iklan Jelajahi tidak tersedia lagi

Dimulai dengan Marketing API v26.0 pada 29 Juli 2026, penempatan Kabar Jelajahi Instagram tidak akan tersedia lagi. Penayangan ke Jelajahi akan dihentikan, dan pengeluaran kampanye akan dialihkan secara otomatis ke penempatan lain yang memenuhi syarat.

Mencoba membuat atau memperbarui set iklan yang menentukan penempatan Jelajahi akan menampilkan kesalahan. Developer harus menghapus Jelajahi dari konfigurasi penempatan dan menggunakan penempatan lain yang memenuhi syarat.

Endpoint berikut terpengaruh:

POST /act_{ad-account-id}/adsets
POST /{ad-set-id}

Marketing API: Penghentian destinasi khusus web untuk kampanye Web+Aplikasi

Mulai 29 Juli 2026, dengan Marketing API v26.0, developer tidak akan bisa lagi melampirkan materi iklan dengan applink_treatment yang diatur ke web_only pada iklan dalam kampanye yang menggunakan lokasi konversi Situs Web dan Aplikasi. Hal ini memengaruhi pembuatan dan pembaruan iklan melalui POST /act_{ad-account-id}/ads dan POST /{ad-id}.

Endpoint Materi Iklan tidak berubah, tetapi POST /act_{ad-account-id}/adcreatives adalah tempat nilai applink_treatment dikonfigurasi. Developer harus meninjau integrasi mereka untuk applink_treatment=web_only dan menggunakan pemilihan destinasi otomatis atau destinasi manual lain yang kompatibel untuk kampanye Situs Web dan Aplikasi.

Pada 27 Oktober 2026, 90 hari setelah perilisan v26.0, pembatasan ini akan berlaku untuk semua versi Marketing API. Lihat dokumentasi Iklan dan Materi Iklan untuk informasi selengkapnya.

Marketing API: Penempatan Messenger Stories dihentikan

Dimulai dengan Marketing API v26.0 pada 29 Juli 2026, nilai story di messenger_positions tidak akan tersedia lagi saat membuat atau memperbarui set iklan melalui panggilan versi v26.0 atau yang lebih baru.

Untuk panggilan ini, story akan dihapus diam-diam dari spesifikasi penargetan dan tidak akan lagi muncul di penempatan yang efektif untuk set iklan baru atau yang sudah ada. Data penargetan historis mungkin terus menyertakan story saat diminta melalui GET /{ad_set-id}?fields=targeting. Tidak ada kesalahan khusus yang akan ditampilkan, tetapi kesalahan validasi penempatan standar dapat berlaku jika penghapusan story meninggalkan konfigurasi penempatan yang tidak valid.

Endpoint berikut terpengaruh:

POST /act_{ad-account-id}/adsets
POST /{ad_set-id}

Developer yang menggunakan penempatan manual harus menghapus story dari messenger_positions. Jika ini satu-satunya nilai, hapus seluruh kolom messenger_positions dan pertimbangkan untuk menghapus messenger dari publisher_platforms jika tidak ada penempatan Messenger lainnya, seperti marketing_messages, yang digunakan. Tidak diperlukan tindakan untuk Penempatan Advantage+.

Perubahan khusus API ini tidak memengaruhi Pengelola Iklan. Panggilan yang tidak berversi dan panggilan ke versi sebelum v26.0 pada awalnya tidak terpengaruh. Pada 27 Oktober 2026, 90 hari setelah rilis v26.0, penghentian akan berlaku untuk semua versi Marketing API, termasuk panggilan yang tidak berversi.

Marketing API: Pembuatan iklan polling dihentikan

Dimulai dengan Marketing API v26.0 pada 29 Juli 2026, komponen polling tidak akan lagi didukung saat membuat atau memperbarui iklan dan materi iklan. Kolom poll_spec dan nilai "poll" untuk kolom type tidak akan tersedia lagi di bagian interactive_components_spec.

Permintaan yang membuat materi iklan polling atau mengubah iklan untuk menggunakan polling akan ditolak. Pembaruan terhadap iklan yang ada tetapi tidak mengubah materi iklannya, seperti perubahan status, anggaran, atau jadwal, bisa dilanjutkan.

Endpoint berikut terpengaruh:

Developer harus menghapus kolom terkait polling dari spesifikasi materi iklan mereka dan menggunakan materi iklan tanpa komponen polling. Panggilan ke versi sebelum v26.0 dan panggilan tanpa versi awalnya tidak terpengaruh.

Pada 27 Oktober 2026, 90 hari setelah rilis v26.0, penghentian ini akan berlaku untuk semua versi Marketing API.

Rilis Meta Business SDK v26

Rilis Meta Business SDK v26 akan segera diterbitkan setelah rilis Graph API v26. Perilisan ini mencakup peningkatan dependensi, integrasi Builder Parameter Conversions API, fitur API baru, dan penghentian Commerce Order Management API dan beberapa fitur protokol lama.

Business SDK sekarang terintegrasi dengan Conversions API Parameter Builder sumber terbuka. Anda bisa memanfaatkan integrasi baru ini untuk meningkatkan kualitas integrasi Conversions API Anda. Fitur utama: Membuat parameter secara otomatis (dibatasi oleh preferensi yang ditetapkan oleh pengiklan) dan menyempurnakan parameter fbc, fbp, event_source_url, referrer_url, client_ip_address dan normalisasi/hashing PII otomatis untuk bahasa yang didukung, lihat selengkapnya di sini. Commerce Order Management API (47 endpoint) dihentikan sepenuhnya tanpa pengganti. Penempatan iklan Kabar Jelajahi Instagram dihapus dan menampilkan kesalahan jika ditentukan. Penempatan Messenger Stories secara diam-diam dihapus dari messenger_positions. Iklan di Status WhatsApp mendapatkan kemampuan baru termasuk spesifikasi identitas, carousel hingga 10 kartu, dan optimasi konversi di luar situs.

Sebagai bagian dari jadwal penghentian 2 tahun kami untuk SDK Platform, harap perhatikan penghentian dan rencana penghentian yang akan datang: