메인 콘텐츠로 건너뛰기
Advertiser API는 여기에서 설명된 REST API v1.1과 유사하게 요청 한도가 적용됩니다: REST API v1.1의 요청 한도. REST API v1.1과 달리 엔드포인트별 한도에 대한 프로그래매틱한 색인은 제공되지 않습니다. 엔드포인트 요청 한도와 재설정 시간 창은 HTTP 응답 헤더를 통해 전달됩니다. Ads API의 모든 요청 한도는 OAuth 1.0A를 사용합니다.

사용자 수준 및 광고 계정 수준 한도

요청 한도에는 두 가지 유형이 있습니다: 사용자 토큰 수준과 광고 계정 수준. 일부 엔드포인트는 광고 계정 수준 요청 한도를 사용하도록 설정되어 있습니다. 사용자 토큰은 Ads API를 인증하고 호출할 때 사용하는 OAuth 액세스 토큰입니다. 각 사용자 토큰은 하나 이상의 광고 계정에 접근할 수 있습니다. 개발자는 응답 헤더에 광고 계정 수준 요청 한도가 반환되는 경우 이를 우선 사용하고, 광고 계정 한도가 없을 때에만 사용자 수준 한도를 사용해야 합니다. 사용자 수준 요청 한도는 다음 헤더로 표시됩니다: x-rate-limit-limit, x-rate-limit-remaining, x-rate-limit-reset 광고 계정 수준 요청 한도가 활성화된 엔드포인트의 경우, 요청 한도는 다음 헤더로 표시됩니다: x-account-rate-limit-limit, x-account-rate-limit-remaining, x-account-rate-limit-reset. 광고 계정 수준 요청 한도는 단일 사용자 토큰이 여러 광고 계정에 접근하는 상황에서 애플리케이션이 엔터티 데이터(예: 캠페인 또는 라인 아이템 객체)를 동기화할 수 있도록 GET 엔드포인트에만 제공됩니다. 쓰기 작업이 동일한 광고 계정 수준 요청 한도를 사용할 것이라는 보장은 없습니다. 광고 계정 수준 요청 한도가 적용된 엔드포인트의 경우 사용자 수준 요청 한도는 애플리케이션 전체에 대한 전역 할당량을 나타내는 높은 값으로 설정됩니다. 가능한 경우 요청량 제어 시 광고 계정 수준 요청 한도를 우선 적용해야 합니다.

모범 사례

  1. 마지막 동기화 시각을 타임스탬프로 데이터베이스에 저장하고, 해당되는 경우 데이터 요청 시 sort_by=updated_at-desc 옵션을 사용하여 마지막 동기화 시각보다 오래된 데이터에 도달하면 동기화 프로세스를 중지할 수 있도록 하십시오. 이렇게 하면 동일한 데이터를 중복 동기화하는 일을 방지할 수 있습니다.
  2. 단일 요청으로 여러 엔터티를 요청하십시오: 일부 엔드포인트는 쉼표로 구분된 값 목록을 지정해 유사한 데이터를 한 번에 여러 개 가져올 수 있습니다. 이는 전체 호출 횟수를 줄여 레이트 리밋을 더 효율적으로 활용하는 데 도움이 됩니다.
  3. 요청에서 “count”를 최대값으로 설정하십시오: GET accounts/:account_id/targeting_criteria와 같은 일부 엔드포인트는 기본값 200이 아닌 1000개의 객체를 반환하도록 count를 최대값으로 설정해 호출할 것을 강력히 권장합니다.

애널리틱스 동기화

애널리틱스 엔드포인트의 요청 한도에 대한 자세한 내용은 애널리틱스 요청 한도 가이드를 참조하세요.

자주 묻는 질문

특정 광고 계정이나 애플리케이션의 요청 한도를 늘릴 수 있나요? 일반적으로 요청 한도는 상향이 불가하며, 대규모 광고 계정을 지원할 수 있도록 설정되어 있습니다. 우선 이 문서에 나열된 모범 사례를 적용해 주세요. 그럼에도 요청 한도가 확장이나 비즈니스 목표 달성에 영향을 미친다면, 사용 사례와 관련 요청의 상세 정보를 포함해 X Ads API 담당자에게 문의해 주시기 바랍니다.

속도 제한 범위

이 문서의 스코프

  • 카테고리: 해당 카테고리에 속하는 모든 엔드포인트는 각 윈도우당 하나의 공용 할당 한도에서 레이트 리밋이 적용됩니다.
  • 엔드포인트: 각 엔드포인트는 윈도우마다 고유하게 할당된 한도가 적용됩니다.

Ads API 제한 속도 표

Ads API 요청 한도

엔드포인트 유형엔드포인트 또는 카테고리별 범위1분 기준 요청 한도
쓰기(POST, PUT, DELETE)카테고리450
오디언스엔드포인트1500
엔드포인트 유형엔드포인트 또는 카테고리별 범위15분 기준 요청 한도
분석(동기)카테고리250
핵심 엔터티 읽기(Line Item, 캠페인 등)

기타 계정 읽기(:account_id가 포함된 기타 GET 엔드포인트)
엔드포인트(광고 계정 수준)

엔드포인트(부분 광고 계정 수준)
10,000

2000
타기팅 기준(아래 항목 제외)카테고리400
타기팅 기준(tv_markets, tv_shows)엔드포인트2000
오디언스 인사이트카테고리400
키워드 인사이트카테고리500
글로벌 읽기(:account_id 없이 GET 엔드포인트)엔드포인트5
전환엔드포인트60,000