Menyiapkan notifikasi Pub/Sub

Notifikasi Pub/Sub memberi Anda cara untuk menerima pemberitahuan tentang perangkat yang baru didaftarkan, laporan perangkat, dan perintah yang baru dikeluarkan.

Untuk menyiapkan notifikasi Pub/Sub, Anda harus mengaktifkan Pub/Sub API dan membuat topik. Untuk menerima pesan yang dipublikasikan ke suatu topik, buat langganan ke topik tersebut. Langganan menghubungkan topik ke aplikasi pelanggan yang menerima dan memproses pesan yang dipublikasikan ke topik. Setelah membuat langganan, Anda harus memberikan izin kepada Android Device Policy untuk memublikasikan ke topik Anda.

1. Aktifkan Pub/Sub API untuk project Anda

Untuk mengetahui petunjuk tentang cara mengaktifkan Pub/Sub API, lihat panduan memulai cepat konsol. Pastikan Anda memilih project yang sama dengan project yang Android Management API diaktifkan untuknya.

2. Membuat topik

Setelah mengaktifkan API, Anda perlu membuat topik yang dapat digunakan Android Device Policy untuk memublikasikan notifikasi. Ada dua cara untuk membuat topik:

a. Secara manual di konsol Google Cloud.
b. Menggunakan Pub/Sub API (lihat metode pembuatan topik).

Setelah membuat topik, catat nama topik.

3. Membuat langganan

Langganan menangkap aliran pesan yang dipublikasikan ke topik tertentu. Ada dua cara untuk membuat langganan:

a. Secara manual di konsol Google Cloud.
b. Menggunakan Pub/Sub API (lihat metode pembuatan langganan).

4. Memberi Android Device Policy hak untuk memublikasikan ke topik Anda

Anda harus memberikan izin kepada android-cloud-policy@system.gserviceaccount.com untuk memublikasikan ke topik Anda. Ada dua cara untuk memberikan hak publikasi:

a. Secara manual di konsol Google Cloud.

  • Tambahkan android-cloud-policy@system.gserviceaccount.com sebagai anggota ke topik Anda.
  • Klik Select a role > Pub/Sub > Pub/Sub Publisher.

b. Menggunakan Pub/Sub API (lihat Mengontrol akses melalui IAM API)

  • Menambahkan serviceAccount:android-cloud-policy@system.gserviceaccount.com ke members.
  • Tetapkan role ke roles/pubsub.publisher.

5. Memperbarui Enterprise untuk mendukung notifikasi

Lewati langkah ini jika notifikasi yang ingin Anda dukung adalah ENTERPRISE_UPGRADE, yang selalu didukung.

Untuk menghubungkan notifikasi tentang perusahaan ke topik yang Anda buat, panggil enterprises.patch dan tentukan parameter berikut:

  • pubsubTopic: Nama topik pub/sub Anda dalam bentuk projects/{project}/topics/{topic}.
  • enabledNotificationTypes: Sertakan semua jenis notifikasi yang ingin Anda terima.

6. Menggunakan Pub/Sub API untuk mendapatkan notifikasi

Langganan dapat menggunakan mekanisme push atau pull untuk pengiriman pesan. Panduan dan petunjuk tentang cara menerima notifikasi melalui kedua mekanisme ini tersedia di Panduan Subscriber Pub/Sub.

Format pesan

Pesan berbentuk PubsubMessage. Kolom attributes pesan berisi atribut dengan kunci notificationType dan nilai yang ditetapkan ke jenis notifikasi yang memicu pesan (misalnya, ENROLLMENT). Kolom data pesan berisi representasi JSON resource yang diperbarui, yang dienkode sebagai string UTF-8. Notifikasi dan jenis resource yang sesuai adalah sebagai berikut:

  • Notifikasi COMMAND menggunakan jenis resource Operation.
  • Notifikasi USAGE_LOGS menggunakan jenis resource UsageLogEvent.
  • Notifikasi ENROLLMENT dan STATUS_REPORT menggunakan jenis resource Perangkat.
  • Notifikasi ENTERPRISE_UPGRADE menggunakan jenis resource EnterpriseUpgradeEvent.

Saat menyetel pubsubTopic di Enterprise, pesan awal akan dipublikasikan dengan notificationType disetel ke test. Pesan ini dikirim untuk memverifikasi bahwa Android Device Policy memiliki izin publikasi di topik dan harus diabaikan.

Latensi yang diharapkan

Peristiwa upgrade Enterprise diharapkan dikirim segera.

Peristiwa perangkat lokal yang terjadi secara berurutan dikelompokkan dan dilaporkan dalam satu pesan Pub/Sub ke EMM.

Jenis peristiwa Latensi yang diharapkan antara peristiwa di perangkat dan notifikasi EMM yang sesuai1
Status aplikasi yang memiliki kunci prioritas tinggi Segera, paling banyak satu laporan per menit
Status aplikasi yang dikunci dengan prioritas standar Dalam waktu satu menit
Peristiwa terkait aplikasi selama penyediaan, untuk aplikasi dengan status penginstalan yang ditentukan oleh admin IT 2 Dalam satu menit di atas peristiwa penyediaan terkait lainnya
Peristiwa terkait aplikasi setelah penyediaan, untuk aplikasi dengan status penginstalan yang ditentukan oleh admin IT. Dalam 5 menit
Peristiwa terkait aplikasi selama dan setelah penyediaan, untuk aplikasi dengan status penginstalan yang ditentukan oleh karyawan3 Dalam waktu 60 menit
Peristiwa aplikasi di perangkat lainnya Dalam waktu 60 menit

  1. Target upaya terbaik berdasarkan keadaan yang terkontrol. Latensi sebenarnya dapat bervariasi sesuai dengan berbagai faktor perangkat dan lingkungan. ↩

  2. InstallType aplikasi yang diterapkan dalam kebijakan: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED, dan KIOSK. ↩

  3. InstallType aplikasi yang tersedia: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