Google Drive Activity API는 사용자의 Google Drive 내 객체에 적용된 변경사항을 나타내는 DriveActivity 리소스와 이러한 변경사항에 관한 정보를 검색하는 데 사용하는 activity.query 메서드로 구성됩니다.
요청
앱에서 activity.query 메서드를 사용하여 사용자의 활동 데이터를 요청합니다. 특정 드라이브 항목 또는 드라이브 폴더에 포함된 모든 항목에 대한 활동을 요청할 수 있습니다. 특정 요청의 경우 시간 범위나 작업 유형과 같은 제약조건으로 응답을 제한하고 응답에 활동이 통합되도록 선택할 수 있습니다. 자세한 내용은 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 데이터 모델을 참고하세요.
활동 내역 공개 상태
이 API를 사용할 때 Drive에서의 일부 활동이 보고되지 않을 수 있습니다. Drive Activity API에서 객체의 특정 변경사항을 보고할지 여부는 변경사항 또는 변경사항에 관한 정보가 애플리케이션에서 인증된 사용자에게 표시되는지에 따라 다릅니다.
공개 상태는 객체에 설정된 권한을 기반으로 합니다. Drive에서 파일과 폴더를 공유하는 경우 다음과 같은 몇 가지 시나리오가 있습니다.
- 작성자가 문서를 공유하면 문서의 활동 내역은 작성자뿐만 아니라 문서가 공유된 인증된 사용자에게도 표시됩니다.
- 문서를 사용자와 공유한 후 비공개로 설정하면 인증된 사용자는 액세스 권한이 있는 동안 모든 활동 기록을 볼 수 있으며 현재 권한은 제한됩니다.
- 사용자와 문서가 공유되지 않은 경우 사용자는 활동 내역을 볼 수 없습니다.
시작하기
Drive Activity API를 최대한 활용하려면 먼저 Google Drive API와 앱을 통합합니다. Drive Activity API를 시작하려면 프로젝트 만들기 및 요청 승인 방법을 알아보세요. 또는 바로 API 참조에서 활동을 읽어보세요.