페이지네이션

더 많은 캠페인 수를 지원하고 계정과 연결된 모든 엔티티를 효율적으로 조회하기 위해, 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 엔드포인트의 페이징은 시간 구간을 지정하는 방식으로 지원됩니다. 자세한 내용은 각 엔드포인트의 문서를 참조하세요.