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

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

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

פרמטרים
pageSize

integer

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

string

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

string

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

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

string

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

string

סדר המיון של התוצאות. חייב להיות אחד מהערכים הבאים: displayName, description, makeAndModel או createTime. סדר ברירת המחדל הוא עולה, אבל אפשר להחזיר סדר יורד על ידי הוספת 'יורד' לשדה 'סידור לפי'. לדוגמה, '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

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