Perubahan yang akan datang dalam penghentian versi Marketing API untuk mengaktifkan peningkatan versi secara otomatis
Untuk meningkatkan pengalaman API secara keseluruhan dengan membuatnya lebih mulus dan efisien, kami dengan senang hati mengumumkan peluncuran fitur peningkatan otomatis versi MAPI yang akan datang. Mulai Mei 2024, kami akan mengaktifkan fitur peningkatan versi otomatis untuk endpoint Marketing API yang tidak terpengaruh antarversi. Ini berarti antara versi yang akan dihentikan dan versi berikutnya yang tersedia, jika endpoint tidak terpengaruh, platform akan secara otomatis meningkatkan panggilan ke versi berikutnya yang tersedia, alih-alih secara langsung menggagalkan permintaan.
Peningkatan versi API adalah cara yang umum untuk menangani perubahan pada API. Cara ini paling sering digunakan untuk mengirimkan perubahan yang dapat menyebabkan gangguan. Saat versi baru dirilis, versi yang lebih lama dihentikan. Selama penghentian API, jika aplikasi memanggil versi API yang sudah dihentikan, aplikasi akan menerima kesalahan '(#2635) Anda memanggil versi API Iklan yang sudah dihentikan. Harap perbarui ke versi terbaru: vXXX'.
Pada tanggal 14 Mei 2024, v17.0 akan dihentikan. Menurut catatan perubahan v18.0, endpoint berikut ini akan terpengaruh:
- POST /act_{ad-account-id}/reachfrequencypredictions
- GET /act_{ad-account-id}/reachestimate
- GET /act_{ad-account-id}/delivery_estimate
- POST /act_{ad-account-id}/adsets
- POST /{adset-id}
- POST /act_{ad-account-id}/saved_audiences
- POST /{saved-audience-id}
- POST /act_{ad-account-id}/credit_cards
Jika aplikasi Anda memanggil POST /{adset-id} dengan v17.0 setelah v17.0 dihentikan pada 14 Mei 2024, permintaan api ini akan gagal karena peningkatan otomatis tidak akan diterapkan pada endpoint yang terpengaruh oleh versi v18.0 yang akan datang.
Jika aplikasi Anda memanggil GET /{ad-account-id}/insights dengan v17.0 setelah v17.0 dihentikan, platform akan meningkatkan panggilan Anda ke versi berikutnya yang tersedia, yaitu v18.0.
Jika aplikasi Anda sudah melakukan panggilan dengan versi yang lebih tinggi dari v17.0, tidak ada yang akan berubah pada tanggal penghentian versi.
Untuk tidak memilih peningkatan versi secara otomatis, silakan periksa Pengaturan > Pengaturan Versi API Iklan di bagian kartu Produk Aplikasi Marketing API untuk menonaktifkan fitur ini.
Untuk mengonfirmasi apakah panggilan telah ditingkatkan secara otomatis, silakan periksa header tanggapan API untuk detail selengkapnya.
- Contoh header notifikasi: ‘X-Ad-Api-Version-Warning:‘ Panggilan telah ditingkatkan secara otomatis ke v17.0 karena v16.0 sudah dihentikan’’
Untuk mempelajari selengkapnya tentang perilaku ini, lihat Peningkatan Versi Marketing API.
Untuk memeriksa endpoint yang terpengaruh pada setiap versi, harap lihat Catatan perubahan.
Endpoint yang terkena dampak
- Semua endpoint MAPI
Tautan ke dokumentasi developer
Tautan ke artikel bantuan tentang fitur
