Anúncio da v17 da API Google Ads

Quarta-feira, 5 de junho de 2024

Hoje, anunciamos o lançamento da v17 da API Google Ads. Para usar alguns dos recursos da v17, você precisa fazer upgrade das bibliotecas de cliente e do código do cliente. As bibliotecas de cliente e os exemplos de código atualizados serão publicados na próxima semana.

Estes são os destaques:

• Para nos prepararmos para a mudança na política de uso de recursos que vai acontecer em 17 de junho de 2024, adicionamos dois novos valores a QuotaError, gerados pelo consumo excessivo de recursos durante um período por um padrão de consulta para solicitações GoogleAdsService.Search() e GoogleAdsService.SearchStream().
• O campo page_size é sempre definido como 10.000, e não é mais possível transmitir um page_size para GoogleAdsService.Search. Isso vai resultar em um erro RequestError.PAGE_SIZE_NOT_SUPPORTED.
• Adicionamos campaign_aggregate_asset_view e channel_aggregate_asset_view para informar mais métricas de campanhas Performance Max e de pesquisa.
• Mudanças no processamento em lote:
  • Adicionamos suporte para definir MutateOperation.asset_group_operation ao usar BatchJobService. Isso permite usar o processamento em lote para criar e gerenciar campanhas Performance Max inteiras.
  • Adicionamos o erro BatchJobError.REQUEST_TOO_LARGE para o envio de um AddBatchJobOperationsRequest maior que 10.484.504 bytes. Divida as operações em grupos menores e envie-as como uma solicitação separada.
• Adicionamos Campaign.keyword_match_type para permitir a definição de um tipo de correspondência de palavra-chave para todas as palavras-chave em uma campanha.
• Remoção de AdService.getAd para alinhar o serviço com outros na API Google Ads. Para recomendações sobre como buscar recursos, consulte Como recuperar objetos.
• Adicionamos primary_status e primary_status_reasons a AdGroupCriterion para mostrar se o critério do grupo de anúncios está sendo veiculado ou os motivos para não estar.
• Adicionamos um novo relatório shopping_product, que corresponde à página Produtos da interface do Google Ads.
• Adicionamos mais validações para ImageAdInfo.image_asset em relação às dimensões e ao formato, o que torna o recurso mais consistente com outras validações de imagem na API Google Ads.
• Adicionamos segments.sk_ad_network_redistributed_fine_conversion_value, que redistribui valores NULL para outros valores com base em um modelo de aprendizado de máquina em dados de postback recentes da SkAdNetwork.
• Renomeamos Discovery para Geração de demanda em todos os campos, tipos enumerados e erros de todos os recursos na API Google Ads.
• Agora, só é possível selecionar campos relacionados a um produto vinculado ao consultar product_link. Caso contrário, QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE será gerado.
• Adicionamos UserListCustomerTypeService.MutateUserListCustomerTypes() para configurar os tipos de clientes do público-alvo. Esse método substitui o uso de CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
• Adicionamos dois campos expiration_date_time local_services_verification_artifact para que os anunciantes possam monitorar melhor quando os artefatos expiram.

Onde posso encontrar mais informações?
Estes recursos podem ajudar você a começar:

• Notas de lançamento
• Guias
• Referência
• Diferenças entre a v16 e a v17

Se tiver dúvidas ou precisar de mais ajuda, entre em contato pelo fórum.

 – Thanet Knack Praneenararat, em nome da equipe da API Google Ads

Marcadores: google-ads-api, release