דף זה תורגם על ידי Cloud Translation API.

REST Resource: mobiledevices

משאב: MobileDevice

Google Workspace Mobile Management כולל מכשירי Android, Google Sync ו-iOS. מידע נוסף על משימות נפוצות של ממשקי API למכשירים ניידים זמין במדריך למפתחים.

ייצוג JSON
{ "kind": string, "etag": string, "resourceId": string, "deviceId": string, "name": [ string ], "email": [ string ], "model": string, "os": string, "type": string, "status": string, "hardwareId": string, "firstSync": string, "lastSync": string, "userAgent": string, "serialNumber": string, "imei": string, "meid": string, "wifiMacAddress": string, "networkOperator": string, "defaultLanguage": string, "managedAccountIsOnOwnerProfile": boolean, "deviceCompromisedStatus": string, "buildNumber": string, "kernelVersion": string, "basebandVersion": string, "unknownSourcesStatus": boolean, "developerOptionsStatus": boolean, "otherAccountsInfo": [ string ], "adbStatus": boolean, "supportsWorkProfile": boolean, "manufacturer": string, "releaseVersion": string, "securityPatchLevel": string, "brand": string, "bootloaderVersion": string, "hardware": string, "encryptionStatus": string, "devicePasswordStatus": string, "privilege": string, "applications": [ { "packageName": string, "displayName": string, "versionName": string, "versionCode": integer, "permission": [ string ] } ] }

ייצוג JSON

{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}

