Reports API: 고객 사용 보고서

고객 사용량 보고서에는 전체 도메인에서 모든 사용자의 Google Workspace 서비스 사용량 정보가 집계됩니다. 사용자 사용량 보고서에는 계정 전체의 Google Workspace 서비스 사용 정보가 반환됩니다. 이 사용 정보는 애플리케이션 유형별로 구성되며 각 애플리케이션의 매개변수로 구성됩니다. 각 보고서의 기본 기간 및 최대 기간은 최근 450일입니다.

이 사용 보고서는 고객 계약에 따라 합법적인 목적으로만 사용할 수 있습니다. 이 보고서는 Google Workspace 및 Education에도 적용됩니다.

고객 사용 보고서를 가져옵니다.

계정 활동 보고서를 검색하려면 다음 GET HTTP 요청을 사용하고 승인 문서에 설명된 승인 토큰을 포함합니다. 다음 예는 가독성을 위해 라인 반환 형식을 사용합니다. 

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date
?parameters=app name: usage parameter,...
&customerId=the customer's ID
&maxResults=number of events listed on each page of the report

dates 값은 사용량이 발생한 날짜이며 타임스탬프는 ISO 8601 형식(yyyy-mm-dd)입니다. 이 경우 계정의 시간대를 사용하는 것이 좋습니다. 요청의 쿼리 문자열 및 응답 속성에 대한 자세한 내용은 API 참조 및 고객 사용량 보고서 매개변수 참조를 확인하세요.

다음 예시는 2013년 3월 3일부터 지난 30일 동안 계정에 성공한 모든 로그인의 총계와 승인된 애플리케이션 목록을 포함한 애플리케이션별 사용자 승인 횟수가 포함된 보고서를 가져옵니다. maxResults 쿼리 문자열은 이 보고서가 보고서 페이지당 두 개의 이벤트를 반환함을 보여줍니다. 

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03
?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2

고객 사용량 보고서에 대한 JSON 응답

{
 "kind": "reports#usageReports",
 "warnings": [
    {
      "code": warning machine-readable code,
      "message": warning human-readable message,
      "data": [
        {
          "key": key for key-value pair that gives detailed warning information,
          "value": value for key-value pair giving detailed warning information
        }
      ]
    }
  ],
 "nextPageToken": "N:NNN:NNN:N:C03az79cb",
 "usageReports": [
  {
   "kind": "usageReport",
   "date": "2013-03-03",
   "entity": {
    "type": "CUSTOMER",
    "customerId": "C03az79cb"
   },
   "parameters": [
    {
     "name": "accounts:num_1day_logins",
     "intValue": "1"
    },
    {
     "name": "accounts:num_30day_logins",
     "intValue": "1"
    },
    {
     "name": "accounts:num_7day_logins",
     "intValue": "1"
    },
    {
     "name": "accounts:num_disabled_accounts",
     "intValue": "5"
    },
    {
     "name": "accounts:authorized_apps",
     "msgValue": [
      {
       "client_id": "1234.apps.googleusercontent.com",
       "client_name": "www.example.com",
       "num_users": 2
      },
      {
       "client_id": "4567.apps.googleusercontent.com",
       "client_name": "Example",
       "num_users": 1
      },
     ...
     ]
    }
   ]
  }
 ]
}