ตอบกลับกิจกรรมจาก Google Meet

เอกสารนี้อธิบายวิธีรับและตอบกลับเหตุการณ์ Google Meet จาก Google Cloud Pub/Sub

กิจกรรมใน Meet แสดงถึงกิจกรรมหรือการเปลี่ยนแปลงในทรัพยากรของ Meet เช่น การสร้างการประชุมใหม่ คุณสามารถใช้เหตุการณ์ เพื่อทําความเข้าใจสิ่งที่เกิดขึ้น แล้วดําเนินการ หรือตอบสนองในลักษณะที่มีความหมาย สําหรับผู้ใช้

ตัวอย่างวิธีใช้เหตุการณ์มีดังนี้

  • สังเกตและตอบสนองต่อการเปลี่ยนแปลงในการประชุม เช่น เมื่อการประชุมเริ่ม หรือสิ้นสุด

  • ติดตามผู้เข้าร่วมการประชุมเพื่อวัตถุประสงค์ด้านกฎระเบียบหรือการฝึกอบรม

  • ฟังข้อความถอดเสียงการประชุมเพื่อให้ระบบแยกวิเคราะห์เนื้อหาไฟล์และ บันทึกลงใน CRM หรือฐานข้อมูลได้

วิธีการทำงานของกิจกรรม

เมื่อใดก็ตามที่เกิดเหตุการณ์ใน Google Meet ระบบจะสร้างหรืออัปเดตทรัพยากร REST API ของ Google Meet Meet ใช้เหตุการณ์เพื่อส่งข้อมูลไปยังแอปของคุณ เกี่ยวกับประเภทกิจกรรมที่เกิดขึ้นและทรัพยากร Meet REST API ที่ได้รับผลกระทบ

ตัวอย่างวิธีที่พื้นที่การประชุมใหม่ทริกเกอร์เหตุการณ์
รูปที่ 1 ผู้ใช้สร้างพื้นที่การประชุม ซึ่งจะสร้างSpaceทรัพยากร จากนั้น Meet จะสร้างกิจกรรม ที่มีข้อมูลเกี่ยวกับพื้นที่การประชุมใหม่

Meet จัดหมวดหมู่กิจกรรมตามประเภท ประเภทเหตุการณ์ช่วยให้คุณกรองและ รับเฉพาะข้อมูลประเภทที่ต้องการได้ และช่วยให้คุณจัดการกิจกรรมที่คล้ายกัน ในลักษณะเดียวกันได้

ตัวอย่างต่อไปนี้แสดงให้เห็นว่ากิจกรรมใน Meet ส่งผลต่อ แหล่งข้อมูล Meet REST API ที่เกี่ยวข้องอย่างไร และประเภทเหตุการณ์ที่แอป Meet ได้รับ

กิจกรรม ทรัพยากร REST API ของ Meet ประเภทของกิจกรรม
ผู้ใช้เข้าร่วมพื้นที่การประชุม สร้างทรัพยากร ConferenceRecord สถิติใหม่ของคอนเฟอเรนซ์

รับข้อมูลเหตุการณ์จาก Google Meet

หากต้องการรับข้อมูลเหตุการณ์ แอปของคุณสามารถทำอย่างใดอย่างหนึ่งต่อไปนี้

ตารางต่อไปนี้อธิบายความแตกต่างและเหตุผลในการติดตาม เหตุการณ์เทียบกับการค้นหาเหตุการณ์

สมัครรับข้อมูลกิจกรรม ค้นหาข้อมูล
กรณีการใช้งาน
  • ประมวลผลหรือตอบสนองต่อเหตุการณ์แบบเรียลไทม์
  • ตรวจสอบการเปลี่ยนแปลงในทรัพยากรเพื่อปรับปรุงประสิทธิภาพของแอป
  • ดึงข้อมูลด้วยตนเอง
  • ดึงข้อมูลทั้งหมดจาก Meet (เนื่องจากบริการหยุดทำงานหรือการสมัครใช้บริการไม่ทำงาน)
API Google Workspace Events API REST API ของ Meet
แหล่งที่มาของเหตุการณ์ สถิติสายและผู้ใช้ บันทึกพื้นที่ทำงานและการประชุม
เหตุการณ์ที่รองรับ บันทึกการประชุม

ดูรายการประเภทกิจกรรมที่รองรับได้ที่ ประเภทกิจกรรมสำหรับการสร้างการสมัครใช้บริการใน เอกสารประกอบของ Google Workspace Events API 		บันทึกพื้นที่ทำงานและการประชุม

