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 el precio general de Search Ads 360. No se aplican tarifas 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 por usuario
- 3,000 búsquedas por minuto por proyecto
- 150,000 consultas 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 API que se realizan 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.
En la siguiente tabla, se proporcionan algunos ejemplos de la contabilización:
| Solicitud a la API | Operaciones que se tienen en cuenta para el límite diario |
|---|---|
Operación: Search
Cantidad: 53 grupos de anuncios
Servicio: |
1 |
Operación: SearchStream
Cantidad: 45 campañas
Servicio: |
1 |
Las solicitudes que infrinjan estos límites se rechazarán con el error RESOURCE_EXHAUSTED.
Solicitudes de búsqueda
Una solicitud Search o SearchStream se 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 informes de Search Ads 360 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 incluya muchos campos puede generar una respuesta de más de 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 consideran en 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 infringen 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 muestran excepciones de la API
Las solicitudes que se rechazan con un
SearchAds360Failure aún se consideran en la
cuota de operaciones diarias del usuario.
Las solicitudes que fallan, pero no muestran un SearchAds360Failure, como las que se producen por un error a nivel de la red, no se registrará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
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 error REQUEST_SIZE_LIMIT_EXCEEDED.
Este mismo mensaje de error también puede deberse a otros problemas.
Cuando realizas 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 muestra un error FILTER_HAS_TOO_MANY_VALUES.