Method: admin.directory.v1.customers.chrome.printServers.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد إعدادات خادم الطباعة.
طلب HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printServers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. رقم التعريف الفريد لحساب العميل على Google Workspace التنسيق: customers/{id}
|
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد العناصر التي سيتم عرضها (القيمة التلقائية هي 100 والحد الأقصى هو 100). قد تعرِض الخدمة عددًا أقل من هذه القيمة.
|
pageToken |
string
رمز مميَّز تم إنشاؤه لتقسيم النتائج إلى صفحات (nextPageToken من طلب سابق)
|
orgUnitId |
string
إذا كان الخيار orgUnitId متوفّرًا في الطلب، يتم عرض خوادم الطباعة التي تملكها الوحدة التنظيمية أو اكتسبتها فقط. إذا كان orgUnitId لمورد PrintServer يتطابق مع القيمة الواردة في الطلب، يعني ذلك أنّ الوحدة التنظيمية تملك الخادم. في حال عدم تحديد orgUnitId في الطلب، يتم عرض جميع خوادم الطباعة أو الفلترة حسبها.
|
filter |
string
طلب البحث بتنسيق بنية لغة التعبير الشائعة الفلاتر المتوافقة هي displayName وdescription وuri. مثال: printServer.displayName=='marketing-queue'
|
orderBy |
string
ترتيب النتائج القيم المسموح بها هي displayName أو description أو createTime. يكون الترتيب التلقائي تصاعديًا، ولكن يمكن عرض الترتيب التنازلي من خلال إلحاق "desc" بحقل 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)."]]
