Reports API: 업데이트 기록

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 페이지에는 Reports API (v1) 변경사항과 문서 업데이트가 나와 있습니다.

2020년 5월 14일

엔터프라이즈 그룹 활동 보고서에 새 매개변수 member_type가 추가되었습니다. 유효한 구성원 유형에는 사용자, 그룹, 서비스 계정 등이 있습니다.

2019년 7월 30일

App Maker 및 Apps Script에 대한 고객 사용 보고서는 지원 중단되었으며 API에서 삭제될 예정입니다.

2018년 10월 22일

이제 Google+ 커뮤니티 보고서의 Community_name 매개변수를 조직 내 커뮤니티에서만 사용할 수 있습니다.

2018년 8월 1일

항목 사용 보고서의 이전 데이터 가용성이 30일로 변경되었습니다.

2018년 6월 4일

일부 Google+ 커뮤니티에서 일부 항목 사용 매개변수가 제대로 보고되지 않는 문제를 해결했습니다. 이 문제는 2018년 5월 25일을 기준으로 수정되었습니다.

2017년 12월 11일

계정 사용자가 사용한 항목에 관한 보고서를 생성하기 위해 항목 사용 보고서를 만들었습니다. 이 API는 현재 Google+ 커뮤니티 보고를 지원합니다.

2017년 7월 11일

9개의 새로운 매개변수가 Google+ 고객 사용량 보고서에 추가되었습니다. 새 매개변수는 다음과 같습니다.

  • num_comununities
  • num_communities_public
  • num_communities_private
  • 조직_num_communuties_wide
  • 조직_비공개_조직_num_communities
  • 컬렉션_개수
  • 컬렉션_개수
  • 조직_수료_컬렉션_수량
  • 조직_비공개_항목_개수
또한 Google+ 사용자 사용 보고서는 다음과 같은 7개의 측정항목으로 생성되었습니다.

  • 공유 수
  • num_plusones
  • num_plusones_Receivedd
  • 답변_개수
  • num_replies_received회
  • 재공유 횟수
  • 재공유_받음

2017년 5월 11일

AppUsageApps Script 고객 사용량 보고서가 customerUsageReports.get 메서드에 추가되었습니다. 이 새로운 보고서를 통해 도메인에서의 App Maker 및 Apps Script 사용에 대한 정보를 확인할 수 있습니다.

2017년 4월 5일

Google Docs 고객 및 사용량 보고서가 Google Drive 고객 및 사용량 측정항목으로 대체됩니다. 자세한 내용은 Drive 및 Docs 측정항목 업데이트를 참고하세요.

2017년 3월 14일

6개의 새로운 매개변수가 Google+ 고객 사용량 보고서에 추가되었습니다. 새 매개변수는 다음과 같습니다.

  • 새 사용자 수
  • 공유 수
  • 재공유 횟수
  • num_plusones
  • 답변_개수
  • num_stream_items_read

2015년 2월 2일

휴대기기 고객 사용량 보고서가 customerUsageReports.get 메서드에 추가되었습니다. 이 새 보고서를 통해 도메인의 휴대기기 사용 정보를 확인할 수 있습니다.

Google에서는 2014년 10월 27일에 출시된 ChromeOS 보고서를 포함하도록 출시 노트를 수정했습니다.

2014년 12월 11일

Google Calendar감사 보고서를 activities.list메서드에 추가했습니다. 이 새로운 보고서를 사용하면 도메인 사용자의 캘린더 및 캘린더 일정에 관한 변경사항 정보를 확인할 수 있습니다.

2014년 11월 20일

customerUsageReports.get 메서드에 Google Sites 고객 사용량 보고서가 추가되었습니다. 이 새 보고서를 통해 도메인의 Google Sites 사용에 대한 정보를 확인할 수 있습니다.

2014년 11월 12일

OAuth.list 메서드에 OAuth 토큰 감사 보고 애플리케이션이 추가되었습니다. 이 새로운 보고서를 사용하면 도메인 사용자가 액세스 권한을 부여한 타사 웹사이트 및 애플리케이션에 대한 정보를 확인할 수 있습니다.

2014년 10월 29일

