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
      ]
    }
  ]
}
שדות
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

DMAgentPermission (לקריאה בלבד)

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

אחזור רשימה מעומדת של כל המכשירים הניידים בבעלות המשתמש לחשבון.