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

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

คุณสามารถใช้ Meet REST API ทำสิ่งต่อไปนี้ได้

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

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

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

แอปจะทำงานร่วมกับ REST API ของ Meet เพื่อทำงานต่อไปนี้

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

  • ระหว่างการประชุม: เรียกดูข้อมูลการประชุมเพื่อเปลี่ยนประสบการณ์การใช้งานแอปตามข้อมูลเมตาที่แสดงผล

  • หลังจบการประชุม: ดึงข้อมูลอาร์ติแฟกต์การประชุม เช่น การบันทึกและการถอดเสียงเป็นคำ

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

  • การจัดการการขายและบัญชี

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

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

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

  • การดำเนินการของนักพัฒนาแอป

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

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

คำทั่วไป

ต่อไปนี้คือรายการคำศัพท์ทั่วไปที่ใช้ใน API นี้

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

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

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

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

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

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

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

สถานที่จัดประชุม

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

URL การประชุม

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

ผู้เข้าร่วม

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

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

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

ข้อมูลการให้สิทธิ์และการตรวจสอบสิทธิ์เฉพาะ API

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

Meet REST API รองรับขอบเขต OAuth 2.0 ต่อไปนี้

รหัสขอบเขต คำอธิบาย การใช้งาน
https://www.googleapis.com/auth/meetings.space.readonly อนุญาตให้แอปอ่านข้อมูลเมตาเกี่ยวกับพื้นที่การประชุมที่ผู้ใช้มีสิทธิ์เข้าถึง ละเอียดอ่อน
https://www.googleapis.com/auth/meetings.space.created อนุญาตให้แอปสร้าง แก้ไข และอ่านข้อมูลเมตาเกี่ยวกับพื้นที่การประชุมที่แอปของคุณสร้างขึ้น ละเอียดอ่อน
https://www.googleapis.com/auth/drive.readonly อนุญาตให้แอปดาวน์โหลดไฟล์การบันทึกและข้อความถอดเสียงจาก Google Drive API ถูกจำกัด

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth 2.0 ที่เฉพาะเจาะจงได้ที่ขอบเขต OAuth 2.0 สำหรับ Google APIs