Directory API: อุปกรณ์เคลื่อนที่

Google Workspace Directory API ช่วยให้คุณจัดการอุปกรณ์เคลื่อนที่ภายในองค์กรได้ หน้านี้มีตัวอย่างของวิธีการแสดงรายการอุปกรณ์เคลื่อนที่ ดูรายละเอียดของอุปกรณ์ที่ต้องการ รวมถึงการเพิ่มหรือนำอุปกรณ์ออก

เอกสารนี้จะถือว่าคุณได้ดำเนินการตามข้อกำหนดเบื้องต้นเรียบร้อยแล้ว อุปกรณ์ Android ต้องมี แอปนโยบายด้านอุปกรณ์ อุปกรณ์ iOS ต้องลงทะเบียนด้วย บริการการจัดการอุปกรณ์เคลื่อนที่ของ Google

ในตัวอย่างต่อไปนี้ ตัวยึดตำแหน่ง 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 ต่อไปนี้และรวมการให้สิทธิ์ที่อธิบายไว้ในให้สิทธิ์คำขอ ตัวอย่างนี้ใช้การขึ้นบรรทัดใหม่เพื่อช่วยให้อ่านง่ายขึ้น 

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