Pembuatan Versi

Pembuatan versi semantik

Google Ads API mengikuti pembuatan versi semantik jika ada 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 angka nol dengan format vX_0 dengan X sebagai file nomor versi aplikasi.

Setiap versi utama memiliki endpoint terpisah. Ini adalah contoh URL di mana X adalah nomor versi utama.

https://googleads.googleapis.com/vX

Jika Anda meningkatkan dari versi utama yang lebih lama, kode Anda mungkin memerlukan berubah saat Anda beralih ke endpoint versi utama yang baru. Jika Anda menggunakan library klien, lalu upgrade ke versi terbaru. Saat versi utama dirilis, kami akan memberikan panduan migrasi yang Anda harus memperbaiki setiap perubahan yang dapat menyebabkan gangguan dalam 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 ke 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.

Ketika versi minor dirilis, endpoint yang sudah digunakan akan diperbarui secara otomatis. Hal ini tidak akan merusak kode Anda. Anda dapat untuk terus menggunakan library klien yang ada.

Versi minor mencakup fitur baru atau update yang tidak memengaruhi dari 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 suatu versi akan segera dihentikan. Tujuan jadwal penghentian diperbarui dengan penghentian di masa mendatang tanggal.