Límites y cuotas de la API

La API de Google Ads aplica límites en las operaciones de la API, como la cantidad de operaciones que se pueden enviar en una solicitud de mutación única. En la siguiente tabla, se resumen algunos de los límites y las cuotas importantes que debes tener en cuenta.

Tipo de solicitud, limitación y código de error
Solicitudes paginadas 10,000 filas por página INVALID_PAGE_SIZE
Operaciones con acceso básico 15,000 operaciones de API por día RESOURCE_EXHAUSTED
Obtener solicitudes 1,000 solicitudes por día RESOURCE_EXHAUSTED
Modificar solicitudes 10,000 operaciones por solicitud TOO_MANY_MUTATE_OPERATIONS
Solicitudes del servicio de planificación 1 QPS RESOURCE_EXHAUSTED
Solicitudes del servicio de carga de conversiones 2,000 conversiones por solicitud TOO_MANY_CONVERSIONS_IN_REQUEST
Solicitudes de facturación y del servicio de presupuesto de la cuenta 1 operación por solicitud mutada TOO_MANY_MUTATE_OPERATIONS

Límites de operaciones diarias de la API

Los límites de uso diarios de la API se basan en la cantidad de operaciones de la API que se realizan por token de desarrollador. Las operaciones de la API son la suma total de las solicitudes get y las operaciones de mutación. Los límites para las operaciones diarias de la API dependen del nivel de acceso del token de desarrollador. En la guía sobre niveles de acceso y uso permitido, se describen los límites de operación de la API específicas para cada nivel de acceso.

Las solicitudes que infringen estos límites se rechazan con el error RESOURCE_EXHAUSTED.

Limitaciones de gRPC

Todas las bibliotecas cliente de la API de Google Ads usan gRPC para generar solicitudes y respuestas. De forma predeterminada, gRPC tiene un tamaño de mensaje de 4 MB, pero nuestras bibliotecas cliente establecen el tamaño máximo de mensaje en 64 MB para aumentar la eficiencia.

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 64 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 la transmisión. Para mutaciones, envía menos operaciones por solicitud.

Las solicitudes que infringen esta limitación no generarán un GoogleAdsError, pero un error de gRPC de 429 Resource Exhausted. Consulta la lista de códigos y mensajes de error de gRPC.

Obtener solicitudes (dejó de estar disponible)

Las solicitudes a Get (por ejemplo, con el método GetCampaign en el CampaignService) tienen limitaciones de uso diario separadas de los límites en las operaciones, que se describen en la Guía de niveles de acceso y uso permitido.

A diferencia de las operaciones diarias, los límites en las solicitudes get no varían según el nivel de acceso. Todos los tokens de desarrollador, incluidos los de Acceso estándar, tienen un límite de 1,000 solicitudes diarias.

A diferencia de las solicitudes de búsqueda, la obtención de solicitudes es costosa porque se recuperan todos los datos de atributos. Por eso, te recomendamos que uses la búsqueda en lugar de obtener siempre que sea posible.

Las solicitudes que infringen estos límites se rechazan con el error RESOURCE_EXHAUSTED.

Modificar solicitudes

Además de contar para la cuota de operación diaria del usuario, una solicitud de mutación no puede contener más de 10,000 operaciones por solicitud.

Las solicitudes que infringen esta limitación se rechazan con el siguiente error: TOO_MANY_MUTATE_OPERATIONS.

A continuación, se describen los límites y las consideraciones adicionales para servicios y tipos de solicitudes específicos.

Solicitudes de búsqueda

Una solicitud Search o SearchStream cuenta como una operación contra la cuota diaria de operación del usuario. Una solicitud SearchStream cuenta como una operación de API independientemente de la cantidad de lotes.

Solicitudes paginadas

Las solicitudes paginadas (por ejemplo, las que contienen un next_page_token válido) no se cuentan en la cuota de operación diaria de un usuario. Sin embargo, las solicitudes de paginación que contienen un token de página vencido o no válido generarán una excepción y se descontarán de la cuota de operación diaria.

Las solicitudes paginadas, como las de búsqueda, también están sujetas a la limitación 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 Paging a través de los resultados.

Otros tipos de solicitudes

Una solicitud que no es Get, Mutate, Search ni SearchStream cuenta como una operación contra la cuota diaria de operación del usuario.

Algunos ejemplos de estas solicitudes son los siguientes:

Solicitudes que muestran excepciones de API

Las solicitudes rechazadas con una solicitud GoogleAdsFailure se descuentan de la cuota de operación diaria del usuario.

Las solicitudes que fallan, pero no muestran un GoogleAdsFailure, como de un error a nivel de red, no se descuentan de la cuota de operación diaria del usuario, ya que las solicitudes nunca llegarían al servicio. Un ejemplo de esto es una falla de conectividad de red.

Servicios de planificación

Debido a los costos y a la complejidad, los métodos de servicio de Planning que se mencionan a continuación están sujetos a límites separados de otros tipos de solicitudes.

Tenga en cuenta estos límites cuando cree un plan de palabras clave.

Objeto del plan de palabras clave Cantidad máxima
KeywordPlan por cuenta 10,000
KeywordPlanAdGroup por KeywordPlan 200
KeywordPlanAdGroupKeyword por KeywordPlan 10,000
KeywordPlanCampaignKeyword (palabras clave negativas) 1,000
KeywordPlanCampaign por KeywordPlan 1

Servicio de carga de conversiones

Servicio de carga con ajuste de conversiones

Servicios de facturación y de presupuesto de la cuenta

  • Las modificaciones solo pueden realizarse con las cuentas configuradas para facturación mensual.

    Las solicitudes que infringen esta limitación se rechazan con el siguiente error: MUTATE_NOT_ALLOWED.

  • Solo se permite 1 operación para las solicitudes de mutación.

    Las solicitudes que infringen esta limitación se rechazan con el siguiente error: TOO_MANY_MUTATE_OPERATIONS.

  • Debe esperar, al menos, 12 horas entre los cambios de pedidos de presupuesto en la misma cuenta. Si realiza cambios antes de que transcurran 12 horas, es posible que se produzcan fallas irrecuperables que solo podrá resolver el representante de su cuenta de Google Ads.

Invitaciones a cuentas de clientes

Se puede invitar a usuarios nuevos a las cuentas de cliente existentes mediante CustomerUserAccessService. Dado que esta funcionalidad envía correos electrónicos de invitación a otros usuarios, es posible que se la use de forma inadecuada y, por lo tanto, su comportamiento tiene limitaciones:

Datos del usuario

Los datos del usuario se administran con UserDataService y OfflineUserDataJobService. En una operación UserData determinada de creación o eliminación, cada conjunto de user_identifiers debe ser específico para un único usuario.

Para aplicar esto, se muestra un error OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS cuando hay más de 20 user_identifiers en un conjunto UserData.

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.

Si encuentras esta limitación y realizas solicitudes que usan un campo repetido, intenta reducir la cantidad de elementos en el campo repetido implementando una lista de operaciones en una solicitud mutada.

Cuando realizas una consulta de GAQL, la cantidad máxima de elementos dentro de una cláusula IN es 20,000. Si excedes ese límite, se muestra el error FILTER_HAS_TOO_MANY_VALUES.