Method: admin.directory.v1.customers.chrome.printers.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימה של הגדרות המדפסות.
בקשת HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
parent |
string
חובה. השם של הלקוח שבבעלותו האוסף הזה של מדפסות. פורמט: customers/{customer_id}
|
פרמטרים של שאילתה
| פרמטרים |
pageSize |
integer
המספר המקסימלי של אובייקטים להחזרה. יכול להיות שהשירות יחזיר פחות מהערך הזה.
|
pageToken |
string
אסימון דף, שהתקבל משיחה קודמת.
|
orgUnitId |
string
היחידה הארגונית שעבורה רוצים לרשום את המדפסות. אם השדה org_unit לא מופיע בבקשה, כל המדפסות של הלקוח יוחזרו (או יסוננו). אם השדה org_unit מופיע בבקשה, יוחזרו רק מדפסות שזמינות ל-OU הזה (בבעלות או בירושה). כדי לבדוק אם המדפסת בבעלות היחידה הארגונית הזו או שהיא הועברה אליה בירושה, אפשר לעיין בערך של Printer.org_unit_id.
|
filter |
string
שאילתת חיפוש. התחביר של החיפוש משותף בין ה-API הזה לבין דפי המדפסות במסוף Admin.
|
orderBy |
string
הסדר שבו רוצים למיין את התוצאות. חייב להיות אחד מהערכים הבאים: displayName, description, makeAndModel או createTime. ברירת המחדל היא סדר עולה, אבל אפשר להוסיף את 'desc' לשדה orderBy כדי לקבל סדר יורד. לדוגמה, 'description desc' תחזיר את המדפסות ממוינות לפי תיאור בסדר יורד.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה להוספת מדפסות לרשימת המדפסות.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| ייצוג ב-JSON |
{
"printers": [
{
object (Printer)
}
],
"nextPageToken": string
} |
| שדות |
printers[] |
object (Printer)
רשימת מדפסות. אם הערך orgUnitId צוין בבקשה, יוחזרו רק מדפסות שגלויות ליחידה הארגונית הזו. אם לא צוין orgUnitId בבקשה, כל המדפסות יוחזרו.
|
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.printers.list\n\nList printers configs.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers`\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 name of the customer who owns this collection of printers. Format: customers/{customer_id} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of objects to return. The service may return fewer than this value. |\n| `pageToken` | `string` A page token, received from a previous call. |\n| `orgUnitId` | `string` Organization Unit that we want to list the printers for. When org_unit is not present in the request then all printers of the customer are returned (or filtered). When org_unit is present in the request then only printers available to this OU will be returned (owned or inherited). You may see if printer is owned or inherited for this OU by looking at Printer.org_unit_id. |\n| `filter` | `string` Search query. Search syntax is shared between this api and Admin Console printers pages. |\n| `orderBy` | `string` The order to sort results by. Must be one of displayName, description, makeAndModel, or createTime. Default order is ascending, but descending order can be returned by appending \"desc\" to the orderBy field. For instance, \"description desc\" will return the printers sorted by description in descending order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for listing printers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printers\": [ { object (/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printers[]` | `object (`[Printer](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer)`)` List of printers. If `orgUnitId` was given in the request, then only printers visible for this OU will be returned. If `orgUnitId` was not given in the request, then all printers will be returned. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` 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)."]]
