각 API 요청에서 할당량이 소진되지 않았는지 확인하고 할당량을 사용합니다. 할당량이 소진되면 요청이 실패하고 관련 오류 메시지가 표시됩니다. 각 Data API 요청은 여러 할당량 버킷을 확인합니다.
할당량 카테고리
Data API에는 할당량과 관련하여 코어, 실시간, 유입경로라는 세 가지 요청 카테고리가 있습니다. 코어 메서드에 대한 API 요청은 코어 할당량을 청구합니다. Realtime 메서드에 대한 API 요청은 Realtime 할당량에 요금을 부과합니다. 하나의 요청은 코어 및 실시간 할당량을 모두 사용하지 않습니다. API 메서드 및 카테고리는 다음과 같습니다.
| 할당량 카테고리 | API 메서드 |
|---|---|
| 핵심 | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| 실시간 | runRealtimeReport |
| 유입경로 | runFunnelReport |
애널리틱스 속성 할당량
모든 요청은 속성 할당량을 사용합니다.
| 할당량 이름 | 표준 속성 한도 | 애널리틱스 360 속성 한도 |
|---|---|---|
| 속성당 일일 코어 토큰 | 200,000 | 2,000,000 |
| 시간당 속성당 코어 토큰 | 40,000 | 400,000 |
| 시간당 속성별 프로젝트당 코어 토큰 | 14,000명 | 140,000 |
| 속성당 코어 동시 요청 | 10 | 50명 |
| 시간당 속성별 프로젝트별 코어 서버 오류 | 10 | 50명 |
| 일일 속성당 실시간 토큰 | 200,000 | 2,000,000 |
| 시간당 속성별 실시간 토큰 | 40,000 | 400,000 |
| 시간당 속성별 프로젝트당 실시간 토큰 | 14,000명 | 140,000 |
| 속성당 실시간 동시 요청 | 10 | 50명 |
| 시간당 속성별 프로젝트별 실시간 서버 오류 | 10 | 50명 |
| 일일 속성별 유입경로 토큰 | 200,000 | 2,000,000 |
| 시간당 속성별 유입경로 토큰 | 40,000 | 400,000 |
| 시간당 속성별 프로젝트당 유입경로 토큰 | 14,000명 | 140,000 |
| 속성당 동시 요청 유입경로 | 10 | 50명 |
| 시간당 속성별 프로젝트별 유입경로 서버 오류 | 10 | 50명 |
- 동시 요청은 동시에 실행되는 요청 수로 측정됩니다. 요청 동시 실행을 줄이려면 추가 요청을 보내기 전에 이전 요청이 완료될 때까지 기다리세요.
- 서버 오류는 500 및 503 코드입니다. 서버 오류 할당량은 요청 서버 오류인 경우에만 청구됩니다. 프로젝트와 속성 쌍의 서버 오류 할당량이 소진되면 프로젝트에서 속성에 대한 모든 요청이 차단됩니다.
- 각 요청은 시간별 속성당 토큰과 시간당 속성별 프로젝트당 토큰의 할당량을 모두 사용합니다. 즉, '시간당 속성당 토큰 수' 할당량이 소진되려면 '시간당 속성별 프로젝트당 토큰' 할당량이 소진되기 전에 3개 이상의 프로젝트에서 속성 하나에 액세스해야 합니다.
속성에는 잠재적으로 기준점이 적용될 수 있는 요청이 시간당 120개 허용됩니다. 측정기준 userAgeBracket, userGender, brandingInterest, audienceId, audienceName는 기준점이 적용될 수 있습니다. 보고서를 보는 사용자가 개별 사용자의 인구통계 또는 관심분야를 추론하지 못하도록 기준점이 적용됩니다.
속성 토큰 할당량
토큰은 각 요청에서 완료할 요청의 복잡성에 따라 계산됩니다. 대부분의 요청은 10개 이하의 토큰을 청구합니다. 한 요청에 많은 수의 할당량 토큰이 사용될 경우 다음과 같은 요인이 작용할 수 있습니다.
- 행 수가 많음
- 다수의 열
- 복잡한 필터 기준
- 긴 기간
각 API 요청에서 요청 본문에 "returnPropertyQuota": true를 지정하여 현재 속성 할당량 토큰 상태를 반환할 수 있습니다. 이 상태에는 이 요청에서 사용한 양과 각 할당량 그룹의 남은 양이 모두 포함됩니다. 예를 들어 RunReportRequest에 이 매개변수를 지정하는 것이 좋습니다.