페이지네이션

캠페인 최대 수 확대 및 계정과 연관된 모든 엔터티의 효율적인 조회를 위해, Advertiser API는 이제 여러 GET 엔드포인트에서 페이지네이션을 지원합니다. 이 페이징 메커니즘은 사용하기 쉽고, 컬렉션 탐색을 위한 커서 사용에 설명된 REST API의 커서 기반 페이지네이션과 매우 유사합니다.

​

시작하기

특정 GET 요청에 대해, 이제 선택적 쿼리 매개변수 cursor와 count를 지원합니다. 응답에 count보다 많은 엔터티가 포함된 경우, 해당 엔드포인트는 처음 count개의 엔터티와 함께 응답 JSON에 next_cursor 키를 반환합니다.

GET https://ads-api.x.com/5/accounts/abc1/campaigns?count=50

{
  "data": \[...\],
  "next_cursor": "c-3yvu1pzhd3i7",
  "request": {...}
}

다음 응답 묶음을 받으려면 쿼리 매개변수에 cursor를 추가하면 됩니다:

GET https://ads-api.x.com/5/accounts/abc1/campaigns?cursor=c-3yvu1pzhd3i7&count=50

{
  "data": \[...\],
  "next_cursor": "c-3w3zdyg8ywan",
  "request": {...}
}

​

더 깊이 알아보기

대부분의 엔드포인트에서 count의 최대값은 1,000, 최소값은 1, 기본값은 200입니다.

next_cursor가 제공하는 값은 항상 문자열이며, 내부 구조가 공개되지 않은 값으로 간주해야 합니다. 구현은 변경될 수 있습니다. 현재 결과 집합의 페이지에서 반환된 엔터티 수가 count보다 적으면 next_cursor 값은 null이 됩니다.

참고: analytics 엔드포인트는 이 방식의 페이지네이션을 지원하지 않습니다. stats 엔드포인트의 페이징은 기간을 지정하여 수행됩니다. 자세한 내용은 해당 개별 엔드포인트의 문서를 참조하세요.