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。查詢中的主要條件，如果未指定索引鍵，則預設值為 祖系 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

個別活動的整合方式。如果一組相關的活動可以合併成一個活動，例如一位演員對多個目標執行相同動作，或多個發動者對單一目標執行相同動作。此策略會定義相關活動的規則。

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

這個類型沒有任何欄位。

不整合個別活動的策略。

舊版

這個類型沒有任何欄位。

一種策略，使用舊版 Activity API 的分組規則來整合活動。將一段時間內發生的類似動作可分成多個目標 (例如一次移動一組檔案) 或多個執行者 (例如多位使用者編輯同一個項目)。這項策略的分組規則專屬於每種動作類型。