ภาพรวมของ REST API ของ Google Meet

Google Meet REST API ช่วยให้คุณสร้างและจัดการการประชุมสำหรับ Google Meet และ มีจุดแรกเข้าสำหรับผู้ใช้โดยตรงจากแอปของคุณ

Meet REST API ช่วยให้คุณทำสิ่งต่อไปนี้ได้

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

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

กรณีการใช้งาน

แอปสามารถผสานรวมกับ Meet REST API เพื่อทำงานต่อไปนี้ได้

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

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

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

ตัวอย่างสิ่งที่คุณอาจต้องการใช้ REST API ของ Meet มีดังนี้

  • การขายและการจัดการลูกค้า

    • เรียกข้อมูลการประชุมและผู้เข้าร่วมเพื่อบันทึก
    • ดึงข้อมูลอาร์ติแฟกต์การประชุมและโพสต์ในบัญชี
    • เรียกใช้การถอดเสียงและการบันทึกผ่านโมเดล AI เพื่อสร้างการวิเคราะห์การฝึกสอน และประสิทธิภาพการขาย

  • การเรียนรู้และการพัฒนา

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

  • การสนับสนุนลูกค้าและการให้คำปรึกษา

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

  • การปฏิบัติงานของนักพัฒนาแอป

    • สร้างการประชุมเพื่อเชื่อมต่อกับเพื่อนร่วมทีมได้ทันที
    • อนุญาตให้ผู้มีส่วนเกี่ยวข้องอื่นๆ เข้าร่วมการประชุมที่กำลังดำเนินอยู่โดยแชร์ข้อมูลการประชุมและผู้เข้าร่วมแบบเรียลไทม์
    • เรียกใช้ข้อมูลการถอดเสียงผ่านโมเดล AI เพื่อสร้างขั้นตอนถัดไปที่ถูกต้อง
สร้างและเข้าร่วมการประชุมแบบไดนามิกกับเพื่อนร่วมงานภายในพื้นที่ใน Chat
รูปที่ 1 สร้างและเข้าร่วมการประชุมแบบไดนามิกกับเพื่อนร่วมงานภายในพื้นที่ใน Chat

นอกจากนี้ คุณยังรวม API อื่นๆ ของ Google Workspace เช่น Chat API เข้ากับแอปเพื่อยกระดับการทำงานร่วมกันได้อีกด้วย ดูข้อมูลเพิ่มเติมได้ที่กรณีการใช้งานแชท

คำทั่วไป

รายการคำศัพท์ทั่วไปที่ใช้ใน API นี้มีดังนี้

การประชุมที่ใช้งานอยู่
การประชุมที่กำลังดำเนินอยู่ภายในพื้นที่การประชุม โดยในแต่ละครั้งจะมีการประชุมที่ใช้งานได้เพียงรายการเดียวในพื้นที่การประชุม เมื่อสิ้นสุดแล้ว วิดีโอจะกลายเป็นบันทึกการประชุม
อาร์ติแฟกต์
ไฟล์ที่ Meet สร้างขึ้นเพื่อตอบสนองต่อการประชุม เช่น recordings และ transcripts ระบบจะบันทึกอาร์ติแฟกต์ไว้ในไดรฟ์ของผู้จัดการประชุม โดยปกติแล้ว คุณจะดึงข้อมูลได้หลังจากที่ การประชุมสิ้นสุดลงไม่นาน
กิจกรรมในปฏิทิน
กิจกรรมใน Google ปฏิทินที่มีผู้เข้าร่วมหลายคน ซึ่งโดยปกติจะสร้างโดยผู้จัดการประชุมที่มีข้อมูลการเข้าร่วมการประชุม Meet อาจเป็นโซลูชันการประชุมสำหรับกิจกรรม
โทร
เซสชันที่ใช้ Meet หรือเพื่อแจ้งให้ผู้อื่นทราบว่าการโทรกำลังจะเริ่มหรือกำลังดำเนินการอยู่ และอนุญาตให้ผู้อื่นเข้าร่วมได้ทันที
ผู้ร่วมจัดการประชุม
บุคคลในการโทรที่ได้รับสิทธิ์การจัดการสำหรับผู้จัดการประชุมจากผู้จัดการประชุม ยกเว้นความสามารถในการนำผู้จัดการประชุมรายเดิมออก
การประชุม
การประชุมคืออินสแตนซ์ของการโทรภายในพื้นที่การประชุม ผู้ใช้ มักจะถือว่าสถานการณ์นี้เป็นการประชุมเดียว
สถิติสาย
รหัสที่ไม่ซ้ำกันสำหรับแต่ละอินสแตนซ์ของการประชุม ระบบจะสร้างโดยอัตโนมัติ เมื่อการประชุมเริ่มขึ้น แหล่งข้อมูล conferenceRecords ใช้รูปแบบ conferenceRecords/{conferenceRecord} เช่น conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ
โทรเข้า
หากต้องการใช้โทรศัพท์เพื่อเข้าร่วมการโทรหรือฟังการโทรที่สตรีม
โฮสต์
ผู้ที่สร้างการโทร (ผู้จัดการประชุม) หรือผู้ที่ควบคุมการโทร โปรดทราบว่าผู้จัดการประชุมสามารถจัดการประชุมได้ แต่ไม่จำเป็นต้องเข้าร่วมเมื่อมีการประชุม ผู้จัดยังมอบสิทธิ์ของผู้จัด ให้กับผู้ร่วมจัดการประชุมได้ด้วย
รหัสการประชุม

