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 dalam kode.
Contoh perubahan yang menyebabkan error 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
0menjadi--sebagai nilai default. - Mengubah alasan error yang ditampilkan dari A ke B.
Versi minor
Versi minor hanya memperkenalkan perubahan yang kompatibel dengan versi sebelumnya.
Saat versi minor dirilis, endpoint yang sudah digunakan akan otomatis diperbarui. 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 ada. Jika ingin menggunakan fitur baru ini, Anda harus mengupgrade library klien ke versi terbaru.
Matahari Terbenam
Saat versi Search Ads 360 Reporting API lama dijadwalkan untuk dihentikan, kami akan memposting pemberitahuan di grup Google searchads-api-announcements.