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