สตริงแบบ 10 อักขระที่ไม่ซ้ำกันซึ่งพิมพ์ได้สำหรับพื้นที่การประชุมที่ใช้ภายใน URI ของการประชุมในพื้นที่การประชุม ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เช่น abc-mnop-xyz ความยาวสูงสุดคือ 128 อักขระ

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

ชื่อการประชุม

รหัสที่ไม่ซ้ำกันที่เซิร์ฟเวอร์สร้างขึ้นซึ่งใช้เพื่อระบุพื้นที่การประชุม โดยคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เช่น jQCFfuBOdN5z ระบบจะแสดงรหัสการประชุมในฟิลด์ name ของทรัพยากร spaces ดูข้อมูลเพิ่มเติมได้ที่วิธีที่ Meet ระบุพื้นที่ การประชุม

ผู้จัดการประชุม

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

พื้นที่การประชุม

สถานที่เสมือนหรือออบเจ็กต์ถาวร (เช่น ห้องประชุม) ที่ใช้จัดการประชุม คุณจัดการประชุมที่ใช้งานอยู่ได้เพียงครั้งละ 1 รายการในพื้นที่หนึ่งๆ นอกจากนี้ พื้นที่การประชุมยังช่วยให้ผู้ใช้ประชุมและค้นหาทรัพยากรที่แชร์ได้ด้วย

URI ของการประชุม

URL ที่คลิกได้ซึ่งเริ่มหรือนำผู้ใช้ไปยังการโทร การโทรแต่ละครั้งจะมี URL ที่ไม่ซ้ำกันซึ่งประกอบด้วย https://meet.google.com/ ตามด้วยรหัสการประชุม ตัวอย่างเช่น https://meet.google.com/abc-mnop-xyz

สมาชิก

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

ผู้เข้าร่วม

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

เซสชันของผู้เข้าร่วม

รหัสเซสชันที่ไม่ซ้ำกันซึ่งสร้างขึ้นสำหรับคู่ผู้เข้าร่วม-อุปกรณ์แต่ละคู่ที่เข้าร่วมการโทร โดยจะมีparticipantSessions ทรัพยากร 1 รายการต่อเซสชัน หากผู้เข้าร่วมเข้าร่วมการโทรเดียวกันหลายครั้งจากคู่ผู้เข้าร่วม-อุปกรณ์เดียวกัน ระบบจะกำหนดรหัสเซสชันที่ไม่ซ้ำกันให้แต่ละครั้ง

การบันทึก

ไฟล์วิดีโอ MP4 และข้อมูลเมตาที่เกี่ยวข้องซึ่งสร้างขึ้นเมื่อมีการบันทึกการประชุม ระบบจะบันทึกไฟล์วิดีโอการประชุมไว้ในไดรฟ์ของผู้จัดการประชุม และสามารถดึงข้อมูลเป็นอาร์ติแฟกต์การประชุมได้

ที่อยู่ SIP

รายละเอียดที่อยู่ Session Initiation Protocol (SIP) จะอธิบายวิธีที่ฮาร์ดแวร์การประชุมทางวิดีโอของบุคคลที่สามค้นหาและ เข้าร่วมการประชุมใน Meet Meet รองรับสคีม URI ของ SIP

ข้อความถอดเสียง

เอกสารข้อความที่บันทึกการสนทนาที่พูดจากการประชุม ซึ่งส่งออกไปยังไดรฟ์ของผู้จัดการประชุมเป็นไฟล์เอกสาร ใน Google เอกสาร

การป้อนข้อความถอดเสียง

ส่วนที่แยกออกมาของคำพูดที่ถอดเสียงจากผู้เข้าร่วมในการประชุม แต่ละรายการจะมีข้อมูลระบุตัวตนของผู้เข้าร่วม การประทับเวลา ข้อความที่พูด และรหัสภาษา โดยจะพร้อมใช้งานเป็นเวลา 30 วันหลังจาก การประชุมสิ้นสุดลง