Google Workspace Directory API giúp bạn quản lý các thiết bị di động trong tổ chức của mình. Trang này bao gồm các ví dụ về cách liệt kê các thiết bị di động của bạn, lấy thông tin chi tiết về một thiết bị cụ thể cũng như như thêm hoặc xoá một thiết bị.
Tài liệu này giả định rằng bạn đã hoàn tất thành công Điều kiện tiên quyết. Thiết bị Android cần có ứng dụng Device Policy . Thiết bị iOS phải được đăng ký với Dịch vụ Google Mobile Management.
Trong những ví dụ này, phần giữ chỗ customerId và resourceId được dùng để cho biết nơi bạn sẽ cung cấp các mã đó. customerId có thể lấy từ Phương thức Users.get. Chiến lược phát hành đĩa đơn resourceId là giá trị nhận dạng duy nhất của Google cho một thiết bị và được tìm thấy trong phản hồi của phương thức Truy xuất tất cả thiết bị di động.
Truy xuất tất cả thiết bị di động
Để truy xuất tất cả các thiết bị di động của một tài khoản, hãy sử dụng GET
sau
yêu cầu và bao gồm thông tin uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
ví dụ này sử dụng phương thức trả về dòng:
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
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Nội dung phản hồi 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" }
Truy xuất thiết bị di động
Để truy xuất các thuộc tính của thiết bị di động, hãy sử dụng yêu cầu GET
sau
và bao gồm giấy uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu. Để dễ đọc,
ví dụ này sử dụng phương thức trả về dòng:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId?projection={FULL|BASIC}
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Ví dụ về yêu cầu cho resourceId:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
Nội dung phản hồi 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", }
Phê duyệt thiết bị di động
Để phê duyệt một thiết bị di động, hãy sử dụng yêu cầu POST
sau đây và đưa vào
uỷ quyền được mô tả trong
Uỷ quyền cho các yêu cầu.
Để dễ đọc, ví dụ này sử dụng giá trị trả về dòng:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId/action
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu JSON
Yêu cầu JSON sau đây cho thấy một yêu cầu mẫu để phê duyệt một thiết bị:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
Nội dung yêu cầu là:
{ "action": "approve" }
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200.
Xoá thiết bị di động
Để xoá thiết bị di động, hãy sử dụng yêu cầu DELETE
sau đây và thêm vào
quyền được mô tả trong
Uỷ quyền cho các yêu cầu.
Để dễ đọc, ví dụ này sử dụng giá trị trả về dòng:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId
Để biết các thuộc tính yêu cầu và phản hồi, hãy xem Tài liệu tham khảo API.
Yêu cầu thành công sẽ trả về một Mã trạng thái HTTP 200.