Atualização da política de uso de recursos da API Google Ads

Quarta-feira, 1º de maio de 2024

O que muda?

Estamos atualizando a política de uso de recursos da API Google Ads para limitar os padrões de consulta GoogleAdsService.Search e GoogleAdsService.SearchStream que consomem muitos recursos da API. Se um padrão de consulta específico for limitado, outros serviços, métodos e padrões de consulta vão continuar funcionando sem serem afetados.

A partir da semana de 17 de junho de 2024, e apenas para os padrões de consulta limitados, as solicitações serão afetadas da seguinte forma:

  • Se você usar a versão v17 ou anterior da API, vai receber um erro QuotaError.RESOURCE_EXHAUSTED.
  • Se você usar a versão v18 ou mais recente da API, vai receber um QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ou QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, dependendo se o consumo excessivo de recursos foi por um curto período (alguns minutos) ou por um longo período.

Para ajudar você a identificar e monitorar seus relatórios caros, também vamos retornar uma métrica de custo para relatórios individuais. Para conferir o custo dos relatórios bem-sucedidos, consulte os seguintes campos:

Qual é o motivo da mudança?

Estamos fazendo essa mudança para preservar a confiabilidade e a estabilidade da API.

O que eu preciso fazer?

Antes de 17 de junho de 2024, atualize seus aplicativos para fazer o seguinte:

  • Processar os novos códigos do erro ao fazer chamadas de GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Se você usa a versão v17 ou anterior da API Google Ads, trate os erros QuotaError.RESOURCE_EXHAUSTED.
    • Se você usa a versão v18 ou mais recente da API, processe os erros QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION e QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Se um ou mais dos seus padrões de consulta de relatórios forem limitados, revise e corrija o padrão de consulta. Veja algumas maneiras de melhorar o desempenho das consultas:
    • Execute a consulta com menos frequência.
    • Use um padrão de consulta ou uma visualização mais barata.

Para saber mais sobre como otimizar suas consultas, consulte Gerenciar a eficiência dos dados.

  • [Opcional] Incorpore a nova métrica query_resource_consumption aos seus sistemas de monitoramento para detectar e processar novas consultas caras.

Como conseguir ajuda

Se tiver dúvidas sobre essa mudança ou precisar de ajuda para otimizar padrões de consulta específicos, consulte as opções na página de suporte da API Google Ads.

– David Stevens, gerente de produtos da API Google Ads

Marcadores: google-ads-api