Límites a nivel de usuario y a nivel de cuenta de anuncios
Hay dos tipos de rate limits: nivel de user token y nivel de cuenta de anuncios. Un subconjunto de endpoints está habilitado para usar rate limiting a nivel de cuenta de anuncios. Un user token es el OAuth access token que usas para autenticarte y llamar a la Ads API. Cada user token puede tener acceso a una o más cuentas de anuncios. Los desarrolladores deben utilizar el rate limit a nivel de cuenta de anuncios cuando se devuelve en las cabeceras de respuesta y solo utilizar el límite a nivel de usuario cuando no se encuentre el límite de la cuenta de anuncios. Los rate limits a nivel de usuario se expresan mediante estas cabeceras: x-rate-limit-limit, x-rate-limit-remaining y x-rate-limit-reset Para los endpoints con rate limiting habilitado a nivel de cuenta de anuncios, los rate limits se expresan mediante estas cabeceras: x-account-rate-limit-limit, x-account-rate-limit-remaining y x-account-rate-limit-reset. Los rate limits a nivel de cuenta de anuncios se proporcionan solo para endpoints GET para permitir que las aplicaciones sincronicen datos de entidades (como objetos campaign o line item) desde un único user token que accede a múltiples cuentas de anuncios. No se garantiza que las acciones de escritura utilicen los mismos rate limits a nivel de cuenta de anuncios. Para los endpoints con rate limits a nivel de cuenta de anuncios, el rate limit a nivel de usuario está establecido en un valor alto que representa una cuota global para toda tu aplicación. Cuando esté disponible, el rate limit a nivel de cuenta de anuncios debe tener prioridad al controlar tu volumen de solicitudes.Mejores prácticas
-
Guarda un timestamp en tu base de datos con el último timestamp sincronizado, y cuando solicites datos, cuando sea aplicable, solicítalos con la opción
sort_by=updated_at-descpara poder detener tu proceso de sincronización tras alcanzar datos más antiguos que tu último timestamp sincronizado. Esto evitará sincronizar los mismos datos de forma redundante. - Solicita múltiples entidades en una sola solicitud: algunos endpoints te permiten especificar una lista separada por comas de valores para recuperar múltiples piezas de datos similares. Esto puede reducir el número total de llamadas que haces y así aprovechar el rate limit de forma más eficiente.
- Solicita el “count” máximo en tus solicitudes: se recomienda encarecidamente llamar a algunos endpoints como GET accounts/:account_id/targeting_criteria con el valor máximo de count para devolver 1000 objetos en lugar del predeterminado de 200.
Sincronización de Analytics
Consulta la guía de rate limiting de Analytics para más información sobre los rate limits de los endpoints de analytics.Preguntas frecuentes
¿Es posible aumentar los rate limits para una cuenta de anuncios en particular o para nuestra aplicación? En general, no podemos aumentar los rate limits y están configurados para soportar las cuentas de anuncios más grandes. Por favor, implementa las mejores prácticas listadas en este documento como primer paso, y si los rate limits siguen afectando tu capacidad de escalar o de alcanzar objetivos de negocio, ponte en contacto con tus contactos de X Ads API con todos los detalles sobre el caso de uso y las solicitudes involucradas.Alcances del rate limiting
Alcances para este documento
- Categoría: todos los endpoints que caen en la categoría dada tienen rate limit desde un único límite asignado por ventana.
- Endpoint: cada endpoint tiene su propio límite distinto asignado por ventana.