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