Method: admin.directory.v1.customers.chrome.printers.list

הצגת רשימה של הגדרות מדפסות.

בקשת HTTP

GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. שם הלקוח שבבעלותו אוסף המדפסות הזה. פורמט: לקוחות/{customer_id}

פרמטרים של שאילתה

פרמטרים
pageSize

integer

מספר האובייקטים המקסימלי להחזרה. השירות עשוי להחזיר ערך נמוך יותר מהערך הזה.
pageToken

string

אסימון דף שהתקבל משיחה קודמת.
orgUnitId

string

היחידה הארגונית שעבורה אנחנו רוצים לרשום את המדפסות. אם לא נכלל org_unit בבקשה, כל המדפסות של הלקוח מוחזרות (או מסוננות).

אם הערך של org_unit כלול בבקשה, יוחזרו רק מדפסות שזמינות ליחידה הארגונית הזו (בבעלות או שעברו בירושה). כדי לראות אם המדפסת משויכת ליחידה הארגונית הזו או שהמדפסת עברה בירושה, אפשר להיכנס לאתר Scanner.org_unit_id.
filter

string

שאילתת חיפוש. תחביר החיפוש משותף לדפי ה-API הזה ולדפי המדפסות של מסוף הניהול.
orderBy

string

הסדר שלפיו למיין את התוצאות. חייב להיות אחד מהפורמטים הבאים: displayName, תיאור, MakeAndModel, או createTime. סדר ברירת המחדל הוא עולה, אך ניתן להחזיר סדר יורד על ידי הוספת "down" לשדה orderBy. למשל, האפשרות 'description description' (תיאור התיאור) תחזיר את המדפסות שמוינו לפי תיאור בסדר יורד.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

תשובה לגבי רשימת מדפסות.

ייצוג 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

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