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

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

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

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

กิจกรรม Meet ที่รองรับ

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

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

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

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

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

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

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

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

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

เมื่อสร้างการสมัครใช้บริการทรัพยากร Meet คุณจะใช้ฟิลด์ eventTypes[] เพื่อระบุประเภทเหตุการณ์ที่ต้องการรับ ประเภทเหตุการณ์จะได้รับการจัดรูปแบบตามข้อกำหนด CloudEvents เช่น google.workspace.APPLICATION.RESOURCE.VERSION.ACTION

เช่น หากต้องการรับเหตุการณ์เกี่ยวกับผู้เข้าร่วมใหม่ในการประชุมสำหรับพื้นที่ทำงาน Meet คุณจะต้องระบุประเภทเหตุการณ์เป็น google.workspace.meet.participant.v2.joined ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีทำงานของเหตุการณ์ได้ที่โครงสร้างของเหตุการณ์ใน Google Workspace

ตารางต่อไปนี้แสดงประเภทเหตุการณ์ที่รองรับสำหรับการสมัครใช้ทรัพยากรของ Meet

ประเภทเหตุการณ์ รูปแบบ ข้อมูลทรัพยากร
การประชุมจะเริ่มขึ้นในพื้นที่การประชุม google.meet.conference.v2.started conferenceRecord
การประชุมจะสิ้นสุดในพื้นที่การประชุม google.meet.conference.v2.ended conferenceRecord
ผู้เข้าร่วมเข้าร่วมการประชุมที่กำลังดำเนินอยู่ในพื้นที่การประชุม google.meet.participant.v2.joined conferenceRecord.participantSession
ผู้เข้าร่วมออกจากการประชุมที่กำลังดำเนินอยู่ในพื้นที่การประชุม google.meet.participant.v2.left conferenceRecord.participantSession
ระบบจะสร้างไฟล์บันทึกสำหรับการประชุมในพื้นที่การประชุม google.meet.recording.v2.fileGenerated conferenceRecord.recording
ระบบจะสร้างไฟล์ข้อความถอดเสียงสำหรับการประชุมในพื้นที่การประชุม google.meet.transcript.v2.fileGenerated conferenceRecord.transcript

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

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

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

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

ตารางต่อไปนี้แสดงตัวอย่างเพย์โหลด JSON สำหรับการสมัครใช้บริการพื้นที่การประชุม Meet ตัวอย่างใช้รหัสบันทึกการประชุม (เช่น conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ) เพื่อ ระบุพื้นที่การประชุม ดูข้อมูลเพิ่มเติมได้ที่วิธีที่ 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"
    }
}

ข้อจำกัด
  • ผู้ได้รับเชิญในปฏิทินและผู้เข้าร่วมอื่นๆ ที่ได้รับเชิญให้เข้าร่วมการประชุมจะได้รับเฉพาะเหตุการณ์ต่อไปนี้ google.workspace.meet.conference.v2.started และ google.workspace.meet.transcript.v2.fileGenerated