Method: customers.reports.countPrintJobsByPrinter
Stay organized with collections
Save and categorize content based on your preferences.
Get a summary of printing done by each printer.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
customer |
string
Required. Customer ID prefixed with "customers/" or "customers/my_customer" to use the customer associated to the account making the request.
|
Query parameters
Parameters |
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.
|
pageSize |
integer
Maximum number of results to return. Maximum and default are 100.
|
pageToken |
string
Token to specify the page of the response to be returned.
|
filter |
string
Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Note: Only >= and <= comparators are supported in this filter. Supported filter fields:
|
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
|
Request body
The request body must be empty.
Response body
Response containing a summary printing report for each printer from the specified organizational unit for the requested time interval.
If successful, the response body contains data with the following structure:
JSON representation |
{
"printerReports": [
{
object (PrinterReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Fields |
printerReports[] |
object (PrinterReport )
List of PrinterReports matching request.
|
nextPageToken |
string
Pagination token for requesting the next page.
|
totalSize |
string (int64 format)
Total number of printers matching request.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrinterReport
Report 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.
JSON representation |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
Fields |
printerId |
string
Printer API ID.
|
printer |
string
Printer name.
|
printerModel |
string
Printer model.
|
jobCount |
string (int64 format)
Number of print jobs sent to the printer.
|
userCount |
string (int64 format)
Number of users that have sent print jobs to the printer.
|
deviceCount |
string (int64 format)
Number of chrome devices that have been used to send print jobs to the specified printer.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-23 UTC.
[null,null,["Last updated 2025-06-23 UTC."],[[["\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. |"]]