Drive 활동 보고서는 사용자가 Google Workspace에서 Google Drive의 파일을 관리, 수정, 공유할 때 사용자의 활동에 대한 정보를 제공합니다. 예를 들어 드라이브 활동 보고서를 사용하여 지정된 기간 동안 특정 사용자가 만든 모든 새 드라이브 문서 목록을 가져올 수 있습니다. 이 정보를 사용하여 더 나은 콘텐츠 관리와 가능한 데이터 유출에 관한 유용한 정보를 얻을 수 있습니다. 보고서를 가져오려면 사용자 이메일 주소 또는 특정 종류의 Google Drive 변경사항과 같은 보고서별 매개변수와 함께 기본 보고서 엔드포인트 요청을 사용합니다. 보고서에는 최대 지난 180일간의 데이터가 포함될 수 있습니다.
API를 사용하여 보고서를 검색하기 전에 보고서 API 기본 요건의 단계를 완료해야 합니다.
Google Drive 활동 보고서는 라이선스가 할당된 계정에서 합법적인 목적으로만 사용할 수 있습니다.
요청의 쿼리 문자열과 응답 속성에 대한 자세한 내용은 API 참조를 확인하세요. Google 드라이브와 관련된 특정 이벤트에 대한 자세한 내용은 드라이브 이벤트 이름을 참조하세요.
도메인의 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 정보는 드라이브 이벤트 이름 참조에서 확인하세요. 요청의 쿼리 문자열과 응답 속성에 대한 자세한 내용은 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"
}
]
}
]
},
]
}