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
danYoutubeAdGroupAd
telah diganti dengan resourceAdGroup
danAdGroupAd
. 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 resourceYoutubeAdGroup
atauYoutubeAdGroupAd
dengan resourceAdGroup
danAdGroupAd
serta perbarui panggilan ke layanan v2 berikut ke layanan v3 yang sesuai:advertisers.youtubeAdGroupAds
keadvertisers.adGroupAds
advertisers.youtubeAdGroups
keadvertisers.adGroups
advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions
hinggaadvertisers.adGroups.targetingTypes.assignedTargetingOptions
- Referensi ke objek
YoutubeAndPartnersBiddingStrategy
telah dipindahkan ke kolomyoutubeAndPartnersBid
baru dalam objekBiddingStrategy
umum. KolombiddingStrategy
telah dihapus dari objekYoutubeAndPartnersSettings
. Perbarui integrasi Anda untuk mengambil strategi bidding untuk item baris atau grup iklan YouTube dari objekBiddingStrategy
di kolombidStrategy
pada resourceLineItem
atauAdGroup
. - Nama kolom
thirdPartyMeasurementSettings
telah diganti menjadithirdPartyMeasurementConfigs
di objekYoutubeAndPartnersSettings
dan objekYoutubeAndPartnersThirdPartyMeasurementSettings
diganti namanya menjadiThirdPartyMeasurementConfigs
. 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 resourceInsertionOrder
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.