이 페이지는 Cloud Translation API를 통해 번역되었습니다.

리소스 기반 할당량

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

소개

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

리소스 기반 할당량 시스템은 애널리틱스 360 계정에서 애널리틱스 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에는 리소스 기반 할당량 시스템 외에도 애널리틱스 API v4의 한도 및 할당량이 적용됩니다.

메모

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

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

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