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
الحقل المستخدَم لترتيب النتائج في حال حذفها، سيتم ترتيب النتائج تصاعديًا حسب "الطابعة" . حقول orderBy المتاحة:
- طابعة
- jobCount
- deviceCount
- userCount
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
استجابة تحتوي على تقرير طباعة ملخص لكل طابعة من الوحدة التنظيمية المحددة للفاصل الزمني المطلوب.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل 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
PrinterReport
يحتوي تقرير reports.countPrintJobsByPrinter على إحصاءات عن استخدام الطابعة. يحتوي على العدد الإجمالي لمهام الطباعة التي تم بدؤها باستخدام هذه الطابعة وعدد المستخدمين وعدد الأجهزة التي بدأت مهمة طباعة واحدة على الأقل باستخدام هذه الطابعة.
| تمثيل JSON |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
| الحقول |
printerId |
string
رقم تعريف واجهة برمجة التطبيقات للطابعة
|
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 (حسب التوقيت العالمي المتفَّق عليه)
[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. |"]]
