Method: chromeosdevices.list

אחזור רשימה מחולקת של מכשירי ChromeOS בחשבון.

בקשת HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

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

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

פרמטרים
customerId

string

המזהה הייחודי של חשבון Google Workspace של הלקוח. כמנהל חשבון, יש לך אפשרות להשתמש בכינוי my_customer גם כדי לייצג את customerId של החשבון שלך. גם השדה customerId מוחזר כחלק ממשאב המשתמשים.

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

פרמטרים
maxResults

integer

מספר התוצאות המקסימלי שיש להחזיר. הערך לא יכול לחרוג מ-300.

orderBy

enum (OrderBy)

מאפיין המכשיר שמשמש למיון התוצאות.

orgUnitPath

string

הנתיב המלא של היחידה הארגונית (להוציא את / בהתחלה) או המזהה הייחודי שלה.

pageToken

string

פרמטר השאילתה pageToken משמש לבקשת הדף הבא של תוצאות השאילתה. פרמטר השאילתה pageToken של בקשת ההמשך הוא nextPageToken מהתגובה הקודמת שלך.

projection

enum (Projection)

קובעת אם התגובה תכיל את רשימת הנכסים המלאה או רק קבוצת משנה.

query

string

מחרוזת חיפוש בפורמט שמצוין בכתובת https://developers.google.com/admin-sdk/directory/v1/list-query-operators.

sortOrder

enum (SortOrder)

האם להחזיר תוצאות בסדר עולה או יורד. יש להשתמש בו עם הפרמטר orderBy.

includeChildOrgunits

boolean

החזרת מכשירים מכל היחידות הארגוניות ברמת הצאצא ומהיחידה הארגונית שצוינה. אם מוגדר כ-True, הערך 'orgUnitPath' חובה לספק.

גוף הבקשה

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

גוף התשובה

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

ייצוג JSON
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
שדות
kind

string

זה סוג המשאב.

etag

string

ה-ETag של המשאב.

chromeosdevices[]

object (ChromeOsDevice)

רשימה של אובייקטים במכשירי ChromeOS.

nextPageToken

string

האסימון שמשמש לגישה לדף הבא בתוצאה הזו. כדי לגשת לדף הבא, צריך להשתמש בערך של האסימון במחרוזת השאילתה pageToken של הבקשה הזו.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

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

OrderBy

טיפוסים בני מנייה (enum)
ANNOTATED_LOCATION המיקום של מכשיר Chrome, כפי שציין האדמין.
ANNOTATED_USER משתמש Chromebook, כפי שהוסבר על ידי האדמין
LAST_SYNC התאריך והשעה שבהם מכשיר Chrome סונכרן לאחרונה עם הגדרות המדיניות במסוף Admin.
NOTES הערות במכשיר Chrome, בהתאם להערות של האדמין.
SERIAL_NUMBER המספר הסידורי של מכשיר Chrome שהוזן כשהמכשיר הופעל.
STATUS הסטטוס של מכשיר Chrome. למידע נוסף, ראו <a chromeosdevices.

היטל

סוג ההקרנה שיש להציג למכשירים.

טיפוסים בני מנייה (enum)
BASIC כולל רק את שדות המטא-נתונים הבסיסיים (למשל, deviceId, מספר סידורי, סטטוס ומשתמש)
FULL כולל את כל שדות המטא-נתונים

SortOrder

סדר המיון שיש להחיל על רשימת המכשירים.

טיפוסים בני מנייה (enum)
ASCENDING סדר עולה.
DESCENDING סדר יורד.