Method: admin.directory.v1.customers.chrome.printServers.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
تنظیمات سرور چاپ را فهرست می کند.
درخواست HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printServers
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. شناسه منحصر به فرد حساب Google Workspace مشتری. قالب: customers/{id} |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد اشیاء برای بازگشت (پیش‌فرض 100 ، حداکثر 100 ). ممکن است این سرویس کمتر از این مقدار را برگرداند. |
pageToken | string یک نشانه تولید شده برای صفحه بندی نتایج ( nextPageToken از تماس قبلی). |
orgUnitId | string اگر orgUnitId در درخواست موجود باشد، فقط سرورهای چاپی که متعلق به واحد سازمانی (OU) یا به ارث رسیده است، بازگردانده می شوند. اگر orgUnitId منبع PrintServer با مورد درخواست مطابقت داشته باشد، OU صاحب سرور است. اگر orgUnitId در درخواست مشخص نشده باشد، تمام سرورهای چاپ برگردانده یا فیلتر می شوند. |
filter | string عبارت جستجو در نحو زبان Common Expression . فیلترهای پشتیبانی شده عبارتند از displayName , description و uri . مثال: printServer.displayName=='marketing-queue' . |
orderBy | string ترتیب مرتب سازی نتایج مقادیر پشتیبانی شده displayName ، description یا createTime هستند. ترتیب پیش‌فرض صعودی است، اما ترتیب نزولی را می‌توان با افزودن «نزولی» به فیلد orderBy برگرداند. برای مثال orderBy=='description desc' سرورهای چاپ را که بر اساس توضیحات به ترتیب نزولی مرتب شده اند، برمی گرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"printServers": [
{
object (PrintServer)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
printServers[] | object ( PrintServer ) لیست سرورهای چاپ |
nextPageToken | string نشانه ای که می تواند به عنوان pageToken در درخواست بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/admin.chrome.printers -
https://www.googleapis.com/auth/admin.chrome.printers.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
،
تنظیمات سرور چاپ را فهرست می کند.
درخواست HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printServers
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. شناسه منحصر به فرد حساب Google Workspace مشتری. قالب: customers/{id} |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد اشیاء برای بازگشت (پیش‌فرض 100 ، حداکثر 100 ). ممکن است این سرویس کمتر از این مقدار را برگرداند. |
pageToken | string یک نشانه تولید شده برای صفحه بندی نتایج ( nextPageToken از تماس قبلی). |
orgUnitId | string اگر orgUnitId در درخواست موجود باشد، فقط سرورهای چاپی که متعلق به واحد سازمانی (OU) یا به ارث رسیده است، بازگردانده می شوند. اگر orgUnitId منبع PrintServer با مورد درخواست مطابقت داشته باشد، OU صاحب سرور است. اگر orgUnitId در درخواست مشخص نشده باشد، تمام سرورهای چاپ برگردانده یا فیلتر می شوند. |
filter | string عبارت جستجو در نحو زبان Common Expression . فیلترهای پشتیبانی شده عبارتند از displayName , description و uri . مثال: printServer.displayName=='marketing-queue' . |
orderBy | string ترتیب مرتب سازی نتایج مقادیر پشتیبانی شده displayName ، description یا createTime هستند. ترتیب پیش‌فرض صعودی است، اما ترتیب نزولی را می‌توان با افزودن «نزولی» به فیلد orderBy برگرداند. برای مثال orderBy=='description desc' سرورهای چاپ را که بر اساس توضیحات به ترتیب نزولی مرتب شده اند، برمی گرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"printServers": [
{
object (PrintServer)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
printServers[] | object ( PrintServer ) لیست سرورهای چاپ |
nextPageToken | string نشانه ای که می تواند به عنوان pageToken در درخواست بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/admin.chrome.printers -
https://www.googleapis.com/auth/admin.chrome.printers.readonly
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-28 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Method: admin.directory.v1.customers.chrome.printServers.list\n\nLists print server configurations.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printServers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The [unique ID](https://developers.google.com/workspace/admin/directory/reference/rest/v1/customers) of the customer's Google Workspace account. Format: `customers/{id}` |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of objects to return (default `100`, max `100`). The service might return fewer than this value. |\n| `pageToken` | `string` A generated token to paginate results (the `nextPageToken` from a previous call). |\n| `orgUnitId` | `string` If `orgUnitId` is present in the request, only print servers owned or inherited by the organizational unit (OU) are returned. If the [`PrintServer`](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printServers) resource's `orgUnitId` matches the one in the request, the OU owns the server. If `orgUnitId` is not specified in the request, all print servers are returned or filtered against. |\n| `filter` | `string` Search query in [Common Expression Language syntax](https://github.com/google/cel-spec). Supported filters are `displayName`, `description`, and `uri`. Example: `printServer.displayName=='marketing-queue'`. |\n| `orderBy` | `string` Sort order for results. Supported values are `displayName`, `description`, or `createTime`. Default order is ascending, but descending order can be returned by appending \"desc\" to the `orderBy` field. For instance, `orderBy=='description desc'` returns the print servers sorted by description in descending order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printServers\": [ { object (/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printServers#PrintServer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printServers[]` | `object (`[PrintServer](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printServers#PrintServer)`)` List of print servers. |\n| `nextPageToken` | `string` A token that can be sent as `pageToken` in a request to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.chrome.printers`\n- `\n https://www.googleapis.com/auth/admin.chrome.printers.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
