Pembuatan versi semantik
Google Ads API mengikuti pembuatan versi semantik dengan
versi utama dan versi minor. Format versi adalah MAJOR.MINOR atau
vMAJOR_MINOR. Misalnya, v21_0 adalah versi utama, sedangkan
v21_1 adalah versi minor.
Lihat catatan rilis untuk versi sebelumnya.
Versi utama
Versi rilis utama memperkenalkan beberapa perubahan yang tidak kompatibel dengan versi sebelumnya dan dapat menyebabkan gangguan.
Versi akan berakhir dengan nol dengan format vX_0, dengan X adalah nomor versi utama.
Setiap versi utama memiliki endpoint terpisah. Dalam contoh URL ini, X adalah
nomor versi utama.
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 versi terbaru. Saat versi utama dirilis, kami akan memberikan panduan migrasi yang harus Anda pelajari untuk memperbaiki perubahan yang tidak kompatibel dalam kode Anda.
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 dari
0menjadi--sebagai 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 akan memiliki nomor MINOR yang lebih besar dari nol.
Saat versi minor dirilis, endpoint yang sudah digunakan akan otomatis diupdate. Hal ini tidak akan menyebabkan kode Anda rusak. Anda dapat terus menggunakan library klien yang ada.
Versi minor mencakup fitur atau update baru yang tidak memengaruhi kode yang ada. Jika Anda ingin menggunakan fitur baru ini, upgrade library klien Anda ke versi terbaru.
Matahari Terbenam
Secara berkala, versi Google Ads API yang lebih lama akan dihentikan. Kami akan memposting pemberitahuan di blog developer saat versi akan dihentikan. Jadwal penghentian penggunaan diperbarui dengan tanggal penghentian mendatang.