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, v25.0 (atau v25) adalah versi
utama, sedangkan v25.1 adalah versi minor.
Lihat catatan rilis untuk mengetahui detail versi saat ini dan sebelumnya.
Versi utama
Versi rilis utama memperkenalkan perubahan yang tidak kompatibel dengan versi sebelumnya dan dapat menyebabkan gangguan. 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. Di URL berikut, X adalah nomor versi utama (misalnya, v25):
https://googleads.googleapis.com/vX
Jika Anda melakukan upgrade 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 merusak kode.
Contoh perubahan yang merusak 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 ke B.
Versi minor
Versi minor hanya memperkenalkan perubahan yang kompatibel dengan versi sebelumnya. Untuk versi minor,
vMAJOR.MINOR memiliki nomor MINOR yang lebih besar dari nol (misalnya,
v25.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 terganggu.
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 layanan
Secara berkala, versi Google Ads API yang lebih lama dihentikan penggunaannya dan kemudian dihentikan:
- Tidak digunakan lagi: Saat versi utama (seperti
v25) dirilis, semua versi utama sebelumnya 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 endpointnya akan gagal.
Kami memposting pengumuman di blog developer sebelum penghentian penggunaan versi. Periksa jadwal penghentian penggunaan dan penghentian fitur untuk tanggal penghentian fitur yang aktif, tidak digunakan lagi, dan terjadwal.