ตั้งค่าการแจ้งเตือน Pub/Sub

การแจ้งเตือน Pub/Sub มอบวิธีที่คุณได้รับการแจ้งเตือนเกี่ยวกับอุปกรณ์ที่ลงทะเบียนใหม่ รายงานอุปกรณ์ และคำสั่งที่เพิ่งออก

หากต้องการตั้งค่าการแจ้งเตือน Pub/Sub คุณจะต้องเปิดใช้ Pub/Sub API และสร้างหัวข้อ หากต้องการรับข้อความที่เผยแพร่ไปยังหัวข้อหนึ่ง ให้สร้างการสมัครใช้บริการหัวข้อนั้น การสมัครใช้บริการจะเชื่อมต่อหัวข้อกับแอปพลิเคชันผู้สมัครใช้บริการที่รับและประมวลผลข้อความที่เผยแพร่ไปยังหัวข้อ หลังจากสร้างการสมัครใช้บริการแล้ว คุณต้องให้สิทธิ์ Android Device Policy ในการเผยแพร่ไปยังหัวข้อของคุณ

1. เปิดใช้ Pub/Sub API สำหรับโปรเจ็กต์

ดูวิธีเปิดใช้ Pub/Sub API ได้ที่คู่มือเริ่มใช้งานคอนโซลฉบับย่อ ตรวจสอบว่าคุณเลือกโปรเจ็กต์เดียวกันที่เปิดใช้ Android Management API

2. สร้างหัวข้อ

หลังจากเปิดใช้ API แล้ว คุณต้องสร้างหัวข้อที่ Android Device Policy สามารถเผยแพร่การแจ้งเตือนได้ การสร้างหัวข้อทำได้ 2 วิธีดังนี้

a. ดำเนินการด้วยตนเองในคอนโซล Google Cloud Platform
ข. การใช้ Pub/Sub API (ดูสร้าง topicmethod)

หลังจากที่สร้างหัวข้อ ให้จดชื่อหัวข้อไว้

3. สร้างการสมัครใช้บริการ

การสมัครสมาชิกจะบันทึกสตรีมของข้อความที่เผยแพร่แล้วไปยังหัวข้อที่เฉพาะเจาะจง คุณสร้างการสมัครใช้บริการได้ 2 วิธี

a. ดำเนินการด้วยตนเองในคอนโซล Google Cloud Platform
ข. การใช้ Pub/Sub API (ดูสร้างวิธีการสมัครใช้บริการ)

4. ให้สิทธิ์ Android Device Policy ในการเผยแพร่ในหัวข้อของคุณ

คุณต้องให้สิทธิ์ android-cloud-policy@system.gserviceaccount.com เผยแพร่หัวข้อ คุณสามารถให้สิทธิ์การเผยแพร่ได้ 2 วิธีดังนี้

a. ดำเนินการด้วยตนเองในคอนโซล Google Cloud Platform

  • เพิ่ม android-cloud-policy@system.gserviceaccount.com เป็นสมาชิกในหัวข้อ
  • คลิกเลือกบทบาท > Pub/Sub > ผู้เผยแพร่โฆษณา Pub/Sub

b. การใช้ Pub/Sub API (โปรดดูการควบคุมการเข้าถึงผ่าน Google Cloud Pub/Sub IAM API)

  • เพิ่ม serviceAccount:android-cloud-policy@system.gserviceaccount.com ไปยัง members
  • ตั้งค่า role เป็น roles/pubsub.publisher

5. อัปเดตองค์กรเพื่อรองรับการแจ้งเตือน

หากต้องการเชื่อมต่อการแจ้งเตือนเกี่ยวกับองค์กรกับหัวข้อที่คุณสร้างขึ้น ให้เรียกใช้ enterprises.patch และระบุพารามิเตอร์ต่อไปนี้

  • pubsubTopic: ชื่อหัวข้อ Pub/sub ในแบบฟอร์ม projects/{project}/topics/{topic}
  • enabledNotificationTypes: ระบุประเภทการแจ้งเตือนทั้งหมดที่คุณต้องการรับ เลือกจาก ENROLLMENT, STATUS_REPORT และ COMMAND

6. ใช้ Pub/Sub API เพื่อรับการแจ้งเตือน

การสมัครใช้บริการสามารถใช้กลไกพุชหรือพุลสำหรับการส่งข้อความ คุณสามารถดูหลักเกณฑ์และคำแนะนำเกี่ยวกับวิธีรับการแจ้งเตือนผ่านทั้ง 2 วิธีนี้ได้ในคู่มือสมาชิก Pub/Sub

รูปแบบข้อความ

ข้อความจะอยู่ในรูปแบบ PubsubMessage ช่อง attributes ของข้อความมีแอตทริบิวต์ที่มีคีย์ notificationType และค่าที่กำหนดเป็นประเภทการแจ้งเตือนที่ทริกเกอร์ข้อความ (เช่น ENROLLMENT) ช่อง data ของข้อความมีการแสดงแทน JSON ของทรัพยากรที่อัปเดต โดยเข้ารหัสเป็นสตริง UTF-8 การแจ้งเตือนและประเภททรัพยากรที่เกี่ยวข้องมีดังนี้

  • การแจ้งเตือน COMMAND ใช้ประเภททรัพยากร การดำเนินการ
  • การแจ้งเตือน USAGE_LOGS ใช้ประเภททรัพยากร UsageLogEvent
  • การแจ้งเตือนของ ENROLLMENT และ STATUS_REPORT จะใช้ประเภททรัพยากร อุปกรณ์

เมื่อตั้งค่า pubsubTopic ใน Enterprise ระบบจะเผยแพร่ข้อความเริ่มต้นโดยตั้งค่า notificationType เป็น test ข้อความนี้จะส่งเพื่อยืนยันว่า Android Device Policy มีสิทธิ์เผยแพร่ในหัวข้อดังกล่าวและควรละเว้น