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,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
필드
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. 쿼리의 기본 기준입니다. 키가 지정되지 않은 경우 기본값은 상위 이름 = 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 표현 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
필드
통합 필드 strategy. 개별 활동이 통합되는 방식입니다. strategy은 다음 중 하나여야 합니다.
none

object (NoConsolidation)

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

object (Legacy)

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

NoConsolidation

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

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

기존

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

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