דף זה תורגם על ידי 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. למשאבים מסוג Mobiledevices, הערך הוא `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 של האפליקציה. דוגמאות להרשאות של אפליקציית יומן הן `READ_CALENDAR` או `MANAGE_ACCOUNTS`.

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

REST Resource: mobiledevices

משאב: MobileDevice

שיטות

`action`

`delete`

`get`

`list`