Devices

Để xem danh sách phương thức cho tài nguyên này, hãy xem phần cuối trang này.

Biểu thị tài nguyên

Tài nguyên thiết bị đại diện cho một thiết bị di động do EMM quản lý và thuộc về một người dùng doanh nghiệp cụ thể.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string,
    "policyId": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}

Tên tài sản	Giá trị	Mô tả	Ghi chú
androidId	string	Mã nhận dạng Android của Dịch vụ Google Play cho thiết bị được mã hoá dưới dạng chuỗi thập lục phân viết thường. Ví dụ: "123456789abcdef0".
device	string	Tên mã phần cứng nội bộ của thiết bị. Đây là ý kiến của android.os.Build.DEVICE. (trường có tên "device" theo logs/wireless/android/android_checkin.proto)
kind	string
latestBuildFingerprint	string	Vân tay số của bản dựng thiết bị (nếu có).
maker	string	Nhà sản xuất thiết bị. Đây là ý kiến của android.os.Build.MANUFACTURER.
managementType	string	Xác định mức độ thiết bị được kiểm soát bởi một EMM được quản lý của Google Play trong nhiều cấu hình triển khai. Các giá trị có thể là: "managedDevice", một thiết bị có bộ điều khiển chính sách thiết bị (DPC) của EMM làm chủ sở hữu thiết bị. "managedProfile", một thiết bị có hồ sơ do DPC quản lý (DPC là chủ sở hữu hồ sơ) ngoài một hồ sơ cá nhân riêng biệt mà DPC không có quyền truy cập. "containerApp", không còn được sử dụng (không dùng nữa). "unmanagedProfile", một thiết bị đã được cho phép (bởi quản trị viên của miền, sử dụng Bảng điều khiển dành cho quản trị viên để bật đặc quyền) sử dụng Managed Google Play, nhưng chính hồ sơ này không thuộc sở hữu của DPC. Các giá trị được chấp nhận là: "containerApp" "managedDevice" "managedProfile" "unmanagedProfile"
model	string	Tên mẫu của thiết bị. Thông tin này đến từ android.os.Build.MODEL.
policy	nested object	Chính sách được thực thi trên thiết bị.
policy.autoUpdatePolicy	string	Kiểm soát thời điểm có thể áp dụng bản cập nhật ứng dụng tự động trên thiết bị. Giải pháp thay thế được đề xuất: autoUpdateMode được đặt cho mỗi ứng dụng, mang lại tính linh hoạt cao hơn về tần suất cập nhật. Khi autoUpdateMode được đặt thành AUTO_UPDATE_POSTPONED hoặc AUTO_UPDATE_HIGH_PRIORITY, autoUpdatePolicy sẽ không có hiệu lực. choiceToTheUser cho phép người dùng thiết bị định cấu hình chính sách cập nhật ứng dụng. always bật tính năng tự động cập nhật. never tắt tính năng tự động cập nhật. wifiOnly chỉ bật tính năng tự động cập nhật khi thiết bị được kết nối với Wi-Fi. Lưu ý quan trọng: Thay đổi đối với chính sách cập nhật ứng dụng không ảnh hưởng đến các bản cập nhật đang trong quá trình cập nhật. Mọi thay đổi về chính sách sẽ áp dụng cho các bản cập nhật ứng dụng tiếp theo. Các giá trị được chấp nhận là: "always" "choiceToTheUser" "never" "wifiOnly"
policy.deviceReportPolicy	string	Liệu thiết bị có báo cáo trạng thái ứng dụng cho EMM hay không. Giá trị mặc định là "deviceReportDisabled". Các giá trị được chấp nhận là: "deviceReportDisabled" "deviceReportEnabled"
policy.maintenanceWindow	nested object	Thời gian bảo trì xác định thời điểm cập nhật các ứng dụng đang chạy ở nền trước.
policy.maintenanceWindow.durationMs	long	Thời lượng của khoảng thời gian bảo trì, tính bằng mili giây. Thời lượng phải nằm trong khoảng từ 30 phút đến 24 giờ (tính cả hai mốc này).
policy.maintenanceWindow.startTimeAfterMidnightMs	long	Thời gian bắt đầu của khoảng thời gian bảo trì, tính theo mili giây sau nửa đêm trên thiết bị. Cửa sổ có thể kéo dài đến nửa đêm.
policy.policyId	string	Giá trị nhận dạng cho chính sách sẽ được truyền cùng với ý kiến phản hồi về lượt cài đặt ứng dụng được gửi từ Cửa hàng Play.
policy.productAvailabilityPolicy	string	Tình trạng còn hàng được cấp cho thiết bị đối với các sản phẩm đã chỉ định. "tất cả" cấp cho thiết bị quyền truy cập vào tất cả sản phẩm, bất kể trạng thái phê duyệt. "tất cả" không bật chế độ hiển thị tự động của các kênh "alpha" hoặc "beta". "danh sách trắng" cấp cho thiết bị quyền truy cập vào các sản phẩm được chỉ định trong productPolicy[]. Chỉ những sản phẩm được phê duyệt hoặc sản phẩm từng được phê duyệt (sản phẩm có quyết định phê duyệt bị thu hồi) của doanh nghiệp mới có thể được đưa vào danh sách trắng. Nếu bạn không cung cấp giá trị nào, thì chế độ có sẵn được đặt ở cấp người dùng sẽ được áp dụng theo mặc định. Các giá trị được chấp nhận là: "all" "whitelist"
policy.productPolicy[]	list	Danh sách các chính sách sản phẩm. Bạn cần đặt productAvailabilityPolicy thành WHITELIST hoặc ALL để áp dụng các chính sách về sản phẩm.
policy.productPolicy[].autoInstallPolicy	nested object	Chính sách tự động cài đặt cho sản phẩm.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]	list	Các điều kiện ràng buộc để tự động cài đặt ứng dụng. Bạn có thể chỉ định tối đa một điều kiện ràng buộc.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint	string	Quy tắc ràng buộc trạng thái sạc. Các giá trị được chấp nhận là: "chargingNotRequired" "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint	string	Quy tắc ràng buộc ở trạng thái rảnh của thiết bị. Các giá trị được chấp nhận là: "deviceIdleNotRequired" "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint	string	Quy tắc ràng buộc về loại mạng. Các giá trị được chấp nhận là: "anyNetwork" "unmeteredNetwork"
policy.productPolicy[].autoInstallPolicy.autoInstallMode	string	Chế độ tự động cài đặt. Nếu không được đặt, giá trị mặc định sẽ là "doNotAutoInstall". Ứng dụng được cài đặt tự động bất kể thời gian bảo trì đã đặt. Các giá trị được chấp nhận là: "autoInstallOnce" "doNotAutoInstall" "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority	integer	Mức độ ưu tiên của lượt cài đặt, dưới dạng số nguyên chưa ký. Số thấp hơn có nghĩa là mức độ ưu tiên cao hơn.
policy.productPolicy[].autoInstallPolicy.minimumVersionCode	integer	Phiên bản tối thiểu của ứng dụng. Nếu bạn cài đặt phiên bản thấp hơn của ứng dụng, thì ứng dụng sẽ tự động cập nhật theo các quy tắc ràng buộc tự động cài đặt, thay vì chờ bản cập nhật tự động thông thường. Bạn có thể đặt mã phiên bản tối thiểu cho tối đa 20 ứng dụng trên mỗi thiết bị.
policy.productPolicy[].autoUpdateMode	string	Chế độ tự động cập nhật cho sản phẩm. Khi được sử dụng, autoUpdateMode luôn được ưu tiên hơn lựa chọn của người dùng. Vì vậy, khi người dùng thay đổi chế độ cài đặt thiết bị theo cách thủ công, những thay đổi này sẽ bị bỏ qua. Các giá trị được chấp nhận là: "autoUpdateDefault" "autoUpdateHighPriority" "autoUpdatePostponed"
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[]	list	Cấu hình URL xác thực cho ứng dụng trình xác thực của nhà cung cấp danh tính. Điều này giúp khởi chạy ứng dụng xác thực của nhà cung cấp danh tính trong quá trình xác thực diễn ra trong một ứng dụng riêng tư bằng Android WebView. Ứng dụng xác thực phải là trình xử lý mặc định cho URL xác thực trên thiết bị.
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri	string	URL xác thực.
policy.productPolicy[].managedConfiguration	nested object	Cấu hình được quản lý cho sản phẩm.
policy.productPolicy[].managedConfiguration.configurationVariables	nested object	Chứa mã của hồ sơ cấu hình được quản lý và tập hợp các biến cấu hình (nếu có) được xác định cho người dùng.
policy.productPolicy[].managedConfiguration.configurationVariables.kind	string
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId	string	Mã của chế độ cài đặt cấu hình được quản lý.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[]	list	Tập hợp biến được phân bổ cho người dùng.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind	string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder	string	Chuỗi phần giữ chỗ; do EMM xác định.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue	string	Giá trị của phần giữ chỗ, dành riêng cho người dùng.
policy.productPolicy[].managedConfiguration.kind	string	Không dùng nữa.
policy.productPolicy[].managedConfiguration.managedProperty[]	list	Tập hợp các tài sản được quản lý cho cấu hình này.
policy.productPolicy[].managedConfiguration.managedProperty[].key	string	Khoá duy nhất giúp xác định cơ sở lưu trú.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool	boolean	Giá trị boolean – giá trị này sẽ chỉ xuất hiện nếu loại thuộc tính là bool.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle	nested object	Gói các tài sản được quản lý – thông tin này sẽ chỉ xuất hiện nếu loại tài sản là gói.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]	list	Danh sách tài sản được quản lý.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[]	list	Danh sách các gói thuộc tính – danh sách này sẽ chỉ xuất hiện nếu loại thuộc tính là bundle_array.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[]	list	Danh sách tài sản được quản lý.
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger	integer	Giá trị số nguyên – giá trị này chỉ xuất hiện nếu loại của thuộc tính là số nguyên.
policy.productPolicy[].managedConfiguration.managedProperty[].valueString	string	Giá trị chuỗi – sẽ chỉ xuất hiện nếu loại thuộc tính là chuỗi, lựa chọn hoặc bị ẩn.
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]	list	Danh sách các giá trị chuỗi – danh sách này sẽ chỉ xuất hiện nếu loại thuộc tính là chọn nhiều đối tượng.
policy.productPolicy[].managedConfiguration.productId	string	Mã của sản phẩm mà cấu hình được quản lý dành cho, ví dụ: "app:com.google.android.gm".
policy.productPolicy[].productId	string	Mã sản phẩm. Ví dụ: "app:com.google.android.gm".
policy.productPolicy[].trackIds[]	list	Cấp quyền hiển thị thiết bị cho(các) kênh phát hành sản phẩm được chỉ định, được xác định bằng trackIds. Bạn có thể lấy danh sách các bản phát hành của một sản phẩm bằng cách gọi Products.Get.
policy.productPolicy[].tracks[]	list	Không dùng nữa. Thay vào đó, hãy sử dụng trackIds.
product	string	Tên sản phẩm của thiết bị. Thông tin này đến từ android.os.Build.PRODUCT.
report	nested object	Báo cáo thiết bị đã cập nhật trạng thái ứng dụng mới nhất.
report.appState[]	list	Danh sách trạng thái ứng dụng do các ứng dụng được quản lý đặt trên thiết bị. Trạng thái ứng dụng là do nhà phát triển ứng dụng xác định. Trường này sẽ luôn xuất hiện.
report.appState[].keyedAppState[]	list	Danh sách các trạng thái ứng dụng được khoá. Trường này sẽ luôn xuất hiện.
report.appState[].keyedAppState[].data	string	Trường bổ sung dành cho dữ liệu mà máy có thể đọc được. Ví dụ: một số hoặc đối tượng JSON. Để ngăn chặn XSS, bạn nên xoá mọi HTML khỏi dữ liệu trước khi hiển thị dữ liệu đó.
report.appState[].keyedAppState[].key	string	Khoá cho biết ứng dụng đang cung cấp trạng thái cho đối tượng nào. Nội dung của khoá là do nhà phát triển ứng dụng thiết lập. Để ngăn chặn XSS, bạn nên xoá mọi HTML khỏi khoá trước khi hiển thị khoá đó. Trường này sẽ luôn xuất hiện.
report.appState[].keyedAppState[].message	string	Thông báo ở dạng tự do, người dùng có thể đọc được, mô tả trạng thái ứng dụng. Ví dụ: thông báo lỗi. Để ngăn XSS, chúng tôi khuyên bạn nên xoá mọi HTML khỏi thư trước khi hiển thị thư.
report.appState[].keyedAppState[].severity	string	Mức độ nghiêm trọng của trạng thái ứng dụng. Trường này sẽ luôn xuất hiện. Các giá trị được chấp nhận là: "severityError" "severityInfo"
report.appState[].keyedAppState[].stateTimestampMillis	long	Dấu thời gian về thời điểm ứng dụng đặt trạng thái tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Trường này sẽ luôn xuất hiện.
report.appState[].packageName	string	Tên gói của ứng dụng. Trường này sẽ luôn xuất hiện.
report.lastUpdatedTimestampMillis	long	Dấu thời gian của lần cập nhật báo cáo gần đây nhất tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Trường này sẽ luôn xuất hiện.
retailBrand	string	Thương hiệu bán lẻ của thiết bị, nếu được đặt. Xem android.os.Build.BRAND
sdkVersion	integer	Phiên bản tương thích với API.

