Notifikasi Pub/Sub memberikan cara bagi Anda untuk menerima pemberitahuan tentang perangkat yang baru didaftarkan, laporan perangkat, dan perintah yang baru-baru ini 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 tersebut. Setelah membuat langganan, Anda harus memberikan izin Android Device Policy untuk memublikasikan ke topik Anda.
1. Mengaktifkan Pub/Sub API untuk project Anda
Untuk mengetahui petunjuk cara mengaktifkan Pub/Sub API, lihat panduan memulai konsol. Pastikan Anda memilih project yang sama dengan Android Management API diaktifkan.
2. Membuat topik
Setelah mengaktifkan API, Anda harus membuat topik yang dapat menjadi tujuan publikasi notifikasi Android Device Policy. Ada dua cara untuk membuat topik:
a. Secara manual di Google Cloud Platform Console.
b. Menggunakan Pub/Sub API (lihat create topicmethod).
Setelah membuat topik, catat nama topiknya.
3. Membuat langganan
Langganan menangkap aliran pesan yang dipublikasikan ke topik tertentu. Ada dua cara untuk membuat langganan:
a. Secara manual di Google Cloud Platform Console.
b. Menggunakan Pub/Sub API (lihat membuat metode 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 topik. Ada dua cara untuk memberikan hak publikasi:
a. Secara manual di Google Cloud Platform Console.
- 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 Kontrol Akses melalui IAM API Google Cloud Pub/Sub)
- Menambahkan
serviceAccount:android-cloud-policy@system.gserviceaccount.com
kemembers
. - Tetapkan
role
keroles/pubsub.publisher
.
5. Mengupdate perusahaan untuk mendukung notifikasi
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
: Menyertakan 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 mengenai cara menerima notifikasi melalui kedua mekanisme ini tersedia di Panduan Pelanggan Pub/Sub.
Format pesan
Pesan dalam bentuk PubsubMessage.
Kolom attributes
pada pesan berisi atribut dengan kunci
notificationType
dan nilai yang ditetapkan ke jenis notifikasi yang memicu
pesan (misalnya, ENROLLMENT
). Kolom data
pesan berisi representasi JSON
dari resource yang telah 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
danSTATUS_REPORT
menggunakan jenis resource Perangkat.
Saat menetapkan pubsubTopic
di Enterprise, pesan awal akan dipublikasikan dengan notificationType
ditetapkan ke test
. Pesan ini dikirim untuk memverifikasi
Android Device Policy memiliki izin publikasi pada topik dan harus
diabaikan.