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

חובה. שם הלקוח שבבעלותו אוסף המדפסות הזה. פורמט: 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

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