Method: activity.query

Google Drive에서 과거 활동을 쿼리합니다.

HTTP 요청

POST https://driveactivity.googleapis.com/v2/activity:query

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  "itemName": string,
  "ancestorName": string
}
필드
consolidationStrategy

object (ConsolidationStrategy)

활동을 구성하는 관련 작업을 통합하는 방법에 관한 세부정보입니다. 설정하지 않으면 관련 작업이 통합되지 않습니다.
pageSize

integer

응답에서 원하는 최소 활동 수입니다. 서버는 이 수 이상의 활동을 반환하려고 시도합니다. 요청 시간이 초과되기 전에 부분 응답이 준비된 경우 서버에서 더 적은 활동을 반환할 수도 있습니다. 설정하지 않으면 기본값이 사용됩니다.
pageToken

string

토큰은 반환할 결과 페이지를 식별합니다. 결과의 다음 페이지를 가져오려면 이전 쿼리에서 반환된 nextPageToken 값으로 설정합니다. 설정하지 않으면 결과의 첫 번째 페이지가 반환됩니다.
filter

string

이 쿼리 요청에서 반환된 항목의 필터링입니다. 필터 문자열의 형식은 일련의 표현식이며, 각 표현식은 '필드 연산자 값' 형식입니다. 표현식은 선택적 'AND'로 결합됩니다.

지원되는 필드:

  • time: 1970년 1월 1일 이후의 밀리초 또는 RFC 3339 형식의 날짜 값에 숫자 연산자를 사용합니다. 예:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: 'has' 연산자 (:)와 단수 값 또는 괄호로 묶인 허용된 작업 유형 목록을 공백으로 구분하여 사용합니다. 대답에서 결과를 제외하려면 필터 문자열의 시작 부분에 하이픈 (-)을 추가합니다. 예:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
통합 필드 key. 쿼리의 기본 기준입니다. 키가 지정되지 않은 경우 기본값은 ancestorName = items/root입니다. key은 다음 중 하나일 수 있습니다.
itemName

string

이 Drive 항목의 활동을 반환합니다. 형식은 items/ITEM_ID입니다.
ancestorName

string

이 Drive 폴더와 모든 하위 항목 및 하위 항목의 활동을 반환합니다. 형식은 items/ITEM_ID입니다.

응답 본문

Drive 활동을 쿼리하기 위한 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
필드
activities[]

object (DriveActivity)

요청된 활동 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰이거나 목록에 더 이상 결과가 없으면 비어 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

자세한 내용은 승인 가이드를 참고하세요.

ConsolidationStrategy

개별 활동이 통합되는 방식입니다. 활동 집합이 관련되어 있으면 여러 타겟에서 동일한 작업을 실행하는 행위자 한 명 또는 단일 타겟에서 동일한 작업을 실행하는 여러 행위자와 같이 하나의 결합된 활동으로 통합할 수 있습니다. 전략은 관련 활동의 규칙을 정의합니다.

JSON 표현 
{

  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
}
필드
통합 필드 strategy. 개별 활동이 통합되는 방식입니다. strategy은 다음 중 하나여야 합니다.
none

object (NoConsolidation)

개별 활동은 통합되지 않습니다.
legacy

object (Legacy)

개별 활동은 기존 전략을 사용하여 통합됩니다.

NoConsolidation

이 유형에는 필드가 없습니다.

개별 활동을 통합하지 않는 전략입니다.

기존

이 유형에는 필드가 없습니다.

기존 V1 활동 API의 그룹화 규칙을 사용하여 활동을 통합하는 전략입니다. 일정 시간 내에 발생하는 유사한 작업은 여러 타겟 (예: 파일 집합을 한 번에 이동) 또는 여러 행위자 (예: 여러 사용자가 동일한 항목을 수정)에 걸쳐 그룹화할 수 있습니다. 이 전략의 그룹화 규칙은 각 작업 유형에 따라 다릅니다.