Fazer upgrade para a versão mais recente

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

Confira nossa programação de descontinuação para planejar os upgrades. Consulte nosso guia de controle de versão para saber como funciona.

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

  1. Seu endpoint será alterado quando você alterar as versões principais. Atualize suas bibliotecas de cliente para usar o endpoint mais recente.
  2. Consulte as notas da versão para ver as mudanças introduzidas em cada versão.
  3. Confira nas tabelas abaixo áreas específicas em que você precisa se concentrar para a versão para a qual está fazendo upgrade.

Para ter uma visão geral abrangente das mudanças com base nas diferenças entre os protos das duas versões, consulte a tabela de diferenças (link em inglês).

v15 a v16

Mudanças nos serviços e componentes deles
AccountLink Os links data_partner e google_ads em linked_account foram removidos. Use ProductLinkService e ProductLinkInvitationService.
CampaignLifecycleGoal Ao atualizar um CampaignLifecycleGoal existente anteriormente, você emitiria uma operação create com requisitos específicos. Agora, é possível emitir uma operação update da mesma forma que acontece com outros tipos de recursos.
Error Reporting Dois casos em que o erro genérico ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT era retornado agora resultam em mensagens de erro mais específicas:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata O campo score foi removido.
KeywordMatchTypeRecommendation Se o tipo de correspondência de palavra-chave não for definido, a API vai retornar UNSPECIFIED em vez de UNKNOWN para o campo recommended_match_type.

v14 a v15

Mudanças nos serviços e componentes deles
AssetGroupListingGroupFilter O campo de enumeração vertical foi renomeado como feed_type.
MediaFileService O serviço foi removido porque não é mais necessário. Confira a mudança em ImageAdInfo abaixo.
ImageAdInfo O campo media_file foi substituído por image_asset.
MerchantCenterLinkService O serviço foi substituído por ProductLinkInvitationService e ProductLinkService.
Campaign.ShoppingSetting O campo sales_country foi removido. A informação agora é retornada no campo feed_label.
ProductBiddingCategoryConstant Substituído por ProductCategoryConstant. Vários campos foram renomeados de acordo. Confira as próximas três mudanças abaixo.
ListingDimensionInfo O campo product_bidding_category foi substituído por product_category.
ListingGroupFilterDimension O campo product_bidding_category foi substituído por product_category.
Relatório shopping_performance_view Os seguintes campos de segmento:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
foram substituídos por:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Removemos o suporte para criação de campanhas de pesquisa com esse campo.
CampaignCriterion.listing_scope Removemos o suporte para criação de campanhas de pesquisa com esse campo.
Relatório sk_ad_network_conversions O metrics.sk_ad_network_conversions foi substituído por metrics.sk_ad_network_installs.
OfflineConversionClientSummary O campo offline_conversion_client_summaries foi movido de Customer para um recurso de nível superior que você pode consultar separadamente.

Altere sua consulta de:

SELECT customer.offline_conversion_client_summaries
FROM customer
para: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

Use o criador de consultas para explorar a lista de campos disponíveis para seleção e filtragem.
OfflineConversionUploadAlert Renomeado como OfflineConversionAlert.
OfflineConversionUploadError Renomeado como OfflineConversionError.
AdNetworkType Os tipos enumerados YOUTUBE_SEARCH e YOUTUBE_WATCH foram mesclados em um único tipo enumerado: YOUTUBE.