Google Drive Activity API는 사용자의 Google Drive 내에서 객체에 적용된 변경사항을 나타내는 DriveActivity 리소스와 이러한 변경사항에 관한 정보를 검색할 수 있는 activity.query 메서드로 구성됩니다.
요청
앱이 activity.query 메서드를 사용하여 사용자의 활동 데이터를 요청합니다. 특정 Drive 항목 또는 Drive 폴더에 포함된 모든 항목에 대한 활동을 요청할 수 있습니다. 특정 요청에 대해 시간 범위나 활동 유형과 같은 제약 조건으로 대답을 제한할 수 있으며, 대답에서 활동을 통합하도록 선택할 수 있습니다. 자세한 내용은 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 참조에서 활동에 관해 읽어보세요.