Actualización de la Política de Uso de Recursos de la API de Google Ads

Miércoles, 1 de mayo de 2024

¿Cuáles son los cambios?

Actualizaremos la política de uso de recursos de la API de Google Ads para limitar los patrones de consulta de GoogleAdsService.Search y GoogleAdsService.SearchStream que consumen una cantidad excesiva de recursos de la API. Si se limita un patrón de consulta en particular, otros servicios, métodos y patrones de consulta seguirán funcionando sin verse afectados.

A partir de la semana del 17 de junio de 2024, y solo para los patrones de consulta limitados, las solicitudes se verán afectadas de la siguiente manera:

  • Si usas la versión v17 o una anterior de la API, recibirás un error QuotaError.RESOURCE_EXHAUSTED.
  • Si usas la versión v18 o una posterior de la API, recibirás un error QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION o QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION, según si el consumo excesivo de recursos se produjo durante un período breve (unos minutos) o un período prolongado.

Para ayudarte a identificar y supervisar tus informes costosos, también mostraremos una métrica de costo para los informes individuales. Para ver el costo de los informes exitosos, consulta los siguientes campos:

¿Por qué se aplicó este cambio?

Realizamos este cambio para preservar la confiabilidad y estabilidad de la API.

¿Qué debo hacer?

Antes del 17 de junio de 2024, actualiza tus aplicaciones para que realicen las siguientes acciones:

  • Controla los nuevos códigos de error cuando realices llamadas a GoogleAdsService::Search or GoogleAdsService::SearchStream
    • Si usas la versión v17 o una anterior de la API de Google Ads, controla los errores QuotaError.RESOURCE_EXHAUSTED.
    • Si usas la versión v18 o una posterior de la API, controla los errores QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION y QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION.
  • Si se limita uno o más de tus patrones de consulta de informes, debes revisarlos y corregirlos. Estas son algunas formas de mejorar el rendimiento de las consultas:
    • Ejecuta la consulta con menos frecuencia.
    • Usa un patrón de consulta o una vista menos costosos.

Para obtener más información sobre cómo optimizar tus consultas, consulta Administra la eficiencia de los datos.

  • [Opcional] Incorpora la nueva métrica query_resource_consumption a tus sistemas de supervisión para detectar y controlar las nuevas consultas costosas.

Cómo obtener ayuda

Si tienes alguna pregunta sobre este cambio o necesitas ayuda para optimizar patrones de consulta específicos, consulta la página de asistencia de la API de Google Ads para conocer las opciones disponibles.

- David Stevens, gerente de producto de la API de Google Ads

Etiquetas: google-ads-api