리소스 기반 할당량

이 문서에서는 애널리틱스 360 고객에게만 제공되는 Google 애널리틱스 Reporting API v4용 리소스 기반 할당량 시스템을 설명합니다. API에 적용되는 전체 한도는 API 한도 및 할당량을 참조하세요.

소개

공유 리소스의 가용성과 안정성을 보장하기 위해 Analytics Reporting API에 액세스하는 모든 프로젝트에는 한도 및 할당량이 적용됩니다. 대규모 데이터 세트를 쿼리하는 경우 Analytics Reporting API에서 샘플링을 사용할 수 있으며, 이는 데이터 결과에 영향을 미칠 수 있습니다.

리소스 기반 할당량 시스템은 새로운 할당량 시스템으로, 이 시스템을 통해 애널리틱스 360 계정이 Analytics Reporting API를 사용하는 동안 샘플링 기준을 더 높일 수 있습니다. 이 시스템은 선택사항이며 Google API 콘솔의 할당량 페이지에 보고된 것과 같은 기존 뷰 및 프로젝트에 적용된 한도와는 별개입니다.

리소스 기반 할당량

모든 요청이 동일한 것은 아닙니다. 일부 요청은 다른 요청에 비해 계산 비용이 훨씬 많이 듭니다. 리소스 기반 할당량 시스템은 애널리틱스 보고 인프라를 보호하면서도 더 높은 샘플링 기준을 지원하도록 설계되었습니다.

각 속성에는 설정된 양의 쿼리 리소스 토큰이 할당됩니다. API 클라이언트는 관련 쿼리 리소스 토큰을 사용하는 대가로 더 높은 샘플링 기준을 얻기 위해 API 요청에 선택적 필드를 추가할 수 있습니다. 계산 비용이 많이 드는 요청에는 토큰이 더 많이 필요합니다.

샘플링 기준

Google 애널리틱스 API v4를 사용한 데이터 요청에는 속성 수준에서 요청된 기간의 세션수를 기준으로 다음과 같은 일반적인 샘플링 기준이 적용됩니다.

애널리틱스 표준: 세션 50만 회
애널리틱스 360: 세션 100만 회
리소스 기반 할당량을 사용하는 애널리틱스 360: 세션 1억 회

리소스 기반 할당량 사용 설정

특정 요청에 리소스 기반 할당량을 사용 설정하려면 API 호출에 batchGet 메서드에 선택적 필드 useResourceQuotas가 포함되어야 합니다.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

예를 들면 다음과 같습니다.

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

쿼리 리소스 비용 응답 필드

batchGet 메서드를 호출할 때마다 응답에 queryCost 필드가 포함됩니다.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

queryCost 필드는 batchGet 요청에 있는 모든 ReportRequests의 총 리소스 비용을 나타내는 정수입니다. 예를 들면 다음과 같습니다.

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

할당량 설정

애널리틱스 360 속성 할당량

속성당 일일 쿼리 비용 단위 100,000
속성별 시간당 쿼리 비용 단위 25,000

할당량 한도를 초과하면 RESOURCE_EXHAUSTED 오류가 발생합니다. 자세한 내용은 오류 응답을 참조하세요.

비용 계산

요청 비용은 다음에 비례합니다.

기간의 크기입니다.
조회 내 조회수입니다.
요청된 측정기준의 카디널리티입니다.
요청된 측정기준 및 측정항목의 수
세그먼트 및 필터 정의의 복잡성
요청된 정보의 처리 상태 (오늘의 데이터를 요청하는 것은 어제의 데이터를 요청하는 것보다 더 많은 비용이 듭니다)
쿼리 시간 가져오기 측정기준 및 측정항목이 있는지 여부

API 한도 및 사용량

API에는 리소스 기반 할당량 시스템 외에도 Analytics API v4의 한도 및 할당량이 적용됩니다.

Notes

queryCost 응답 필드는 요청의 계산 비용을 나타냅니다. 금전적 비용이 발생하지 않으며 API를 무료로 사용할 수 있습니다.
일중 및 특정 이전 데이터 (1년 이상) 보고서는 useResourceQuotas 설정과 관계없이 계속해서 샘플링될 수 있습니다.
요청에 대해 더 높은 샘플링 임곗값을 충족할 수 없는 경우에는 리소스 할당량 토큰이 공제되지 않습니다 (샘플링된 응답은 항상 리소스 할당량 비용이 0임).
응답에 samplesReadCounts, samplingSpaceSizes 필드가 있으면 보고서에 샘플링된 데이터가 포함됩니다.

프로젝트의 사용량 한도를 확인 또는 변경하거나 할당량 증가를 요청하려면 다음 단계를 따르세요.

프로젝트의 결제 계정이 아직 없는 경우 계정을 만듭니다.
API 콘솔에서 API 라이브러리의 사용 설정된 API 페이지를 방문하여 목록에서 API를 선택합니다.
할당량 관련 설정을 확인하고 변경하려면 할당량을 선택합니다. 사용량 통계를 확인하려면 사용량을 선택합니다.