ติดตามกิจกรรมใน 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.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.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.started conferenceRecord.recording
การบันทึกการประชุมในพื้นที่การประชุมสิ้นสุดลง google.workspace.meet.recording.v2.ended conferenceRecord.recording
ระบบจะสร้างไฟล์บันทึกสำหรับการประชุมทางโทรศัพท์ในพื้นที่การประชุม google.workspace.meet.recording.v2.fileGenerated conferenceRecord.recording
โน้ตอัจฉริยะจะเริ่มทำงานสำหรับการประชุมในพื้นที่การประชุม google.workspace.meet.smartNote.v2.started conferenceRecord.smartNote
โน้ตอัจฉริยะจะสิ้นสุดลงสำหรับการประชุมในพื้นที่การประชุม google.workspace.meet.smartNote.v2.ended conferenceRecord.smartNote
ระบบจะสร้างไฟล์โน้ตอัจฉริยะสำหรับการประชุมทางโทรศัพท์ในพื้นที่การประชุม google.workspace.meet.smartNote.v2.fileGenerated conferenceRecord.smartNote
การถอดเสียงเป็นคำจะเริ่มขึ้นสำหรับการประชุมในพื้นที่การประชุม google.workspace.meet.transcript.v2.started conferenceRecord.transcript
การถอดเสียงเป็นคำสำหรับการประชุมในพื้นที่การประชุมสิ้นสุดลง google.workspace.meet.transcript.v2.ended conferenceRecord.transcript
ระบบจะสร้างไฟล์ข้อความถอดเสียงสำหรับการประชุมในพื้นที่การประชุม google.workspace.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
  • google.workspace.meet.conference.v2.ended

ไม่รวมข้อมูลทรัพยากร:

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

ผู้เข้าร่วมเข้าร่วมหรือออกจากการประชุมในพื้นที่การประชุม Meet

  • google.workspace.meet.participant.v2.joined
  • google.workspace.meet.participant.v2.left

ไม่รวมข้อมูลทรัพยากร:

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

การบันทึกเริ่มต้น สิ้นสุด หรือมีการสร้างไฟล์สำหรับการประชุมในพื้นที่การประชุม Meet

  • google.workspace.meet.recording.v2.started
  • google.workspace.meet.recording.v2.ended
  • google.workspace.meet.recording.v2.fileGenerated

ไม่รวมข้อมูลทรัพยากร:

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

โน้ตอัจฉริยะเริ่มต้น สิ้นสุด หรือมีการสร้างไฟล์สำหรับการประชุมในพื้นที่การประชุม Meet

  • google.workspace.meet.smartNote.v2.started
  • google.workspace.meet.smartNote.v2.ended
  • google.workspace.meet.smartNote.v2.fileGenerated

ไม่รวมข้อมูลทรัพยากร:

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

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

  • google.workspace.meet.transcript.v2.started
  • google.workspace.meet.transcript.v2.ended
  • 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