Method: customers.reports.countPrintJobsByUser
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zobacz podsumowanie drukowania wykonanego przez każdego użytkownika.
Żądanie HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
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 ją określisz, zliczane będą tylko zadania drukowania zainicjowane za pomocą drukarek w określonej jednostce organizacyjnej. W przypadku pominięcia tego parametru liczone są wszystkie zadania drukowania.
|
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 parametru „userEmail” . Obsługiwane pola orderBy:
- userEmail
- jobCount
- printerCount
- deviceCount
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź zawierająca raport z podsumowaniem drukowania dla każdego użytkownika, który w wybranym przedziale czasu zainicjował zadanie drukowania na drukarce w określonej jednostce organizacyjnej.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"userPrintReports": [
{
object (UserPrintReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Pola |
userPrintReports[] |
object (UserPrintReport )
Lista pasujących żądań UserPrintReports.
|
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 użytkowników pasujących do żądania.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
UserPrintReport
Raport dotyczący reports.countPrintJobsByUser zawiera statystyki drukowania dotyczące użytkownika. Zawiera liczbę drukarek, liczbę urządzeń używanych do inicjowania zadań drukowania oraz liczbę zainicjowanych zadań drukowania.
Zapis JSON |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
Pola |
userId |
string
Unikalny identyfikator użytkownika interfejsu Directory API.
|
userEmail |
string
Podstawowy adres e-mail użytkownika.
|
jobCount |
string (int64 format)
Liczba zadań drukowania zainicjowanych przez użytkownika.
|
printerCount |
string (int64 format)
Liczba drukarek używanych przez użytkownika.
|
deviceCount |
string (int64 format)
Liczba urządzeń z Chrome, które zostały użyte do zainicjowania zadań drukowania przez użytkownika.
|
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\u003eRetrieve a summary of printing activity by user, including the number of print jobs, printers, and devices used.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by organizational unit, date, and other criteria using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes a list of UserPrintReports, each containing user-specific printing statistics.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countPrintJobsByUser\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.CountPrintJobsByUserResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UserPrintReport](#UserPrintReport)\n - [JSON representation](#UserPrintReport.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet a summary of printing done by each user.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser`\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 print jobs initiated with printers from the specified organizational unit will be counted. If omitted, all print jobs will be counted. |\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 'userEmail' field. Supported orderBy fields: - userEmail - jobCount - printerCount - deviceCount |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a summary printing report for each user that has initiated a print job with a printer from the specified organizational unit during the requested time interval.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"userPrintReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByUser#UserPrintReport) } ], \"nextPageToken\": string, \"totalSize\": string } ``` |\n\n| Fields ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userPrintReports[]` | `object (`[UserPrintReport](/chrome/management/reference/rest/v1/customers.reports/countPrintJobsByUser#UserPrintReport)`)` List of UserPrintReports 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 users matching request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nUserPrintReport\n---------------\n\nReport for reports.countPrintJobsByUser, contains printing statistics for a user. Contains the number of printers, the number of devices used to initiate print jobs, and the number of print jobs initiated.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"userId\": string, \"userEmail\": string, \"jobCount\": string, \"printerCount\": string, \"deviceCount\": string } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The unique Directory API ID of the user. |\n| `userEmail` | `string` The primary e-mail address of the user. |\n| `jobCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of print jobs initiated by the user. |\n| `printerCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of printers used by the user. |\n| `deviceCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of chrome devices that have been used to initiate print jobs by the user. |"]]