Menyiapkan notifikasi Pub/Sub

Catatan: Partner EMM yang ada dengan ESA yang dibuat secara terprogram harus mendaftarkan project Cloud pilihan mereka ke Google sebelum menyiapkan notifikasi Pub/Sub untuk Android Management API. Untuk mengetahui detail selengkapnya, lihat Panduan untuk partner EMM yang ada.

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 [e-mail] untuk memublikasikan topik. Ada dua cara untuk memberikan hak publikasi:

a. Secara manual di Google Cloud Platform Console.

• Tambahkan [e-mail] 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:[e-mail] ke members.
• Tetapkan role ke roles/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 bentuk projects/{project}/topics/{topic}.
• enabledNotificationTypes: Menyertakan semua jenis notifikasi yang ingin Anda terima. Pilih dari ENROLLMENT, STATUS_REPORT, dan COMMAND.

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 dan STATUS_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.

Catatan: Saat menggunakan REST API Pub/Sub, kolom data dienkode sebagai string base64. Untuk mendapatkan JSON resource, pertama-tama lakukan decoding base64 pada konten data, lalu tafsirkan byte yang dihasilkan sebagai string UTF-8.