Límites y cuotas de API

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 mutación. En la siguiente tabla, se resumen algunos de los límites y 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
Modificación de solicitudes	10,000 operaciones por solicitud	TOO_MANY_MUTATE_OPERATIONS
Solicitudes de servicios 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 servicios de presupuesto de la cuenta y facturación	1 operación por solicitud de mutación	TOO_MANY_MUTATE_OPERATIONS

Límites diarios de operaciones de API

Los límites de uso diario de la API se basan en la cantidad de operaciones de la API realizadas por cada 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 del desarrollador. En la guía de Niveles de acceso y uso permitido, se describen los límites de operación específicos de la API 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 los mensajes 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 las mutaciones, envía menos operaciones por solicitud.

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

Modificación de solicitudes

Además de deducir de la cuota de operaciones diarias 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 error TOO_MANY_MUTATE_OPERATIONS.

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

Solicitudes de búsqueda

Una solicitud de 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, sin importar la cantidad de lotes.

Solicitudes paginadas

Las solicitudes paginadas (por ejemplo, las solicitudes que contienen un next_page_token válido) no se descuentan de la cuota de operación diaria 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 ocuparán espacio de la cuota diaria de operación.

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 Paging por los resultados.

Otros tipos de solicitudes

Una solicitud que no sea Get, Mutate, Search o SearchStream cuenta como una operación en la cuota de operaciones diarias del usuario.

Algunos ejemplos de tales solicitudes incluyen los siguientes:

• BatchJobService.ListMutateJobResults
• ConversionUploadService.UploadCallConversions
• ConversionUploadService.UploadClickConversions
• OfflineUserDataJobService.AddOfflineUserDataJobOperations
• OfflineUserDataJobService.CreateOfflineUserDataJob
• UserDataService.UploadUserData

Solicitudes que muestran excepciones de API

Las solicitudes que se rechazan con un GoogleAdsFailure se descuentan de la cuota de operaciones diarias del usuario.

Las solicitudes que fallan, pero no muestran un GoogleAdsFailure, como las de un error en el 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 al costo y la complejidad, los métodos del Servicio de planificación que se enumeran a continuación están sujetos a límites independientes de otros tipos de solicitudes.

• Límite de 1 solicitud por segundo por CID o token de desarrollador:

  • KeywordPlanService.GetKeywordPlan
  • KeywordPlanService.GenerateHistoricalMetrics
  • KeywordPlanService.GenerateForecastMetrics

  Las solicitudes que incumplen estas limitaciones se rechazan con el error: RESOURCE_EXHAUSTED.

• 1 QPS se calcula como 60 solicitudes cada 60 segundos.

Ten en cuenta estos límites cuando crees un plan de palabras clave.

Objeto de 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

• Límite de 2,000 conversiones de llamada o clic por solicitud:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

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

Servicio de carga de ajuste de conversiones

• Límite de 2,000 ajustes de conversiones por solicitud:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

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

Servicios de facturación y presupuestos de la cuenta

• Solo se pueden realizar modificaciones en cuentas configuradas para facturación mensual.

  Las solicitudes que infringen esta limitación se rechazan con el 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 error TOO_MANY_MUTATE_OPERATIONS.

• Debes esperar al menos 12 horas entre los cambios de pedido de presupuesto en la misma cuenta. Si realizas cambios antes de que transcurran las 12 horas, es posible que se generen fallas irrecuperables que solo el representante de tu cuenta de Google Ads podrá resolver.

Invitaciones a cuentas de clientes

Se puede invitar a usuarios nuevos a cuentas de cliente existentes con el CustomerUserAccessService. Debido a que esta función envía correos electrónicos de invitación a otros usuarios, tiene el potencial de no usarse de forma inadecuada, por lo que su comportamiento tiene limitaciones:

• 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 mostrará 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 causa que se supere este valor, se muestra este 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 UserData de creación o eliminación determinada, cada conjunto de user_identifiers debe ser específico para un solo 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 te encuentras con esta limitación y realizas solicitudes que usan un campo repetido, intenta reducir la cantidad de elementos en el campo repetido mediante la implementación de una lista de operaciones en una solicitud de mutación.

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