Reports API: Drive 활동 보고서

Drive 활동 보고서는 사용자가 Google Workspace의 Google Drive에서 파일을 관리, 수정, 공유할 때의 사용자 활동에 관한 정보를 제공합니다. 예를 들어 Drive 활동 보고서를 사용하여 특정 사용자가 지정된 기간 동안 만든 모든 새 Drive 문서의 목록을 가져올 수 있습니다. 이 정보를 사용하여 콘텐츠 관리를 개선하고 데이터 유출 가능성에 대한 유용한 정보를 얻을 수 있습니다. 보고서를 가져오려면 사용자의 이메일 주소 또는 특정 종류의 Google Drive 변경사항과 같은 보고서별 매개변수가 포함된 기본 보고서 엔드포인트 요청을 사용합니다. 보고서에는 최대 180일간의 데이터가 포함될 수 있습니다.

Google Drive 활동 보고서는 라이선스가 할당된 계정에서 합법적인 목적으로만 사용할 수 있습니다.

요청의 쿼리 문자열 및 응답 속성에 관한 자세한 내용은 API 참조를 참고하세요. Google Drive와 관련된 특정 이벤트에 관한 자세한 내용은 Drive 이벤트 이름을 참고하세요.

도메인의 Google Drive 이벤트 가져오기

Drive 활동 보고서를 사용하여 Drive 문서에 관한 정보를 표시할 수 있습니다. 예를 들어 최대 180일 동안 계정의 최근 Drive 이벤트 25개를 나열하는 보고서를 요청할 수 있습니다. 이 보고서를 가져오려면 승인 가이드에 설명된 대로 승인 토큰을 가져온 다음 다음 HTTP GET 요청을 사용하세요.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

이 API 호출에 대한 응답 예를 확인할 수 있습니다.

다음 예에서는 최대 기간인 지난 180일 동안의 모든 Drive 이벤트에 관한 보고서를 검색합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

사용자별 Google Drive 이벤트 검색

특정 사용자의 Google Drive 활동 보고서를 검색하려면 승인 가이드 가이드에 설명된 승인 토큰이 포함된 HTTP GET 요청을 사용하세요. userKey 필드는 보고서에 있는 사용자의 기본 이메일 주소이거나 모든 사용자의 경우 all입니다.

다음 예에서는 지정된 사용자가 만든 모든 변경사항을 나열하는 보고서를 검색합니다. API 응답의 예는 JSON 샘플 응답을 참고하세요.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

공유 드라이브의 Google Drive 이벤트 가져오기

승인 가이드에 설명된 승인 토큰이 포함된 HTTP GET 요청을 사용하여 특정 공유 드라이브의 Google Drive 활동 보고서를 검색할 수 있습니다. userKey 필드에 보고서를 실행할 사용자의 이메일 주소를 지정하거나 all를 지정하여 모든 사용자에 대해 보고서를 실행합니다.

다음 예에서는 특정 공유 드라이브의 모든 변경사항에 관한 보고서를 검색합니다. API 응답의 예는 JSON 샘플 응답을 참고하세요.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>

공유 드라이브의 이벤트를 검색하려면 doc_type를 사용하여 필터링합니다. 다음 예에서는 모든 공유 드라이브에 영향을 미치는 이벤트를 검색합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive

멤버십 변경에 관한 이벤트를 검색하려면 shared_drive_membership_change 이벤트를 지정하세요. 다음 예에서는 공유 드라이브에 추가된 모든 구성원을 검색합니다.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive

이벤트 유형별 Google Drive 이벤트 가져오기

문서 생성 또는 수정과 같은 특정 이벤트 유형의 모든 인스턴스에 관한 보고서를 검색하려면 승인 가이드에 설명된 승인 토큰이 포함된 HTTP GET 요청을 사용하세요. userKey 필드는 보고서에 있는 사용자의 기본 이메일 주소이거나 모든 사용자의 경우 all입니다.

다음 예는 모든 계정 문서 생성 활동에 대한 보고서를 검색합니다. API 응답의 예는 샘플 JSON 응답을 참고하세요.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create

JSON 응답 예시

API에 HTTP GET 요청을 하면 성공적인 응답은 HTTP 200 상태 코드를 반환합니다. 응답에는 상태 코드와 함께 Drive에 대한 보고서가 반환됩니다. 이러한 보고서는 관리 콘솔에서도 확인할 수 있습니다. 자세한 내용은 Google Workspace 관리자 고객센터를 참고하세요. eventName 정보는 Drive 이벤트 이름 참조를 참고하세요. 요청의 쿼리 문자열 및 응답 속성에 관한 자세한 내용은 API 참조를 참고하세요.

{
 "kind": "reports#auditActivities",
 "nextPageToken": "next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2014-03-17T15:39:18.460Z",
    "uniqQualifier": "report's unique ID",
    "applicationName": "drive",
    "customerId": "ABC123xyz"
   },
   "actor": {
   "callerType": "USER",
   "email": "kim@example.com",
   "profileId": "user's unique Google Workspace profile ID",
   "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "domain of the source owner",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "access",
     "name": "edit",
     "parameters": [
      {
        "name": "primary_event",
        "boolValue": true
      },
      {
        "name": "owner_is_shared_drive",
        "boolValue": false
      },      {
        "name": "doc_id",
        "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
      },
      {
        "name": "doc_title",
        "value": "Meeting notes"
      },
      {
        "name": "doc_type",
        "value": "document"
      },
      {
        "name": "owner",
        "value": "mary@example.com"
      }
      ]
     }
    ]
   },
  ]
 }