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.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-31 UTC."],[],["To migrate to v4, update endpoint URLs to v4 and adjust for breaking changes. `FirstAndThirdPartyAudience` resources are replaced by `FirstPartyAndPartnerAudience`. `advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions` is now `bulkListAssignedTargetingOptions`. `optimizationObjective` is required in `InsertionOrder` resource creation. Remove all requests for campaign or insertion order targeting. Also, remove all references to the `publisherReviewStatuses` field in the `Creative` resource. Finally update `FirstAndThirdPartyAudienceType` and `AudienceType` references.\n"],null,["# Migrate from v3 to v4\n\n*Last update: 2025-07-31*\n\nMigrate your application\n------------------------\n\nMigrating from v3 to v4 requires updating your endpoint URLs to call v4 and\nupdating your application to account for breaking changes.\n\n### Update your API calls from v3 to v4\n\nTo use v4 instead of v3, update your requests to use new v4 endpoints.\n\nFor example, to call the [`advertisers.get`](/display-video/api/reference/rest/v4/advertisers/get) method with v3, use the\nfollowing URL: \n\n GET https://displayvideo.googleapis.com/v3/advertisers/\u003cvar translate=\"no\"\u003eadvertiserId\u003c/var\u003e\n\nFor v4, update the URL to the following: \n\n GET https://displayvideo.googleapis.com/v4/advertisers/\u003cvar translate=\"no\"\u003eadvertiserId\u003c/var\u003e\n\nIf you are using a client library to make requests to the API, use the most\nrecent version of the client library and update your configuration to use v4.\n\n### Make required changes\n\nWe're introducing a number of breaking changes in v4. Review the following\ninstructions and make the required changes relevant to your existing use of the\nDisplay \\& Video 360 API.\n\n#### Update calls regarding first- and third-party audience resources and related targeting\n\n`FirstAndThirdPartyAudience` resources have been replaced by\n`FirstPartyAndPartnerAudience` resources.\n\nThis change requires you to update the following:\n\n- References to `FirstAndThirdPartyAudience` resources to use the new [`FirstPartyAndPartnerAudience`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience) resource.\n- Existing requests to methods in the v3 service `firstAndThirdPartyAudiences` to the new v4 service [`firstPartyAndPartnerAudiences`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#methods).\n- Expectations of the default page size for [`firstPartyAndPartnerAudiences.list`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences/list) requests from 100 to 5000 items.\n- References to the v3 `firstAndThirdPartyAudienceType` field to the new v4 [`firstPartyAndPartnerAudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.first_party_and_partner_audience_type) field, using the new [`FirstPartyAndPartnerAudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudienceType) enum type, with old values corresponding to the following new values:\n - `FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY` to `TYPE_FIRST_PARTY`\n - `FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY` to `TYPE_PARTNER`\n- References to [`AudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#AudienceType) enum value `LICENSED` to instead use\n one of the following new, more specific values:\n\n - `THIRD_PARTY`\n - `COMMERCE`\n - `LINEAR`\n- References to [`AssignedTargetingOption`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) resources of\n [`TargetingType`](/display-video/api/reference/rest/v4/TargetingType) `TARGETING_TYPE_AUDIENCE_GROUP` to replace\n the v3 fields in\n [`AudienceGroupAssignedTargetingOptionDetails`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails) with\n the following new v4 fields:\n\n - `excludedFirstAndThirdPartyAudienceGroup` with [`excludedFirstPartyAndPartnerAudienceGroup`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails.FIELDS.excluded_first_party_and_partner_audience_group)\n - `includedFirstAndThirdPartyAudienceGroups` with [`includedFirstPartyAndPartnerAudienceGroups`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails.FIELDS.included_first_party_and_partner_audience_groups)\n\n#### Update existing ad group bulk list targeting requests\n\n`advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions` has been renamed\n[`advertisers.adGroups.bulkListAssignedTargetingOptions`](/display-video/api/reference/rest/v4/advertisers.adGroups/bulkListAssignedTargetingOptions).\nUpdate your existing requests to use the new method name.\n\n#### Include an optimization objective when creating insertion orders\n\n[`optimizationObjective`](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder.FIELDS.optimization_objective) is now a required field in the\n[`InsertionOrder`](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder) resource. Update your\n[`advertisers.insertionOrders.create`](/display-video/api/reference/rest/v4/advertisers.insertionOrders/create) requests to verify that this\nfield is set.\n\n#### Remove references to the creative resource field `publisherReviewStatuses`\n\nThe `publisherReviewStatuses` field has been removed from the\n[`ReviewStatusInfo`](/display-video/api/reference/rest/v4/advertisers.creatives#ReviewStatusInfo) object under the\n[`Creative`](/display-video/api/reference/rest/v4/advertisers.creatives#Creative) resource after being [deprecated in June\n2024](/display-video/api/deprecations#features.creative_publisher_review_statuses)."]]
