Method: customers.reports.countPrintJobsByUser

获取每位用户所完成的打印任务的摘要。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

必需。前缀为“customers/”的客户 ID或“customers/my_customer”以使用与发出请求的账号相关联的客户。

查询参数

参数
printerOrgUnitId

string

打印机所属的组织部门的 ID。如果指定,则系统只会统计使用指定组织部门的打印机发起的打印任务。如果省略,系统会统计所有打印作业。

pageSize

integer

返回的结果数上限。最大值和默认值为 100。

pageToken

string

用于指定要返回的响应页面的令牌。

filter

string

用于过滤结果的查询字符串,以及采用 EBNF 语法且以 AND 分隔的字段。

注意:此过滤条件不支持 OR 运算。注意:此过滤条件中仅支持 >= 和 <= 比较运算符。

支持的过滤条件字段:

  • completeTime
orderBy

string

用于对结果进行排序的字段。如果省略,结果将按“userEmail”的升序排列字段。

支持的 orderBy 字段:

  • userEmail
  • jobCount
  • printerCount
  • deviceCount

请求正文

请求正文必须为空。

响应正文

包含针对在请求的时间间隔内使用指定组织部门的打印机启动打印作业的每个用户的响应,其中包含汇总打印报告。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "userPrintReports": [
    {
      object (UserPrintReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
字段
userPrintReports[]

object (UserPrintReport)

UserPrintReports 匹配请求的列表。

nextPageToken

string

用于请求下一页的分页令牌。

totalSize

string (int64 format)

匹配请求的用户总数。

授权范围

需要以下 OAuth 范围:

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

UserPrintReport

reports.countPrintJobsByUser 报表,包含用户输出的统计信息。包含打印机数量、启动打印作业的设备数量和启动的打印作业的数量。

JSON 表示法
{
  "userId": string,
  "userEmail": string,
  "jobCount": string,
  "printerCount": string,
  "deviceCount": string
}
字段
userId

string

用户的唯一 Directory API ID。

userEmail

string

用户的主电子邮件地址。

jobCount

string (int64 format)

用户发起的打印任务数量。

printerCount

string (int64 format)

用户使用的打印机数量。

deviceCount

string (int64 format)

用户曾用于启动打印任务的 Chrome 设备的数量。