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
รหัส API ไดเรกทอรีที่ไม่ซ้ำกันของผู้ใช้
|
userEmail |
string
อีเมลหลักของผู้ใช้
|
jobCount |
string (int64 format)
จำนวนงานพิมพ์ที่ผู้ใช้เริ่มต้น
|
printerCount |
string (int64 format)
จำนวนเครื่องพิมพ์ที่ผู้ใช้ใช้
|
deviceCount |
string (int64 format)
จำนวนอุปกรณ์ Chrome ที่ผู้ใช้ใช้เพื่อเริ่มงานพิมพ์
|
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[[["\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. |"]]
