Fazer upgrade para a versão mais recente

Periodicamente, convém atualizar de uma versão principal mais antiga do a API Google Ads para uma nova versão principal. Pode ser porque uma versão está sendo desativada ou porque você quer usar um novo recurso. Recomendamos que você sempre atualize para a versão mais recente.

Consulte nossa programação de descontinuação para planejar seus upgrades. Consulte nosso guia de controle de versões para saber como ele funciona.

Confira uma lista de verificação para ajudar você a começar o processo de upgrade:

  1. Seu endpoint vai mudar quando você mudar as versões principais. Atualize suas bibliotecas de cliente para usar o endpoint mais recente.
  2. Leia as notas da versão para ver as alterações que foram introduzidas em cada versão.
  3. Confira as tabelas abaixo para conhecer as áreas específicas em que focar para a versão está sendo atualizado.

Para uma visão geral abrangente das mudanças com base em uma diferença entre os protos as duas versões, consulte a tabela de diferenças.

v17 para v18

Mudanças nos serviços e componentes deles
GoogleAdsService solicitações Search e SearchStream

O erro quando sua solicitação é limitada porque é muito cara será QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ou QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION em vez de QuotaError.RESOURCE_EXHAUSTED. Confira mais detalhes na postagem do blog.
GoogleAdsService Os campos summary_row_setting e return_total_results_count em SearchGoogleAdsRequest agora fazem parte do novo objeto SearchSettings.
AssetType O valor de enumeração DISCOVERY_CAROUSEL_CARD foi renomeado como DEMAND_GEN_CAROUSEL_CARD. Isso está de acordo com uma alteração anterior para mudar o nome das campanhas Discovery para campanhas Geração de demanda.
AudienceInsightsService.GenerateSuggestedTargetingInsights Os campos audience, baseline_audience e data_month foram movidos para o campo audience_definition.
DemandGenCampaignSettings O valor padrão do campo upgraded_targeting agora é true em vez de false.
LocalServicesLeadConversation O campo phone_call_details.call_recording_url não vai mais ser preenchido para chamadas estáticas.

v16 a v17

Mudanças nos serviços e componentes deles
GoogleAdsService solicitações Search e SearchStream

Sua solicitação pode ser limitada se a consulta for muito cara. Se for, você receberá um erro QuotaError.RESOURCE_EXHAUSTED. Confira mais detalhes na postagem do blog.
GoogleAdsService Search solicitações.

Como transmitir um page_size para GoogleAdsService.Search vai resultar em um erro RequestError.PAGE_SIZE_NOT_SUPPORTED.
Campaign e Ad

Campanhas com um AdvertisingChannelType de DISCOVERY agora terá um AdvertisingChannelType de DEMAND_GEN.

Além disso, alguns anúncios mudam de tipo e nomes de campo para a geração de relatórios:

  • DISCOVERY_MULTI_ASSET_ADD vai se tornar DEMAND_GEN_MULTI_ASSET_ADD, e o campo de relatório correspondente ad_group_ad.ad.discovery_multi_asset_ad vai se tornar ad_group_ad.ad.demand_gen_multi_asset_ad.
  • DISCOVERY_CAROUSEL_AD vai se tornar DEMAND_GEN_CAROUSEL_AD, e o campo de relatório correspondente ad_group_ad.ad.discovery_carousel_ad vai se tornar ad_group_ad.ad.demand_gen_carousel_ad.
  • DISCOVERY_VIDEO_RESPONSIVE_AD vai se tornar DEMAND_GEN_VIDEO_RESPONSIVE_AD e o campo de relatório correspondente ad_group_ad.ad.discovery_video_responsive_ad vai se tornar ad_group_ad.ad.demand_gen_video_responsive_ad
AdService O endpoint GetAd será removido. Isso traz AdService de acordo com outros serviços da API Google Ads. Consulte nosso guia sobre como recuperar objetos para conferir a maneira recomendada de buscar anúncios e outros tipos de recursos.
CustomerLifecycleGoal e CampaignLifecycleGoal A maneira como você gerencia segmentos para metas de ciclo de vida foi reformulada. Consulte a seção segmentar seus públicos-alvo da documentação das metas do ciclo de vida para uma visão geral completa.
ProductLink Ao executar uma pesquisa GoogleAdsService ou uma solicitação de stream de pesquisa para product_link, agora só é possível selecionar campos relacionados a um produto vinculado. A seleção de vários campos de produtos vinculados diferentes resultará em um erro QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
Relatórios O campo metrics.sk_ad_network_conversion_value foi renomeado como metrics.sk_ad_network_fine_conversion_value.