Method: customers.telemetry.events.list

列出遙測事件。

HTTP 要求

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/telemetry/events

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必填。客戶 ID 或「my_customer」，用於與提出要求的帳戶相關聯的客戶。

查詢參數

參數
filter

string

(選用步驟) 只納入符合篩選條件的資源。雖然目前這個參數為選用，但之後會變成必填，請至少指定 1 個事件類型。

支援的篩選器欄位：

  • deviceId
  • userId
  • deviceOrgUnitId
  • userOrgUnitId
  • 時間戳記
  • eventType
「時間戳記」篩選器接受 Unix Epoch 毫秒格式，或 RFC3339 UTC「Zulu」格式，解析度為奈秒，最多可有九位小數。兩種格式都應以簡單的雙引號括住。例如：「2014-10-02T15:01:23Z」、「2014-10-02T15:01:23.045123456Z」、「1679283943823」。
readMask

string (FieldMask format)

必填。讀取遮罩，用於指定要傳回的欄位。雖然目前為必填，但這個欄位之後會變成選填，而含有事件類型的篩選條件參數則會變成必填。

支援的 readMask 路徑如下：

  • 裝置
  • 使用者
  • audioSevereUnderrunEvent
  • usbPeripheralsEvent
  • httpsLatencyChangeEvent
  • networkStateChangeEvent
  • wifiSignalStrengthEvent
  • vpnConnectionStateChangeEvent
  • appInstallEvent
  • appUninstallEvent
  • appLaunchEvent
  • osCrashEvent
  • externalDisplaysEvent

這是以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。
pageSize

integer

(選用步驟) 要傳回的結果數上限。預設值為 100。最大值為 1000。
pageToken

string

(選用步驟) 用於指定清單中的下一頁。

要求主體

要求主體必須為空白。

回應主體

客戶的商家資訊遙測事件的回覆訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "telemetryEvents": [
    {
      object (TelemetryEvent)
    }
  ],
  "nextPageToken": string
}
欄位
telemetryEvents[]

object (TelemetryEvent)

回應中傳回的遙測事件。
nextPageToken

string

用於指定清單中的下一頁。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/chrome.management.telemetry.readonly