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
|
|
Silencia 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 de servicio de presupuesto de la cuenta | 1 operación por solicitud de mutación |
TOO_MANY_MUTATE_OPERATIONS
|
Límites de operaciones de la API a diario
Los límites de uso diarios de la API se basan en la cantidad de operaciones de la API realizadas por token de desarrollador. Las operaciones de API son la suma total de solicitudes de obtención y 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 de la API específicos 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 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 incluya muchos campos podría 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 una GoogleAdsError
, pero generarán un error de gRPC de 429 Resource Exhausted
. Consulta la lista de códigos de error y mensajes de gRPC.
Silencia solicitudes
Además de contar 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 solicitudes específicos.
Solicitudes de búsqueda
Una solicitud Search
o SearchStream
cuenta como una operación respecto de la cuota diaria de operaciones 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 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 incumplen 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
o SearchStream
cuenta como una operación que se descuenta de la cuota diaria de operaciones del usuario.
Estos son algunos ejemplos de estas solicitudes:
BatchJobService.ListMutateJobResults
ConversionUploadService.UploadCallConversions
ConversionUploadService.UploadClickConversions
OfflineUserDataJobService.AddOfflineUserDataJobOperations
OfflineUserDataJobService.CreateOfflineUserDataJob
UserDataService.UploadUserData
Solicitudes que muestran excepciones de API
Las solicitudes rechazadas con un GoogleAdsFailure
se descuentan de la cuota diaria de operaciones del usuario.
Las solicitudes que fallan, pero no muestran una GoogleAdsFailure
, como la 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 al costo y la complejidad, los métodos del servicio de Planificación que se indican a continuación están sujetos a límites separados de otros tipos de solicitudes.
Limitado a 1 solicitud por segundo por CID o token de desarrollador:
KeywordPlanService.GetKeywordPlan
KeywordPlanService.GenerateHistoricalMetrics
KeywordPlanService.GenerateForecastMetrics
Las solicitudes que infringen estas limitaciones se rechazan con el error:
RESOURCE_EXHAUSTED
.1 QPS equivale a 60 solicitudes cada 60 segundos.
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
Límite de 2,000 conversiones de llamada o clic por solicitud:
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 conversión por solicitud:
Las solicitudes que infringen estos límites se rechazan con el error:
TOO_MANY_ADJUSTMENTS_IN_REQUEST
.
Facturación y servicios de presupuesto de la cuenta
Los cambios solo se pueden realizar en las cuentas configuradas para la facturación mensual.
Las solicitudes que infringen esta limitación se rechazan con el error:
MUTATE_NOT_ALLOWED
.Solo se permite la operación 1 para las solicitudes mutables.
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. Realizar cambios antes de que transcurran 12 horas puede dar como resultado fallas irrecuperables que solo puede resolver el representante de su cuenta de Google Ads.
Invitaciones a cuentas de clientes
Los usuarios nuevos se pueden invitar a cuentas de cliente existentes con el CustomerUserAccessService
. Debido a que esta funcionalidad envía correos electrónicos de invitación a otros usuarios, tiene el potencial de usarse de manera inadecuada. Por lo tanto, 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 muestra 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 mostrará 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 determinada de UserData
para crear o quitar elementos, 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 topas 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 GAQL, la cantidad máxima de elementos dentro de una cláusula IN
es 20,000. Si excedes ese límite, se muestra un error FILTER_HAS_TOO_MANY_VALUES
.