Search Ads 360 Reporting API menggunakan pembuatan versi semantik.
Ada versi utama dan minor, yang diformat sebagai
vMAJOR_MINOR. Misalnya, v0_0 adalah
versi utama pertama, dan v0_1 versi minor pertama. Akhiran dari
nomor versi menunjukkan jenis versi: untuk versi utama selalu nol,
dan untuk versi minor, nilainya selalu lebih besar dari nol.
Versi utama
Rilis besar memperkenalkan perubahan yang dapat menyebabkan gangguan, yaitu perubahan yang kompatibel dengan teknologi lama.
Setiap versi utama memiliki endpoint terpisah, misalnya:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Saat meningkatkan dari satu versi utama ke versi lainnya, Anda mungkin perlu mengubah kode sebelum beralih ke endpoint versi utama yang baru.
Jika Anda menggunakan library klien, Anda harus meningkatkan ke versi terbaru. Versi utama yang baru menyediakan panduan migrasi untuk membantu Anda memperbaiki perubahan yang dapat menyebabkan gangguan pada kode.
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
0menjadi--sebagai nilai default. - Mengubah alasan error yang ditampilkan dari A ke B.
Versi minor
Versi minor hanya memperkenalkan perubahan yang kompatibel dengan versi lama.
Saat versi minor dirilis, endpoint yang sudah digunakan diperbarui secara otomatis. Hal ini tidak menyebabkan kode Anda rusak. Anda dapat melanjutkan untuk menggunakan library klien yang ada.
Versi minor mencakup fitur baru atau update yang tidak memengaruhi yang sudah ada pada kode sumber. Jika ingin menggunakan fitur baru ini, Anda harus mengupgrade library klien ke versi terbaru .
Matahari Terbenam
Saat Search Ads 360 Reporting API versi lama dijadwalkan untuk dihentikan, kami posting pemberitahuan di grup Google searchads-api-announcements.