หน้านี้จะอธิบายถึงกิจกรรมใน Google Meet ที่แอปของคุณสามารถสมัครรับข้อมูลได้โดยใช้ Google Workspace Events API หลังจากตัดสินใจเลือกประเภทกิจกรรมที่ต้องการแล้ว ให้สร้างการสมัครใช้บริการเพื่อเริ่มรับกิจกรรมจาก Google Meet
หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาแอปสำหรับ Google Meet โปรดดูภาพรวม API ของ REST สำหรับ Google Meet
ทรัพยากรเป้าหมายของ Meet ที่รองรับ
หากต้องการรับกิจกรรมใน Meet ทาง Google Workspace Events API รองรับการสมัครใช้บริการทรัพยากรต่อไปนี้
- พื้นที่จัดการประชุม ซึ่งแสดงเป็นทรัพยากร
space
- ผู้ใช้ซึ่งแสดงเป็นทรัพยากร
user
ของ Cloud Identity API
กิจกรรมใน Meet ที่รองรับ
การสมัครใช้บริการ Google Workspace จะให้คุณได้รับกิจกรรมเกี่ยวกับการเปลี่ยนแปลงประเภทต่อไปนี้ใน Meet
- การประชุมจะเริ่มหรือสิ้นสุดในพื้นที่ประชุม
- ผู้เข้าร่วมเข้าร่วมหรือออกจากการประชุม
- ระบบจะสร้างการบันทึกสำหรับการประชุม
- ระบบจะสร้างข้อความถอดเสียงสำหรับการประชุม
เมื่อสร้างการสมัครใช้บริการทรัพยากรของ Meet คุณจะใช้ช่อง eventTypes[]
เพื่อระบุประเภทกิจกรรมที่ต้องการรับ ประเภทเหตุการณ์จะได้รับการจัดรูปแบบตามข้อกำหนดของ CloudEvents เช่น google.workspace.APPLICATION.RESOURCE.VERSION.ACTION
ตัวอย่างเช่น หากต้องการรับกิจกรรมเกี่ยวกับผู้เข้าร่วมรายใหม่ในการประชุมสำหรับพื้นที่ใน Meet ให้ระบุประเภทกิจกรรมเป็น google.workspace.meet.participant.v2.joined
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของกิจกรรมได้ในโครงสร้างของกิจกรรมใน Google Workspace
ตารางต่อไปนี้แสดงประเภทเหตุการณ์ที่รองรับ คำอธิบาย และทรัพยากร Meet ที่เปลี่ยนแปลงซึ่งแสดงในข้อมูลเหตุการณ์
ประเภทเหตุการณ์ | คำอธิบาย | แหล่งข้อมูลของ Meet |
---|---|---|
|
การประชุมจะเริ่มในพื้นที่ประชุม |
|
|
การประชุมจะสิ้นสุดลงในพื้นที่ประชุม |
|
|
ผู้เข้าร่วมเข้าร่วมการประชุมที่ยังดำเนินอยู่ในพื้นที่การประชุม |
|
|
ผู้เข้าร่วมออกจากการประชุมที่ยังดำเนินอยู่ในพื้นที่ประชุม |
|
|
ระบบจะสร้างไฟล์บันทึกสำหรับการประชุมในพื้นที่ประชุม |
|
|
ระบบจะสร้างไฟล์ข้อความถอดเสียงสำหรับการประชุมในพื้นที่ประชุม |
|
ข้อมูลเหตุการณ์
ส่วนนี้จะอธิบายถึงข้อมูลกิจกรรมและตัวอย่างเพย์โหลดสำหรับกิจกรรมในพื้นที่การประชุมของ Meet
เมื่อการสมัครใช้บริการ Google Workspace ได้รับเหตุการณ์จาก Meet ช่อง data
จะมีเพย์โหลดสำหรับกิจกรรมดังกล่าว เพย์โหลดนี้มีข้อมูลเกี่ยวกับทรัพยากร Google Workspace ที่มีการเปลี่ยนแปลง เช่น หากคุณสมัครรับข้อมูลกิจกรรมเกี่ยวกับข้อความถอดเสียงใหม่ในพื้นที่ทำงาน เพย์โหลดของเหตุการณ์เหล่านี้จะมีข้อมูลเกี่ยวกับทรัพยากร transcript
ที่มีการเปลี่ยนแปลง
ข้อมูลทรัพยากรในเพย์โหลดเหตุการณ์
ตารางต่อไปนี้มีตัวอย่างของเพย์โหลด JSON สำหรับการสมัครใช้บริการพื้นที่ประชุม Meet ตัวอย่างข้างต้นใช้การประชุม conferenceRecords/AAA-BBB-CCC-DDD-EEE
ที่เกิดขึ้นในพื้นที่ทำงาน สำหรับแต่ละเหตุการณ์ที่การสมัครใช้บริการได้รับ เพย์โหลดจะปรากฏในช่อง data
ของเหตุการณ์ ดังนี้
ตัวอย่าง | ประเภทเหตุการณ์ | เพย์โหลด JSON |
---|---|---|
การประชุมจะเริ่มสำหรับพื้นที่ประชุมของ Meet |
|
ไม่รวมข้อมูลทรัพยากร
{ "conferenceRecord": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE" } } |
ผู้เข้าร่วมเข้าร่วมการประชุมในพื้นที่ประชุมของ Meet |
|
ไม่รวมข้อมูลทรัพยากร
{ "participantSession": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/participants/FFF-GGG-HHH-III-JJJ/participantSessions/LLL-MMM-NNN-OOO-PPP" } } |
ระบบจะสร้างไฟล์บันทึกสำหรับการประชุมในพื้นที่ประชุมของ Meet | google.workspace.meet.recording.v2.fileGenerated |
ไม่รวมข้อมูลทรัพยากร
{ "recording": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/recordings/LLL-MMM-NNN-OOO-PPP" } } |
ระบบจะสร้างข้อความถอดเสียงสำหรับการประชุมในพื้นที่ประชุมของ Meet | google.workspace.meet.transcript.v2.fileGenerated |
ไม่รวมข้อมูลทรัพยากร
{ "transcript": { "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE/transcripts/PPP-QQQ-RRR-SSS-TTT" } } |