Method: customers.reports.countPrintJobsByUser
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
خلاصه ای از چاپ انجام شده توسط هر کاربر را دریافت کنید.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customer | string مورد نیاز. شناسه مشتری با پیشوند «customers/» یا «customers/my_customer» برای استفاده از مشتری مرتبط با حسابی که درخواست را ارائه می‌کند. |
پارامترهای پرس و جو
| پارامترها |
|---|
printerOrgUnitId | string شناسه واحد سازمانی چاپگرها. در صورت مشخص شدن، فقط کارهای چاپی که با چاپگرهای واحد سازمانی مشخص شده آغاز شده اند، شمارش خواهند شد. اگر حذف شود، تمام کارهای چاپ شمارش می شود. |
pageSize | integer حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 100 است. |
pageToken | string رمزی برای مشخص کردن صفحه پاسخی که باید برگردانده شود. |
filter | string رشته پرس و جو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در نحو EBNF. توجه: عملیات OR در این فیلتر پشتیبانی نمی شود. توجه: فقط مقایسه کننده های >= و <= در این فیلتر پشتیبانی می شوند. فیلدهای فیلتر پشتیبانی شده: |
orderBy | string فیلد مورد استفاده برای سفارش نتایج. در صورت حذف، نتایج به ترتیب صعودی فیلد 'userEmail' مرتب خواهند شد. فیلدهای سفارشی پشتیبانی شده: - ایمیل کاربر
- تعداد شغل
- تعداد چاپگر
- شمارش دستگاه
|
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخی حاوی گزارش چاپ خلاصه برای هر کاربری که در بازه زمانی درخواستی، کار چاپ را با چاپگر از واحد سازمانی مشخص شده آغاز کرده است.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی 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
گزارش برای report.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) تعداد دستگاه‌های کرومی که برای شروع کارهای چاپی توسط کاربر استفاده شده‌اند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
