Migrar da v3 para a v4

Ú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.

Essa mudança exige que você atualize o seguinte:

• Referências a recursos FirstAndThirdPartyAudience para usar o novo recurso FirstPartyAndPartnerAudience.
• Solicitações atuais para métodos no serviço v3 firstAndThirdPartyAudiences para o novo serviço v4 firstPartyAndPartnerAudiences.
• Expectativas do tamanho de página padrão para solicitações de firstPartyAndPartnerAudiences.list de 100 a 5.000 itens.
• Referências do campo firstAndThirdPartyAudienceType v3 para o novo campo firstPartyAndPartnerAudienceType v4, usando o novo tipo de enum FirstPartyAndPartnerAudienceType, com valores antigos correspondentes aos seguintes novos valores:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY a TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY a TYPE_PARTNER

• Referências ao valor de enumeração AudienceType LICENSED para usar um dos seguintes valores novos e mais específicos:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Referências aos recursos AssignedTargetingOption de TargetingType TARGETING_TYPE_AUDIENCE_GROUP para substituir os campos v3 em AudienceGroupAssignedTargetingOptionDetails pelos seguintes novos campos v4:

  • excludedFirstAndThirdPartyAudienceGroup com excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups com includedFirstPartyAndPartnerAudienceGroups

Atualizar solicitações de segmentação por lista em massa de grupos de anúncios

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions foi renomeado como advertisers.adGroups.bulkListAssignedTargetingOptions. Atualize as solicitações atuais para usar o novo nome do método.

Incluir um objetivo de otimização ao criar pedidos de inserção

optimizationObjective agora é um campo obrigatório no recurso InsertionOrder. Atualize suas solicitações de advertisers.insertionOrders.create para verificar se esse campo está definido.

Remova referências ao campo de recurso do criativo publisherReviewStatuses

O campo publisherReviewStatuses foi removido do objeto ReviewStatusInfo no recurso Creative após ser descontinuado em junho de 2024.