Method: customers.reports.countPrintJobsByUser
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByUser
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
customer |
string
必要欄位。客戶 ID 開頭為「customers/」或「customers/my_customer」使用與提出要求之帳戶相關聯的客戶。
|
查詢參數
參數 |
printerOrgUnitId |
string
印表機的機構單位 ID。如果指定這個值,系統只會計算透過指定機構單位的印表機啟動的列印工作。如果省略此引數,系統會計算所有列印工作。
|
pageSize |
integer
要傳回的結果數上限。最大值和預設值為 100。
|
pageToken |
string
用於指定要傳回回應頁面的權杖。
|
filter |
string
篩選結果的查詢字串,以及採用 EBNF 語法的「AND」分隔欄位。 注意:這個篩選器不支援 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
report.countPrintJobsByUser 的報表,包含使用者的列印統計資料。包含印表機數量、用來啟動列印工作的裝置數量,以及啟動的列印工作數量。
JSON 表示法 |
{
"userId": string,
"userEmail": string,
"jobCount": string,
"printerCount": string,
"deviceCount": string
} |
欄位 |
userId |
string
使用者的專屬 Directory API ID。
|
userEmail |
string
使用者的主要電子郵件地址。
|
jobCount |
string (int64 format)
使用者啟動的列印工作數量。
|
printerCount |
string (int64 format)
使用者使用的印表機數量。
|
deviceCount |
string (int64 format)
這是指使用者用於啟動列印工作的 Chrome 裝置數量。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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. |"]]