Method: admin.directory.v1.customers.chrome.printServers.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימה של הגדרות שרתי ההדפסה.
בקשת HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printServers
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
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 Language. המסננים הנתמכים הם 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-24 (שעון UTC)."],[],[],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)."]]