A partir de 8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Última atualização: 31/07/2025
Migrar o aplicativo
Para migrar da v3 para a v4, é necessário atualizar os URLs de endpoint para chamar a v4 e
atualizar o aplicativo para considerar as mudanças significativas.
Atualizar as chamadas de API da v3 para a v4
Para usar a v4 em vez da v3, atualize suas solicitações para usar os novos endpoints da v4.
Por exemplo, para chamar o método advertisers.get com a v3, use o seguinte URL:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
Para a v4, atualize o URL para o seguinte:
GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId
Se você estiver usando uma biblioteca de cliente para fazer solicitações à API, use a versão mais recente e atualize sua configuração para usar a v4.
Faça as alterações necessárias
Estamos introduzindo várias mudanças interruptivas na v4. Revise as instruções a seguir e faça as mudanças necessárias relevantes para seu uso atual da API Display & Video 360.
Atualizar chamadas relacionadas a recursos de público-alvo próprios e de terceiros e segmentação relacionada
Os recursos FirstAndThirdPartyAudience foram substituídos por recursos FirstPartyAndPartnerAudience.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