ดูรายการปลายทางที่รองรับได้ในแหล่งข้อมูล Space และแหล่งข้อมูล ConferenceRecord ในเอกสารประกอบ REST API ของ Meet
รูปแบบกิจกรรม ข้อความ Google Cloud Pub/Sub ที่จัดรูปแบบตามข้อกำหนดของ CloudEvent โปรดดูรายละเอียดที่หัวข้อ โครงสร้างของกิจกรรมใน Google Workspace ทรัพยากร REST API ของ Meet (Space และ ConferenceRecord)
ข้อมูลเหตุการณ์ สตริงที่เข้ารหัส Base64 ที่มีหรือไม่มีข้อมูลทรัพยากร ดูเพย์โหลดตัวอย่างได้ที่ข้อมูลเหตุการณ์ เพย์โหลด JSON ที่มีข้อมูลทรัพยากร ดูตัวอย่างเพย์โหลดได้ที่แหล่งข้อมูล ConferenceRecord ในเอกสารอ้างอิง

ตัวอย่าง: ดึงข้อมูลกิจกรรมเกี่ยวกับผู้เข้าร่วมในพื้นที่การประชุม

ในตัวอย่างนี้ แอป Meet ต้องการรับข้อมูลเกี่ยวกับการเปลี่ยนแปลงผู้เข้าร่วมในพื้นที่การประชุม ในพื้นที่การประชุม ผู้เข้าร่วม จะเข้าร่วมการประชุมที่กำลังดำเนินอยู่ ซึ่งจะสร้าง ParticipantSession ทรัพยากรและทริกเกอร์กิจกรรมใหม่ จากนั้นคุณจะดูข้อมูลเกี่ยวกับเหตุการณ์เหล่านี้ได้ โดยใช้วิธีการ subscribe หรือ query

สมัครรับข้อมูลกิจกรรม

หากต้องการรับเหตุการณ์แบบเรียลไทม์ แอป Meet จะเรียกใช้เมธอด Google Workspace Events API subscriptions.create เพื่อสมัครรับข้อมูลพื้นที่การประชุมสำหรับเหตุการณ์ทุกประเภท หลังจากสร้างการสมัครใช้บริการแล้ว แอป Meet จะเริ่มรับเหตุการณ์ได้

แอป Meet ที่สมัครรับข้อมูลกิจกรรมของผู้เข้าร่วมโดยใช้ Google Workspace Events API
รูปที่ 2 แอป Meet จะได้รับ เหตุการณ์ของผู้เข้าร่วมผ่านการสมัครใช้บริการโดยใช้ Google Workspace Events API

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

ดูข้อมูลเกี่ยวกับการสร้างการสมัครรับข้อมูลโดยใช้ Google Workspace Events API ได้ที่เอกสารประกอบของ Google Workspace Events API

ค้นหาเหตุการณ์ล่าสุด

นอกจากจะรับเหตุการณ์เมื่อเกิดขึ้นแล้ว แอป Meet ยังเรียกใช้ Meet REST API เพื่อแสดงเหตุการณ์ในพื้นที่การประชุมล่าสุดที่เกี่ยวข้องกับกิจกรรมของผู้เข้าร่วมได้ด้วย

แอป Meet ที่ค้นหาเหตุการณ์ของผู้เข้าร่วมโดยใช้ Meet REST API
รูปที่ 3 แอป Meet จะได้รับ เหตุการณ์ผู้เข้าร่วมล่าสุดโดยการค้นหาเหตุการณ์พื้นที่การประชุมโดยใช้ REST API ของ Meet

ในรูปที่ 3 แอป Meet จะเรียกใช้ REST API ของ Meet conferenceRecords.participants.participantSessions.list หลังจากที่กิจกรรมเซสชันของผู้เข้าร่วมทั้งหมดเกิดขึ้นแล้ว Meet REST API จะแสดงรายการParticipantSessionทรัพยากรที่ แสดงถึงการเปลี่ยนแปลงแต่ละรายการ จากนั้นแอป Meet จะประมวลผลหรือ ตอบกลับตามกิจกรรมล่าสุด เช่น การสร้างรายชื่อผู้เข้าร่วม ที่เข้าร่วมและออกจากห้องประชุม

หากต้องการค้นหาเหตุการณ์โดยใช้ Meet REST API โปรดดูแสดงรายการเซสชันของผู้เข้าร่วมทั้งหมด

ข้อจำกัด
  • ผู้ได้รับเชิญในปฏิทินและผู้เข้าร่วมอื่นๆ ที่ได้รับเชิญให้เข้าร่วมการประชุมจะได้รับเฉพาะเหตุการณ์ต่อไปนี้ google.workspace.meet.conference.v2.started และ google.workspace.meet.transcript.v2.fileGenerated