Method: customers.reports.countPrintJobsByPrinter
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קבלת סיכום של פעולות ההדפסה שבוצעו בכל מדפסת.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
customer |
string
חובה. מספר לקוח עם הקידומת "customers/ " או 'customers/my_customer' כדי להשתמש בלקוח שמשויך לחשבון שממנו נשלחה הבקשה.
|
פרמטרים של שאילתה
פרמטרים |
printerOrgUnitId |
string
המזהה של היחידה הארגונית למדפסות. אם צוין, יוחזרו רק נתונים של מדפסות מהיחידה הארגונית שצוינה. אם לא צוין, יוחזרו נתונים של מדפסות מכל היחידות הארגוניות.
|
pageSize |
integer
מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי וברירת המחדל הוא 100.
|
pageToken |
string
אסימון שמציין את הדף בתגובה שיש להחזיר.
|
filter |
string
מחרוזת שאילתה לסינון התוצאות, ושדות שמופרדים באמצעות AND בתחביר EBNF. הערה: המסנן הזה לא תומך בפעולות OR. הערה: מסנן זה תומך רק בקומפרטורים >= ו-<=. שדות סינון נתמכים:
|
orderBy |
string
שדה שמשמש לסדר התוצאות. אם לא צוין, התוצאות מסודרות בסדר עולה לפי ה'מדפסת'. השדה הזה. השדות הנתמכים של 'סידור לפי':
- מדפסת
- jobCount
- deviceCount
- userCount
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תשובה שמכילה דוח סיכום של הדפסה לגבי כל מדפסת מהיחידה הארגונית שצוינה עבור פרק הזמן המבוקש.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"printerReports": [
{
object (PrinterReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
שדות |
printerReports[] |
object (PrinterReport )
רשימת בקשות להתאמת דוחות המדפסת.
|
nextPageToken |
string
אסימון העימוד לבקשת הדף הבא.
|
totalSize |
string (int64 format)
המספר הכולל של מדפסות שתואמות לבקשה.
|
היקפי ההרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
PrinterReport
דוח עבור reports.countPrintJobsByPrinter, מכיל נתונים סטטיסטיים לגבי השימוש במדפסת. מכילה את המספר הכולל של משימות הדפסה שהופעלו באמצעות המדפסת הזו, את מספר המשתמשים ואת מספר המכשירים שהתחילו לפחות משימת הדפסה אחת במדפסת הזו.
ייצוג JSON |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
שדות |
printerId |
string
מזהה ממשק ה-API של המדפסת.
|
printer |
string
שם המדפסת.
|
printerModel |
string
דגם של מדפסת.
|
jobCount |
string (int64 format)
מספר משימות ההדפסה שנשלחו למדפסת.
|
userCount |
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\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. |"]]