Directory API: מכשירים ניידים

Google Workspace Directory API מאפשר לנהל את המכשירים הניידים בארגון. בדף הזה מפורטות דוגמאות לפירוט המכשירים הניידים שלך, לקבלת פרטים על מכשיר ספציפי ולהוספה או הסרה של מכשיר.

מסמך זה מבוסס על ההנחה שהשלמתם בהצלחה את הדרישות המוקדמות. האפליקציה של מדיניות המכשירים צריכה להיות מותקנת במכשירי Android. מכשירי iOS צריכים להיות רשומים בשירות Google Mobile Management.

בדוגמאות האלה, ה-placeholders customerId ו-resourceId משמשים כדי לציין איפה הייתם מספקים את המזהים האלה. ניתן לקבל את השדה customerId בשיטה Users.get. resourceId הוא מזהה Google ייחודי של מכשיר, שמופיע בתגובה של השיטה אחזור כל המכשירים הניידים.

אחזור של כל המכשירים הניידים

כדי לאחזר את כל המכשירים הניידים של חשבון, משתמשים בבקשת GET הבאה וכוללים את ההרשאה שמתוארת בבקשות הרשאה. לצורך הקריאות, הדוגמה הזו משתמשת בהחזרות שורה: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile?projection={BASIC|FULL}&query=query
  &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
  &pageToken=token for next results page
  &maxResults=max number of results per page

בחומר העזר בנושא API תוכלו למצוא מידע על מאפייני הבקשה והתגובה.

תגובת JSON

{
   "kind": "directory#mobiledevices",
   "mobiledevices": [
    {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Sales"
     ],
     "email": [
      "sales@example.com"
     ],
     "model": "Nexus 4",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "1234567890",
     "firstSync": "2013-05-15T17:30:04.325Z",
     "lastSync": "2013-06-05T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
   },
   {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Liz"
     ],
     "email": [
      "liz@example.com"
     ],
     "model": "Galaxy Nexus",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "9123456780",
     "firstSync": "2013-06-05T17:30:04.325Z",
     "lastSync": "2013-08-12T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
    }
   ],
   "nextPageToken": "next_page_token_value"
  }

אחזור מכשיר נייד

כדי לאחזר מאפיינים של מכשיר נייד, משתמשים בבקשת GET הבאה וכוללים את ההרשאה שמתוארת בקטע Authorize requests. לצורך הקריאות, הדוגמה הזו משתמשת בהחזרות שורה: 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

בחומר העזר בנושא API תוכלו למצוא מידע על מאפייני הבקשה והתגובה.

בקשת JSON

בקשה לדוגמה עבור resourceId היא: 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

תגובת JSON

{
   "kind": "directory#mobiledevice",
   "resourceId": "resourceId",
   "deviceId": "deviceId",
   "name": [
    "Sales3"
   ],
   "email": [
    "sales@example.com"
   ],
   "model": "Nexus 4",
   "os": "Android 4.2.2",
   "type": "ANDROID",
   "status": "APPROVED",
   "hardwareId": "1234567890",
   "firstSync": "2010-05-15T17:30:04.325Z",
   "lastSync": "2013-06-05T17:30:04.325Z",
   "userAgent": "Google Apps Device Policy 4.14",
  }

אישור מכשיר נייד

כדי לאשר מכשיר נייד, יש להשתמש בבקשת POST הבאה ולכלול את ההרשאה שמתוארת בבקשות הרשאה. לצורך הקריאות, הדוגמה הזו משתמשת בהחזרות שורה: 

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

בחומר העזר בנושא API תוכלו למצוא מידע על מאפייני הבקשה והתגובה.

בקשת JSON

בבקשת ה-JSON הבאה מוצגת בקשה לאישור מכשיר: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

גוף הבקשה הוא:

{
    "action": "approve"
}

בקשה שמבוצעת בהצלחה מחזירה קוד הסטטוס HTTP 200.

הסרת מכשיר נייד

כדי להסיר מכשיר נייד, יש להשתמש בבקשת DELETE הבאה ולכלול את ההרשאה שמתוארת בבקשות הרשאה. לצורך הקריאות, הדוגמה הזו משתמשת בהחזרות שורה: 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

בחומר העזר בנושא API תוכלו למצוא מידע על מאפייני הבקשה והתגובה.

בקשה שמבוצעת בהצלחה מחזירה קוד הסטטוס HTTP 200.