获取打印任务列表。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:enumeratePrintJobs
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customer |
必需。以“customers/”或“customers/my_customer”开头的客户 ID,可使用与发出请求的帐号相关联的客户。 |
查询参数
参数 | |
---|---|
printerOrgUnitId |
打印机组织部门的 ID。如果指定,则只返回由指定组织部门提交给打印机的打印任务。 |
pageSize |
页面中的打印作业数量(介于 0 和 100 之间,包括 0 和 100),如果 pageSize 未指定或为零,则大小将为 50。 |
pageToken |
从之前的 进行分页时,提供给 |
filter |
用于过滤结果的查询字符串,采用 EBNF 语法以 AND 分隔的字段。 注意:此过滤条件不支持 OR 运算。注意: 支持的过滤条件字段:
|
orderBy |
用于对结果进行排序的字段。如果未指定,则结果将按 支持的字段顺序:
|
请求正文
请求正文必须为空。
响应正文
包含打印任务列表的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"printJobs": [
{
object ( |
字段 | |
---|---|
printJobs[] |
请求的打印作业列表。 |
nextPageToken |
一个令牌,可以在后续请求中用于检索下一页。如果省略此字段,则不存在后续页面。 |
totalSize |
符合请求的打印任务总数。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrintJob
表示打印已提交至打印机的文档的请求。
JSON 表示法 |
---|
{ "id": string, "title": string, "state": enum ( |
字段 | |
---|---|
id |
打印作业的唯一 ID。 |
title |
文档的标题。 |
state |
作业的最终状态。 |
createTime |
打印任务创建时间戳。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
completeTime |
打印任务完成时间戳。 时间戳,采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,具有纳秒级分辨率,最多包含九个小数位。示例: |
documentPageCount |
文档的页数。 |
colorMode |
颜色模式。 |
duplexMode |
双面模式。 |
copyCount |
副本数量。 |
printerId |
用于打印的打印机的 API ID。 |
printer |
用于打印的打印机的名称。 |
userEmail |
提交打印作业的用户的主电子邮件地址。 |
userId |
提交打印作业的用户的唯一 Directory API ID。 |
状态
打印作业的状态。
枚举 | |
---|---|
STATE_UNSPECIFIED |
打印作业处于未指定状态。 |
PRINTED |
文档已成功打印。 |
CANCELLED |
打印作业已取消。 |
FAILED |
打印作业失败。 |
ColorMode
打印任务颜色模式。
枚举 | |
---|---|
COLOR_MODE_UNSPECIFIED |
未指定。 |
BLACK_AND_WHITE |
黑白。 |
COLOR |
颜色。 |
DuplexMode
打印任务双面模式。
枚举 | |
---|---|
DUPLEX_MODE_UNSPECIFIED |
未指定。 |
ONE_SIDED |
单面。 |
TWO_SIDED_LONG_EDGE |
双面翻转长边。 |
TWO_SIDED_SHORT_EDGE |
双面翻转过短边。 |