Bermigrasi dari Display & Video 360 API v4 ke v5

Terakhir diperbarui: 22-10-2026

Peringatan: v5 masih dalam versi beta terbuka. Perubahan yang dapat menyebabkan gangguan mungkin dilakukan pada v5 selama dalam versi beta dan akan dicantumkan dalam catatan rilis Display & Video 360 API. Dokumen ini akan diperbarui sesuai kebutuhan untuk mencerminkan versi beta langsung.

Memigrasikan aplikasi Anda

Migrasi dari v4 ke v5 memerlukan pembaruan URL endpoint untuk memanggil v5, pembaruan aplikasi untuk memperhitungkan perubahan yang dapat menyebabkan gangguan, dan peninjauan fitur baru yang dapat menguntungkan integrasi Anda.

Mengupdate panggilan API Anda dari v4 ke v5

Untuk menggunakan v5, bukan v4, Anda harus mengupdate permintaan untuk menggunakan endpoint v5 baru.

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

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

Untuk v5, perbarui URL menjadi berikut:

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

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

Membuat perubahan yang diperlukan

Display & Video 360 API v5 memperkenalkan sejumlah perubahan yang dapat menyebabkan gangguan. Tinjau petunjuk berikut dan lakukan perubahan yang diperlukan yang relevan dengan penggunaan Display & Video 360 API yang ada.

Untuk mengetahui daftar lengkap perbedaan antara Display & Video 360 API v4 dan v5, lihat catatan rilis.

Memperbarui pengambilan dan penargetan sumber inventaris untuk menggunakan ID dan jenis baru

Display & Video 360 API v5 mengubah cara pengambilan dan penargetan transaksi sumber inventaris dan paket lelang.

Di v4, resource InventorySource yang diambil menggunakan layanan inventorySources mewakili transaksi sumber inventaris dan paket lelang. Transaksi dan paket lelang ditargetkan menggunakan TARGETING_TYPE_INVENTORY_SOURCE.

Di v5, transaksi sumber inventaris dan paket lelang ditangani secara terpisah:

• Transaksi sumber inventaris ditargetkan menggunakan TARGETING_TYPE_INVENTORY_SOURCE_DEAL, diambil menggunakan layanan advertisers.inventorySources dan partners.inventorySources, dan ditargetkan menggunakan kolom AssignedTargetingOption inventorySourceDetails.
• Paket lelang ditargetkan menggunakan TARGETING_TYPE_AUCTION_PACKAGE, diambil menggunakan layanan targetingTypes.targetingOptions, dan ditargetkan menggunakan kolom AssignedTargetingOption auctionPackageDetails.

Pembaruan ini mengubah ID yang digunakan untuk paket lelang dan transaksi yang ada, sehingga Anda tidak dapat menggunakan ID resource InventorySource yang di-cache sebelumnya setelah migrasi.

Selain perubahan ini, v5 juga menghapus kemampuan untuk membuat, memperbarui, dan mengedit pengakses sumber inventaris.

Memperbarui logika penargetan audiens untuk resource Peningkat Permintaan dan YouTube

Display & Video 360 API v5 memperbarui logika penargetan audiens untuk resource Peningkat Permintaan dan YouTube agar menggunakan opsi yang ditetapkan secara individual untuk setiap daftar audiens target.

Di v4, semua penargetan audiens dikelola menggunakan TARGETING_TYPE_AUDIENCE_GROUP.

Di v5, penargetan audiens yang ditetapkan ke grup iklan Peningkat Permintaan dan YouTube dikelola menggunakan salah satu jenis penargetan dan kolom resource AssignedTargetingOption berikut, bergantung pada jenis audiens:

• TARGETING_TYPE_COMBINED_AUDIENCE menggunakan combinedAudienceDetails
• TARGETING_TYPE_CUSTOM_LIST menggunakan customListDetails
• TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE menggunakan firstPartyAndPartnerAudienceDetails
• TARGETING_TYPE_GOOGLE_AUDIENCE menggunakan googleAudienceDetails
• TARGETING_TYPE_LOOKALIKE_AUDIENCE menggunakan lookalikeAudienceDetails

Item baris akan terus menggunakan satu TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption untuk mengelola penargetan audiens untuk semua jenis.

Mengupgrade ke Data Manager API untuk pengelolaan audiens Customer Match