새 매개변수가 Gmail 고객 사용량 보고서에 추가되었습니다. 새 매개변수는 다음과 같습니다.

  • 이메일_포함_게재_완료
  • 이메일_누적_재라우팅_이메일
  • 이메일_거부_거부_이메일
  • 발신 이메일 스팸 개수
  • 수신된_스팸_이메일이_없는_이메일
  • num_inbound_encrypted_emails
  • num_inbound_unencrypted_emails
  • 발신 이메일_제외_전송_이메일
  • 이메일 발신 한도_해제_경로
  • 발신 이메일_거부_거부_이메일
  • num_outbound_encrypted_emails
  • num_outbound_unencrypted_emails

2014년 10월 27일

customerUsageReports.get 메서드에 ChromeOS 기기 고객 사용량 보고서가 추가되었습니다. 이 새로운 보고서를 통해 도메인의 ChromeOS 기기 사용 정보를 볼 수 있습니다.

2014년 9월 2일

사용 보고서의 최대 시간 한도가 180일에서 450일로 늘어났습니다. 이 변경사항이 Google 데이터에 입력되는 데 시간이 걸리므로 전체 450일 기록은 2015년 5월 30일 이후의 가장 빠른 기록 날짜인 2014년 3월 6일에서 확인할 수 있습니다.

2014년 8월 15일

view 이벤트Drive 활동 보고서에 추가되었습니다.

2014년 6월 25일

이제 보고서 API에서 Drive 활동 보고서를 사용할 수 있습니다. 이 새 보고서에서는 Drive 활동, 그리고 계정의 사용자가 Google Drive 문서를 관리, 수정, 공유하는 방식에 대한 통계를 제공합니다. 이 보고서는 G Suite Business 고객만 사용할 수 있으며 Google Docs 활동 보고서를 대체합니다. Google Docs 활동 보고서는 현재 지원이 중단되어 2015년 1월 31일부터 작동이 중단될 예정입니다.

2014년 6월 5일

이제 고객사용자 Gmail 보고서에 기본값이 포함됩니다. 예를 들어 사용자가 이메일을 보내지 않으면 num_emails_sent 매개변수가 0으로 반환됩니다. 이전에는 필드에 데이터가 없으면 보고서에서 해당 필드가 생략되었습니다.

2014년 5월 27일

이제 Reports API의 고객 사용량 보고서에 사용중지된 사용자의 사용 통계가 포함됩니다.

2014년 4월 23일

데이터가 없는 매개변수가 API에서 반환되는 방식이 변경되었습니다. 이전에는 매개변수 데이터가 없는 경우 보고서에 표시되지 않았습니다. 예를 들어 사용자가 보고서 날짜에 이메일을 보내지 않은 경우 Gmail 사용자 사용 보고서에는 응답에 num_emails_sent 필드가 포함되지 않습니다. 이제 API가 정수에서 기본값 0, 부울 값 false에서 이 매개변수를 반환합니다.

2014년 4월 15일

num_users_2sv_not_enrolled_but_enforced 매개변수가 고객 계정 사용량 보고서에 추가되었습니다. 이 새 매개변수는 2단계 인증을 사용 설정했지만 등록하지 않은 도메인 사용자 수를 나타냅니다.

2014년 3월 27일

2개의 새로운 login_failure_type 값이 Login Audit events(login_failure_account_disabledlogin_failure_unknown)에 추가되었습니다.

필터에서 대소문자 구분 비교를 사용하도록 하는 문제에 대한 버그가 수정되었습니다. 이제 모든 필터는 대소문자를 구분하지 않습니다.

2014년 3월 5일

단일 사용자의 쿼리에서 필터가 무시되고 항상 단일 레코드를 반환하는 문제가 버그 수정으로 구현되었습니다. 수정 후 사용자가 필터 기준과 일치하지 않으면 필터를 포함하는 단일 사용자에 대한 쿼리가 결과를 반환하지 않습니다.

2014년 2월 28일

활성 사용자 수에 관한 특정 통계에 하루가 더 포함되는 문제가 해결되었습니다. 일부 도메인의 경우 2014년 2월 24일 이후에 보고서에 보고된 활성 사용자 수가 줄어들 수 있습니다. 영향을 받는 필드는 다음과 같습니다.

  • 계정
    • 로그인 num_1일
    • 로그인 수_7일
    • 로그인_num_30일
  • Google Calendar
    • num_1일_활성_사용자
    • num_7day_active_users
  • Google Docs
    • num_1일_활성_사용자
    • num_7day_active_users
    • num_30일_활성_사용자
  • Gmail
    • num_1일_활성_사용자
    • num_7day_active_users
    • num_30일_활성_사용자
  • Google+
    • num_1일_활성_사용자
    • num_7day_active_users

