Thiết lập thông báo Pub/Sub

Thông báo Pub/Sub giúp bạn nhận được cảnh báo về các thiết bị mới đăng ký, báo cáo thiết bị và lệnh mới phát hành.

Để thiết lập thông báo Pub/Sub, bạn cần bật API Pub/Sub và tạo một chủ đề. Để nhận các tin nhắn được đăng lên một chủ đề, hãy tạo một gói thuê bao cho chủ đề đó. Gói thuê bao kết nối chủ đề với một ứng dụng thuê bao nhận và xử lý các thông báo được xuất bản cho chủ đề đó. Sau khi tạo một gói thuê bao, bạn cần cấp cho Android Device Policy quyền xuất bản lên chủ đề của mình.

1. Bật API Pub/Sub cho dự án của bạn

Để biết hướng dẫn về cách bật API Pub/Sub, hãy xem hướng dẫn nhanh về bảng điều khiển. Đảm bảo rằng bạn chọn cùng một dự án mà Android Management API được bật.

2. Tạo một chủ đề

Sau khi bật API này, bạn cần tạo một chủ đề mà Android Device Policy có thể đăng thông báo. Có hai cách để tạo một chủ đề:

a. Theo cách thủ công trong Google Cloud Console.
b. Sử dụng Pub/Sub API (xem phương thức tạo chủ đề).

Sau khi tạo chủ đề, hãy ghi lại tên chủ đề.

3. Tạo gói thuê bao

Một gói thuê bao ghi lại luồng tin nhắn được xuất bản cho một chủ đề nhất định. Có 2 cách để tạo gói thuê bao:

a. Theo cách thủ công trong Google Cloud Console.
b. Sử dụng Pub/Sub API (xem phương thức tạo gói thuê bao).

4. Cấp cho Android Device Policy quyền xuất bản vào chủ đề của bạn

Bạn cần cấp cho android-cloud-policy@system.gserviceaccount.com quyền xuất bản vào chủ đề của mình. Có 2 cách để cấp quyền xuất bản:

a. Theo cách thủ công trong bảng điều khiển Google Cloud.

  • Thêm android-cloud-policy@system.gserviceaccount.com làm thành viên vào chủ đề của bạn.
  • Nhấp vào Chọn vai trò > Pub/Sub > Nhà xuất bản Pub/Sub.

b. Sử dụng API Pub/Sub (xem phần Kiểm soát quyền truy cập thông qua API IAM)

  • Thêm serviceAccount:android-cloud-policy@system.gserviceaccount.com vào members.
  • Đặt role thành roles/pubsub.publisher.

5. Cập nhật doanh nghiệp để hỗ trợ thông báo

Bỏ qua bước này nếu thông báo bạn muốn hỗ trợ là ENTERPRISE_UPGRADE (luôn được hỗ trợ).

Để kết nối thông báo về một doanh nghiệp với chủ đề bạn đã tạo, hãy gọi enterprises.patch và chỉ định các tham số sau:

  • pubsubTopic: Tên chủ đề pub/sub của bạn ở dạng projects/{project}/topics/{topic}.
  • enabledNotificationTypes: Thêm tất cả các loại thông báo mà bạn muốn nhận.

6. Sử dụng Pub/Sub API để nhận thông báo

Một thuê bao có thể sử dụng cơ chế đẩy hoặc kéo để gửi thông báo. Bạn có thể xem hướng dẫn và chỉ dẫn về cách nhận thông báo thông qua cả hai cơ chế này trong Hướng dẫn dành cho người đăng ký Pub/Sub.

Định dạng thư

Thông báo có dạng PubsubMessage. Trường attributes của thông báo chứa một thuộc tính có khoá notificationType và giá trị được đặt thành loại thông báo đã kích hoạt thông báo (ví dụ: ENROLLMENT). Trường data của thông báo chứa biểu thị JSON của tài nguyên đã được cập nhật, được mã hoá dưới dạng một chuỗi UTF-8. Sau đây là các thông báo và loại tài nguyên tương ứng:

  • Thông báo COMMAND sử dụng loại tài nguyên Operation.
  • Thông báo USAGE_LOGS sử dụng loại tài nguyên UsageLogEvent.
  • Thông báo ENROLLMENT và STATUS_REPORT sử dụng loại tài nguyên Device.
  • Thông báo ENTERPRISE_UPGRADE sử dụng loại tài nguyên EnterpriseUpgradeEvent.

Khi đặt pubsubTopic trên một Doanh nghiệp, một thông báo ban đầu sẽ được xuất bản với notificationType được đặt thành test. Thông báo này được gửi để xác minh rằng Android Device Policy có quyền xuất bản trên chủ đề và bạn nên bỏ qua thông báo này.

Độ trễ dự kiến

Các sự kiện nâng cấp doanh nghiệp dự kiến sẽ được gửi ngay lập tức.

Các sự kiện trên thiết bị cục bộ xảy ra liên tiếp sẽ được xử lý theo lô và báo cáo trong một thông báo Pub/Sub duy nhất cho EMM.

Loại sự kiện Độ trễ dự kiến giữa sự kiện trên thiết bị và thông báo EMM tương ứng1
Trạng thái ứng dụng được khoá có mức độ ưu tiên cao Ngay lập tức, tối đa một báo cáo mỗi phút
Trạng thái ứng dụng được khoá có mức độ ưu tiên tiêu chuẩn Trong vòng một phút
Các sự kiện liên quan đến ứng dụng trong quá trình cung cấp, đối với các ứng dụng có trạng thái cài đặt do quản trị viên CNTT xác định2 Trong vòng một phút, ngoài các sự kiện cung cấp có liên quan khác
Các sự kiện liên quan đến ứng dụng sau khi cung cấp, đối với các ứng dụng có trạng thái cài đặt do quản trị viên CNTT xác định. Trong vòng 5 phút
Các sự kiện liên quan đến ứng dụng trong và sau khi cung cấp, đối với các ứng dụng có trạng thái cài đặt do nhân viên xác định3 Trong vòng 60 phút
Các sự kiện khác trên thiết bị Trong vòng 60 phút

  1. Mục tiêu tối ưu nhất dựa trên các trường hợp được kiểm soát. Độ trễ thực tế có thể thay đổi tuỳ theo nhiều yếu tố về thiết bị và môi trường. ↩

  2. InstallType của các ứng dụng được thực thi trong chính sách: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED và KIOSK. ↩

  3. InstallType trong số các ứng dụng có sẵn: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