A API Display & Video 360 agora oferece suporte ao gerenciamento de recursos da Geração de demanda. Consulte nosso novo guia para saber como criar e veicular uma campanha publicitária Geração de demanda.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Migrar da API Display & Video 360 v4 para a v5

Última atualização: 22/10/2026

Migrar o aplicativo

Para migrar da v4 para a v5, é necessário atualizar os URLs de endpoint para chamar a v5, atualizar o aplicativo para considerar as alterações interruptivas e analisar os novos recursos que podem beneficiar sua integração.

Atualizar as chamadas de API da v4 para a v5

Para usar a v5 em vez da v4, atualize suas solicitações para usar os novos endpoints da v5.

Por exemplo, para chamar o método advertisers.get com a v4, use o seguinte URL:

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

Para a v5, atualize o URL para o seguinte:

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

Se você estiver usando uma biblioteca de cliente para fazer solicitações à API, use a versão mais recente da biblioteca de cliente e atualize sua configuração para usar a v5.

Faça as alterações necessárias

A v5 da API Display & Video 360 apresenta várias alterações interruptivas. Leia as instruções a seguir e faça as mudanças necessárias para o uso atual da API Display & Video 360.

Para uma lista completa das diferenças entre as versões 4 e 5 da API Display & Video 360, consulte as notas da versão.

Atualizar a recuperação e a segmentação da origem de inventário para usar novos IDs e tipos

A API Display & Video 360 v5 muda a forma como as transações de origem de inventário e os pacotes de leilão são recuperados e segmentados.

Na v4, os recursos InventorySource recuperados usando o serviço inventorySources representam as transações de origem de inventário e os pacotes de leilão. As transações e os pacotes de leilão são segmentados usando TARGETING_TYPE_INVENTORY_SOURCE.

Na v5, as transações de origem de inventário e os pacotes de leilão são processados separadamente:

As transações de inventário são segmentadas usando TARGETING_TYPE_INVENTORY_SOURCE_DEAL, recuperadas com os serviços advertisers.inventorySources e partners.inventorySources e segmentadas usando o campo AssignedTargetingOption inventorySourceDetails.
Os pacotes de leilão são segmentados usando TARGETING_TYPE_AUCTION_PACKAGE, recuperados com o serviço targetingTypes.targetingOptions e segmentados usando o campo AssignedTargetingOption auctionPackageDetails.

Essa atualização muda os IDs usados para transações e pacotes de leilão atuais. Portanto, não será possível usar IDs de recursos InventorySource armazenados em cache anteriormente após a migração.

Além dessas mudanças, a v5 também remove a capacidade de criar, atualizar e editar acessadores de inventário.

Atualizar a lógica de segmentação por público-alvo para recursos da Geração de Demanda e do YouTube

A v5 da API Display & Video 360 atualiza a lógica de segmentação por público-alvo para os recursos de Geração de Demanda e do YouTube, usando opções atribuídas individualmente para cada lista de público-alvo segmentada.

Na v4, toda a segmentação por público-alvo é gerenciada usando TARGETING_TYPE_AUDIENCE_GROUP.

Na v5, a segmentação por público-alvo atribuída aos grupos de anúncios de Geração de Demanda e de anúncios no YouTube é gerenciada usando um dos seguintes tipos de segmentação e campos de recurso AssignedTargetingOption, dependendo do tipo de público-alvo:

TARGETING_TYPE_COMBINED_AUDIENCE usando combinedAudienceDetails
TARGETING_TYPE_CUSTOM_LIST usando customListDetails
TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE usando firstPartyAndPartnerAudienceDetails
TARGETING_TYPE_GOOGLE_AUDIENCE usando googleAudienceDetails
TARGETING_TYPE_LOOKALIKE_AUDIENCE usando lookalikeAudienceDetails

Os itens de linha vão continuar usando um único TARGETING_TYPE_AUDIENCE_GROUP AssignedTargetingOption para gerenciar a segmentação por público-alvo de todos os tipos.

Fazer upgrade para a API Data Manager para gerenciar públicos-alvo segmentados por lista de clientes

