REST Resource: mobiledevices

Tài nguyên: MobileDevice

Google Workspace Mobile Management hỗ trợ các thiết bị Android, Google Sync và iOS. Để biết thêm thông tin về các tác vụ API thiết bị di động nhóm phổ biến, hãy xem Hướng dẫn dành cho nhà phát triển.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "etag": string,
  "resourceId": string,
  "deviceId": string,
  "name": [
    string
  ],
  "email": [
    string
  ],
  "model": string,
  "os": string,
  "type": string,
  "status": string,
  "hardwareId": string,
  "firstSync": string,
  "lastSync": string,
  "userAgent": string,
  "serialNumber": string,
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperator": string,
  "defaultLanguage": string,
  "managedAccountIsOnOwnerProfile": boolean,
  "deviceCompromisedStatus": string,
  "buildNumber": string,
  "kernelVersion": string,
  "basebandVersion": string,
  "unknownSourcesStatus": boolean,
  "developerOptionsStatus": boolean,
  "otherAccountsInfo": [
    string
  ],
  "adbStatus": boolean,
  "supportsWorkProfile": boolean,
  "manufacturer": string,
  "releaseVersion": string,
  "securityPatchLevel": string,
  "brand": string,
  "bootloaderVersion": string,
  "hardware": string,
  "encryptionStatus": string,
  "devicePasswordStatus": string,
  "privilege": string,
  "applications": [
    {
      "packageName": string,
      "displayName": string,
      "versionName": string,
      "versionCode": integer,
      "permission": [
        string
      ]
    }
  ]
}
Trường
kind

string

Loại tài nguyên API. Đối với tài nguyên Thiết bị di động, giá trị là admin#directory#mobiledevice.

etag

string

ETag của tài nguyên.

resourceId

string

Mã nhận dạng duy nhất mà dịch vụ API sử dụng để xác định thiết bị di động.

deviceId

string

Số sê-ri của thiết bị di động Google Sync. Đối với thiết bị Android và iOS, đây là giá trị nhận dạng duy nhất do phần mềm tạo.

name[]

string

Danh sách tên người dùng của chủ sở hữu. Nếu ứng dụng của bạn cần danh sách tên chủ sở hữu thiết bị hiện tại, hãy sử dụng phương thức get. Để biết thêm thông tin về cách truy xuất thông tin người dùng thiết bị di động, hãy xem Hướng dẫn dành cho nhà phát triển.

email[]

string

Danh sách địa chỉ email của chủ sở hữu. Nếu ứng dụng của bạn cần danh sách email hiện tại của người dùng, hãy sử dụng phương thức get. Để biết thêm thông tin, hãy xem phương thức truy xuất người dùng.

model

string

Tên mẫu của thiết bị di động, ví dụ: Nexus S. Bạn có thể cập nhật thuộc tính này. Để biết thêm thông tin, hãy xem Hướng dẫn dành cho nhà phát triển.

os

string

Hệ điều hành của thiết bị di động, ví dụ: iOS 4.3 hoặc Android 2.3.5. Bạn có thể cập nhật thuộc tính này. Để biết thêm thông tin, hãy xem Hướng dẫn dành cho nhà phát triển.

type

string

Loại thiết bị di động.

status

string

Trạng thái của thiết bị.

hardwareId

string

Mã nhận dạng duy nhất IMEI/MEID của phần cứng Android. Tính năng này không áp dụng cho các thiết bị Google Sync. Khi thêm thiết bị di động Android, đây là thuộc tính không bắt buộc. Khi cập nhật một trong những thiết bị này, đây là thuộc tính chỉ có thể đọc.

firstSync

string

Ngày và giờ thiết bị được đồng bộ hoá lần đầu với chế độ cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây ở dạng <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Ví dụ: 2010-04-05T17:30:04+01:00.

lastSync

string

Ngày và giờ thiết bị được đồng bộ hoá gần đây nhất với chế độ cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị ở định dạng ngày và giờ ISO 8601. Thời gian là ngày đầy đủ cùng với giờ, phút và giây ở dạng <em>YYYY-MM-DD</em>T<em>hh:mm:ssTZD</em>. Ví dụ: 2010-04-05T17:30:04+01:00.

userAgent

string

