REST Resource: mobiledevices

Tài nguyên: MobileDevice

Google Workspace Mobile Management bao gồm thiết bị Android, Google Sync và iOS. Để biết thêm thông tin về các tác vụ phổ biến đối với API trên thiết bị di động theo nhóm, hãy xem Hướng dẫn 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
      ]
    }
  ]
}
Các 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 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 các thiết bị Android và iOS, đây là mã nhận dạng duy nhất do phần mềm tạo ra.

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 hiện tại của chủ sở hữu thiết bị, 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, 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 người dùng hiện tại, 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 tài sản này. Để biết thêm thông tin, hãy xem Hướng dẫn 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 tài sản này. Để biết thêm thông tin, hãy xem Hướng dẫn 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

Giá trị nhận dạng duy nhất của IMEI/MEID cho phần cứng Android. 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 các thiết bị này, đây sẽ là thuộc tính chỉ có thể đọc.

firstSync

string

Ngày và giờ thiết bị được đồng bộ hóa lần đầu với cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị này ở đị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 theo biểu mẫu <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ộ hóa lần gần đây nhất với các tùy chọn cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị này ở đị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 theo biểu mẫu <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 tài sản này. Để biết thêm thông tin, hãy xem Hướng dẫn 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à cung cấp dịch vụ mạng hoặc thiết bị di động (nếu có) (Chỉ đọc)

defaultLanguage

string

Ngôn ngữ mặc định dùng trên thiết bị.

managedAccountIsOnOwnerProfile

boolean

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

deviceCompromisedStatus

string

Trạng thái thiết bị bị xâm nhập.

buildNumber

string

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

kernelVersion

string

Phiên bản kernel của thiết bị.

basebandVersion

string

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

unknownSourcesStatus

boolean

Đã bật hoặc tắt các nguồn không xác định trên thiết bị (Chỉ đọc)

developerOptionsStatus

boolean

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

otherAccountsInfo[]

string

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

adbStatus

boolean

Bật hoặc tắt Adb (Gỡ lỗi qua USB) trên thiết bị (Chỉ đọc)

supportsWorkProfile

boolean

Hồ sơ công việc được hỗ trợ trên thiết bị (Chỉ đọ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 trên thiết bị di động (Chỉ đọc)

brand

string

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

bootloaderVersion

string

Phiên bản Trình tải khởi động thiết bị di động (Chỉ đọ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)

devicePasswordStatus

string

DevicePasswordStatus (Chỉ đọc)

privilege

string

DMAgentPermission (Chỉ đọc)

applications[]

object

Danh sách ứng dụng được cài đặt trên thiết bị di động Android. Không thể áp dụng 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 trong 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 hiện có 2 ứng dụng và API cập nhật danh sách gồm 5 ứng dụng thì giờ đây, đó là danh sách 5 ứng dụng đã cập nhật.

applications[].packageName

string

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

applications[].displayName

string

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

applications[].versionName

string

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

applications[].versionCode

integer

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

applications[].permission[]

string

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

Phương thức

action

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

delete

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

get

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

list

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