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。クエリの主な条件。特にキーが指定されていない場合、祖先名 = 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

詳しくは、認可ガイドをご覧ください。

統合戦略

個々のアクティビティの統合方法関連する一連のアクティビティは、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)

個々のアクティビティは、従来の戦略を使用して統合されます。

非統合

個々のアクティビティを統合しない戦略。

レガシー

従来の V1 Activity API のグループ化ルールを使用してアクティビティを統合する戦略です。一定の期間に行われた類似アクションは、複数のターゲット（一連のファイルを一度に移動するなど）や、複数のアクター（同じアイテムを編集する複数のユーザーなど）にグループ化できます。この戦略のグループ化ルールは、各アクションの種類に固有のものです。