Pembuatan Versi

Pembuatan versi semantik

Google Ads API mengikuti pembuatan versi semantik dengan versi utama dan minor. Format versinya adalah MAJOR.MINOR atau vMAJOR_MINOR. Misalnya, v11_0 adalah versi utama, sedangkan v11_1 adalah versi minor.

Lihat catatan rilis untuk versi sebelumnya.

Versi utama

Versi rilis utama memperkenalkan beberapa perubahan yang tidak kompatibel dan mundur. Versi akan diakhiri dengan nol dengan format vX_0 dengan X adalah nomor versi utama.

Setiap versi utama memiliki endpoint terpisah. Ini adalah contoh URL dengan X sebagai nomor versi utama.

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, upgrade ke versi terbaru. Jika ada versi utama yang dirilis, kami akan memberikan panduan migrasi yang harus Anda perbaiki untuk memperbaiki setiap perubahan yang dapat menyebabkan gangguan dalam kode.

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 dari 0 ke -- 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 angka MINOR 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 sudah ada. Jika Anda ingin menggunakan fitur-fitur baru ini, upgrade library klien ke versi terbaru.

Matahari Terbenam

Google Ads API versi lama secara berkala harus dihentikan. Kami akan memposting pemberitahuan di blog developer saat versi akan dihentikan. Jadwal penghentian diperbarui dengan tanggal penghentian matahari mendatang.