הצגת רשימה של הגדרות מדפסות.
בקשת HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
parent |
חובה. שם הלקוח שהוא הבעלים של אוסף המדפסות הזה. פורמט: client/{customer_id} |
פרמטרים של שאילתה
פרמטרים | |
---|---|
pageSize |
המספר המקסימלי של אובייקטים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. |
pageToken |
אסימון דף, שהתקבל משיחה קודמת. |
orgUnitId |
היחידה הארגונית שאנחנו רוצים להציג את רשימת המדפסות שלה. אם הפרמטר org_unit לא מופיע בבקשה, המערכת מחזירה (או מסוננת) את כל המדפסות של הלקוח. אם היחידה org_unit מופיעה בבקשה, המערכת תחזיר רק מדפסות שזמינות ליחידה הארגונית הזו (בבעלות או שעברה בירושה). אפשר לבדוק אם המדפסת הזאת נמצאת בבעלות היחידה הארגונית הזו או שהיא עברה בירושה ליחידה הארגונית הזו. כדי לבדוק זאת, אפשר לבדוק את המוצר Filter.org_unit_id. |
filter |
שאילתת חיפוש. תחביר החיפוש משותף בין ממשק ה-API הזה לדף המדפסות של מסוף Admin. |
orderBy |
סדר המיון של התוצאות. חייב להיות אחד מהערכים הבאים: displayName, description, makeAndModel או createTime. סדר ברירת המחדל הוא עולה, אבל אפשר להחזיר סדר יורד על ידי הוספת 'יורד' לשדה 'סידור לפי'. לדוגמה, 'description description' הפונקציה תחזיר את המדפסות שמוינו לפי תיאור בסדר יורד. |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
תגובה להצגת רשימה של מדפסות.
ייצוג JSON |
---|
{
"printers": [
{
object ( |
שדות | |
---|---|
printers[] |
רשימה של מדפסות. אם בבקשה צוין |
nextPageToken |
אסימון, שניתן לשלוח בתור |
היקפי הרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
מידע נוסף זמין במדריך להרשאות.