ติดตามกิจกรรมใน Google Meet

หน้านี้จะอธิบายถึงกิจกรรมใน 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

google.workspace.meet.conference.v2.started

การประชุมจะเริ่มในพื้นที่ประชุม

conferenceRecord

google.workspace.meet.conference.v2.ended

การประชุมจะสิ้นสุดลงในพื้นที่ประชุม

conferenceRecord

google.workspace.meet.participant.v2.joined

ผู้เข้าร่วมเข้าร่วมการประชุมที่ยังดำเนินอยู่ในพื้นที่การประชุม

conferenceRecord.participantSession

google.workspace.meet.participant.v2.left

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

conferenceRecord.participantSession

google.workspace.meet.recording.v2.fileGenerated

ระบบจะสร้างไฟล์บันทึกสำหรับการประชุมในพื้นที่ประชุม

conferenceRecord.recording

google.workspace.meet.transcript.v2.fileGenerated

ระบบจะสร้างไฟล์ข้อความถอดเสียงสำหรับการประชุมในพื้นที่ประชุม

conferenceRecord.transcript

ข้อมูลเหตุการณ์

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

เมื่อการสมัครใช้บริการ Google Workspace ได้รับเหตุการณ์จาก Meet ช่อง data จะมีเพย์โหลดสำหรับกิจกรรมดังกล่าว เพย์โหลดนี้มีข้อมูลเกี่ยวกับทรัพยากร Google Workspace ที่มีการเปลี่ยนแปลง เช่น หากคุณสมัครรับข้อมูลกิจกรรมเกี่ยวกับข้อความถอดเสียงใหม่ในพื้นที่ทำงาน เพย์โหลดของเหตุการณ์เหล่านี้จะมีข้อมูลเกี่ยวกับทรัพยากร transcript ที่มีการเปลี่ยนแปลง

ข้อมูลทรัพยากรในเพย์โหลดเหตุการณ์

ตารางต่อไปนี้มีตัวอย่างของเพย์โหลด JSON สำหรับการสมัครใช้บริการพื้นที่ประชุม Meet ตัวอย่างข้างต้นใช้การประชุม conferenceRecords/AAA-BBB-CCC-DDD-EEE ที่เกิดขึ้นในพื้นที่ทำงาน สำหรับแต่ละเหตุการณ์ที่การสมัครใช้บริการได้รับ เพย์โหลดจะปรากฏในช่อง data ของเหตุการณ์ ดังนี้

ตัวอย่าง ประเภทเหตุการณ์ เพย์โหลด JSON

การประชุมจะเริ่มสำหรับพื้นที่ประชุมของ Meet

google.workspace.meet.conference.v2.started

ไม่รวมข้อมูลทรัพยากร
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/AAA-BBB-CCC-DDD-EEE"
    }
}
ผู้เข้าร่วมเข้าร่วมการประชุมในพื้นที่ประชุมของ Meet

google.workspace.meet.participant.v2.joined

ไม่รวมข้อมูลทรัพยากร
{
    "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"
    }
}