Data API에는 다음 한도와 할당량이 적용됩니다.
할당량 적용 방식
Google 애널리틱스 Data API v1에 대한 모든 요청에는 Google Cloud 프로젝트가 필요하며 이 페이지에 설명된 할당량이 적용됩니다. 할당량은 호출 프로젝트를 식별하는 데 사용된 메서드와 관계없이 소모됩니다.
- OAuth 2.0 사용자 인증 정보로 인증된 요청입니다.
- API 키만 사용하여 인증된 요청입니다.
API 키는 할당량 및 결제 목적으로 요청을 특정 Google Cloud 프로젝트와 연결하는 데 사용됩니다. 프로젝트의 사용자 인증 정보 또는 API 키를 사용하여 이루어진 모든 API 호출은 프로젝트 및 Google 애널리틱스 속성의 해당 할당량에 포함됩니다.
할당량 카테고리
Data API에는 핵심, 실시간, 유입경로의 세 가지 요청 할당량 카테고리가 있습니다. 핵심 메서드에 대한 API 요청은 핵심 할당량을 사용합니다. 실시간 메서드에 대한 API 요청은 실시간 할당량을 사용합니다. 각 요청은 한 종류의 할당량만 사용합니다.
| 할당량 카테고리 | API 메서드 |
|---|---|
| Core | 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 측정기준은 잠재적으로 기준점이 적용됩니다. 보고서를 조회하는 사용자가 개별 사용자의 인구통계 또는 관심분야를 추론하지 못하도록 데이터 기준이 적용됩니다.
속성 토큰 할당량
Google 애널리틱스 Data API v1에 대한 각 요청에 토큰이 사용됩니다. 청구되는 토큰 수는 요청의 복잡성에 따라 다릅니다. 대부분의 요청에는 10개 이하의 토큰이 청구되지만 더 복잡한 요청에는 더 많은 토큰이 사용됩니다.
토큰 소비에 영향을 미치는 요인
요청의 정확한 토큰 비용은 실행 시점에 결정되므로 정확한 사전 계산이 어렵습니다. 비용은 요청 자체와 Google 애널리틱스 속성의 기본 데이터와 관련된 여러 요인의 영향을 받습니다. 다음과 같은 요인으로 인해 비용이 높아질 수 있습니다.
- 행 수: 더 많은 행을 요청합니다.
- 측정기준 및 측정항목 수: 측정기준 및 측정항목을 더 많이 포함합니다.
- 필터 복잡성: 복잡한 필터 표현식을 사용합니다.
- 기간 길이: 더 긴 기간에 대해 쿼리합니다.
- 데이터 카디널리티: 카디널리티가 높은 측정기준 (예:
pagePath, 맞춤 측정기준과 같이 고유 값이 많음)은 토큰 비용을 크게 늘릴 수 있습니다. - 속성 이벤트 볼륨: 이벤트 볼륨이 더 많은 속성에 대한 쿼리는 데이터가 적은 속성에 대한 동일한 쿼리보다 더 많은 토큰을 소비할 수 있습니다.
토큰 사용량 모니터링
특정 API 호출의 토큰 비용을 확인하는 가장 효과적인 방법은 요청 본문에 "returnPropertyQuota": true 매개변수를 포함하는 것입니다.
그러면 API 응답에 해당 특정 요청에서 사용된 토큰과 남은 할당량 잔액을 자세히 설명하는 PropertyQuota 객체가 포함됩니다.