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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาแอปสําหรับ Google Meet ได้ที่ภาพรวมของ REST API ของ Google Meet

เหตุการณ์ของ Meet ที่รองรับ

การสมัครใช้บริการ Google Workspace ช่วยให้คุณได้รับเหตุการณ์เกี่ยวกับการเปลี่ยนแปลงประเภทต่อไปนี้ใน Meet

ทรัพยากรที่คุณสามารถตรวจสอบเหตุการณ์ได้

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

Google Workspace Events API รองรับทรัพยากรเป้าหมายต่อไปนี้สำหรับ Meet

ทรัพยากรเป้าหมาย รูปแบบ ข้อจำกัด (หากมี)
พื้นที่การประชุม //meet.googleapis.com/spaces/SPACE

โดยที่ SPACE คือรหัสใน ชื่อทรัพยากรของทรัพยากร space ใน Meet REST API โปรดดูรายละเอียดที่หัวข้อวิธีที่ Meet ระบุพื้นที่การประชุม
ผู้ใช้ //cloudidentity.googleapis.com/users/USER

โดยที่ USER คือรหัสในช่อง signedinUser.user ของทรัพยากร participant ใน Meet REST API โปรดดูรายละเอียดที่หัวข้อทำงานร่วมกับผู้เข้าร่วม

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

  • เจ้าของพื้นที่จัดประชุม
  • ผู้จัดการกิจกรรมใน Google ปฏิทินที่เชื่อมโยงกับพื้นที่การประชุม

ประเภทเหตุการณ์สําหรับการสร้างการสมัครใช้บริการ

เมื่อสร้างการสมัครใช้บริการทรัพยากร 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"
    }
}