REST Resource: mobiledevices

Tài nguyên: MobileDevice

Google Workspace Mobile Management bao gồm 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 phổ biến theo nhóm, 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 các thiết bị Android và iOS, đây là giá trị 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 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. 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 dành cho nhà phát triển.

os

string

Hệ điều hành của thiết bị di động, ví dụ như iOS 4.3 hoặc Android 2.3.5. 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 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. Không áp dụng được cho các thiết bị Google Sync. Khi thêm một 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, thuộc tính này chỉ có thể đọc.

firstSync

string

Ngày và giờ thiết bị được đồng bộ hoá lần đầu với các cài đặt chính sách trong Bảng điều khiển dành cho quản trị viên. Giá trị có đị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ờ gần đây nhất mà thiết bị được đồng bộ hoá với các 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ị có đị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. 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 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à 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ó 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 nhập.

buildNumber

string

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

kernelVersion

string

Phiên bản nhân hệ điều hành 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 nguồn không xác định trên thiết bị (Chỉ đọc)

developerOptionsStatus

boolean

Bật hoặc tắt Tuỳ chọn dành 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)

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 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 các ứ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 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 có 5 ứng dụng, thì danh sách đó sẽ là danh sách cập nhật của 5 ứng dụng.

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. Đây có thể là một quyền tiêu chuẩn trên Android 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: 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 của tất cả thiết bị di động thuộc sở hữu của người dùng cho một tài khoản.