Pembuatan versi semantik
Google Ads API mengikuti pembuatan versi semantik dengan nomor versi utama dan minor. Versi ditulis sebagai MAJOR.MINOR atau vMAJOR.MINOR.
Misalnya, v26.0 (atau v26) adalah versi utama, sedangkan v26.1 adalah versi minor.
Lihat catatan rilis untuk mengetahui detail tentang versi saat ini dan versi sebelumnya.
Versi utama
Versi rilis utama memperkenalkan perubahan yang dapat menyebabkan gangguan dan tidak kompatibel dengan versi lama. Rilis
awal versi utama diakhiri dengan angka nol (vX.0, atau vX, dengan X adalah
nomor versi utama).
Setiap versi utama memiliki jalur endpoint REST dan gRPC terpisah (vX), yang tidak
menyertakan akhiran versi minor. Dalam URL berikut, X adalah nomor versi utama (misalnya, v26):
https://googleads.googleapis.com/vX
Jika Anda mengupgrade dari versi utama yang lebih lama, kode Anda mungkin memerlukan perubahan saat Anda beralih ke endpoint versi utama yang baru. Jika Anda menggunakan library klien kami, upgrade ke rilis library klien yang mendukung versi utama baru. Saat versi utama dirilis, kami menyediakan panduan upgrade untuk membantu Anda menyelesaikan perubahan yang dapat menyebabkan gangguan dalam kode Anda.
Contoh perubahan yang dapat menyebabkan gangguan meliputi:
- Menghapus atau mengganti nama layanan, antarmuka, kolom, metode, atau nilai enum.
- Mengubah jenis kolom.
- Mengubah format nama resource.
- Mengubah format URL dalam definisi HTTP.
- Mengubah format output, seperti mengubah nilai default.
- Mengubah alasan error yang ditampilkan dari A menjadi B.
Versi minor
Versi minor hanya memperkenalkan perubahan yang kompatibel dengan versi lama. Untuk versi minor,
vMAJOR.MINOR memiliki nomor MINOR yang lebih besar dari nol (misalnya,
v26.1).
Saat versi minor dirilis, endpoint versi utama yang ada
(https://googleads.googleapis.com/vX) akan otomatis diupdate di tempat. Anda tidak perlu mengubah jalur versi di URL endpoint, dan kode yang ada akan terus berfungsi tanpa gangguan.
Versi minor menambahkan fitur atau update yang tidak memengaruhi kode yang ada. Untuk menggunakan kolom atau fitur dari versi minor dengan library klien, upgrade library klien Anda ke rilis yang menyertakan definisi versi minor.
Penghentian penggunaan dan penghentian
Secara berkala, versi Google Ads API yang lebih lama tidak digunakan lagi dan kemudian dihentikan:
- Tidak digunakan lagi: Saat versi utama (seperti
v26) dirilis, semua versi utama sebelumnya akan ditandai sebagai tidak digunakan lagi. Panggilan API ke versi yang tidak digunakan lagi akan terus berhasil hingga tanggal penghentiannya, dan rilis library klien yang ada akan terus mendukungnya, meskipun rilis library klien berikutnya akan menghilangkan versi API yang tidak digunakan lagi untuk mengurangi ukuran paket. - Penghentian: Versi dinonaktifkan pada tanggal penghentiannya, dan semua panggilan API ke endpoint-nya akan gagal.
Kami memposting pengumuman di blog developer sebelum penghentian versi. Periksa jadwal penghentian penggunaan dan penghentian untuk tanggal penghentian yang aktif, tidak digunakan lagi, dan dijadwalkan.