Reports API: Drive 활동 보고서

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

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

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

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

드라이브 활동 보고서를 사용하여 드라이브 문서에 대한 정보를 나열할 수 있습니다. 예를 들어 계정의 최근 Drive 이벤트 25개가 포함된 보고서를 요청할 수 있으며, 여기에는 최대 180일까지 포함됩니다. 이 보고서를 가져오려면 승인 가이드에 설명된 대로 승인 토큰을 가져온 후 다음 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 상태 코드를 반환합니다. 응답은 상태 코드와 함께 드라이브에 관한 보고서를 반환합니다. 이 보고서는 관리 콘솔에서도 사용할 수 있습니다. 자세한 내용은 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"
      }
      ]
     }
    ]
   },
  ]
 }