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

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

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

בדוגמאות האלה, ה-placeholders customerId ו-resourceId משמשים כדי ולציין איפה תציינו את המזהים האלה. אפשר לקבל את הנתונים של customerId דרך ה-method 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 הבאה ולכלול את ההרשאה שמתוארת אישור בקשות. כדי לשפר את הקריאוּת, בדוגמה הזו אנחנו משתמשים בהחזרות שורות:

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.