Method: mobiledevices.list

אחזור רשימה מעומדת של כל המכשירים הניידים בבעלות המשתמש לחשבון. כדי לאחזר רשימה שכוללת מכשירים בבעלות החברה, צריך להשתמש ב-Cloud Identity Devices API. השיטה הזו מפסיקה לפעול לאחר 60 דקות. מידע נוסף זמין במאמר פתרון בעיות בקודי שגיאה.

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

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

פרמטרים
maxResults

integer

מספר התוצאות המקסימלי שיוחזר. הערך המקסימלי המותר הוא 100.
orderBy

enum (OrderBy)

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

string

אסימון לציון הדף הבא ברשימה
projection

enum (Projection)

להגביל מידע שמוחזר לקבוצה של שדות נבחרים.
query

string

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

enum (SortOrder)

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

גוף הבקשה

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

גוף התגובה

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

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

string

סוג המשאב הזה.
etag

string

ETag של המשאב.
mobiledevices[]

object (MobileDevice)

רשימת אובייקטים של מכשירים ניידים.
nextPageToken

string

האסימון משמש לגישה לדף הבא של התוצאה הזו.

היקפי הרשאות

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

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

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

OrderBy

טיפוסים בני מנייה (enums)
DEVICE_ID המספר הסידורי של מכשיר נייד של Google Sync. למכשירי Android, זהו מזהה ייחודי שנוצר על ידי תוכנה.
EMAIL זוהי כתובת האימייל של בעלי המכשיר.
LAST_SYNC תאריך הסנכרון של הגדרות המדיניות האחרונות של המכשיר.
MODEL הדגם של המכשיר הנייד.
NAME שם המשתמש של הבעלים של המכשיר.
OS מערכת ההפעלה של המכשיר.
STATUS סטטוס המכשיר.
TYPE סוג המכשיר.

תחזית

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

SortOrder

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