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

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับการพัฒนาแอปสำหรับ 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"
    }
}