Method: customers.reports.countPrintJobsByPrinter
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie erhalten eine Zusammenfassung der von jedem Drucker durchgeführten Druckvorgänge.
HTTP-Anfrage
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
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 Daten für Drucker der angegebenen Organisationseinheit zurückgegeben. Wenn nichts angegeben ist, werden die Daten zu Druckern aus allen Organisationseinheiten zurückgegeben.
|
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. Wenn nichts angegeben ist, werden die Ergebnisse in aufsteigender Reihenfolge nach „Drucker“ sortiert. ein. Unterstützte „orderBy“-Felder:
- drucker
- jobCount
- deviceCount
- userCount
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort, die einen zusammenfassenden Druckbericht für jeden Drucker aus der angegebenen Organisationseinheit für das angeforderte Zeitintervall enthält.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"printerReports": [
{
object (PrinterReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Felder |
printerReports[] |
object (PrinterReport )
Liste der PrinterReports-Übereinstimmungsanfragen.
|
nextPageToken |
string
Das Paginierungstoken zum Anfordern der nächsten Seite.
|
totalSize |
string (int64 format)
Gesamtzahl der Drucker, die der Anfrage entsprechen.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrinterReport
Bericht für Reports.countPrintJobsByPrinter enthält Statistiken zur Druckernutzung. Enthält die Gesamtzahl der Druckaufträge, die mit diesem Drucker initiiert wurden, die Anzahl der Nutzer und die Anzahl der Geräte, die mindestens einen Druckauftrag auf diesem Drucker initiiert haben.
JSON-Darstellung |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
Felder |
printerId |
string
Printer API-ID.
|
printer |
string
Druckername.
|
printerModel |
string
Druckermodell.
|
jobCount |
string (int64 format)
Anzahl der Druckaufträge, die an den Drucker gesendet wurden.
|
userCount |
string (int64 format)
Anzahl der Nutzer, die Druckaufträge an den Drucker gesendet haben.
|
deviceCount |
string (int64 format)
Anzahl der Chrome-Geräte, die zum Senden von Druckaufträgen an den angegebenen Drucker verwendet 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\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. |"]]