Method: customers.reports.countPrintJobsByPrinter

取得每部印表機的列印摘要。

HTTP 要求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter

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

路徑參數

參數
customer

string

必要欄位。客戶 ID 前面加上「customers/」或「customers/my_customer」,即可使用與提出要求帳戶相關聯的客戶。

查詢參數

參數
printerOrgUnitId

string

印表機機構單位的 ID。如有指定,系統只會傳回指定機構單位的印表機資料。如果省略,系統會傳回所有機構單位的印表機資料。

pageSize

integer

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

pageToken

string

用來指定要傳回回應頁面的符記。

filter

string

用來篩選結果的查詢字串,以及 EBNF 語法中的 AND 分隔欄位。

注意:這個篩選器不支援 OR 作業。注意:這個篩選器僅支援 >= 和 <= 比較器。

支援的篩選器欄位:

  • completeTime
orderBy

string

用於排序結果的欄位。若省略,則會在 [printer] (印表機) 欄位遞增排序結果。

支援的 orderBy 欄位:

  • 印表機
  • jobCount
  • deviceCount
  • userCount

要求主體

要求主體必須為空白。

回應主體

回應包含指定機構單位在指定的時間間隔內,每部印表機的列印摘要報告。

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

JSON 表示法
{
  "printerReports": [
    {
      object (PrinterReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
欄位
printerReports[]

object (PrinterReport)

PrinterReports 比對要求清單。

nextPageToken

string

用於要求下一頁的分頁權杖。

totalSize

string (int64 format)

符合要求的印表機總數。

授權範圍

需要下列 OAuth 範圍:

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

PrinterReport

report.countPrintJobsByPrinter 的報告內含印表機使用情形的統計資料。這裡會顯示透過這台印表機啟動的列印工作總數、使用者人數,以及已透過這部印表機啟動至少一項列印工作的裝置數量。

JSON 表示法
{
  "printerId": string,
  "printer": string,
  "printerModel": string,
  "jobCount": string,
  "userCount": string,
  "deviceCount": string
}
欄位
printerId

string

印表機 API ID。

printer

string

印表機名稱。

printerModel

string

印表機型號。

jobCount

string (int64 format)

傳送至印表機的列印工作數量。

userCount

string (int64 format)

已傳送列印工作給印表機的使用者人數。

deviceCount

string (int64 format)

用於將列印工作傳送至指定印表機的 Chrome 裝置數量。