Phương thức

forceReportUpload

Tải một báo cáo chứa mọi thay đổi về trạng thái ứng dụng trên thiết bị lên kể từ khi báo cáo gần đây nhất được tạo. Bạn có thể gọi phương thức này tối đa 3 lần mỗi 24 giờ cho một thiết bị nhất định.

get

Truy xuất thông tin chi tiết về một thiết bị.

getState

Truy xuất xem quyền truy cập của thiết bị vào các dịch vụ của Google có được bật hay tắt hay không. Trạng thái thiết bị chỉ có hiệu lực nếu bạn bật chế độ thực thi chính sách EMM trên thiết bị Android trong Bảng điều khiển dành cho quản trị viên của Google. Nếu không, trạng thái thiết bị sẽ bị bỏ qua và tất cả thiết bị đều được phép truy cập vào các dịch vụ của Google. Chế độ này chỉ được hỗ trợ cho người dùng do Google quản lý.

list

Truy xuất mã nhận dạng của tất cả thiết bị của người dùng.

setState

Đặt quyền truy cập của một thiết bị vào các dịch vụ của Google là bật hay tắt. Trạng thái thiết bị chỉ có hiệu lực nếu bạn bật chế độ thực thi chính sách EMM trên thiết bị Android trong Bảng điều khiển dành cho quản trị viên của Google. Nếu không, trạng thái thiết bị sẽ bị bỏ qua và tất cả thiết bị đều được phép truy cập vào các dịch vụ của Google. Chế độ này chỉ được hỗ trợ cho người dùng do Google quản lý.

update

Cập nhật chính sách thiết bị.

Để đảm bảo chính sách này được thực thi đúng cách, bạn cần ngăn các tài khoản không được quản lý truy cập vào Google Play bằng cách thiết lập allowed_accounts trong cấu hình được quản lý cho gói Google Play. Xem bài viết hạn chế tài khoản trong Google Play.