Límites de tasa

El Advertiser API está sujeto a límites de tasa de forma similar a la REST API v1.1, como se documenta aquí: Limitación de tasa en la REST API 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. Todos los límites de tasa en el Ads API utilizan OAuth 1.0a.

​

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

Hay dos tipos de límites de tasa: a nivel de token de usuario y a nivel de cuenta de anuncios. Un subconjunto de endpoints está configurado para usar límites de tasa a nivel de cuenta de anuncios. Un token de usuario es el OAuth access token que utilizas para autenticarte y llamar a la Ads API. Cada token de usuario puede tener acceso a una o más cuentas de anuncios.

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

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 límites de tasa a nivel de cuenta de anuncios habilitados, 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 de anuncios se proporcionan solo para endpoints de tipo GET, con el fin de permitir que las aplicaciones sincronicen datos de entidades (como objetos de campaña o de line item) desde un único token de usuario que accede a múltiples cuentas de anuncios. No se garantiza que las acciones de escritura utilicen los mismos límites de tasa a nivel de cuenta de anuncios.

Para los endpoints con límites de tasa a nivel de cuenta de anuncios, 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 de anuncios debe tener prioridad para controlar tu volumen de solicitudes.

​

Mejores prácticas

1. Guarda en tu base de datos una marca de tiempo con la última sincronización y, al solicitar datos, cuando corresponda, pide los datos con la opción sort_by=updated_at-desc para poder detener tu proceso de sincronización una vez que alcances datos anteriores a la marca de tiempo de tu última sincronización. Esto evitará sincronizar los mismos datos de forma redundante.

2. Solicita múltiples entidades en una sola petición: algunos endpoints te permiten especificar una lista de valores separados 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 mejor el límite de frecuencia.

3. Solicita el valor máximo de “count” en tus peticiones: en algunos endpoints como GET accounts/:account_id/targeting_criteria se recomienda encarecidamente hacer la llamada 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 sobre límites de tasa de Analytics para obtener más información sobre los límites de tasa de los endpoints de Analytics.

​

Preguntas frecuentes

¿Es posible aumentar los límites de tasa para una cuenta publicitaria en particular o para nuestra aplicación?

En general, no podemos aumentar los límites de tasa y estos están configurados para admitir incluso las cuentas publicitarias más grandes. Implementa primero las prácticas recomendadas que se indican en este documento y, si los límites de tasa siguen afectando tu capacidad para escalar o lograr tus objetivos comerciales, comunícate con tus contactos de X Ads API con todos los detalles sobre el caso de uso y las solicitudes involucradas.

​

Ámbitos de los límites de frecuencia

​

Ámbitos de este documento

• Categoría: todos los endpoints que entran en la categoría indicada están sujetos a límites de frecuencia que comparten un único cupo asignado por ventana.
• Endpoint: cada endpoint tiene su propio cupo de solicitudes asignado por ventana.

​

Tabla de límites de frecuencia de Ads API

​

Límites de tasa de la 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
Audiencia	Endpoint	1500

Tipo de endpoint	Alcance por endpoint o categoría	Límite de tasa por ventana de 15 minutos
Analytics (síncrono)	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 (excepto los siguientes)	Categoría	400
Criterios de segmentación (tv_markets, tv_shows)	Endpoint	2000
Audience Insights	Categoría	400
Keyword Insights	Categoría	500
Lecturas globales (endpoints GET sin :account_id)	Endpoint	5
Conversiones	Endpoint	60,000