사용 제한

사용량 한도는 Display & Video 360 API를 부적절한 방식으로 사용하는 자동화된 프로세스로부터 Google 인프라를 보호합니다. 한 개발자의 조치가 대규모 커뮤니티에 부정적인 영향을 미치지 않도록 합니다.

API 요청 할당량 한도

Display & Video 360 API는 두 가지 유형의 한도를 사용합니다.

  • 총 할당량 한도: 모든 관련 요청이 집계됩니다.
  • 쓰기 할당량 한도: 쓰기 메서드와 관련된 모든 요청이 반영됩니다. 쓰기 메서드는 create, patch, delete, bulkEdit 등 리소스를 수정하는 메서드로 정의됩니다. 일부 메서드는 다른 메서드보다 쓰기 할당량을 더 많이 사용합니다.

프로젝트가 이러한 한도를 초과하면 제한이 발생할 수 있습니다.

프로젝트 전체 할당량 한도

다음 기본 할당량 한도는 모든 Display & Video 360 API 리소스 및 메서드에서 공유됩니다.

  • 프로젝트별 분당 총 요청: 1500
  • 프로젝트별 분당 쓰기 요청: 700

광고주별 요청 할당량 한도

요청 URL에 광고주 ID를 지정하는 메서드는 '프로젝트당 광고주별' 추가 할당량 한도 계산에 포함됩니다.

URL 경로에 광고주 ID가 지정된 모든 요청(예: advertisers.lineItems, advertisers.creatives 또는 advertisers.channels 서비스에 대한 요청)이 다음 할당량 한도 계산에 포함됩니다.

  • 프로젝트별 광고주별 분당 총 요청 수: 300
  • 프로젝트별 광고주별 분당 쓰기 요청: 150

쓰기 집약적인 메서드

다음 API 메서드는 쓰기 집약적인 메서드입니다. 즉, 상당한 양의 제품 리소스를 사용하므로 다른 쓰기 요청보다 쓰기 요청 할당량을 더 많이 사용합니다.

쓰기 요청 할당량 소비를 계산할 때 쓰기 집약적인 메서드에 대한 요청은 쓰기 쿼리 5개로 집계됩니다. 예를 들어 1분 내에 수행된 표준 쓰기 요청 100개와 쓰기 집약적인 요청 21개 (광고주를 지정하지 않음)는 쓰기 쿼리 205개 (100 + (21 * 5) = 205)로 집계되며 기존의 일반 요청 할당량 한도인 분당 쓰기 쿼리 200개를 초과합니다.

다음 메서드는 쓰기 집약적인 메서드로 간주됩니다.

할당량 한도 초과

드물지만 API 요청 한도를 초과하여 요청이 실패하면 API가 HTTP 상태 코드와 오류의 원인을 반환합니다. 또한 응답 본문에는 오류를 일으킨 원인에 관한 자세한 설명이 포함되어 있습니다.

다음 목록은 API 요청 한도 초과로 인해 발생할 수 있는 오류와 요청 실패에 대한 권장 조치를 보여줍니다.

코드 RPC 메시지 권장 조치
429 RESOURCE_EXHAUSTED 리소스가 소진되었습니다(예: 할당량 확인). Google API 콘솔에서 사용량을 검토하고 워크플로를 수정하여 서로 다른 광고주의 요청을 더 효율적으로 동시에 처리하거나 일반적으로 요청을 전송하는 속도를 늦춥니다.

Display & Video 360 API 할당량 한도의 상향은 요청할 수 없습니다.