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:
- Seu endpoint vai mudar quando você mudar as versões principais. Atualize suas bibliotecas de cliente para usar o endpoint mais recente.
- Leia as notas da versão para ver as alterações que foram introduzidas em cada versão.
- 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á
|
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 |
GoogleAdsService
Search solicitações. |
Como transmitir um |
Campaign e Ad |
Campanhas com um Além disso, alguns anúncios mudam de tipo e nomes de campo para a geração de relatórios:
|
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 . |