Display & Video 360 API v5 menghapus kemampuan untuk membuat dan mengelola keanggotaan audiens Customer Match dengan menghapus metode berikut:

• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• firstPartyAndPartnerAudiences.patch

Untuk terus mengelola audiens Customer Match, upgrade alur kerja Anda untuk menggunakan Data Manager API.

Menambahkan dukungan untuk mengambil pesanan pemasangan Digital Luar Ruangan

Display & Video 360 API v5 menambahkan dukungan untuk mengambil pesanan pemasangan Iklan Digital Luar Ruangan.

Jika pengiklan Anda menggunakan iklan Digital Luar Ruangan, upgrade integrasi apa pun yang memanggil advertisers.insertionOrders.list untuk mengantisipasi penyertaan resource InsertionOrder dengan nilai kolom insertionOrderType OUT_OF_HOME.

Di v5, item baris di bagian pesanan pemasangan Iklan Digital Luar Ruangan akan terus dapat diambil seperti di v4.

Memperbarui referensi ke Adloox menjadi Peer39

Di v5, kolom dan nilai enum yang merujuk pada integrasi kesesuaian merek pihak ketiga Display & Video 360 dengan Adloox (juga disebut sebagai Scope3) telah diperbarui ke Peer39:

• ThirdPartyVerifierAssignedTargetingOptionDetails kolom adloox telah diganti dengan peer39.
• Nilai enum PartnerCostType PARTNER_COST_TYPE_ADLOOX dan PARTNER_COST_TYPE_ADLOOX_PREBID telah diganti dengan PARTNER_COST_TYPE_PEER39 dan PARTNER_COST_TYPE_PEER39_PREBID.

Memperbarui kolom untuk item baris, grup iklan, dan iklan YouTube

Di v5, berbagai kolom di resource LineItem, AdGroup, dan AdGroupAd telah dihapus atau diperbarui. Perbarui logika pengambilan resource Anda untuk memperhitungkan perubahan ini.

Di resource LineItem:

• Kolom YoutubeAndPartnersSettings relatedVideoIds telah diganti dengan relatedVideos.

Dalam resource LineItem dan AdGroup:

• Kolom TargetingExpansionConfig audienceExpansionSeedListExcluded dan audienceExpansionLevel telah dihapus.

Di resource AdGroupAd:

• Kolom containsSyntheticMedia telah ditambahkan.
• Kolom trackingUrl di objek AudioAd, CommonInStreamAttribute, dan VideoPerformanceAd telah dibagi menjadi dua kolom, trackingUrl dan userSpecifiedTrackingUrl, untuk membedakan antara URL yang digunakan untuk pelacakan dan URL pelacakan yang ditentukan oleh pengguna.

Menghapus referensi ke nilai enum yang tidak digunakan lagi

Di v5, nilai enum yang sebelumnya tidak digunakan lagi telah dihapus sepenuhnya. Meskipun penggunaan nilai ini dalam permintaan ke API akan menghasilkan error di v4, perubahan ini akan menghapus referensi apa pun ke nilai tersebut dari library klien v5. Referensi apa pun ke nilai yang tidak digunakan lagi ini dalam kode Anda dapat menyebabkan error saat mengupgrade ke v5.

Jenis enum yang memiliki nilai yang terpengaruh mencakup ContentRatingTier, GoogleAudienceType, SdfVersion, dan SensitiveCategory. Lihat catatan rilis kami untuk mengetahui daftar lengkap semua nilai enum yang dihapus.

Meninjau fitur baru

Selain perubahan yang dapat menyebabkan gangguan, v5 juga memperkenalkan fitur baru berikut:

• Pengelolaan penuh penargetan pengecualian video dan channel YouTube di tingkat pengiklan dalam jenis penargetan TARGETING_TYPE_YOUTUBE_VIDEO dan TARGETING_TYPE_YOUTUBE_CHANNEL. Di v4, penargetan ini bersifat hanya baca.
• Kemampuan untuk membuat resource InsertionOrder Digital Luar Ruangan (DOOH).
• Dukungan untuk grup iklan yang menggunakan materi iklan yang ditetapkan untuk membuat iklan melalui penambahan kolom AdGroup adSource dan creativeAssignments serta kolom AdGroupAd parentCreativeId.
• Kemampuan untuk membuat dan mengambil resource LookalikeAudience.
• Kolom containsSyntheticMedia baru di resource AdGroupAd.