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/{customer_id}

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

פרמטרים
pageSize

integer

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

string

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

string

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

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

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