การแจ้งเตือน 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 มีสิทธิ์เผยแพร่ในหัวข้อดังกล่าวและควรละเว้น