Notifikasi Pub/Sub menyediakan cara bagi Anda untuk menerima pemberitahuan tentang perangkat yang baru terdaftar, 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 perlu memberikan izin Device Policy Android untuk memublikasikan ke topik Anda.
1. Mengaktifkan Pub/Sub API untuk project Anda
Untuk petunjuk cara mengaktifkan Pub/Sub API, lihat panduan memulai konsol. Pastikan Anda memilih project yang sama dengan project yang digunakan untuk mengaktifkan Android Management API.
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 membuat 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 membuat langganan).
4. Memberikan hak publikasi ke topik Anda kepada Android Device Policy
Anda harus memberikan izin 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)
- Tambahkan
serviceAccount:android-cloud-policy@system.gserviceaccount.com
kemembers
. - Tetapkan
role
keroles/pubsub.publisher
.
5. Mengupdate versi perusahaan 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 bentukprojects/{project}/topics/{topic}
.enabledNotificationTypes
: Sertakan semua jenis notifikasi yang ingin Anda terima. Pilih dariENROLLMENT
,STATUS_REPORT
, danCOMMAND
.
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 Operasi. - Notifikasi
USAGE_LOGS
menggunakan jenis resource UsageLogEvent. - Notifikasi
ENROLLMENT
danSTATUS_REPORT
menggunakan jenis resource Perangkat. - Notifikasi
ENTERPRISE_UPGRADE
menggunakan jenis resource EnterpriseUpgradeEvent.
Saat menetapkan pubsubTopic
di Enterprise, pesan awal akan
dipublikasikan dengan notificationType
ditetapkan ke test
. Pesan ini dikirim untuk memverifikasi bahwa
Android Device Policy memiliki izin publikasi pada topik dan harus
diabaikan.
Latensi yang diharapkan
Peristiwa upgrade Enterprise diharapkan akan segera dikirim.
Peristiwa perangkat lokal yang terjadi secara berurutan akan dikelompokkan dan dilaporkan dalam satu pesan Pub/Sub ke EMM.
Jenis peristiwa | Perkiraan latensi antara peristiwa di perangkat dan notifikasi EMM yang sesuai1 |
---|---|
Status aplikasi dengan kunci prioritas tinggi | Langsung, maksimal satu laporan per menit |
Status aplikasi dengan kunci prioritas standar | Dalam satu menit |
Peristiwa terkait aplikasi selama penyediaan, untuk aplikasi dengan status penginstalan yang ditentukan oleh admin IT2 | Dalam satu menit di samping 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 lainnya di perangkat | Dalam waktu 60 menit |
-
Target upaya terbaik berdasarkan situasi yang terkontrol. Latensi yang sebenarnya dapat bervariasi sesuai dengan berbagai faktor perangkat dan lingkungan. ↩
-
InstallType
aplikasi yang diterapkan dalam kebijakan:FORCE_INSTALLED
,BLOCKED
,REQUIRED_FOR_SETUP
,PREINSTALLED
, danKIOSK
. ↩ -
InstallType
aplikasi yang tersedia:AVAILABLE
,INSTALL_TYPE_UNSPECIFIED
. ↩