Method: customers.reports.countPrintJobsByUser
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Nhận bản tóm tắt về hoạt động in của từng người dùng.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số |
customer |
string
Bắt buộc. Mã khách hàng có tiền tố là "customer/" hoặc "customer/my_customer" để sử dụng khách hàng liên kết với tài khoản đưa ra yêu cầu.
|
Tham số truy vấn
Tham số |
printerOrgUnitId |
string
Mã của đơn vị tổ chức dùng cho máy in. Nếu bạn chỉ định, chỉ các lệnh in được khởi tạo bằng máy in thuộc đơn vị tổ chức được chỉ định mới được tính. Nếu bạn bỏ qua lệnh in này, hệ thống sẽ tính tất cả các lệnh in.
|
pageSize |
integer
Số kết quả tối đa cần trả về. Tối đa và mặc định là 100.
|
pageToken |
string
Mã thông báo để chỉ định trang của phản hồi sẽ được trả về.
|
filter |
string
Chuỗi truy vấn để lọc kết quả, các trường được phân tách bằng dấu AND bằng cú pháp EBNF. Lưu ý: Bộ lọc này không hỗ trợ phép toán OR. Lưu ý: Chỉ các phép so sánh >= và <= được hỗ trợ trong bộ lọc này. Các trường bộ lọc được hỗ trợ:
|
orderBy |
string
Trường được dùng để sắp xếp kết quả. Nếu bỏ qua, kết quả sẽ được sắp xếp theo thứ tự tăng dần của 'userEmail' . Các trường orderBy được hỗ trợ:
- userEmail
- jobCount
- printerCount
- deviceCount
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi chứa báo cáo in tóm tắt cho từng người dùng đã bắt đầu lệnh in bằng máy in từ đơn vị tổ chức được chỉ định trong khoảng thời gian yêu cầu.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"userPrintReports": [
{
object (UserPrintReport )
}
],
"nextPageToken": string,
"totalSize": string
} |
Trường |
userPrintReports[] |
object (UserPrintReport )
Danh sách yêu cầu so khớp UserPrintReports.
|
nextPageToken |
string
Mã thông báo phân trang để yêu cầu trang tiếp theo.
|
totalSize |
string (int64 format)
Tổng số người dùng phù hợp với yêu cầu.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.reports.readonly
UserPrintReport
Báo cáo cho báo cáo.countPrintCông việcByUser, chứa số liệu thống kê về việc in cho người dùng. Chứa số lượng máy in, số lượng thiết bị được dùng để bắt đầu các lệnh in và số lượng lệnh in đã thực hiện.
Biểu diễn dưới dạng JSON |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
Trường |
userId |
string
Mã Directory API duy nhất của người dùng.
|
userEmail |
string
Địa chỉ email chính của người dùng.
|
jobCount |
string (int64 format)
Số lệnh in do người dùng thực hiện.
|
printerCount |
string (int64 format)
Số máy in mà người dùng sử dụng.
|
deviceCount |
string (int64 format)
Số thiết bị Chrome mà người dùng đã sử dụng để bắt đầu lệnh in.
|
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]