Límite de tasa

La Ads API tiene límites de tasa similares a los de la REST API v1.1, como se documenta aquí: REST API Rate Limiting in v1.1. A diferencia de la REST API v1.1, no existe un índice programático de los límites por endpoint. Los límites de tasa por endpoint y las ventanas de restablecimiento se comunican mediante encabezados de respuesta HTTP. Todo el límite de tasa en la Ads API utiliza OAuth 1.0a.

​

Límites a nivel de usuario y a nivel de cuenta publicitaria

Hay dos tipos de límites de tasa: a nivel de token de usuario y a nivel de cuenta publicitaria. Un subconjunto de endpoints está habilitado para usar la limitación de tasa a nivel de cuenta publicitaria. Un token de usuario es el OAuth access token que se utiliza para autenticar y llamar a la X Ads API. Cada token de usuario puede tener acceso a una o más cuentas publicitarias.

Los desarrolladores deben utilizar el límite de tasa a nivel de cuenta publicitaria cuando este se devuelva en los encabezados de la respuesta y recurrir al límite a nivel de usuario únicamente cuando no se encuentre el límite de la cuenta publicitaria.

Los límites de tasa a nivel de usuario se expresan mediante estos encabezados: x-rate-limit-limit, x-rate-limit-remaining y x-rate-limit-reset.

Para los endpoints con la limitación de tasa a nivel de cuenta publicitaria habilitada, los límites de tasa se expresan mediante estos encabezados: x-account-rate-limit-limit, x-account-rate-limit-remaining y x-account-rate-limit-reset.

Los límites de tasa a nivel de cuenta publicitaria se proporcionan solo para endpoints GET, a fin de permitir que las aplicaciones sincronicen los datos de entidades (como objetos de campaña o de ítem de línea) desde un único token de usuario que accede a varias cuentas publicitarias. No se garantiza que las acciones de escritura utilicen los mismos límites de tasa a nivel de cuenta publicitaria.

Para los endpoints con limitación de tasa a nivel de cuenta publicitaria, el límite de tasa a nivel de usuario se establece en un valor alto que representa una cuota global para toda la aplicación. Cuando esté disponible, el límite de tasa a nivel de cuenta publicitaria debe tener prioridad para controlar el volumen de solicitudes.

​

Mejores prácticas

1. Guarde en su base de datos una marca de tiempo correspondiente a la última sincronización y, al solicitar data cuando corresponda, solicite data con la opción sort_by=updated_at-desc para poder detener su proceso de sincronización cuando alcance data anterior a su última marca de tiempo sincronizada. Esto evitará volver a sincronizar la misma data de forma redundante.

2. Solicite varias entidades en una sola petición: Algunos endpoints permiten especificar una lista de valores separada por comas para recuperar múltiples conjuntos de data similares. Esto puede reducir el número total de llamadas que realiza y, por lo tanto, aprovechar el límite de tasa con mayor eficiencia.

3. Solicite el valor máximo de “count” en sus peticiones: En algunos endpoints, como GET accounts/:account_id/targeting_criteria, se recomienda encarecidamente usar el valor máximo de count para retornar 1000 objetos en lugar del valor predeterminado de 200.

​

Sincronización de Analytics

Consulta la Guía de límite de tasa de Analytics para obtener más información sobre los límites de tasa del endpoint de analytics.

​

Preguntas frecuentes

¿Es posible aumentar el límite de tasa para una cuenta publicitaria específica o para nuestra aplicación?

Por lo general, no podemos aumentar los límites de velocidad y están configurados para admitir incluso las cuentas publicitarias más grandes. Implementa las mejores prácticas enumeradas en este documento como primer paso y, si los límites de velocidad siguen afectando tu capacidad para escalar o alcanzar objetivos comerciales, ponte en contacto con tus contactos de X Ads API con detalles completos sobre el caso de uso y las solicitudes implicadas.

​

Ámbitos del límite de tasa

​

Alcances de este documento

• Categoría: todos los endpoints que pertenecen a la categoría indicada comparten un único límite de tasa asignado por ventana.
• Endpoint: cada endpoint tiene su propio límite de tasa asignado, distinto, por ventana.

​

Tabla de límites de tasa de la X Ads API

​

Límites de tasa de la X Ads API

Tipo de endpoint	Alcance por endpoint o categoría	Límite de tasa por ventana de 1 minuto
Escrituras (POST, PUT, DELETE)	Categoría	450
Audiencias	Endpoint	1500

Tipo de endpoint	Alcance por endpoint o categoría	Límite de tasa por ventana de 15 minutos
Analítica (sincrónica)	Categoría	250
Lecturas de entidades principales (Line Items, Campaigns, etc.) Otras lecturas de cuenta (otros endpoints GET con :account_id)	Endpoint (nivel de cuenta de anuncios) Endpoint (nivel parcial de cuenta de anuncios)	10,000 2000
Criterios de segmentación (excepto los siguientes)	Categoría	400
Criterios de segmentación (tv_markets, tv_shows)	Endpoint	2000
Información de audiencia	Categoría	400
Información de palabras clave	Categoría	500
Lecturas globales (endpoints GET sin :account_id)	Endpoint	5
Conversiones	Endpoint	60,000