Bermigrasi dari Bid Manager API v1.1 ke v2

Pada Maret 2022, kami merilis Bid Manager API versi 2. Mengingat rilis versi baru ini, kami berencana untuk segera mengumumkan tanggal penghentian untuk v1.1. Rab Sebaiknya mulai migrasi dari v1.1 ke v2 sesegera mungkin.

Memigrasikan aplikasi Anda

Migrasi dari v1.1 ke v2 memerlukan update URL endpoint untuk memanggil v2, dan memperbarui aplikasi untuk memperhitungkan perubahan yang dapat menyebabkan gangguan.

Mengupdate panggilan API dari v1.1 ke v2

Untuk menggunakan v2, bukan v1.1, Anda harus memperbarui permintaan agar menggunakan v2 baru endpoint.

Mengidentifikasi metode ekuivalen

Untuk memperbarui panggilan API agar tidak menggunakan v1.1 ke v2, pertama-tama Anda harus mengidentifikasi metode v1.1 yang setara dalam v2.

Nama semua layanan dan metode berikut telah sedikit berubah antara v1.1 dan v2:

Perubahan ke endpoint baru

Setelah mengidentifikasi metode yang setara, Anda perlu memperbarui permintaan Anda. Sebagai misalnya, untuk memanggil metode queries.getquery dengan v1.1, Anda akan menggunakan URL berikut:

https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId

Untuk memanggil metode yang setara di v2, yang dikenal sebagai queries.get, update URL ke:

GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId

Jika Anda menggunakan library klien untuk membuat permintaan ke API, gunakan versi terbaru pustaka klien dan perbarui konfigurasi Anda untuk menggunakan v2.

Membuat perubahan yang diperlukan

Kami memperkenalkan sejumlah perubahan yang dapat menyebabkan gangguan di v2. Tinjau hal berikut dan membuat perubahan yang diperlukan relevan dengan penggunaan Anda atas API Bid Manager.

Update panggilan ke layanan queries

Update panggilan ke layanan reports

Memperbarui logika penanganan error

Pesan error di seluruh API telah diperbarui di v2. Pesan {i>error<i} baru ini lebih spesifik dan, dalam beberapa kasus, memberikan informasi tentang nilai dalam Permintaan API yang menyebabkan error ditampilkan. Jika pesan error yang ada logika penanganan mengandalkan teks pesan error tertentu, menggeneralisasi error Anda ditangani sebelum bermigrasi ke v2.