또한 최근 고객 계정 사용량사용자 계정 사용량 보고서에 몇 가지 새로운 필드가 추가되었습니다. 새 필드는 다음과 같습니다.

  • 고객 계정
    • num_authorized_apps
    • 승인된_앱
    • drive_used_quota_in_mb
    • Gmail_사용_할당량_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • 앱_총_라이선스
    • 앱_사용_라이선스
    • Vault_total_라이선스
    • 좌표_총_라이선스
  • 사용자 계정
    • num_authorized_apps
    • drive_used_quota_in_mb
    • Gmail_사용_할당량_in_mb
    • gplus_photos_used_quota_in_mb
    • total_quota_in_mb
    • used_quota_in_mb
    • used_quota_in_percentage

2014년 2월 10일

사용중지된 사용자는 이제 Docs 보고서의 통계에 포함됩니다. 일부 도메인의 경우 보고된 문서 수가 증가할 수 있습니다.

다음 매개변수가 사용자 사용량 보고서에 추가되었습니다.

  • 계정
    • used_quota_in_percentage
  • Docs
    • num_docs_externally_visible
    • num_docs_internally_visible
  • Gmail
    • num_emails_exchanged

2014년 1월 27일

활동 리소스 변경사항에 관한 푸시 알림이 추가되었습니다. 이는 API에서 두 가지 새로운 메서드인 activities.watchchannels.stop로 노출되어 알림 수신을 시작하고 중지합니다.

2013년 12월 3일

리셀러가 특정 고객에 대한 사용 보고서와 감사 정보를 검색할 수 있도록 하기 위한 지원이 추가되었습니다. API에서 activities.list, customerUsageReports.get, userUsageReport.get 메서드의 새 customerId 매개변수로 노출됩니다.

2013년 4월

이 섹션에서는 Reports API와 지원 중단된 G Suite Admin Audit API (v1)의 몇 가지 차이점을 설명합니다. Reports API 관리자 활동에 대한 자세한 내용은 개발자 가이드, API 참조, 관리자 활동 이벤트 참조를 확인하세요.

API 기능 Reports API (v1) 지원 중단된 Admin Audit API (v1)
applicationIdapplicationName 관리자 활동 보고서는 applicationName: "admin"을(를) 사용하여 관리 콘솔을 식별합니다. 자세한 내용은 API 참조를 참고하세요. Admin Audit API는 "applicationId": "207535951991"를 사용하여 관리 콘솔 애플리케이션을 식별합니다.
제어판의 CSV 내보내기 기능 이 보고서 API 버전에서는 이 기능이 지원되지 않습니다. 이 기능은 Admin Audit API에서 지원됩니다.
eventTypetype 관리자 활동 보고서는 type 매개변수를 반환합니다. Admin Audit API는 이벤트 카테고리에 eventType를 사용합니다.
OAuth 및 OAuth 범위 Reports API에서는 OAuth 2.0 프로토콜을 사용합니다. Reports API에서는 Admin Audit API OAuth 범위가 지원되지 않습니다.
페이지로 나누기 응답 페이지가 여러 개인 보고서의 경우 Reports API에서 maxResultspageToken 쿼리 문자열과 nextPageToken 응답 매개변수를 지원합니다. Admin Audit API는 maxResults, rel, next 매개변수를 지원합니다.
리소스 URL 관리자 활동 보고서에 customerId을 사용하지 않는 다른 URL이 있습니다. 관리자 활동 보고서 URL: https://www.googleapis.com/admin/reports/v1/activity/users/userKey | all/applications/admin Admin Audit API URL은 https://www.googleapis.com/apps/reporting/audit/v1/the customer ID/the application ID입니다.
시간 및 날짜 형식 Reports API 요청 시간은 ISO 8601 yyyy-mm-dd 형식입니다. Reports API 응답은 UNIX 에포크 시간(초)으로 표시됩니다. Admin Audit API는 UTC 형식을 사용합니다.