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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "conferenceRecord":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID"
  }
}
      

{
  "participantSession":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/participants/PARTICIPANT_ID/participantSessions/PARTICIPANT_SESSION_ID"
  }
}
      

{
  "recording":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/recordings/RECORDING_ID"
  }
}
      

{
  "smartNote":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/smartNotes/SMART_NOTE_ID"
  }
}
      

{
  "transcript":
  {
      "name": "conferenceRecords/CONFERENCE_RECORD_ID/transcripts/TRANSCRIPT_ID"
  }
}
      

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

หัวข้อที่เกี่ยวข้อง

• ภาพรวมของ Google Workspace Events API
• โครงสร้างของเหตุการณ์ Google Workspace
• เลือกขอบเขต Google Workspace Events API
• ภาพรวมของ REST API ของ Google Meet
• เลือกขอบเขต Meet REST API
• บทแนะนำ: สังเกตการณ์เหตุการณ์การประชุมด้วย Python และ REST API ของ Google Meet