Límites y cuotas de 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 sola solicitud de mutación. La siguiente tabla resume algunos de sobre los límites y las cuotas importantes que se deben 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
Solicitudes de modificación	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 del Servicio de facturación y de presupuesto de la cuenta	1 operación por solicitud de mutación	TOO_MANY_MUTATE_OPERATIONS

Límites diarios de operación de la API

Los límites de uso diario de la API se basan en la cantidad de API por token de desarrollador. API operaciones son la suma total de las solicitudes GET y las operaciones mutate. Límites para las operaciones diarias de la API depende del nivel de acceso del token de desarrollador. El En la guía de niveles de acceso y uso permitido, se describen los límites específicos de operaciones de la API para cada nivel de acceso.

Las solicitudes que incumplen estos límites se rechazan con el siguiente 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 del 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 superar este límite. Por ejemplo, una solicitud de búsqueda que incluye muchos campos que puede generar una respuesta que supere los 64 MB de tamaño. Para evitar este límite, reducir la cantidad de campos seleccionados, reducir la cantidad o usar la transmisión. Para mutaciones, envía menos operaciones por solicitud.

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

Solicitudes de modificación

Además de descontar de la cuota de operaciones diarias del usuario, una modificación no puede contener más de 10,000 operaciones por solicitud.

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

Se aplican límites y consideraciones adicionales para servicios y tipos de solicitudes específicos que se describen a continuación.

Solicitudes de búsqueda

Una solicitud Search o SearchStream cuenta como una operación para la solicitud la cuota de operación diaria. Una solicitud SearchStream cuenta como una operación de API. sin importar la cantidad de lotes.

Solicitudes paginadas

Solicitudes paginadas (por ejemplo, solicitudes que contienen un next_page_token) 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á una excepción y se descontará de la cuota de operación diaria.

Las solicitudes paginadas, como las solicitudes de búsqueda, también están sujetas a la Page size cannot exceed 10,000 rows limitación y se rechazan si infringe este límite, con el siguiente error: INVALID_PAGE_SIZE.

Para obtener más detalles sobre la paginación, consulta Paginación a través de resultados.

Otros tipos de solicitudes

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

Estos son algunos ejemplos de tales solicitudes:

• 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 aún se cuentan en el la cuota de operaciones diarias del usuario.

Solicitudes que fallan, pero que no muestran un GoogleAdsFailure, como de un error en el nivel de red, no se descontará 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.

Servicios de planificación

Debido al costo y la complejidad, los métodos del servicio de planificación que se mencionan a continuación son que están sujetas a límites distintos a los de otros tipos de solicitudes.

• Límite de 1 solicitud por segundo por CID:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics
  • KeywordPlanIdeaService.GenerateKeywordForecastMetrics

  Las solicitudes que no cumplen con estas limitaciones se rechazan con el siguiente error: RESOURCE_EXHAUSTED.

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

• Límite de 2 solicitudes por segundo, por CID:

  • KeywordPlanIdeaService.GenerateAdGroupTheme

Ten en cuenta estos límites cuando crees 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

• Límite de 2,000 conversiones de llamadas o clics por solicitud:

  • ConversionUploadService.UploadCallConversions
  • ConversionUploadService.UploadClickConversions

  Las solicitudes que incumplen estos límites se rechazan con el siguiente error: TOO_MANY_CONVERSIONS_IN_REQUEST.

Servicio de carga de ajustes de conversiones

• Límite de 2,000 ajustes de conversión por solicitud:

  • ConversionAdjustmentUploadService.UploadConversionAdjustments

  Las solicitudes que incumplen estos límites se rechazan con el siguiente error: TOO_MANY_ADJUSTMENTS_IN_REQUEST.

Servicios de facturación y presupuesto de la cuenta

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

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

• Debe esperar, al menos, 12 horas entre cada cambio de pedido de presupuesto al misma cuenta. Realizar cambios antes de que transcurran 12 horas puede hacer que fallas irrecuperables que solo pueden resolverse con su cuenta de Google Ads representante.

Invitaciones a cuentas de clientes

Se puede invitar a usuarios nuevos a cuentas de clientes existentes con el CustomerUserAccessService. Porque esta función envía correos electrónicos de invitación a otros usuarios, tiene el potencial se utilicen de forma inadecuada y, por lo tanto, existen limitaciones en su comportamiento:

• Los usuarios no pueden recibir más de una invitación pendiente para el mismo cliente de servicio predeterminada. Si se hace 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 provoca que se supere este valor, este error devuelto: ACCESS_INVITATION_ERROR_PENDING_INVITATIONS_LIMIT_EXCEEDED.

Datos del usuario

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

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

Otros tipos de límites

Un campo repetido, como una lista de operaciones, que tiene demasiados elementos en una puede generar el siguiente 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 intenta reducir la cantidad de elementos en el campo repetido implementando un una lista de operaciones en una solicitud de mutación.

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