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 adalah versi minor pertama. Akhiran
nomor versi menunjukkan jenis versi: untuk versi utama selalu nol,
dan untuk versi minor selalu lebih besar dari nol.
Versi utama
Rilis utama memperkenalkan perubahan yang dapat menyebabkan gangguan, yaitu perubahan yang tidak kompatibel dengan versi sebelumnya.
Setiap versi utama memiliki endpoint terpisah, misalnya:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Saat mengupgrade dari satu versi utama ke versi utama lainnya, Anda mungkin perlu mengubah kode sebelum beralih ke endpoint versi utama yang baru.
Jika menggunakan library klien, Anda harus mengupgrade ke versi terbaru. Versi utama baru menyediakan panduan migrasi untuk membantu Anda memperbaiki perubahan yang dapat menyebabkan gangguan pada 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, misalnya, mengubah
0menjadi--sebagai nilai default. - Mengubah alasan error yang ditampilkan dari A ke B.
Versi minor
Versi minor hanya menerapkan perubahan yang kompatibel dengan versi lama.
Saat versi minor dirilis, endpoint yang sudah digunakan akan otomatis diperbarui. Ini tidak menyebabkan kode Anda rusak. Anda dapat terus menggunakan library klien yang ada.
Versi minor mencakup fitur baru atau update yang tidak memengaruhi kode yang sudah ada. 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 akan memposting pemberitahuan di grup Google searchads-api-announcements.