Directory API: Thiết bị di động

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 có 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ư cách 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. Các thiết bị Android cần phải cài đặt ứng dụng Device Policy và phải đăng ký thiết bị iOS với dịch vụ Quản lý thiết bị di động của Google.

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ã nhận dạng đó. Bạn có thể lấy customerId từ phương thức Users.get. resourceId là giá trị nhận dạng duy nhất của Google cho một thiết bị và có 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ả thiết bị di động của một tài khoản, hãy sử dụng yêu cầu GET sau và bao gồm quyền uỷ quyền được mô tả trong phần Yêu cầu cho phép. Để 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 đây và bao gồm quyền uỷ quyền được mô tả trong phần Yêu cầu cho phép. Để 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 là: 

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à bao gồm quyền uỷ quyền được mô tả trong phần Yêu cầu cho phép. Để dễ đọc, ví dụ này sử dụng phương thức 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á một thiết bị di động, hãy sử dụng yêu cầu DELETE sau và bao gồm quyền uỷ quyền được mô tả trong phần Yêu cầu cho phép. Để dễ đọc, ví dụ này sử dụng phương thức 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.