A API Display & Video 360 v5 remove a capacidade de criar e gerenciar a associação de públicos-alvo segmentados por lista de clientes ao remover os seguintes métodos:

firstPartyAndPartnerAudiences.create
firstPartyAndPartnerAudiences.editCustomerMatchMembers
firstPartyAndPartnerAudiences.patch

Para continuar gerenciando públicos-alvo segmentados por lista de clientes, atualize seus fluxos de trabalho para usar a API Data Manager.

Adicionar suporte para recuperar pedidos de inserção de mídia digital out of home

A v5 da API Display & Video 360 adiciona suporte para recuperar pedidos de inserção de mídia digital out of home.

Se os anunciantes usam mídia digital out of home, faça upgrade de qualquer integração que chame advertisers.insertionOrders.list em antecipação à inclusão de recursos InsertionOrder com o valor de campo insertionOrderType de OUT_OF_HOME.

Na v5, os itens de linha em pedidos de inserção de mídia digital out of home vão continuar sendo recuperáveis como na v4.

Atualizar as referências da Adloox para a Peer39

Na v5, os campos e os valores de tipo enumerado que fazem referência à integração de adequação da marca de terceiros do Display & Video 360 com o Adloox (também conhecido como Scope3) foram atualizados para Peer39:

O campo adloox de ThirdPartyVerifierAssignedTargetingOptionDetails foi substituído por peer39.
Os valores de tipo enumerado PARTNER_COST_TYPE_ADLOOX e PARTNER_COST_TYPE_ADLOOX_PREBID de PartnerCostType foram substituídos por PARTNER_COST_TYPE_PEER39 e PARTNER_COST_TYPE_PEER39_PREBID.

Atualizar campos de itens de linha, grupos de anúncios e anúncios do YouTube

Na v5, vários campos nos recursos LineItem, AdGroup e AdGroupAd foram removidos ou atualizados. Atualize sua lógica de recuperação de recursos para considerar essas mudanças.

No recurso LineItem:

O campo YoutubeAndPartnersSettings relatedVideoIds foi substituído por relatedVideos.

Nos recursos LineItem e AdGroup:

Os campos TargetingExpansionConfig audienceExpansionSeedListExcluded e audienceExpansionLevel foram removidos.

No recurso AdGroupAd:

Um campo containsSyntheticMedia foi adicionado.
O campo trackingUrl nos objetos AudioAd, CommonInStreamAttribute e VideoPerformanceAd foi dividido em dois campos, trackingUrl e userSpecifiedTrackingUrl, para diferenciar o URL usado para rastreamento e o URL de rastreamento especificado pelo usuário.

Remover referências a valores de tipo enumerado descontinuados

Na v5, os valores de tipo enumerado descontinuados foram totalmente removidos. Embora o uso desses valores em solicitações à API resultasse em um erro na v4, essa mudança remove qualquer referência a eles das bibliotecas de cliente da v5. Qualquer referência a esses valores descontinuados no código pode causar erros ao fazer upgrade para a v5.

Os tipos de enumeração que têm valores afetados incluem ContentRatingTier, GoogleAudienceType, SdfVersion e SensitiveCategory. Consulte nossas notas da versão para ver uma lista completa de todos os valores de tipo enumerado removidos.

Analisar novos recursos

Além das alterações interruptivas, a v5 também apresenta os seguintes novos recursos:

Gerenciamento completo da segmentação por exclusão de vídeos e canais do YouTube no nível do anunciante nos tipos de segmentação TARGETING_TYPE_YOUTUBE_VIDEO e TARGETING_TYPE_YOUTUBE_CHANNEL. Na v4, essa segmentação era somente leitura.
A capacidade de criar recursos de mídia digital out of home InsertionOrder.
Suporte para grupos de anúncios que usam criativos atribuídos para gerar anúncios com a adição dos campos AdGroup adSource e creativeAssignments e do campo AdGroupAd parentCreativeId.
A capacidade de criar e recuperar recursos do LookalikeAudience.
Um novo campo containsSyntheticMedia no recurso AdGroupAd.