שדות
`kind`	`string` הסוג של משאב ה-API. במשאבים של מכשירים ניידים, הערך הוא `admin#directory#mobiledevice`.
`etag`	`string` ה-ETag של המשאב.
`resourceId`	`string` המזהה הייחודי שמשמש את שירות ה-API לזיהוי המכשיר הנייד.
`deviceId`	`string` המספר הסידורי של מכשיר נייד של Google Sync. במכשירי Android ו-iOS זהו מזהה ייחודי שנוצר באמצעות תוכנה.
`name[]`	`string` רשימה של שמות המשתמשים של הבעלים. אם לאפליקציה נדרשת הרשימה העדכנית של השמות של בעלי המכשירים, צריך להשתמש בשיטה get. מידע נוסף על אחזור מידע של משתמשים במכשירים ניידים זמין במדריך למפתחים.
`email[]`	`string` רשימת כתובות האימייל של הבעלים. אם לאפליקציה שלכם נדרשת הרשימה העדכנית של כתובות האימייל של המשתמשים, משתמשים בשיטה get. למידע נוסף, אפשר לעיין בשיטת אחזור משתמש.
`model`	`string` שם הדגם של המכשיר הנייד, למשל Nexus S. אפשר לעדכן את הנכס הזה. אפשר למצוא מידע נוסף במדריך למפתחים.
`os`	`string` מערכת ההפעלה של המכשיר הנייד, למשל IOS 4.3 או Android 2.3.5. אפשר לעדכן את הנכס הזה. אפשר למצוא מידע נוסף במדריך למפתחים.
`type`	`string` סוג המכשיר הנייד.
`status`	`string` הסטטוס של המכשיר.
`hardwareId`	`string` מזהה ייחודי IMEI/MEID של חומרת Android. הוא לא רלוונטי למכשירי Google Sync. כשמוסיפים מכשיר נייד עם Android, זהו מאפיין אופציונלי. כשמעדכנים את אחד מהמכשירים האלה, זהו נכס לקריאה בלבד.
`firstSync`	`string` התאריך והשעה שבהם המכשיר סונכרן לראשונה עם הגדרות המדיניות במסוף Admin. הערך מופיע בפורמט תאריך ושעה לפי ISO 8601. השעה היא התאריך המלא לצד שעות, דקות ושניות בתבנית `<em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>`. לדוגמה, `2010-04-05T17:30:04+01:00`.
`lastSync`	`string` התאריך והשעה שבהם המכשיר סונכרן לאחרונה עם הגדרות המדיניות במסוף Admin. הערך מופיע בפורמט תאריך ושעה לפי ISO 8601. השעה היא התאריך המלא לצד שעות, דקות ושניות בתבנית `<em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>`. לדוגמה, `2010-04-05T17:30:04+01:00`.
`userAgent`	`string` מספק מידע על המכשיר, כמו הגרסה של `os`. אפשר לעדכן את הנכס הזה. אפשר למצוא מידע נוסף במדריך למפתחים.
`serialNumber`	`string` המספר הסידורי של המכשיר.
`imei`	`string` מספר ה-IMEI של המכשיר.
`meid`	`string` מספר ה-MEID של המכשיר.
`wifiMacAddress`	`string` כתובת ה-MAC של המכשיר ברשתות Wi-Fi.
`networkOperator`	`string` ספק סלולר או מפעיל רשת של נייד (אם זמין) (קריאה בלבד)
`defaultLanguage`	`string` לוקאל ברירת המחדל שמוגדר במכשיר.
`managedAccountIsOnOwnerProfile`	`boolean` ערך בוליאני שמציין אם החשבון הזה מוגדר כ'בעלים' או 'פרופיל ראשי' או לא.
`deviceCompromisedStatus`	`string` הסטטוס של המכשיר שנפרץ.
`buildNumber`	`string` מספר ה-build של מערכת ההפעלה במכשיר.
`kernelVersion`	`string` גרסת הליבה של המכשיר.
`basebandVersion`	`string` גרסת פס הבסיס של המכשיר.
`unknownSourcesStatus`	`boolean` מקורות לא ידועים מופעלים או הושבתו במכשיר (לקריאה בלבד)
`developerOptionsStatus`	`boolean` התכונה 'אפשרויות למפתחים' מופעלת או מושבתת במכשיר (לקריאה בלבד)
`otherAccountsInfo[]`	`string` רשימת החשבונות שנוספו במכשיר (לקריאה בלבד)
`adbStatus`	`boolean` Adb (ניפוי באגים ב-USB) מופעל או מושבת במכשיר (לקריאה בלבד)
`supportsWorkProfile`	`boolean` פרופיל עבודה נתמך במכשיר (לקריאה בלבד)
`manufacturer`	`string` יצרן המכשיר הנייד (קריאה בלבד)
`releaseVersion`	`string` גרסת הפצה למכשיר נייד (קריאה בלבד)
`securityPatchLevel`	`string (int64 format)` רמת תיקון האבטחה של המכשיר הנייד (קריאה בלבד)
`brand`	`string` מותג של המכשיר הנייד (קריאה בלבד)
`bootloaderVersion`	`string` גרסת תוכנת אתחול של מכשיר נייד (קריאה בלבד)
`hardware`	`string` חומרה למכשירים ניידים (קריאה בלבד)
`encryptionStatus`	`string` סטטוס הצפנה של מכשיר נייד (קריאה בלבד)
`devicePasswordStatus`	`string` DevicePasswordStatus (קריאה בלבד)
`privilege`	`string` DMAgentAuthor (קריאה בלבד)
`applications[]`	`object` רשימת האפליקציות המותקנות במכשיר נייד עם Android. הוא לא רלוונטי למכשירי Google Sync ו-iOS. הרשימה כוללת את כל האפליקציות ל-Android שיש להן גישה לנתונים של Google Workspace. כשמעדכנים רשימת אפליקציות, חשוב לציין שעדכונים מחליפים את הרשימה הקיימת. אם במכשיר Android יש שתי אפליקציות קיימות וה-API מעדכן את הרשימה עם חמש אפליקציות, הרשימה המעודכנת היא עכשיו רשימה של חמש אפליקציות.
`applications[].packageName`	`string` שם החבילה של האפליקציה. למשל, `com.android.browser`.
`applications[].displayName`	`string` השם המוצג של האפליקציה. למשל, `Browser`.
`applications[].versionName`	`string` שם הגרסה של האפליקציה. למשל, `3.2-140714`.
`applications[].versionCode`	`integer` קוד הגרסה של האפליקציה. למשל, `13`.
`applications[].permission[]`	`string` רשימת ההרשאות לאפליקציה הזו. ההרשאות האלה יכולות להיות הרשאה רגילה ל-Android או הרשאה שהוגדרה על ידי האפליקציה. הן נמצאות במניפסט של האפליקציה ל-Android. דוגמאות להרשאות של אפליקציית יומן Google: `READ_CALENDAR` או `MANAGE_ACCOUNTS`.

שיטות
`action`	מבצע פעולה שמשפיעה על מכשיר נייד.
`delete`	הסרת מכשיר נייד.
`get`	אחזור מאפיינים של מכשיר נייד.
`list`	אחזור רשימה מחולקת של כל המכשירים הניידים בבעלות משתמש עבור חשבון.

REST Resource: mobiledevices

משאב: MobileDevice

שיטות

`action`

`delete`

`get`

`list`