Devices

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

Biểu diễn 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
  },
  "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ị	Nội dung mô tả	Notes
androidId	string	Mã nhận dạng Android trên Dịch vụ Google Play cho thiết bị được mã hoá dưới dạng chuỗi hex viết thường. Ví dụ: "123456789abcdef0".
device	string	Tên mã phần cứng bên trong của thiết bị. Nội dung này là của android.os.Build.DEVICE. (trường có tên là "device" mỗi nhật ký/Wireless/android/android_checkin.proto)
kind	string
latestBuildFingerprint	string	Vân tay số của bản dựng của thiết bị (nếu được biết).
maker	string	Nhà sản xuất thiết bị. Nội dung này là của android.os.Build.MANUFACTURER.
managementType	string	Xác định mức độ kiểm soát thiết bị do một nhà cung cấp dịch vụ EMM (quản lý) trên Google Play kiểm soát trong nhiều cấu hình triển khai. Các giá trị có thể bao gồm: "managedDevice", một thiết bị có trình kiểm soát chính sách thiết bị (DPC) của EMM làm chủ sở hữu. "managedProfile", một thiết bị có một hồ sơ do DPC quản lý (DPC là chủ sở hữu hồ sơ) cùng với một hồ sơ cá nhân riêng biệt mà DPC không có. "containerApp", không còn được sử dụng (không dùng nữa). "unmanagedProfile", thiết bị đã được quản trị viên của miền cho phép (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 bản thân hồ sơ này không do DPC sở hữu. 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ị. Nội dung này là của android.os.Build.MODEL.
policy	nested object	Đã thực thi chính sách trên thiết bị.
policy.autoUpdatePolicy	string	Kiểm soát thời điểm có thể áp dụng các bản cập nhật ứng dụng tự động trên thiết bị. Lựa chọn thay thế được đề xuất: autoUpdateMode được đặt cho mỗi ứng dụng, giúp tăng sự linh hoạt cho tần suất cập nhật. Khi bạn đặt autoUpdateMode 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. "luôn luôn" cho phép cập nhật tự động. "không bao giờ" tắt tính năng cập nhật tự động. "Chỉ Wi-Fi" chỉ bật chế độ tự động cập nhật khi thiết bị được kết nối với Wi-Fi. 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 với 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	Khoảng thời gian bảo trì xác định thời điểm các ứng dụng chạy ở nền trước cần được cập nhật.
policy.maintenanceWindow.durationMs	long	Thời gian bảo trì, tính bằng mili giây. Thời lượng phải từ 30 phút đến 24 giờ (bao gồm cả 30 phút).
policy.maintenanceWindow.startTimeAfterMidnightMs	long	Thời gian bắt đầu của khoảng thời gian bảo trì, tính bằng mili giây sau nửa đêm trên thiết bị. Windows có thể kéo dài đến nửa đêm.
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 được chỉ định. "tất cả" cho phép thiết bị truy cập vào tất cả sản phẩm, bất kể trạng thái phê duyệt là gì. "all" không bật chế độ tự động hiển thị của các bản nhạc "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 các sản phẩm đã được doanh nghiệp phê duyệt trước đây (những sản phẩm bị thu hồi phê duyệt) mới có thể được đưa vào danh sách cho phép. Nếu không có giá trị nào được cung cấp, tình trạng còn hàng đượ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 phải đặt productAvailabilityPolicy thành WHITELIST hoặc ALL thì chính sách sản phẩm mới được áp dụng.
policy.productPolicy[].autoInstallPolicy	nested object	Chính sách tự động cài đặt dành cho sản phẩm.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[]	list	Các quy tắc ràng buộc đối với việc tự động cài đặt ứng dụng. Bạn có thể chỉ định tối đa một quy tắc ràng buộc.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint	string	Quy tắc ràng buộc về 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 về 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 bạn không đặt chính sách này thì chế độ 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 ra. 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 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 phiên bản thấp hơn của ứng dụng được cài đặt, thì ứng dụng sẽ được tự động cập nhật theo các giới hạn tự động cài đặt, thay vì chờ tự động cập nhật 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 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 của 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 xác thực của nhà cung cấp danh tính. Thao tác 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 trong một ứng dụng riêng tư sử dụng WebView trên Android. Ứng dụng Authenticator 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ý của sản phẩm.
policy.productPolicy[].managedConfiguration.configurationVariables	nested object	Chứa mã nhận dạng 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 các 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 được dùng nữa.
policy.productPolicy[].managedConfiguration.managedProperty[]	list	Tập hợp các thuộc tính được quản lý cho cấu hình này.
policy.productPolicy[].managedConfiguration.managedProperty[].key	string	Khoá duy nhất xác định tài sản.
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 thuộc tính được quản lý - thuộc tính này sẽ chỉ xuất hiện nếu loại thuộc tính là gói.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[]	list	Danh sách các cơ sở lưu trú đượ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 các cơ sở lưu trú đượ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 thuộc tính là số nguyên.
policy.productPolicy[].managedConfiguration.managedProperty[].valueString	string	Giá trị chuỗi – giá trị này 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 giá trị chuỗi – giá trị này sẽ chỉ xuất hiện nếu loại thuộc tính là nhiều lựa chọn.
policy.productPolicy[].managedConfiguration.productId	string	Mã sản phẩm chứa cấu hình được quản lý, ví dụ: "app:com.google.android.gm".
policy.productPolicy[].productId	string	Mã nhận dạng của 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ụ thể, do trackIds xác định. Bạn có thể lấy danh sách kênh 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ị. Nội dung này là của android.os.Build.PRODUCT.
report	nested object	Báo cáo thiết bị được cập nhật với các 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 ứng dụng được quản lý đặt trên thiết bị. Trạng thái ứng dụng là do các 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 quan trọng. 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ụ: 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ị.
report.appState[].keyedAppState[].key	string	Khoá cho biết mục đích mà ứng dụng đang cung cấp trạng thái. Nội dung của khoá 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ị. Trường này sẽ luôn xuất hiện.
report.appState[].keyedAppState[].message	string	Thông báo dạng tự do mà con người có thể đọc được, dùng để mô tả trạng thái ứng dụng. Ví dụ: một thông báo lỗi. Để ngăn XSS, bạn nên xoá mọi HTML khỏi thông báo trước khi hiển 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 theo 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ó). Xem android.os.Build.BRAND
sdkVersion	integer	Phiên bản khả năng tương thích với API.

Phương thức

forceReportUpload

Tải lên 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ị 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.

nhận

Truy xuất thông tin chi tiết của một thiết bị.

getState

Truy xuất xem quyền truy cập của một thiết bị vào các dịch vụ của Google đang bật hay tắt. Trạng thái thiết bị chỉ có hiệu lực nếu bật 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. Tính năng 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 tất cả các thiết bị của người dùng.

setState

Thiết lập bật hoặc tắt quyền truy cập của một thiết bị vào các dịch vụ của Google. Trạng thái thiết bị chỉ có hiệu lực nếu bật 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. Tính năng này chỉ được hỗ trợ cho người dùng do Google quản lý.

cập nhật

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

Để đảm bảo thực thi chính sách đú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 đặt allowed_accounts trong cấu hình được quản lý cho gói Google Play. Xem phần hạn chế tài khoản trong Google Play.