获取打印作业列表。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:enumeratePrintJobs
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customer |
必需。客户 ID,前缀为“customers/”或“customers/my_customer”,用于使用与发出请求的账号关联的客户。 |
查询参数
参数 | |
---|---|
printer |
打印机所属的组织部门的 ID。如果指定,则系统只会返回指定组织部门中提交到打印机的打印作业。 |
page |
页面中的打印作业数量(介于 0 到 100 之间,包括这两个数值)。如果未指定 pageSize 或其值为零,则大小为 50。 |
page |
从之前的 进行分页时,提供给 |
filter |
用于过滤结果的查询字符串,采用 EBNF 语法,字段之间用“AND”分隔。 注意:此过滤条件不支持 OR 运算。注意: 支持的过滤字段:
|
order |
用于对结果进行排序的字段。如果未指定,结果将按 支持的排序字段:
|
请求正文
请求正文必须为空。
响应正文
包含打印作业列表的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"printJobs": [
{
object ( |
字段 | |
---|---|
print |
请求的打印作业列表。 |
next |
令牌,可在后续请求中用于检索下一页。如果省略此字段,则不存在后续页面。 |
total |
与请求匹配的打印作业总数。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrintJob
表示请求打印已提交给打印机的文档。
JSON 表示法 |
---|
{ "id": string, "title": string, "state": enum ( |
字段 | |
---|---|
id |
打印作业的唯一 ID。 |
title |
文档的标题。 |
state |
作业的最终状态。 |
create |
打印作业创建时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
complete |
打印作业完成时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
document |
文档的页数。 |
color |
颜色模式。 |
duplex |
双工模式。 |
copy |
副本数量。 |
printer |
用于打印的打印机的 API ID。 |
printer |
用于打印的打印机的名称。 |
user |
提交打印作业的用户的主电子邮件地址。 |
user |
提交打印作业的用户的唯一 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 |
短边翻转双面翻转。 |