Method: activity.query

Google ドライブの過去のアクティビティをクエリします。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

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。クエリの主な条件。キーが指定されていない場合、デフォルトは ancestorName = items/root です。key は次のいずれかになります。
itemName

string

このドライブ アイテムの戻りアクティビティ。形式は items/ITEM_ID です。
ancestorName

string

このドライブ フォルダのアクティビティと、すべての子と子孫を返します。形式は items/ITEM_ID です。

レスポンスの本文

ドライブ アクティビティのクエリのレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

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

個々のアクティビティが統合される方法。一連のアクティビティが関連している場合は、1 つの統合アクティビティに統合できます。たとえば、1 人の攻撃者が複数のターゲットに対して同じアクションを実行する場合や、複数の攻撃者が 1 つのターゲットに対して同じアクションを実行する場合などです。この戦略では、関連するアクティビティのルールを定義します。

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 のグループ化ルールを使用してアクティビティを統合する戦略。一定期間内に発生した同様のアクションは、複数のターゲット（一連のファイルを一度に移動するなど）または複数のアクター（複数のユーザーが同じアイテムを編集するなど）にわたってグループ化できます。この戦略のグループ化ルールは、アクションのタイプごとに異なります。