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