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à:
|
Ủ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à:
|
|
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à:
|
|
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à:
|
|
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à:
Các giá trị được chấp nhận là:
|
|
notification[].notificationType |
string |
Loại thông báo.
Các giá trị được chấp nhận là:
|
|
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à:
|
|
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 |