Method: customers.reports.countPrintJobsByUser
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie erhalten eine Zusammenfassung der von jedem Nutzer durchgeführten Druckaufträge.
HTTP-Anfrage
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
customer |
string
Erforderlich. Kundennummer mit dem Präfix „customers/“ oder „customers/my_customer“ um den Kunden zu verwenden, der mit dem Konto verknüpft ist, von dem die Anfrage stammt.
|
Abfrageparameter
Parameter |
printerOrgUnitId |
string
Die ID der Organisationseinheit für Drucker. Wenn angegeben, werden nur Druckaufträge gezählt, die mit Druckern der angegebenen Organisationseinheit initiiert wurden. Wird er nicht angegeben, werden alle Druckaufträge gezählt.
|
pageSize |
integer
Maximale Anzahl der zurückzugebenden Ergebnisse. Der Höchst- und der Standardwert sind 100.
|
pageToken |
string
Token zur Angabe der Seite der zurückzugebenden Antwort.
|
filter |
string
Abfragezeichenfolge zum Filtern von Ergebnissen, UND-getrennte Felder in der EBNF-Syntax. Hinweis: OR-Vorgänge werden in diesem Filter nicht unterstützt. Hinweis: In diesem Filter werden nur Vergleichszeichen >= und <= unterstützt. Unterstützte Filterfelder:
|
orderBy |
string
Feld zum Sortieren der Ergebnisse. Ohne Angabe werden die Ergebnisse in aufsteigender Reihenfolge nach „userEmail“ sortiert. ein. Unterstützte „orderBy“-Felder:
- userEmail
- jobCount
- printerCount
- deviceCount
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort, die einen zusammenfassenden Druckbericht für jeden Nutzer enthält, der während des angeforderten Zeitraums einen Druckauftrag mit einem Drucker aus der angegebenen Organisationseinheit initiiert hat.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"userPrintReports": [
{
object (UserPrintReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Felder |
userPrintReports[] |
object (UserPrintReport )
Liste der UserPrintReports-Übereinstimmungsanfragen.
|
nextPageToken |
string
Das Paginierungstoken zum Anfordern der nächsten Seite.
|
totalSize |
string (int64 format)
Gesamtzahl der Nutzer, die der Anfrage entsprechen.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.reports.readonly
UserPrintReport
Der Bericht für „reports.countPrintJobsByUser“ enthält Druckstatistiken für einen Nutzer. Enthält die Anzahl der Drucker, die Anzahl der Geräte, mit denen Druckaufträge initiiert werden, und die Anzahl der initiierten Druckaufträge.
JSON-Darstellung |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
Felder |
userId |
string
Die eindeutige Directory API-ID des Nutzers.
|
userEmail |
string
Die primäre E-Mail-Adresse des Nutzers.
|
jobCount |
string (int64 format)
Anzahl der Druckaufträge, die vom Nutzer initiiert wurden.
|
printerCount |
string (int64 format)
Anzahl der vom Nutzer verwendeten Drucker.
|
deviceCount |
string (int64 format)
Anzahl der Chrome-Geräte, auf denen Druckaufträge vom Nutzer initiiert wurden.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]