Method: customers.reports.countPrintJobsByUser
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Obtenez un résumé des impressions effectuées par chaque utilisateur.
Requête HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
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 tâches d'impression lancées avec des imprimantes appartenant à l'unité organisationnelle spécifiée seront comptabilisées. Si cette valeur n'est pas spécifiée, toutes les tâches d'impression seront comptabilisé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 n'est pas spécifiée, les résultats seront classés dans l'ordre croissant de "userEmail". . Champs "orderBy" acceptés:
- userEmail
- jobCount
- printerCount
- deviceCount
|
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 utilisateur ayant lancé une tâche d'impression avec une imprimante de l'unité organisationnelle spécifiée au cours de 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 |
{
"userPrintReports": [
{
object (UserPrintReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Champs |
userPrintReports[] |
object (UserPrintReport )
Liste des requêtes correspondantes de UserPrintReports.
|
nextPageToken |
string
Jeton de pagination pour demander la page suivante.
|
totalSize |
string (int64 format)
Nombre total d'utilisateurs 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
UserPrintReport
Rapport pour reports.countPrintJobsByUser : contient les statistiques d'impression pour un utilisateur. Contient le nombre d'imprimantes, le nombre d'appareils utilisés pour lancer des tâches d'impression et le nombre de tâches d'impression lancées.
Représentation JSON |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
Champs |
userId |
string
ID unique de l'API Directory de l'utilisateur.
|
userEmail |
string
Adresse e-mail principale de l'utilisateur.
|
jobCount |
string (int64 format)
Nombre de tâches d'impression lancées par l'utilisateur.
|
printerCount |
string (int64 format)
Nombre d'imprimantes utilisées par l'utilisateur.
|
deviceCount |
string (int64 format)
Nombre de Chromebooks utilisés pour lancer des tâches d'impression par l'utilisateur.
|
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\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. |"]]