Enterprises: pullNotificationSet

Lấy và trả về thông báo đã đặt cho các doanh nghiệp liên kết với tài khoản dịch vụ đã xác thực cho yêu cầu. Bộ thông báo có thể trống nếu không có thông báo nào đang chờ xử lý.
Bạn phải xác nhận một tập hợp thông báo được trả về trong vòng 20 giây bằng cách gọi Enterprise.AcknowledgeNotificationSet, trừ khi tập hợp thông báo trống.
Những thông báo không được xác nhận trong vòng 20 giây sẽ được đưa lại vào phản hồi cho một yêu cầu PullNotificationSet khác và những thông báo chưa được xác nhận cuối cùng sẽ bị xoá theo chính sách của hệ thống Google Cloud Platform Pub/Sub.
Bạn có thể thực hiện nhiều yêu cầu cùng lúc để truy xuất thông báo. Trong trường hợp đó, các thông báo đang chờ xử lý (nếu có) sẽ được chia nhỏ cho từng người gọi (nếu có).
Nếu không có thông báo nào, thì một danh sách thông báo trống sẽ được trả về. Các yêu cầu tiếp theo có thể trả về nhiều thông báo hơn sau khi có sẵn.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

Các tham số

Tên thông số Giá trị Mô tả
Tham số truy vấn không bắt buộc
requestMode string Chế độ yêu cầu để lấy thông báo.
Việc chỉ định waitForNotifications sẽ khiến yêu cầu chặn và đợi cho đến khi có một hoặc nhiều thông báo, hoặc trả về một danh sách thông báo trống nếu không có thông báo nào xuất hiện sau một khoảng thời gian.
Việc chỉ định returnImmediately sẽ khiến yêu cầu trả về ngay các thông báo đang chờ xử lý hoặc một danh sách trống nếu không có thông báo nào.
Nếu bỏ qua, mặc định là waitForNotifications.

Các giá trị được chấp nhận là:
  • "returnImmediately"
  • "waitForNotifications"

Ủy quyền

Yêu cầu này cần được cho phép với phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/androidenterprise

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi với cấu trúc sau:

