Method: customers.telemetry.devices.list

列出所有遙測裝置。

HTTP 要求

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

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

路徑參數

參數
parent

string

必要欄位。客戶 ID 或「my_customer」：可使用與提出要求之帳戶相關聯的客戶。

查詢參數

參數
filter

string

選用設定。請只納入符合篩選條件的資源。如果要求未指定「reports_timestamp」值，則預設只會傳回最近的報表。指定「reports_timestamp>=0」即可取得所有報表資料。

支援的篩選器欄位：

  • orgUnitId
  • serialNumber
  • deviceId
  • reports_timestamp
「reports_timestamp」篩選器可接受採用 Unix 紀元起算的毫秒數格式，或採用 RFC3339 世界標準時間「Zulu」格式，精確度可達奈秒，最多可顯示九位小數。兩種格式都應以半形雙引號括住。例如：「2014-10-02T15:01:23Z」、「2014-10-02T15:01:23.045123456Z」、「1679283943823」。
readMask

string (FieldMask format)

必要欄位。讀取遮罩，用於指定要傳回的欄位。

支援的 readMask 路徑如下：

  • name
  • orgUnitId
  • deviceId
  • serialNumber
  • cpuInfo
  • cpuStatusReport
  • memoryInfo
  • memoryStatusReport
  • networkInfo
  • networkDiagnosticsReport
  • networkStatusReport
  • osUpdateStatus
  • graphicsInfo
  • graphicsStatusReport
  • batteryInfo
  • batteryStatusReport
  • storageInfo
  • storageStatusReport
  • thunderboltInfo
  • audioStatusReport
  • bootPerformanceReport
  • heartbeatStatusReport
  • networkBandwidthReport
  • peripheralsReport
  • kioskAppStatusReport
  • appReport
  • runtimeCountersReport

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

integer

要傳回的結果數上限。預設值為 100。最大值為 1000。
pageToken

string

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

要求主體

要求主體必須為空白。

回應主體

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

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

object (TelemetryDevice)

回應中傳回的遙測裝置。
nextPageToken

string

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

授權範圍

需要下列 OAuth 範圍：

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