La API de Search Ads 360 Reporting aplica límites a las operaciones de la API para garantizar un rendimiento óptimo del sistema 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 cargos adicionales por usar la API.
Límites de consultas
Los siguientes límites se aplican a las operaciones de consulta que se realizan a través de los métodos Search o SearchStream.
- 3,000 consultas por minuto por proyecto y por usuario
- 3,000 búsquedas por minuto por proyecto
- 150,000 búsquedas por día por proyecto
Límites diarios de operaciones de la API
Los límites de uso diario de la API se basan en la cantidad de operaciones de la API que se realizan por proyecto de Google Cloud.
Una sola consulta o informe se cuenta como una operación, independientemente de que los resultados se transmitan a través de SearchAds360Service.SearchStream o se paginen desde una llamada a SearchAds360Service.Search. Obtén más información.
En la siguiente tabla, se proporcionan algunos ejemplos de la contabilidad:
| Solicitud a la API | Operaciones que se incluyen en el límite diario |
|---|---|
Operación: Search
Recuento: 53 grupos de anuncios Servicio: SearchAds360Service
|
1 |
Operación: SearchStream
Recuento: 45 campañas Servicio: SearchAds360Service
|
1 |
Las solicitudes que incumplen estos límites se rechazan con el error RESOURCE_EXHAUSTED.
Solicitudes de búsqueda
Una solicitud Search o SearchStream se considera una operación en la cuota de operaciones diarias del usuario. Una solicitud SearchStream se considera una operación de la API, independientemente de 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 exceder este límite. Por ejemplo, una solicitud de búsqueda que incluye muchos campos puede 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 incumplan esta limitación no generarán un SearchAds360Error, sino que generarán un error de gRPC 429 Resource Exhausted. 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 contabilizarán en la cuota de operaciones diarias.
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 incumplen este límite, con el error INVALID_PAGE_SIZE.
Para obtener más detalles sobre la paginación, consulta Desplázate por los resultados.
Solicitudes que devuelven excepciones de la API
Las solicitudes que se rechazan con un SearchAds360Failure aún se incluyen en la cuota de operaciones diarias del usuario.
Las solicitudes que fallan, pero no devuelven un SearchAds360Failure, como las que se producen por un error a nivel de la red, no se contabilizarán en la cuota de operaciones diarias del usuario, ya que las solicitudes nunca llegarán al servicio. Un ejemplo de esto es una falla en la conectividad de la red.
Otros tipos de límites
Un campo repetido, como una lista de operaciones, que tiene demasiados elementos en una solicitud puede generar el error REQUEST_SIZE_LIMIT_EXCEEDED.
Este mismo mensaje de error también puede deberse a otros problemas.
Cuando se realiza una consulta con el lenguaje de consultas de Search Ads 360, la cantidad máxima de elementos dentro de una cláusula IN es de 20,000. Si superas ese límite, se mostrará un error de FILTER_HAS_TOO_MANY_VALUES.