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, מוחזרים רק שרתי הדפסה שנמצאים בבעלות היחידה הארגונית (OU) או שעברו בירושה ליחידה הארגונית. אם orgUnitId של המשאב ב-PrintServer תואם לערך שצוין בבקשה, היחידה הארגונית היא הבעלים של השרת.

אם לא מציינים את orgUnitId בבקשה, כל שרתי ההדפסה מוחזרים או מסוננים.

filter

string

שאילתת חיפוש בתחביר של Common Expression Language. המסננים הנתמכים הם 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

מידע נוסף זמין במדריך להרשאות.