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。查詢中的主要條件。如未指定鍵，則預設值為 parentName = 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 的分組規則合併活動的策略。你可以將在特定時間範圍內發生的類似動作分成多個目標群組 (例如一次移動一組檔案) 或多位演員 (例如多位使用者編輯同一個項目)。這項策略的分組規則會因動作類型而異。