Cung cấp thông tin về thiết bị, chẳng hạn như phiên bản os. Bạn có thể cập nhật thuộc tính này. Để biết thêm thông tin, hãy xem Hướng dẫn dành cho nhà phát triển.

serialNumber

string

Số sê-ri của thiết bị.

imei

string

Số IMEI của thiết bị.

meid

string

Số MEID của thiết bị.

wifiMacAddress

string

Địa chỉ MAC của thiết bị trên mạng Wi-Fi.

networkOperator

string

Nhà mạng hoặc nhà mạng di động của Thiết bị di động (nếu có) (Chỉ có thể đọc)

defaultLanguage

string

Ngôn ngữ mặc định được sử dụng trên thiết bị.

managedAccountIsOnOwnerProfile

boolean

Giá trị boolean cho biết tài khoản này có thuộc chủ sở hữu/hồ sơ chính hay không.

deviceCompromisedStatus

string

Trạng thái thiết bị bị xâm phạm.

buildNumber

string

Số bản dựng của hệ điều hành trên thiết bị.

kernelVersion

string

Phiên bản hạt nhân của thiết bị.

basebandVersion

string

Phiên bản băng tần cơ sở của thiết bị.

unknownSourcesStatus

boolean

Nguồn không xác định được bật hoặc tắt trên thiết bị (Chỉ có thể đọc)

developerOptionsStatus

boolean

Tuỳ chọn cho nhà phát triển đã bật hoặc tắt trên thiết bị (Chỉ có thể đọc)

otherAccountsInfo[]

string

Danh sách tài khoản được thêm vào thiết bị (Chỉ có thể đọc)

adbStatus

boolean

Adb (gỡ lỗi qua USB) đã bật hoặc tắt trên thiết bị (Chỉ có thể đọc)

supportsWorkProfile

boolean

Hồ sơ công việc được hỗ trợ trên thiết bị (Chỉ có thể đọc)

manufacturer

string

Nhà sản xuất thiết bị di động (Chỉ đọc)

releaseVersion

string

Phiên bản phát hành dành cho thiết bị di động (Chỉ đọc)

securityPatchLevel

string (int64 format)

Cấp bản vá Bảo mật thiết bị di động (Chỉ có thể đọc)

brand

string

Thương hiệu thiết bị di động (Chỉ có thể đọc)

bootloaderVersion

string

Phiên bản trình tải khởi động của thiết bị di động (Chỉ có thể đọc)

hardware

string

Phần cứng thiết bị di động (Chỉ đọc)

encryptionStatus

string

Trạng thái mã hoá thiết bị di động (Chỉ có thể đọc)

devicePasswordStatus

string

DevicePasswordStatus (Chỉ có thể đọc)

privilege

string

DMAgentPermission (Chỉ có thể đọc)

applications[]

object

Danh sách ứng dụng được cài đặt trên thiết bị di động Android. Không áp dụng được cho Google Sync và các thiết bị iOS. Danh sách này bao gồm mọi ứng dụng Android truy cập vào dữ liệu Google Workspace.

Khi cập nhật danh sách ứng dụng, điều quan trọng cần lưu ý là bản cập nhật sẽ thay thế danh sách hiện có. Nếu thiết bị Android có 2 ứng dụng hiện có và API cập nhật danh sách bằng 5 ứng dụng, thì đây là danh sách cập nhật gồm 5 ứng dụng.

applications[].packageName

string

Tên gói của ứng dụng. Ví dụ: com.android.browser.

applications[].displayName

string

Tên hiển thị của ứng dụng. Ví dụ: Browser.

applications[].versionName

string

Tên phiên bản của ứng dụng. Ví dụ: 3.2-140714.

applications[].versionCode

integer

Mã phiên bản của ứng dụng. Ví dụ: 13.

applications[].permission[]

string

Danh sách quyền của ứng dụng này. Đây có thể là quyền Android tiêu chuẩn hoặc quyền do ứng dụng xác định và có trong tệp kê khai Android của ứng dụng. Ví dụ về quyền của ứng dụng Lịch là READ_CALENDAR hoặc MANAGE_ACCOUNTS.

Phương thức

action

Thực hiện một hành động ảnh hưởng đến thiết bị di động.

delete

Xoá một thiết bị di động.

get

Truy xuất các thuộc tính của thiết bị di động.

list

Truy xuất danh sách phân trang tất cả thiết bị di động do người dùng sở hữu cho một tài khoản.