Method: customers.reports.countPrintJobsByPrinter
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
网址采用 gRPC 转码语法。
路径参数
参数 |
customer |
string
必需。前缀为“customers/”的客户 ID或“customers/my_customer”以使用与发出请求的账号相关联的客户。
|
查询参数
参数 |
printerOrgUnitId |
string
打印机所属的组织部门的 ID。如果指定,则系统将仅返回指定组织部门的打印机数据。如果省略此参数,则系统将返回所有组织部门中打印机的数据。
|
pageSize |
integer
返回的结果数上限。最大值和默认值为 100。
|
pageToken |
string
用于指定要返回的响应页面的令牌。
|
filter |
string
用于过滤结果的查询字符串,以及采用 EBNF 语法且以 AND 分隔的字段。 注意:此过滤条件不支持 OR 运算。注意:此过滤条件中仅支持 >= 和 <= 比较运算符。 支持的过滤条件字段:
|
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 设备的数量。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eGet a summary of printing activity by each printer, including the number of jobs, users, and devices.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by organizational unit and time range using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of PrinterReports, each containing printer details and usage statistics.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countPrintJobsByPrinter\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CountPrintJobsByPrinterResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [PrinterReport](#PrinterReport)\n - [JSON representation](#PrinterReport.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet a summary of printing done by each printer.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Customer ID prefixed with \"customers/\" or \"customers/my_customer\" to use the customer associated to the account making the request. |\n\n### Query parameters\n\n| Parameters ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printerOrgUnitId` | `string` The ID of the organizational unit for printers. If specified, only data for printers from the specified organizational unit will be returned. If omitted, data for printers from all organizational units will be returned. |\n| `pageSize` | `integer` Maximum number of results to return. Maximum and default are 100. |\n| `pageToken` | `string` Token to specify the page of the response to be returned. |\n| `filter` | `string` Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only \\\u003e= and \\\u003c= comparators are supported in this filter. Supported filter fields: - completeTime |\n| `orderBy` | `string` Field used to order results. If omitted, results will be ordered in ascending order of the 'printer' field. Supported orderBy fields: - printer - jobCount - deviceCount - userCount |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a summary printing report for each printer from the specified organizational unit for the requested time interval.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printerReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByPrinter#PrinterReport) } ], \"nextPageToken\": string, \"totalSize\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printerReports[]` | `object (`[PrinterReport](/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByPrinter#PrinterReport)`)` List of PrinterReports matching request. |\n| `nextPageToken` | `string` Pagination token for requesting the next page. |\n| `totalSize` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Total number of printers matching request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nPrinterReport\n-------------\n\nReport for reports.countPrintJobsByPrinter, contains statistics on printer usage. Contains the total number of print jobs initiated with this printer, the number of users and the number of devices that have initiated at least one print job with this printer.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printerId\": string, \"printer\": string, \"printerModel\": string, \"jobCount\": string, \"userCount\": string, \"deviceCount\": string } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printerId` | `string` Printer API ID. |\n| `printer` | `string` Printer name. |\n| `printerModel` | `string` Printer model. |\n| `jobCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of print jobs sent to the printer. |\n| `userCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of users that have sent print jobs to the printer. |\n| `deviceCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of chrome devices that have been used to send print jobs to the specified printer. |"]]