Method: customers.reports.countPrintJobsByPrinter
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zobacz podsumowanie informacji o drukowaniu na każdej drukarce.
Żądanie HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
customer |
string
Wymagane. Identyfikator klienta z prefiksem „customers/” lub „customers/my_customer” , aby użyć konta klienta powiązanego z kontem, z którego wysłano prośbę.
|
Parametry zapytania
Parametry |
printerOrgUnitId |
string
Identyfikator jednostki organizacyjnej drukarek. Jeśli określisz wartość, zwracane będą tylko dane dotyczące drukarek z określonej jednostki organizacyjnej. Jeśli go pominiesz, zwrócone zostaną dane dotyczące drukarek ze wszystkich jednostek organizacyjnych.
|
pageSize |
integer
Maksymalna liczba wyników do zwrócenia. Wartość maksymalna i domyślna to 100.
|
pageToken |
string
Token określający stronę odpowiedzi, która ma zostać zwrócona.
|
filter |
string
Ciąg zapytania do filtrowania wyników, pola rozdzielone ORAZ w składni EBNF. Uwaga: w tym filtrze operacje LUB nie są obsługiwane. Uwaga: w tym filtrze dopuszczalne są tylko operatory >= i <=. Obsługiwane pola filtrów:
|
orderBy |
string
Pole używane do sortowania wyników. Jeśli nazwa zostanie pominięta, wyniki zostaną uporządkowane rosnąco według wartości „drukarka” . Obsługiwane pola orderBy:
- drukarka
- jobCount
- deviceCount
- userCount
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź zawierająca raport z podsumowaniem drukowania dla każdej drukarki z określonej jednostki organizacyjnej w żądanym przedziale czasu.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"printerReports": [
{
object (PrinterReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Pola |
printerReports[] |
object (PrinterReport )
Lista pasujących żądań Drukarki.
|
nextPageToken |
string
Token podziału na strony, który służy do żądania wyświetlenia następnej strony.
|
totalSize |
string (int64 format)
Łączna liczba drukarek pasujących do żądania.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrinterReport
Raport dotyczący reports.countPrintJobsByPrinter, zawiera statystyki korzystania z drukarki. Zawiera łączną liczbę zadań drukowania zainicjowanych na tej drukarce, liczbę użytkowników i liczbę urządzeń, które zainicjowały na tej drukarce co najmniej jedno zadanie drukowania.
Zapis JSON |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
Pola |
printerId |
string
Identyfikator interfejsu Printer API.
|
printer |
string
Nazwa drukarki.
|
printerModel |
string
Model drukarki.
|
jobCount |
string (int64 format)
Liczba zadań drukowania wysłanych do drukarki.
|
userCount |
string (int64 format)
Liczba użytkowników, którzy wysłali zadania drukowania do drukarki.
|
deviceCount |
string (int64 format)
Liczba urządzeń z Chrome, które były używane do wysyłania zadań drukowania do określonej drukarki.
|
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-25 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. |"]]