Pembuatan versi semantik
Google Ads API mengikuti pembuatan versi semantik dengan menyertakan
versi utama dan minor. Format versi adalah MAJOR.MINOR
atau
vMAJOR_MINOR
. Misalnya, v17_0
adalah versi utama, sedangkan
v17_1
adalah versi minor.
Lihat catatan rilis untuk versi sebelumnya.
Versi utama
Versi rilis utama memperkenalkan beberapa perubahan yang dapat menyebabkan gangguan dan tidak kompatibel dengan versi sebelumnya.
Versi akan diakhiri dengan nol dengan format vX_0
dengan X
sebagai
nomor versi utama.
Setiap versi utama memiliki endpoint terpisah. Ini adalah contoh URL dengan
X
sebagai nomor versi utamanya.
https://googleads.googleapis.com/vX
Jika Anda mengupgrade dari versi utama yang lebih lama, kode mungkin memerlukan perubahan saat Anda beralih ke endpoint versi utama yang baru. Jika Anda menggunakan library klien, upgrade ke versi terbaru. Saat ada versi utama yang dirilis, kami akan memberikan panduan migrasi yang harus Anda pelajari untuk memperbaiki perubahan yang dapat menyebabkan gangguan pada kode Anda.
Contoh perubahan yang dapat menyebabkan gangguan mencakup:
- 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
0
menjadi--
sebagai 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
akan memiliki angka MINOR
yang lebih besar dari nol.
Saat versi minor dirilis, endpoint yang sudah digunakan akan otomatis diupdate. Hal ini tidak akan merusak kode Anda. Anda dapat terus menggunakan library klien yang sudah ada.
Versi minor mencakup fitur baru atau update yang tidak memengaruhi kode yang sudah ada. Jika Anda ingin menggunakan fitur baru ini, upgrade library klien ke versi terbaru.
Matahari Terbenam
Google Ads API versi lama harus dihentikan secara berkala. Kami akan memposting pemberitahuan di blog developer saat versi akan dihentikan. Jadwal penghentian diperbarui dengan tanggal penghentian di masa mendatang.