La API de Search Ads 360 Reporting aplica límites en las operaciones de la API para garantizar un rendimiento del sistema óptimo para todos los usuarios.
Precios
El uso de la API de Search Ads 360 Reporting se incluye en los precios generales de Search Ads 360. No se aplican tarifas adicionales por usar la API.
Límites de consulta
Los siguientes límites se aplican a las operaciones de consulta realizadas a través de los métodos Search o SearchStream.
- 3,000 consultas por minuto, por proyecto y por usuario
- 3,000 consultas por minuto, por proyecto
- 150,000 consultas al día, por proyecto
Límites diarios de operación de la API
Los límites de uso diario de la API se basan en la cantidad de operaciones de API realizadas por proyecto de Google Cloud.
Una sola consulta o informe se cuenta como una operación, sin importar si los resultados se transmiten a través de SearchAds360Service.SearchStream o se paginan desde una llamada SearchAds360Service.Search.
Obtén más información.
La siguiente tabla proporciona algunos ejemplos de la contabilización:
| Solicitud a la API | Las operaciones se cuentan para el límite diario |
|---|---|
Operación: Search
Recuento: 53 grupos de anuncios
Servicio: |
1 |
Operación: SearchStream
Recuento: 45 campañas
Servicio: |
1 |
Las solicitudes que incumplen estos límites se rechazan con el error:
RESOURCE_EXHAUSTED.
Solicitudes de búsqueda
Una solicitud Search o SearchStream cuenta como una operación en la cuota de operaciones diarias del usuario. Una solicitud SearchStream cuenta como una operación de API, sin importar la cantidad de lotes.
Limitaciones de gRPC
Todas las bibliotecas cliente de la API de Search Ads 360 Reporting usan gRPC para generar solicitudes y respuestas. De forma predeterminada, gRPC tiene un tamaño de mensaje de 4 MB.
Las respuestas no deben superar este límite. Por ejemplo, una solicitud de búsqueda que incluya muchos campos podría generar una respuesta que supere los 4 MB de tamaño. Para evitar este límite, puedes reducir la cantidad de campos seleccionados, reducir el tamaño de la página o usar transmisión.
Las solicitudes que infrinjan esta limitación no generarán una SearchAds360Error, pero sí un error 429 Resource Exhausted de gRPC. Consulta la lista de códigos y mensajes de error de gRPC.
Solicitudes paginadas
Las solicitudes paginadas (por ejemplo, las que contienen un next_page_token válido) no se descuentan de la cuota de operaciones diarias de un usuario.
Sin embargo, las solicitudes de paginación que contengan un token de página vencido o no válido generarán una excepción y se descuentan de la cuota de operación diaria.
Las solicitudes paginadas, como las de búsqueda, también están sujetas a la limitación de Page size cannot exceed 10,000 rows y se rechazan si infringen este límite, con el error INVALID_PAGE_SIZE.
Para obtener más detalles sobre la paginación, consulta Paginación de los resultados.
Solicitudes que muestran excepciones de API
Las solicitudes que se rechazan con un SearchAds360Failure aún se descuentan de la cuota de operaciones diarias del usuario.
Las solicitudes que fallan, pero que no muestran una SearchAds360Failure, como las de un error a nivel de red, no se descontarán de la cuota de operaciones diarias del usuario, ya que las solicitudes nunca llegarían al servicio. Un ejemplo de esto es una falla de conectividad de red.
Otros tipos de límites
Un campo repetido, como una lista de operaciones, que tiene demasiados elementos en una solicitud puede generar el siguiente error: REQUEST_SIZE_LIMIT_EXCEEDED.
Este mismo mensaje de error también puede deberse a otros problemas.
Cuando realizas una consulta en el lenguaje de consulta de Search Ads 360, la cantidad máxima de elementos en una cláusula IN es de 20,000. Si superas ese límite, se mostrará un error FILTER_HAS_TOO_MANY_VALUES.