{
  "kind": "androidenterprise#notificationSet",
  "notificationSetId": string,
  "notification": [
    {
      "enterpriseId": string,
      "timestampMillis": long,
      "notificationType": string,
      "productApprovalEvent": {
        "productId": string,
        "approved": string
      },
      "installFailureEvent": {
        "productId": string,
        "deviceId": string,
        "userId": string,
        "failureReason": string,
        "failureDetails": string
      },
      "appUpdateEvent": {
        "productId": string
      },
      "newPermissionsEvent": {
        "productId": string,
        "requestedPermissions": [
          string
        ],
        "approvedPermissions": [
          string
        ]
      },
      "appRestrictionsSchemaChangeEvent": {
        "productId": string
      },
      "productAvailabilityChangeEvent": {
        "productId": string,
        "availabilityStatus": string
      },
      "newDeviceEvent": {
        "userId": string,
        "deviceId": string,
        "managementType": string,
        "dpcPackageName": string
      },
      "deviceReportUpdateEvent": {
        "userId": string,
        "deviceId": string,
        "report": {
          "lastUpdatedTimestampMillis": long,
          "appState": [
            {
              "packageName": string,
              "keyedAppState": [
                {
                  "key": string,
                  "stateTimestampMillis": long,
                  "severity": string,
                  "message": string,
                  "data": string
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Tên tài sản Giá trị Mô tả Ghi chú
notificationSetId string Mã nhóm thông báo (bắt buộc để đánh dấu thông báo là đã nhận được) qua Enterprises.AcknowledgeNotification. Hệ thống sẽ bỏ qua thông báo này nếu không có thông báo.
notification[] list Thông báo nhận được hoặc để trống nếu không có thông báo.
notification[].enterpriseId string Mã nhận dạng của doanh nghiệp mà thông báo được gửi. Điều này sẽ luôn tồn tại.
notification[].timestampMillis long Thời điểm xuất bản thông báo tính bằng mili giây kể từ năm 1970-01-01T00:00:00Z. Điều này sẽ luôn tồn tại.
notification[].productApprovalEvent nested object Thông báo về các thay đổi đối với trạng thái phê duyệt sản phẩm.
notification[].productApprovalEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") mà trạng thái phê duyệt đã thay đổi. Trường này sẽ luôn xuất hiện.
notification[].productApprovalEvent.approved string Sản phẩm đã được phê duyệt hay chưa. Trường này sẽ luôn xuất hiện.

Các giá trị được chấp nhận là:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Thông báo về lỗi cài đặt ứng dụng.
notification[].installFailureEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") nơi xảy ra sự cố cài đặt. Trường này sẽ luôn xuất hiện.
notification[].installFailureEvent.deviceId string Mã Android của thiết bị. Trường này sẽ luôn xuất hiện.
notification[].installFailureEvent.userId string Mã nhận dạng của người dùng. Trường này sẽ luôn xuất hiện.
notification[].installFailureEvent.failureReason string Nguyên nhân cài đặt không thành công. Trường này sẽ luôn xuất hiện.

Các giá trị được chấp nhận là:
  • "timeout"
  • "unknown"
notification[].installFailureEvent.failureDetails string Thông tin bổ sung về lỗi này, nếu có.
notification[].appUpdateEvent nested object Thông báo về các bản cập nhật ứng dụng.
notification[].appUpdateEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") đã được cập nhật. Trường này sẽ luôn xuất hiện.
notification[].newPermissionsEvent nested object Thông báo về các quyền mới cho ứng dụng.
notification[].newPermissionsEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") đã thêm các quyền mới. Trường này sẽ luôn xuất hiện.
notification[].newPermissionsEvent.requestedPermissions[] list Tập hợp các quyền mà ứng dụng hiện đang yêu cầu. Sử dụng Quyền.Truy cập API EMM để truy xuất thông tin chi tiết về các quyền này.
notification[].newPermissionsEvent.approvedPermissions[] list Bộ quyền mà quản trị viên doanh nghiệp đã phê duyệt cho ứng dụng này. Sử dụng Quyền.Truy cập API EMM để truy xuất thông tin chi tiết về các quyền này.
notification[].appRestrictionsSchemaChangeEvent nested object Thông báo về các thay đổi đối với giản đồ hạn chế ứng dụng mới.
notification[].appRestrictionsSchemaChangeEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") mà giản đồ hạn chế ứng dụng bị thay đổi. Trường này sẽ luôn xuất hiện.
notification[].productAvailabilityChangeEvent nested object Thông báo về việc thay đổi tình trạng còn hàng của sản phẩm.
notification[].productAvailabilityChangeEvent.productId string Mã sản phẩm (ví dụ: "app:com.google.android.gm") mà tình trạng còn hàng của sản phẩm đã thay đổi. Trường này sẽ luôn xuất hiện.
notification[].productAvailabilityChangeEvent.availabilityStatus string Trạng thái mới của sản phẩm. Trường này sẽ luôn xuất hiện.

Các giá trị được chấp nhận là:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
notification[].newDeviceEvent nested object Thông báo về thiết bị mới.
notification[].newDeviceEvent.userId string Mã nhận dạng của người dùng. Trường này sẽ luôn xuất hiện.
notification[].newDeviceEvent.deviceId string Mã Android của thiết bị. Trường này sẽ luôn xuất hiện.
notification[].newDeviceEvent.managementType string Xác định mức độ mà thiết bị Android EMM kiểm soát trong nhiều cấu hình triển khai.

Các giá trị có thể là:
  • "managedDevice", một thiết bị mà DPC được đặt làm chủ sở hữu thiết bị,
  • "managedProfile", một thiết bị mà DPC được đặt làm chủ sở hữu hồ sơ.


Các giá trị được chấp nhận là:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string Loại thông báo.

Các giá trị được chấp nhận là:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
notification[].newDeviceEvent.dpcPackageName string Ứng dụng Chính sách trên thiết bị.
notification[].deviceReportUpdateEvent nested object Thông báo về các bản cập nhật báo cáo về thiết bị.
notification[].deviceReportUpdateEvent.userId string Mã nhận dạng của người dùng. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.deviceId string Mã Android của thiết bị. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.report nested object Bản báo cáo thiết bị đã cập nhật theo trạng thái ứng dụng mới nhất. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.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.
notification[].deviceReportUpdateEvent.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 do nhà phát triển ứng dụng xác định. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.report.appState[].packageName string Tên gói của ứng dụng. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Danh sách các trạng thái khoá của ứng dụng. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Khóa cho biết ứng dụng đang cung cấp trạng thái cho mục đích gì. Nhà phát triển ứng dụng đã thiết lập nội dung của khóa. Để ngăn XSS, bạn nên xoá mọi HTML khỏi khoá trước khi cho hiện. Trường này sẽ luôn xuất hiện.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Dấu thời gian khi ứ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.
notification[].deviceReportUpdateEvent.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"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Thông báo dạng tự do và dễ đọc dành cho người dùng, mô tả trạng thái của ứ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ị.
notification[].deviceReportUpdateEvent.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 XSS, bạn nên xoá mọi HTML khỏi dữ liệu trước khi cho hiện.
kind string