ตั้งค่าการแจ้งเตือน 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
ข. การใช้ Pub/Sub API (ดูสร้างเมธอดหัวข้อ)

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

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

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

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

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

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

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

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

b. การใช้ Pub/Sub API (ดูการควบคุมการเข้าถึงผ่าน 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 มีสิทธิ์เผยแพร่ในหัวข้อดังกล่าวและควรละเว้น

เวลาในการตอบสนองที่คาดไว้

เหตุการณ์ในอุปกรณ์ที่เกิดขึ้นติดต่อกันอย่างรวดเร็วจะได้รับการจัดกลุ่มและรายงานในข้อความ Pub/Sub เดียวไปยัง EMM

ประเภทเหตุการณ์ เวลาในการตอบสนองที่คาดไว้ระหว่างเหตุการณ์ในอุปกรณ์และการแจ้งเตือน EMM ที่เกี่ยวข้อง1
สถานะของแอปคีย์ที่มีลำดับความสำคัญสูง แบบทันที ไม่เกิน 1 ฉบับต่อนาที
สถานะแอปซึ่งผูกกับลำดับความสำคัญมาตรฐาน ภายใน 1 นาที
เหตุการณ์ที่เกี่ยวข้องกับแอปพลิเคชันในระหว่างการจัดสรร สำหรับแอปที่มีสถานะการติดตั้งที่กำหนดโดยผู้ดูแลระบบไอที2 ภายใน 1 นาที เพิ่มเติมจาก เหตุการณ์การจัดสรรอื่นๆ ที่เกี่ยวข้อง
เหตุการณ์ที่เกี่ยวข้องกับแอปพลิเคชันหลังจากการจัดสรร สำหรับแอปที่มีสถานะการติดตั้งที่กำหนดโดยผู้ดูแลระบบไอที ภายใน 5 นาที
เหตุการณ์ที่เกี่ยวข้องกับแอปพลิเคชันทั้งในระหว่างและหลังการจัดสรรสำหรับแอปที่มีสถานะการติดตั้งซึ่งพนักงานกำหนด3 ภายใน 60 นาที
เหตุการณ์อื่นๆ ของแอปในอุปกรณ์ ภายใน 60 นาที

  1. เป้าหมายความพยายามที่ดีที่สุดตามสถานการณ์ที่ควบคุม เวลาในการตอบสนองจริงอาจแตกต่างกันไปตามอุปกรณ์และปัจจัยทางสภาพแวดล้อม

  2. InstallType ของแอปที่บังคับใช้ในนโยบาย: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED และ KIOSK

  3. InstallType ของแอปที่พร้อมใช้งาน: AVAILABLE, INSTALL_TYPE_UNSPECIFIED