Data API에는 다음 한도와 할당량이 적용됩니다.
할당량 적용 방식
Google 애널리틱스 Data API v1에 대한 모든 요청에는 Google Cloud 프로젝트가 필요하며 이 페이지에 설명된 할당량이 적용됩니다. 할당량은 호출 프로젝트를 식별하는 데 사용된 메서드와 관계없이 소진됩니다.
- OAuth 2.0 사용자 인증 정보로 인증된 요청입니다.
- API 키만 사용하여 인증된 요청입니다.
API 키는 할당량 및 결제 목적으로 요청을 특정 Google Cloud 프로젝트와 연결하는 데 사용됩니다. 프로젝트의 사용자 인증 정보 또는 API 키를 사용하여 이루어진 모든 API 호출은 프로젝트 및 Google 애널리틱스 속성의 해당 할당량에 포함됩니다.
할당량 카테고리
Data API에는 핵심, 실시간, 유입경로, 채팅의 네 가지 요청 할당량 카테고리가 있습니다.
Core 메서드에 대한 API 요청은 Core 할당량을 사용합니다. Realtime 메서드에 대한 API 요청은 Realtime 할당량을 사용합니다. Funnel 메서드에 대한 API 요청은 Funnel 할당량을 소진합니다. Chat 메서드에 대한 API 요청에는 Chat 할당량이 청구됩니다. 각 요청은 한 종류의 할당량만 사용합니다.
| 할당량 카테고리 | API 메서드 |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| 실시간 | runRealtimeReport |
| 유입경로 | runFunnelReport |
| 채팅 | properties.chat |
애널리틱스 속성 할당량
모든 요청은 속성 할당량을 사용합니다.
| 할당량 이름 | 스탠더드 속성 한도 | 애널리틱스 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 |
| 일일 속성별 채팅 토큰 수 | 3,750,000 | 3,750,000 |
| 시간당 속성별 채팅 토큰 수 | 500,000 | 500,000 |
- 동시 요청은 동시에 실행되는 요청 수로 측정됩니다. 요청 동시성을 줄이려면 이전 요청이 완료될 때까지 기다린 후 추가 요청을 보내세요.
- 서버 오류는 500 및 503 코드입니다. 서버 오류 할당량은 요청으로 인해 서버 오류가 발생하는 경우에만 청구됩니다. 프로젝트 및 속성 쌍의 서버 오류 할당량이 소진되면 프로젝트에서 속성으로의 모든 요청이 차단됩니다. 전체 오류 응답 목록은 오류 응답을 참고하세요.
- 각 요청은 시간당 속성별 토큰과 시간당 속성별 프로젝트당 토큰의 할당량을 모두 사용합니다. 즉, '시간당 속성별 토큰 수' 할당량이 '시간당 속성별 프로젝트당 토큰 수' 할당량보다 먼저 소진되려면 3개 이상의 프로젝트에서 하나의 속성에 액세스해야 합니다.
속성은 시간당 기준점을 초과할 수 있는 요청이 120개까지 허용됩니다. userAgeBracket, userGender, brandingInterest, audienceId, audienceName 측정기준은 잠재적으로 기준점이 적용됩니다. 보고서를 조회하는 사용자가 개별 사용자의 인구통계 또는 관심분야를 추론하지 못하도록 데이터 기준이 적용됩니다.
속성 토큰 할당량
토큰은 Google Analytics Data API v1에 대한 각 요청과 함께 사용됩니다.
청구되는 토큰 수는 요청의 복잡성에 따라 다릅니다. 대부분의 요청에는 10개 이하의 토큰이 청구되지만, 더 복잡한 요청 (예: 분석 어드바이저 chat 쿼리)에는 더 많은 토큰이 사용됩니다.
토큰 소비에 영향을 미치는 요인
요청의 정확한 토큰 비용은 실행 시점에 결정되므로 정확한 사전 계산이 어렵습니다. 비용은 요청 자체와 Google 애널리틱스 속성의 기본 데이터와 관련된 여러 요인의 영향을 받습니다. 이러한 요인으로 인해 비용이 증가할 수 있습니다.
- 행 수: 더 많은 행을 요청합니다.
- 측정기준 및 측정항목 수: 더 많은 측정기준과 측정항목을 포함합니다.
- 필터 복잡성: 복잡한 필터 표현식을 사용합니다.
- 기간 길이: 더 긴 기간에 대해 쿼리합니다.
- 데이터 카디널리티: 카디널리티가 높은 측정기준 (고유 값이 많은 측정기준, 예:
pagePath, 맞춤 측정기준)은 토큰 비용을 크게 늘릴 수 있습니다. - 속성 이벤트 볼륨: 이벤트 볼륨이 더 많은 속성에 대한 쿼리는 데이터가 적은 속성에 대한 동일한 쿼리보다 더 많은 토큰을 소비할 수 있습니다.
토큰 사용량 모니터링
특정 API 호출의 토큰 비용을 확인하는 가장 효과적인 방법은 요청 본문에 "returnPropertyQuota": true 매개변수를 포함하는 것입니다.
그러면 API 응답에 해당 특정 요청에서 사용된 토큰과 남은 할당량 잔액을 자세히 설명하는 PropertyQuota 객체가 포함됩니다.
채팅 토큰 소비 및 모니터링
애널리틱스 어드바이저 chat 요청의 경우 토큰은 모델 계산, 추론, 기본 데이터 검색 비용을 나타냅니다. 채팅 토큰 소비는 다음의 영향을 받습니다.
- 질문 및 분석 범위: 요청된 분석의 복잡성과 범위입니다.
- 모델 입력 및 출력 토큰: 처리된 컨텍스트 데이터의 양과 생성된 응답 설명입니다.
- 사고 토큰: 결과를 종합하는 데 필요한 모델 추론 단계입니다.
- 실행 지연 시간: 다단계 데이터 탐색에 필요한 처리 시간입니다.
채팅 토큰 사용량을 모니터링하려면 ChatRequest에서 "returnPropertyQuota": true을 설정하세요. 응답에는 사용된 잔액과 남은 잔액이 포함된 tokensPerDay 및 tokensPerHour 필드가 포함된 PropertyChatQuota 객체가 포함됩니다.