사용 제한

사용량 제한을 사용하면 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 Console에서 사용량을 검토하고 워크플로를 수정하여 여러 광고주의 요청을 더 효과적으로 병렬화하거나 전반적으로 요청을 전송하는 속도를 낮춥니다.

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