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。クエリの主な条件です。キーが指定されていない場合のデフォルトは、祖先 Name = 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 のグループ化ルールを使用してアクティビティを統合する戦略。一定の期間内に発生する同様のアクションは、複数のターゲット（一連のファイルを一度に移動するなど）または複数のアクター（複数のユーザーが同じアイテムを編集するなど）にまたがってグループ化できます。この戦略のグループ化ルールは、アクションのタイプごとに固有のものです。