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": [
      "[email protected]"
     ],
     "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": [
      "[email protected]"
     ],
     "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": [
    "[email protected]"
   ],
   "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