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.

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ị	Mô tả	Ghi chú
androidId	string	Mã nhận dạng thiết bị Android của 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ị. Đây là ý kiến của android.os.Build.DEVICE. (trường có tên "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 đã biết.
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 phạm vi mà thiết bị được kiểm soát bởi dịch vụ EMM (quản lý thiết bị di động doanh nghiệp) được quản lý của Google Play trong các cấu hình triển khai khác nhau. 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 với tư cách là 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 không dành cho DPC. "containerApp", không còn được sử dụng (không dùng nữa). "unmanagedProfile", một thiết bị đã được quản trị viên của miền cho phép (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 bản thân hồ sơ này không thuộc sở hữu của DPC nào. 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ị. Đây là ý kiến của 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 tính năng tự động cập nhật ứng dụng trên thiết bị. Giải pháp thay thế nên dùng: autoUpdateMode (được đặt theo từng ứng dụng) giúp bạn linh hoạt hơn về 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" bật tính năng tự động cập nhật. "không bao giờ" tắt cập nhật tự động. "chỉ wifi" chỉ cho phép tự động cập nhật khi thiết bị được kết nố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 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	Cửa sổ bảo trì xác định thời điểm cập nhật các ứng dụng chạy ở nền trước.
policy.maintenanceWindow.durationMs	long	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ờ (bao gồm cả).
policy.maintenanceWindow.startTimeAfterMidnightMs	long	Thời gian bắt đầu của 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ị của những sản phẩm được 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 là gì. "tất cả" không bật chế độ tự động hiển thị "alpha" hoặc "beta" bản nhạc. "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 doanh nghiệp đã phê duyệt hoặc từng được phê duyệt (sản phẩm đã bị thu hồi quyết định phê duyệt) của doanh nghiệp mới có thể được đưa vào danh sách cho phép. Nếu bạn không cung cấp giá trị nào, thì tình trạng còn hàng thiết lập ở 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 chính sách 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 quy tắc ràng buộ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	Hạn chế 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 ở 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, 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 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 quy tắc ràng buộc đối với việc tự động cài đặt, thay vì đợi bản cập nhật tự động như 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 dùng autoUpdateMode, lựa chọn này 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 trình 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 diễn ra trong một ứng dụng riêng tư sử dụng Android WebView. Ứ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ã 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 giúp xác định tài sản.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool	boolean	Giá trị boolean – giá trị này chỉ xuất hiện nếu loại thuộc tính là boolean.
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 các 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 các 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	Ví dụ: Mã của sản phẩm chứa cấu hình được quản lý "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 chỉ định, 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ị. Đây là ý kiến của android.os.Build.PRODUCT.
report	nested object	Báo cáo thiết bị đã cập nhật các trạng thái mới nhất của ứng dụng.
report.appState[]	list	Danh sách trạng thái ứng dụng do các ứng dụng được quản lý thiết lập 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 trạng thái của ứ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 XSS, chúng tôi khuyên bạn nên xoá mọi HTML khỏi dữ liệu trước khi hiển thị nó.
report.appState[].keyedAppState[].key	string	Khoá cho biết ứng dụng đang cung cấp trạng thái cho mục đích gì. Nội dung của khoá do nhà phát triển ứng dụng thiết lập. Để ngă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, con người có thể đọc được, mô tả trạng thái ứng dụng. Ví dụ: một 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	Tính 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 đã đặt). Xem android.os.Build.BRAND
sdkVersion	integer	Phiên bản tương thích 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ừ báo cáo cuối cùng đã đượ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ị cụ thể.

nhận

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

getState

Truy xuất xem bạn có bật quyền truy cập của một thiết bị vào các dịch vụ của Google hay không tắt. Trạng thái thiết bị chỉ có hiệu lực nếu thực thi các chính sách EMM trên Android thiết bị được bật 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à mọi 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ả 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 thực thi các chính sách EMM trên Android thiết bị được bật 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à mọi 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 chính sách này được thực thi đúng cách, bạn cần ngăn chặn các tệp không được quản lý tài khoản truy cập Google Play bằng cách đặt allowed_accounts trong cấu hình được quản lý của Google Gói Play. Xem phần hạn chế trong Google Play.