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 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ỗ customerIdresourceId đượ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.