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 측정기준은 잠재적으로 기준점이 적용됩니다. 보고서를 조회하는 사용자가 개별 사용자의 인구통계 또는 관심분야를 추론하지 못하도록 데이터 기준이 적용됩니다.
속성 토큰 할당량
토큰은 요청의 복잡성에 따라 각 요청에 대해 계산됩니다. 대부분의 요청에는 10개 이하의 토큰이 청구됩니다. 요청에서 많은 수의 할당량 토큰을 사용하는 경우 다음 요소가 원인인 경우가 많습니다.
- 행 수가 많음
- 열이 많음
- 복잡한 필터 기준
- 긴 기간
각 API 요청에서 요청 본문에 "returnPropertyQuota": true을 지정하여 현재 속성 할당량 토큰 상태를 반환할 수 있습니다. 이 상태에는 이 요청에서 사용한 양과 각 할당량 그룹에 남아 있는 양이 모두 포함됩니다. 예를 들어 RunReportRequest에서 이 매개변수를 지정하는 것을 고려해 보세요.