Mulai 8 September 2025, setiap item baris baru harus menyatakan apakah item baris tersebut akan menayangkan iklan politik Uni Eropa (EU) atau tidak. Upload SDF dan API Display & Video 360 yang tidak memberikan pernyataan akan gagal. Lihat halaman penghentian penggunaan kami untuk mengetahui detail selengkapnya tentang cara memperbarui integrasi Anda untuk membuat pernyataan ini.

Halaman ini diterjemahkan oleh Cloud Translation API.

Bermigrasi dari v2 ke v3

Terakhir diperbarui: 31-10-2023

Memigrasikan aplikasi Anda

Untuk bermigrasi dari v2 ke v3, Anda harus memperbarui URL endpoint untuk memanggil v3 dan memperbarui aplikasi untuk memperhitungkan perubahan yang menyebabkan error.

Memperbarui panggilan API dari v2 ke v3

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

Misalnya, untuk memanggil metode advertisers.get dengan v2, Anda akan menggunakan URL berikut:

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

Untuk v3, perbarui URL ke URL berikut:

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

Jika Anda menggunakan library klien untuk membuat permintaan ke API, gunakan library klien versi terbaru dan perbarui 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 yang relevan dengan penggunaan Display & Video 360 API yang ada.

Memperbarui panggilan yang mengambil resource YouTube dan penargetan terkait

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, ganti penggunaan resource YoutubeAdGroup atau YoutubeAdGroupAd dengan resource AdGroup dan AdGroupAd, lalu 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 ke 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 di resource LineItem atau AdGroup.
Kolom thirdPartyMeasurementSettings telah diganti namanya menjadi thirdPartyMeasurementConfigs dalam objek YoutubeAndPartnersSettings dan objek YoutubeAndPartnersThirdPartyMeasurementSettings telah 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 kini menjadi kolom wajib diisi dalam resource Advertiser. Perbarui permintaan advertisers.create untuk memverifikasi bahwa kolom ini telah ditetapkan. Informasi penagihan default dapat diambil untuk partner induk melalui kolom resource billingConfig Partner baru.

Menggunakan kolom baru untuk mengontrol penargetan yang dioptimalkan

Kolom boolean enableOptimizedTargeting baru telah menggantikan kolom targetingExpansionLevel dalam 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 ganti objek PerformanceGoal dan menggunakan kolom dan enum baru.

Menghapus referensi ke layanan dan kolom yang tidak digunakan lagi

Berbagai entity telah dihapus di v3 agar selaras dengan penghentian fitur terdahulu:

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

Perubahan lainnya

Selain perubahan yang 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 jarak

Di v3, Anda dapat sepenuhnya mengelola daftar lokasi kedekatan, yang memungkinkan Anda 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. Data 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.