ติดตามกิจกรรมใน 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 ใน REST API ของ Meet โปรดดูรายละเอียดที่หัวข้อ วิธี ที่ 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) เพื่อระบุพื้นที่การประชุม ดูข้อมูลเพิ่มเติมได้ที่วิธีที่ Meet ระบุพื้นที่ การประชุม

สำหรับแต่ละเหตุการณ์ที่การสมัครรับข้อมูลได้รับ เพย์โหลดจะปรากฏในฟิลด์ data ของเหตุการณ์

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

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

google.workspace.meet.conference.v2.started
ไม่รวมข้อมูลทรัพยากร
{
    "conferenceRecord":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID"
    }
}
ผู้เข้าร่วมเข้าร่วมการประชุมในพื้นที่การประชุมของ Meet

google.workspace.meet.participant.v2.joined
ไม่รวมข้อมูลทรัพยากร
{
    "participantSession":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
    }
}
ระบบจะสร้างการบันทึกสำหรับการประชุมในพื้นที่การประชุม Meet google.workspace.meet.recording.v2.fileGenerated
ไม่รวมข้อมูลทรัพยากร
{
    "recording":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
    }
}
ระบบจะสร้างข้อความถอดเสียงสำหรับการประชุมในพื้นที่การประชุม Meet google.workspace.meet.transcript.v2.fileGenerated
ไม่รวมข้อมูลทรัพยากร
{
    "transcript":
    {
        "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
    }
}