La API de Google Ads aplica límites a las operaciones de la API, como la cantidad de operaciones que se pueden enviar en una sola solicitud de modificación. 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 | ||
|---|---|---|
| Operaciones con el nivel de acceso básico | 15,000 operaciones de API por día |
RESOURCE_EXHAUSTED
|
| Solicitudes de mutación | 10,000 operaciones por solicitud |
TOO_MANY_MUTATE_OPERATIONS
|
| Solicitudes de 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 servicio de facturación y presupuesto de la cuenta | 1 operación por solicitud de mutación |
TOO_MANY_MUTATE_OPERATIONS
|
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 token de desarrollador. Las operaciones de la API son la suma total de las solicitudes de obtención y las operaciones de modificación. Los límites para las operaciones diarias de la API dependen del nivel de acceso del token de desarrollador. En la guía de Niveles de acceso y uso permitido, se describen los límites específicos de las operaciones de la API para cada nivel de acceso.
Las solicitudes que incumplen 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 del mensaje en 64 MB para aumentar la eficiencia.
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 64 MB de tamaño. Para evitar este límite, puedes reducir la cantidad de campos seleccionados o usar la transmisión. Para las mutaciones, envía menos operaciones por solicitud.
Las solicitudes que incumplan esta limitación no generarán un GoogleAdsError, sino un error de gRPC 429 Resource Exhausted. Consulta la lista de códigos y mensajes de error de gRPC.
Solicitudes de mutación
Además de contabilizarse en la cuota de operaciones diarias del usuario, una solicitud de modificación no puede contener más de 10,000 operaciones por solicitud.
Las solicitudes que incumplen esta limitación se rechazan con el error TOO_MANY_MUTATE_OPERATIONS.
A continuación, se describen los límites y las consideraciones adicionales para los servicios y los tipos de solicitudes específicos.
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.
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 para la cuota de operaciones diarias.
Para obtener más detalles sobre la paginación, consulta Desplázate por los resultados.
Otros tipos de solicitudes
Una solicitud que no sea de Get, Mutate, Search o SearchStream se considera una operación que se descuenta de la cuota diaria de operaciones del usuario.
Estos son algunos ejemplos de solicitudes de este tipo:
BatchJobService.ListMutateJobResultsConversionUploadService.UploadCallConversionsConversionUploadService.UploadClickConversionsOfflineUserDataJobService.AddOfflineUserDataJobOperationsOfflineUserDataJobService.CreateOfflineUserDataJobUserDataService.UploadUserData
Solicitudes que devuelven excepciones de la API
Las solicitudes que se rechazan con un GoogleAdsFailure aún se consideran en la cuota de operaciones diarias del usuario.
Las solicitudes que fallan, pero no muestran un GoogleAdsFailure, 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ían al servicio. Un ejemplo de esto es una falla de conectividad de red.
Servicio de planificación de palabras clave
Debido a su costo y complejidad, los siguientes métodos del servicio de Planificación de palabras clave están sujetos a límites independientes de otros tipos de solicitudes.
Se limita a 1 solicitud por segundo por CID:
KeywordPlanIdeaService.GenerateKeywordIdeasKeywordPlanIdeaService.GenerateKeywordHistoricalMetricsKeywordPlanIdeaService.GenerateKeywordForecastMetrics
Las solicitudes que incumplen estas limitaciones se rechazan con el error
RESOURCE_EXHAUSTED.1 QPS se calcula como 60 solicitudes por 60 segundos.
Se limita a 2 solicitudes por segundo por CID:
Ten en cuenta estos límites cuando crees un plan de palabras clave.
| Objeto KeywordPlan | 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 estadísticas de público
Los siguientes métodos dentro de los métodos AudienceInsightsService están sujetos a límites de cuota específicos.
Se limita a aproximadamente 200 solicitudes por día por CID:
Se limita a 2 solicitudes por segundo por token de desarrollador:
Servicio de carga de conversiones
Se limita a 2,000 conversiones de llamadas o clics por solicitud:
Las solicitudes que incumplen estos límites se rechazan con el error
TOO_MANY_CONVERSIONS_IN_REQUEST.
Servicio de carga de ajustes de conversiones
Se limita a 2,000 ajustes de conversiones por solicitud:
Las solicitudes que incumplen estos límites se rechazan con el error
TOO_MANY_ADJUSTMENTS_IN_REQUEST.
Servicios de facturación y presupuesto de la cuenta
Las mutaciones solo se pueden realizar en cuentas configuradas para la facturación mensual.
Las solicitudes que incumplen esta limitación se rechazan con el error
MUTATE_NOT_ALLOWED.Solo se permite 1 operación para las solicitudes de modificación.
Las solicitudes que incumplen esta limitación se rechazan con el error
TOO_MANY_MUTATE_OPERATIONS.Debes esperar al menos 12 horas entre los cambios en los pedidos de presupuesto de la misma cuenta. Si realizas cambios antes de que transcurran 12 horas, es posible que se produzcan errores irrecuperables que solo podrá resolver tu representante de la cuenta de Google Ads.
Invitaciones a cuentas de clientes
Se puede invitar a usuarios nuevos a cuentas de cliente existentes con CustomerUserAccessService. Dado que esta función envía correos electrónicos de invitación a otros usuarios, se puede usar de forma inadecuada. Por lo tanto, existen limitaciones en su comportamiento:
Los usuarios no pueden recibir más de una invitación pendiente para la misma cuenta de cliente. Si se realiza una solicitud posterior para enviar una invitación a un usuario que ya tiene una invitación pendiente, se devuelve este error:
ACCESS_INVITATION_ERROR_EMAIL_ADDRESS_ALREADY_HAS_PENDING_INVITATION.Las cuentas de cliente no pueden tener más de 70 invitaciones pendientes a la vez. Si se envía una solicitud que hace que se supere este valor, se devuelve el siguiente error:
ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.
Datos del usuario
Los datos del usuario se administran con UserDataService y OfflineUserDataJobService.
En una operación de creación o eliminación UserData determinada, cada conjunto de user_identifiers debe ser específico para un solo usuario.
Para aplicar este requisito, se muestra un error de OfflineUserDataJobError.TOO_MANY_USER_IDENTIFIERS o UserDataError.TOO_MANY_USER_IDENTIFIERS cuando hay más de 20 user_identifiers en un conjunto de UserData.
Puedes usar hasta 100,000 identificadores de usuario, independientemente de la cantidad de operaciones.
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 te encuentras con 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 de mutación.
Cuando se realiza una consulta en GAQL, 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.