Method: mobiledevices.list

אחזור רשימה מחולקת של כל המכשירים הניידים בבעלות משתמש עבור חשבון. כדי לאחזר רשימה שכוללת מכשירים בבעלות החברה, צריך להשתמש במקום זאת ב-Devices API של Cloud Identity. בשיטה הזו הזמן הקצוב לתפוגה מסתיים אחרי 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

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

היטל

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

SortOrder

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