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" . حقول orderBy المتاحة:
- 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
المعرّف الفريد لواجهة برمجة تطبيقات الدليل للمستخدم.
|
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 (حسب التوقيت العالمي المتفَّق عليه)
[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. |"]]
