Migrar da v2 para a v3

Última atualização: 31/10/2023

Migrar seu aplicativo

A migração da v2 para a v3 requer a atualização dos URLs de endpoint para chamar a v3 e atualizando o aplicativo para considerar alterações interruptivas.

Atualizar suas chamadas de API da v2 para a v3

Para usar a v3 em vez da v2, é necessário atualizar suas solicitações para usar a nova v3 endpoints.

Por exemplo, para chamar o método advertisers.get com a v2, você precisaria use o seguinte URL:

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

Para a v3, atualize o URL para o seguinte:

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

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

Faça as alterações necessárias

Estamos introduzindo uma série de alterações interruptivas na v3. Analise o seguinte e faça as alterações necessárias relevantes ao seu uso atual do Rede de Display e API Video 360.

Atualizar ligações recuperando recursos do YouTube e a segmentação relacionada

• Os recursos YoutubeAdGroup e YoutubeAdGroupAd foram substituídos por AdGroup e AdGroupAd. Esses novos recursos oferecem informações quase idênticas aos recursos da v2, mas pode usar um campo atualizado nomes ou tipos de enumeração. Na sua integração, substitua os usos YoutubeAdGroup ou YoutubeAdGroupAd recursos com AdGroup e AdGroupAd e atualize as chamadas para os seguintes serviços da v2 para serviço da v3 correspondente:
  • advertisers.youtubeAdGroupAds a advertisers.adGroupAds
  • advertisers.youtubeAdGroups a advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions a advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Referências a objetos YoutubeAndPartnersBiddingStrategy foram movidas para um novo campo youtubeAndPartnersBid. no objeto geral BiddingStrategy. A O campo biddingStrategy foi removido do Objeto YoutubeAndPartnersSettings. Atualize sua integração para recuperar a estratégia de lances para itens de linha ou grupos de anúncios do YouTube dos Objeto BiddingStrategy no campo bidStrategy na LineItem ou AdGroup.
• O campo thirdPartyMeasurementSettings foi renomeado como thirdPartyMeasurementConfigs no YoutubeAndPartnersSettings e o O objeto YoutubeAndPartnersThirdPartyMeasurementSettings foi renomeado como ThirdPartyMeasurementConfigs. Atualize sua integração para Recupere as informações de configuração da medição de terceiros usando o novo campo. e objeto.

Incluir as configurações de faturamento necessárias ao criar anunciantes

billingConfig agora é um campo obrigatório na Advertiser. Atualizar o advertisers.create para verificar se esse campo está definido. As informações de faturamento padrão podem ser recuperados para o parceiro pai pelo novo Partner. campo de recurso billingConfig.

Use o novo campo para controlar a segmentação otimizada

Um novo campo booleano enableOptimizedTargeting substituiu o campo Campo targetingExpansionLevel em TargetingExpansionConfig objeto.

Atualize a integração do pedido de inserção para usar o novo campo de KPI

Um novo campo kpi substituiu o campo performanceGoal em o recurso InsertionOrder. Esse novo campo usa um Kpi no lugar do PerformanceGoal e usa novos campos e tipos enumerados.

Remover referências a serviços e campos descontinuados

Várias entidades foram removidas na v3 para se alinharem ao recurso anterior descontinuações:

• O serviço advertisers.manualTriggers foi removido como acionadores manuais foram descontinuados.
• O campo billableOutcome foi removido do InsertionOrder como a compra com base em resultados tem sido descontinuado.

Alterações adicionais

Além das alterações interruptivas listadas acima, a v3 também introduz novos atributos de machine learning.

Os recursos adicionados à v3 após o lançamento inicial podem ser encontrados na versão observações.

Gerenciamento da lista de locais por proximidade

Na v3, é possível gerenciar totalmente as listas de locais por proximidade, permitindo usar o serviço advertisers.locationLists.assignedLocations para criar e excluir locais atribuídos a TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Os locais são identificados pelo ID TARGETING_TYPE_POI TargetingOption recursos. Eles podem ser recuperados usando targetingTypes.targetingOptions.search.

Capacidade de criar algoritmos de lances personalizados com base em regras

Na v3, é possível criar e recuperar algoritmos de lances personalizados com base em regras usando a customBiddingAlgorithms, media customBiddingAlgorithms.rules.

Esse recurso está na versão Beta e disponível apenas para parceiros na lista de permissões. Se as parceiro não estiver na lista de permissões, sua solicitação retornará um erro.