Saltar al contenido principal
Para admitir un mayor número máximo de campañas y recuperar de forma eficiente todas las entidades asociadas a una cuenta, la API de Advertiser ahora admite paginación en muchos endpoints GET. El mecanismo de paginación es fácil de usar y muy similar a la paginación basada en cursores de la API REST, como se describe en Uso de cursores para navegar por colecciones.

​
Introducción

Para determinadas solicitudes GET, ahora aceptamos los parámetros de query cursor y count, ambos opcionales. Si una respuesta incluye más de count entidades, estos endpoints devolverán las primeras count entidades y una clave next_cursor en el JSON de la respuesta. GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50 
{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}
Para obtener la siguiente serie de respuestas, agregue cursor a los parámetros de query: GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50 
{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​
Profundizando

Para la mayoría de los endpoints, el valor máximo de count es 1.000, el mínimo es 1 y el predeterminado es 200. El valor que proporciona next_cursor siempre es una cadena y debe considerarse opaco; la implementación está sujeta a cambios. Si en la página actual del conjunto de resultados se devuelven menos entidades que count, el valor de next_cursor será null. Nota: los endpoints de analytics no admiten este estilo de paginación. La paginación en los endpoints de stats se realiza especificando períodos de tiempo. Consulta la documentación de esos endpoints individuales para obtener más información.
⌘I