Method: customers.reports.countPrintJobsByPrinter

获取每台打印机的打印摘要。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

必需。以“customers/”或“customers/my_customer”开头的客户 ID,可使用与发出请求的帐号相关联的客户。

查询参数

参数
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

reports.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 设备数量。