Method: customers.reports.countPrintJobsByPrinter
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countPrintJobsByPrinter
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
customer |
string
必須。先頭に「customers/」が付いたお客様 IDまたは「customers/my_customer」リクエストを発行したアカウントに関連付けられているお客様を使用します。
|
クエリ パラメータ
パラメータ |
printerOrgUnitId |
string
プリンタの組織部門の ID。指定した場合、指定した組織部門のプリンタのデータのみが返されます。省略した場合は、すべての組織部門のプリンタのデータが返されます。
|
pageSize |
integer
返される結果の最大数。最大値とデフォルトは 100 です。
|
pageToken |
string
返されるレスポンスのページを指定するトークン。
|
filter |
string
結果をフィルタリングするクエリ文字列、EBNF 構文の AND で区切られたフィールド。 注: このフィルタでは OR 演算はサポートされていません。注: このフィルタでは、コンパレータ「>=」と「<=」のみを使用できます。 サポートされているフィルタ フィールド:
|
orderBy |
string
結果の並べ替えに使用するフィールド。省略すると、結果は「printer」の昇順で並べられます表示されます。 サポートされている 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
report.countPrintJobsByPrinter のレポート。プリンタの使用状況に関する統計情報が含まれます。このプリンタで開始された印刷ジョブの合計数、ユーザー数、このプリンタで少なくとも 1 つの印刷ジョブを開始したデバイスの数が含まれます。
JSON 表現 |
{
"printerId": string,
"printer": string,
"printerModel": string,
"jobCount": string,
"userCount": string,
"deviceCount": string
} |
フィールド |
printerId |
string
プリンタ API ID。
|
printer |
string
プリンタ名。
|
printerModel |
string
プリンタのモデル。
|
jobCount |
string (int64 format)
プリンタに送信された印刷ジョブの数。
|
userCount |
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\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. |"]]