La API de Search Ads 360 Reporting aplica límites en 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 consulta
Los siguientes límites se aplican a las operaciones de búsqueda 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 diarias por proyecto
Límites diarios de operaciones de API
Los límites de uso diario de las APIs 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, sin importar los resultados que se transmitan a través de SearchAds360Service.SearchStream
o paginados desde una llamada SearchAds360Service.Search
.
Obtén más información.
La siguiente tabla ofrece algunos ejemplos de la contabilización:
Solicitud a la API | Operaciones registradas 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 infringen estos límites se rechazan con el error RESOURCE_EXHAUSTED
.
Solicitudes de búsqueda
Una solicitud Search
o SearchStream
cuenta como una operación de la cuota de operaciones diarias del usuario. Una solicitud SearchStream
cuenta como una operación de 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 superar 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 el de transmisión.
Las solicitudes que infrinjan esta limitación no generarán un SearchAds360Error
, pero sí un error 429 Resource Exhausted
de gRPC. Consulta la lista de códigos de error y mensajes 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 contienen un token de página no válido o vencido generarán una excepción y se tendrán en cuenta para la cuota de operaciones diarias.
Las solicitudes paginadas, como las solicitudes 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 Cómo desplazarse por los resultados.
Solicitudes que muestran excepciones de API
Las solicitudes que se rechazan con un SearchAds360Failure
se descuentan de la cuota de operaciones diaria del usuario.
Las solicitudes que fallan pero no muestran un SearchAds360Failure
(por ejemplo, si se produce un error en el nivel de red) no se descuentan 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 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 20,000. Si superas ese límite, se mostrará un error FILTER_HAS_TOO_MANY_VALUES
.