Method: customers.reports.countPrintJobsByUser
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קבלת סיכום לגבי כל הדפסה שכל משתמש ביצע.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
customer |
string
חובה. מספר לקוח עם הקידומת "customers/ " או 'customers/my_customer' כדי להשתמש בלקוח שמשויך לחשבון שממנו נשלחה הבקשה.
|
פרמטרים של שאילתה
פרמטרים |
printerOrgUnitId |
string
המזהה של היחידה הארגונית למדפסות. אם צוין, ייספרו רק משימות הדפסה שהופעלו באמצעות מדפסות מהיחידה הארגונית שצוינה. אם לא צוין, כל משימות ההדפסה ייספרו.
|
pageSize |
integer
מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי וברירת המחדל הוא 100.
|
pageToken |
string
אסימון שמציין את הדף בתגובה שיש להחזיר.
|
filter |
string
מחרוזת שאילתה לסינון התוצאות, ושדות שמופרדים באמצעות AND בתחביר EBNF. הערה: המסנן הזה לא תומך בפעולות OR. הערה: מסנן זה תומך רק בקומפרטורים >= ו-<=. שדות סינון נתמכים:
|
orderBy |
string
שדה שמשמש לסדר התוצאות. אם לא צוין, התוצאות יסודרו בסדר עולה לפי 'userEmail'. השדה הזה. השדות הנתמכים של 'סידור לפי':
- userEmail
- jobCount
- printerCount
- deviceCount
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה שמכילה דוח הדפסת סיכום לכל משתמש שהתחיל משימת הדפסה במדפסת מהיחידה הארגונית שצוינה במהלך פרק הזמן המבוקש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"userPrintReports": [
{
object (UserPrintReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
שדות |
userPrintReports[] |
object (UserPrintReport )
רשימת בקשות להתאמת UserPrintReports.
|
nextPageToken |
string
אסימון העימוד לבקשת הדף הבא.
|
totalSize |
string (int64 format)
המספר הכולל של משתמשים שתואמים לבקשה.
|
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
UserPrintReport
הדוח של reports.countPrintJobsByUser, מכיל נתונים סטטיסטיים של הדפסה עבור משתמש. מכילה את מספר המדפסות, את מספר המכשירים ששימשו להתחלת משימות הדפסה ואת מספר משימות ההדפסה שהופעלו.
ייצוג JSON |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
שדות |
userId |
string
המזהה הייחודי של המשתמש ב-Directory API.
|
userEmail |
string
כתובת האימייל הראשית של המשתמש.
|
jobCount |
string (int64 format)
מספר משימות ההדפסה שהופעלו על ידי המשתמש.
|
printerCount |
string (int64 format)
מספר המדפסות ששימשו את המשתמש.
|
deviceCount |
string (int64 format)
מספר מכשירי Chrome שהשתמשו בהם כדי להתחיל משימות הדפסה על ידי המשתמש.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]