Reports API: Drive 활동 보고서

Drive 활동 보고서는 활동 Google Workspace에서 Google Drive의 파일을 관리, 수정, 공유하는 경우 예를 들어 Drive 활동 보고서를 사용하여 문서 전체 목록을 볼 수 있습니다. 지정된 날짜 범위입니다. 이 정보를 사용하여 더 나은 콘텐츠 관리와 데이터 유출 가능성이 있습니다. 보고서를 가져오려면 다음과 같은 보고서별 매개변수가 포함된 기본 보고서 엔드포인트 요청을 사용자의 이메일 주소 또는 특정 종류의 Google Drive 변경사항 보고서는 최대 지난 180일 동안의 데이터를 포함합니다.

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

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

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

Drive 활동 보고서를 사용하면 Drive 문서. 예를 들어 특정 구매자, 광고주에게는 계정의 최근 Drive 이벤트 25개(최대 180개 포함) 일 이 보고서를 가져오려면 아래 설명에 따라 승인 토큰을 가져오세요. 승인 가이드를 읽은 다음 다음 HTTP GET 요청을 전송합니다.

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

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

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

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 이벤트 가져오기

특정 공유 계정에 대한 Google Drive 활동 보고서를 가져올 수 있습니다. 아래 설명된 인증 토큰으로 HTTP GET 요청을 사용하여 승인 가이드를 참조하세요. 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"
      }
      ]
     }
    ]
   },
  ]
 }