Method: activity.query

查詢 Google 雲端硬碟中的活動記錄。

HTTP 要求

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

這個網址使用 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。查詢中的主要條件。如果未指定任何鍵，預設值為 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

如何彙整個別活動。如果一組活動相關，可以整合成一個合併活動，例如一個行為者對多個目標執行相同動作，或多個行為者對單一目標執行相同動作。策略會定義相關活動的規則。

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 的分組規則，合併活動。如果多個目標發生類似動作 (例如一次移動一組檔案)，或多位使用者對同一項目執行動作 (例如編輯)，系統就會將這些動作歸為一組。這項策略的分組規則會因動作類型而異。