Method: customers.reports.countPrintJobsByPrinter
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Obtenez un récapitulatif des impressions effectuées par chaque imprimante.
Requête HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
customer |
string
Obligatoire. Numéro client précédé de "customers/" ou "customers/my_customer" pour utiliser le client associé au compte à l'origine de la demande.
|
Paramètres de requête
Paramètres |
printerOrgUnitId |
string
ID de l'unité organisationnelle pour les imprimantes. Si cette option est spécifiée, seules les données des imprimantes de l'unité organisationnelle spécifiée sont renvoyées. En cas d'omission, les données des imprimantes de toutes les unités organisationnelles sont renvoyées.
|
pageSize |
integer
Nombre maximal de résultats sur une page. La valeur maximale et la valeur par défaut sont 100.
|
pageToken |
string
Jeton permettant de spécifier la page de la réponse à renvoyer.
|
filter |
string
Chaîne de requête pour filtrer les résultats, et les champs séparés par ET (ET) dans une syntaxe EBNF. Remarque: Les opérations OR ne sont pas prises en charge par ce filtre. Remarque: Seuls les comparateurs >= et <= sont acceptés dans ce filtre. Champs de filtre compatibles:
|
orderBy |
string
Champ permettant de trier les résultats. Si cette valeur est omise, les résultats sont classés dans l'ordre croissant pour le terme "imprimante". . Champs "orderBy" acceptés:
- imprimante
- jobCount
- deviceCount
- userCount
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse contenant un rapport d'impression récapitulatif pour chaque imprimante de l'unité organisationnelle spécifiée pour l'intervalle de temps demandé.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"printerReports": [
{
object (PrinterReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Champs |
printerReports[] |
object (PrinterReport )
Liste des requêtes correspondantes PrinterReports.
|
nextPageToken |
string
Jeton de pagination pour demander la page suivante.
|
totalSize |
string (int64 format)
Nombre total d'imprimantes correspondant à la demande.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrinterReport
Le rapport "reports.countPrintJobsByPrinter" contient des statistiques sur l'utilisation de l'imprimante. Contient le nombre total de tâches d'impression lancées avec cette imprimante, ainsi que le nombre d'utilisateurs et d'appareils ayant lancé au moins une tâche d'impression avec cette imprimante.
Représentation JSON |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
Champs |
printerId |
string
ID de l'API de l'imprimante.
|
printer |
string
Nom de l'imprimante.
|
printerModel |
string
Modèle de l'imprimante.
|
jobCount |
string (int64 format)
Nombre de tâches d'impression envoyées à l'imprimante.
|
userCount |
string (int64 format)
Nombre d'utilisateurs ayant envoyé des tâches d'impression à l'imprimante.
|
deviceCount |
string (int64 format)
Nombre de Chromebooks utilisés pour envoyer des tâches d'impression à l'imprimante spécifiée.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]