Bermigrasi dari v3 ke v4

Terakhir diperbarui: 31-07-2025

Memigrasikan aplikasi Anda

Migrasi dari v3 ke v4 memerlukan pembaruan URL endpoint untuk memanggil v4 dan memperbarui aplikasi Anda untuk memperhitungkan perubahan yang menyebabkan gangguan.

Memperbarui panggilan API Anda dari v3 ke v4

Untuk menggunakan v4, bukan v3, perbarui permintaan Anda untuk menggunakan endpoint v4 baru.

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

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

Untuk v4, perbarui URL ke berikut ini:

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

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

Membuat perubahan yang diperlukan

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

Memperbarui panggilan terkait sumber daya audiens pihak pertama dan ketiga serta penargetan terkait

Resource FirstAndThirdPartyAudience telah diganti dengan resource FirstPartyAndPartnerAudience.

Perubahan ini mengharuskan Anda memperbarui hal berikut:

• Referensi ke resource FirstAndThirdPartyAudience untuk menggunakan resource FirstPartyAndPartnerAudience baru.
• Permintaan yang ada ke metode di layanan v3 firstAndThirdPartyAudiences ke layanan v4 baru firstPartyAndPartnerAudiences.
• Ekspektasi ukuran halaman default untuk permintaan firstPartyAndPartnerAudiences.list dari 100 hingga 5.000 item.
• Referensi ke kolom firstAndThirdPartyAudienceType v3 ke kolom firstPartyAndPartnerAudienceType v4 baru, menggunakan jenis enum FirstPartyAndPartnerAudienceType baru, dengan nilai lama yang sesuai dengan nilai baru berikut:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY hingga TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY hingga TYPE_PARTNER

• Referensi ke nilai enum AudienceType LICENSED untuk menggunakan salah satu nilai baru yang lebih spesifik berikut:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Referensi ke resource AssignedTargetingOption dari TargetingType TARGETING_TYPE_AUDIENCE_GROUP untuk menggantikan kolom v3 di AudienceGroupAssignedTargetingOptionDetails dengan kolom v4 baru berikut:

  • excludedFirstAndThirdPartyAudienceGroup dengan excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups dengan includedFirstPartyAndPartnerAudienceGroups

Memperbarui permintaan penargetan daftar massal grup iklan yang ada

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions telah diganti namanya menjadi advertisers.adGroups.bulkListAssignedTargetingOptions. Perbarui permintaan yang ada untuk menggunakan nama metode baru.

Menyertakan tujuan pengoptimalan saat membuat perjanjian pemasangan iklan

optimizationObjective kini menjadi kolom wajib diisi dalam resource InsertionOrder. Perbarui permintaan advertisers.insertionOrders.create Anda untuk memverifikasi bahwa kolom ini ditetapkan.

Menghapus referensi ke kolom resource materi iklan publisherReviewStatuses

Kolom publisherReviewStatuses telah dihapus dari objek ReviewStatusInfo dalam resource Creative setelah tidak digunakan lagi pada Juni 2024.