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 참조에서 활동에 대해 자세히 알아보세요.