Bermigrasi dari v2 ke v3

Terakhir diperbarui: 31-10-2023

Memigrasikan aplikasi Anda

Migrasi dari v2 ke v3 memerlukan update URL endpoint untuk memanggil v3 dan mengupdate aplikasi untuk memperhitungkan perubahan yang dapat menyebabkan gangguan.

Mengupdate panggilan API dari v2 ke v3

Untuk menggunakan v3, bukan v2, Anda harus memperbarui permintaan untuk menggunakan endpoint v3 yang baru.

Misalnya, untuk memanggil metode advertisers.get dengan v2, gunakan URL berikut:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Untuk v3, perbarui URL menjadi berikut:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Jika Anda menggunakan library klien untuk membuat permintaan ke API, gunakan versi library klien terbaru dan update konfigurasi Anda untuk menggunakan v3.

Membuat perubahan yang diperlukan

Kami memperkenalkan sejumlah perubahan yang dapat menyebabkan gangguan di v3. Tinjau petunjuk berikut dan buat perubahan yang diperlukan sesuai dengan penggunaan Display & Video 360 API oleh Anda saat ini.

Memperbarui panggilan yang mengambil resource YouTube dan penargetan terkaitnya

• Resource YoutubeAdGroup dan YoutubeAdGroupAd telah diganti dengan resource AdGroup dan AdGroupAd. Resource baru ini memberikan informasi yang hampir sama dengan resource v2, tetapi dapat menggunakan nama kolom atau jenis enum yang diperbarui. Dalam integrasi Anda, ganti penggunaan resource YoutubeAdGroup atau YoutubeAdGroupAd dengan resource AdGroup dan AdGroupAd serta perbarui panggilan ke layanan v2 berikut ke layanan v3 yang sesuai:
  • advertisers.youtubeAdGroupAds ke advertisers.adGroupAds
  • advertisers.youtubeAdGroups ke advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions hingga advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Referensi ke objek YoutubeAndPartnersBiddingStrategy telah dipindahkan ke kolom youtubeAndPartnersBid baru dalam objek BiddingStrategy umum. Kolom biddingStrategy telah dihapus dari objek YoutubeAndPartnersSettings. Perbarui integrasi Anda untuk mengambil strategi bidding untuk item baris atau grup iklan YouTube dari objek BiddingStrategy di kolom bidStrategy pada resource LineItem atau AdGroup.
• Nama kolom thirdPartyMeasurementSettings telah diganti menjadi thirdPartyMeasurementConfigs di objek YoutubeAndPartnersSettings dan objek YoutubeAndPartnersThirdPartyMeasurementSettings diganti namanya menjadi ThirdPartyMeasurementConfigs. Perbarui integrasi Anda untuk mengambil informasi konfigurasi pengukuran pihak ketiga menggunakan kolom dan objek baru.

Menyertakan konfigurasi penagihan yang diperlukan saat membuat pengiklan

billingConfig sekarang menjadi kolom wajib diisi di resource Advertiser. Perbarui permintaan advertisers.create Anda untuk memverifikasi bahwa kolom ini telah ditetapkan. Informasi penagihan default dapat diambil untuk partner induk melalui kolom resource Partner billingConfig baru.

Gunakan kolom baru untuk mengontrol penargetan yang dioptimalkan

Kolom boolean enableOptimizedTargeting baru telah menggantikan kolom targetingExpansionLevel di objek TargetingExpansionConfig.

Memperbarui integrasi pesanan pemasangan iklan untuk menggunakan kolom KPI baru

Kolom kpi baru telah menggantikan kolom performanceGoal di resource InsertionOrder. Kolom baru ini menggunakan objek Kpi sebagai pengganti objek PerformanceGoal serta menggunakan kolom dan enum baru.

Menghapus referensi ke layanan dan kolom yang tidak digunakan lagi

Berbagai entity telah dihapus di v3 agar sesuai dengan penghentian fitur sebelumnya:

• Layanan advertisers.manualTriggers telah dihapus karena pemicu manual tidak digunakan lagi.
• Kolom billableOutcome telah dihapus dari resource InsertionOrder karena pembelian berbasis hasil sudah tidak digunakan lagi.

Perubahan lainnya

Selain perubahan yang dapat menyebabkan gangguan yang tercantum di atas, v3 juga memperkenalkan fitur baru.

Fitur yang ditambahkan ke v3 setelah peluncuran awal dapat ditemukan di catatan rilis kami.

Pengelolaan daftar lokasi kedekatan

Di v3, Anda dapat sepenuhnya mengelola daftar lokasi kedekatan, sehingga Anda dapat menggunakan layanan advertisers.locationLists.assignedLocations untuk membuat dan menghapus lokasi yang ditetapkan ke resource TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Lokasi diidentifikasi menggunakan ID resource TARGETING_TYPE_POI TargetingOption. Ini dapat diambil menggunakan targetingTypes.targetingOptions.search.

Kemampuan untuk membuat algoritma bidding kustom berbasis aturan

Di v3, Anda dapat membuat dan mengambil algoritma bidding kustom berbasis aturan menggunakan layanan customBiddingAlgorithms, media, customBiddingAlgorithms.rules.

Fitur ini masih dalam versi beta dan hanya tersedia untuk partner yang diizinkan. Jika partner Anda tidak diizinkan, permintaan Anda akan menampilkan error.