Limitación de tasa

La API de Anunciantes tiene límites de uso 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 por endpoint y las ventanas de restablecimiento se comunican mediante encabezados de respuesta HTTP. Toda la limitación de tasa en la Ads API utiliza OAuth 1.0A.

​

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

Existen 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 token de acceso OAuth que usas para autenticarte y llamar a la 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 respuesta y utilizar el límite a nivel de usuario solo cuando no se encuentre el 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 únicamente para endpoints GET, con el fin de permitir que las aplicaciones sincronicen datos de entidades (como objetos de campaña o de línea de pedido) a partir de 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 tu aplicación. Cuando esté disponible, el límite de tasa a nivel de cuenta publicitaria debe tener prioridad para controlar tu volumen de solicitudes.

​

Mejores prácticas

1. Guarda en tu base de datos una marca de tiempo de la última sincronización y, cuando corresponda, solicita los datos con la opción sort_by=updated_at-desc para poder detener tu proceso de sincronización al alcanzar datos anteriores a tu última marca de tiempo sincronizada. Esto evitará volver a sincronizar los mismos datos.

2. Solicita múltiples entidades en una sola petición: Algunos endpoints permiten especificar una lista de valores separada por comas para recuperar varios conjuntos de datos similares. Esto puede reducir el número total de llamadas que realizas y, por lo tanto, aprovechar el límite de tasa de forma más eficiente.

3. Solicita el valor máximo de “count” en tus solicitudes: Se recomienda encarecidamente que algunos endpoints, como GET accounts/:account_id/targeting_criteria, se llamen con el valor máximo de count para devolver 1000 objetos en lugar del valor predeterminado de 200.

​

Sincronización de Analytics

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

​

Preguntas frecuentes

¿Es posible aumentar los límites de tasa para una cuenta publicitaria específica o para nuestra App?

Por lo general, no podemos aumentar los límites de tasa y están establecidos para admitir incluso las cuentas publicitarias más grandes. Implementa las mejores prácticas indicadas en este documento como primer paso y, si los límites de tasa siguen afectando tu capacidad para escalar o alcanzar los objetivos comerciales, comunícate con tus contactos de X Ads API con información completa sobre el caso de uso y las solicitudes correspondientes.

​

Alcances de la limitación de tasa

​

Ámbitos de este documento

• Categoría: todos los endpoints que pertenecen a la categoría indicada están sujetos a limitación de tasa con un único límite asignado por ventana.
• Endpoint: cada endpoint tiene su propio límite asignado, independiente, por ventana.

​

Tabla de límites de la Ads API

​

Límites de uso de la Ads API

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

Tipo de endpoint	Alcance por endpoint o categoría	Límite por ventana de 15 minutos
Analytics (sincrónico)	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 publicitaria) Endpoint (nivel parcial de cuenta publicitaria)	10,000 2000
Criterios de segmentación (además de los siguientes)	Categoría	400
Criterios de segmentación (tv_markets, tv_shows)	Endpoint	2000
Insights de audiencia	Categoría	400
Insights de palabras clave	Categoría	500
Lecturas globales (endpoints GET sin :account_id)	Endpoint	5
Conversiones	Endpoint	60,000