이 문서에서는 Google Drive Activity API에 대해 간략하게 설명합니다.
Drive Activity API를 사용하면 최근 이벤트를 쿼리할 수 있습니다. 각 이벤트에 관한 세부정보를 비롯한 모든 활동의 세부 내역을 가져올 수 있습니다. 이는 ActionDetail, Actor, Target 정보를 포함하는 정확한 활동을 검색할 수 있으므로 감사와 같은 작업에 유용합니다.
Drive Activity API는 사용자의 Google Drive 내에서 객체에 적용된 변경사항을 나타내는
DriveActivity 리소스와 이러한 변경사항에 관한 정보를 검색할 수 있는
activity.query 메서드로 구성됩니다.
요청
앱은 activity.query 메서드를 사용하여 사용자의 활동 데이터를 요청합니다. 특정 Drive 항목 또는 Drive 폴더에 포함된 모든 항목에 대한 활동을 요청할 수 있습니다. 지정된 요청의 경우 시간 범위
또는 작업 유형과 같은 필터를 사용하여
응답을 제한하도록 선택할 수 있으며 응답에서 활동을 통합하도록 선택할 수 있습니다. 자세한 내용은
Google Drive Activity API에서 요청 만들기를 참고하세요.
응답
응답에는 지정된 매개변수와 일치하는 활동 목록이 포함되며, 여기서
DriveActivity 리소스는 각
활동을 나타냅니다.
DriveActivity 리소스는 각각
Action 객체의 모음이며, 각각은
이벤트 와 같이 자체 포함됩니다. Action에는 ActionDetail (예: Create 또는 Edit), Actor (예: User 또는 Administrator), Target (예: DriveItem 또는 Drive) 및
Timestamp
또는 TimeRange가 포함됩니다.
DriveActivity 리소스에는 모든 작업의 모든
Actor 및 Target, 통합된 Timestamp 또는 TimeRange,
그리고 Action의 가장 중요하거나 대표적인 ActionDetail와 같은 요약 정보도 포함됩니다.
자세한 내용은 Drive Activity API 데이터 모델을 참고하세요.
활동 내역 공개 상태
Drive Activity API를 사용하는 경우 Drive의 일부 활동이 보고되지 않을 수 있습니다. API에서 객체에 대한 지정된 변경사항을 보고하는지 여부는 변경사항 또는 변경사항에 관한 정보가 앱에서 인증된 사용자에게 표시되는지 여부에 따라 다릅니다.
공개 상태는 객체에 설정된 권한을 기반으로 합니다. Drive에서 파일 및 폴더가 공유되는 시나리오는 다음과 같습니다.
작성자가 문서를 공유하면 문서의 활동 내역이 작성자와 공유된 사용자 모두에게 표시됩니다.
문서가 사용자와 공유된 후 비공개로 설정된 경우 사용자는 액세스 권한이 있었던 기간의 모든 활동 내역을 볼 수 있지만 권한이 제한된 후에는 볼 수 없습니다.
문서가 사용자와 공유된 적이 없는 경우 사용자는 활동 내역을 볼 수 없습니다.
관련 주제
- Drive Activity API를 최대한 활용하려면 먼저 앱을 Google Drive API와 통합하세요.
- 프로젝트 만들기 또는 인증 및 승인 처리를 비롯한 Google Workspace API를 사용하여 개발하는 방법을 알아보려면 Google Workspace에서 개발을 참고하세요.
- 활동에 관해 알아보려면 API 참조를 참고하세요.