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