ภาพรวมของพื้นที่การประชุม Google Meet

Google Meet REST API ภาพประกอบ

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

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

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

วิธีเรียกใช้เมธอดของพื้นที่การประชุม

ตารางต่อไปนี้แสดงรายละเอียดบทบาทในการประชุมที่จำเป็นต่อการใช้วิธีการของพื้นที่การประชุม

วิธีการ เจ้าของ ผู้เข้าร่วม อื่นๆ
endActiveConference x
get x x x
     โดยใช้การตั้งค่า x
     ในการประชุมที่ใช้งานอยู่ x x
patch x

วิธีที่ Meet ระบุพื้นที่การประชุม

REST API ของ Google Meet จะสร้างทรัพยากร spaces สำหรับพื้นที่การประชุมแต่ละแห่ง spaces แหล่งข้อมูลนี้มีจุดเริ่มต้นหลายจุดสำหรับการเข้าร่วมการประชุม

ตารางต่อไปนี้แสดงวิธีระบุและเข้าร่วมพื้นที่การประชุม

ชื่อช่อง คำอธิบาย
name ชื่อของพื้นที่ทำงาน สตริง {space} คือตัวระบุทรัพยากร ของพื้นที่ทำงานและมีรูปแบบเป็น spaces/{space} โดยเป็นรหัสที่ไม่ซ้ำกันที่เซิร์ฟเวอร์สร้างขึ้นและคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เช่น spaces/jQCFfuBOdN5z
meetingCode นามแฝงสำหรับชื่อพื้นที่ทำงาน {meetingCode} เป็นสตริงอักขระที่ไม่ซ้ำกันซึ่งพิมพ์ได้ และไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ โดยมีรูปแบบเป็น spaces/{meetingCode} เช่น spaces/abc-mnop-xyz ความยาวต้องไม่เกิน 128 อักขระ ซึ่งเป็นส่วนหนึ่งของmeetingUri https://meet.google.com/abc-mnop-xyz
phoneAccess วิธีการเข้าถึงการประชุมผ่านโทรศัพท์สำหรับพื้นที่การประชุมนี้ ออบเจ็กต์ phoneAccess มีข้อมูลที่จำเป็นในการโทรเข้าร่วมการประชุม ซึ่งรวมถึงหมายเลขโทรศัพท์ในภูมิภาคสำหรับพื้นที่การประชุมและรหัส PIN ที่เฉพาะเจาะจงสำหรับหมายเลขโทรศัพท์นั้น PIN ประกอบด้วยตัวเลขฐานสิบเท่านั้น และความยาวอาจแตกต่างกัน เช่น "pin": 19707127300

spaces มีหมายเลขโทรเข้าจำนวนจำกัดเช่นเดียวกับ UI ของ Meet คุณดูหมายเลขโทรศัพท์เพิ่มเติมสำหรับพื้นที่การประชุมได้โดยต่อท้าย {meetingCode} ใน URL ต่อไปนี้ https://meet.google.com/tel/ เช่น https://meet.google.com/tel/abc-mnop-xyz
gatewaySipAccess วิธีการเข้าถึงโปรโตคอลการเริ่มต้นเซสชัน (SIP) สำหรับพื้นที่การประชุมนี้ รายละเอียดที่อยู่ SIP จะอธิบายวิธีที่ฮาร์ดแวร์การประชุมทางวิดีโอของบุคคลที่สามค้นหาและเข้าร่วมการประชุม Meet ออบเจ็กต์ gatewaySipAccess มี URI และรหัสการเข้าถึงที่เป็นตัวเลข Meet รองรับรูปแบบ URI ของ SIP

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

  • หากต้องการดูรายละเอียดเกี่ยวกับพื้นที่จัดประชุม คุณสามารถใช้ spaces/{space} หรือ นามแฝง spaces/{meetingCode} ดูข้อมูลเพิ่มเติมได้ที่จัดหาพื้นที่การประชุม

  • หากต้องการอัปเดตรายละเอียดของพื้นที่การประชุม คุณจะใช้ได้เฉพาะ spaces/{space} ดูข้อมูลเพิ่มเติมได้ที่อัปเดตห้องประชุม

  • หากต้องการสิ้นสุดการประชุมที่ใช้งานอยู่ภายในพื้นที่การประชุม คุณจะใช้ได้เฉพาะ spaces/{space} ดูข้อมูลเพิ่มเติมได้ที่สิ้นสุดการประชุมทางวิดีโอที่ใช้งานอยู่

วงจรของพื้นที่การประชุม

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

วงจรของพื้นที่จัดการประชุม
รูปที่ 1 วงจรของพื้นที่การประชุม

  1. โทร spaces.create ระบบจะสร้างพื้นที่การประชุมและออบเจ็กต์ spaces ที่แสดงผลจะมีสตริง meetingUri จากนั้นระบบจะแจกจ่ายmeetingUriให้แก่ผู้เข้าร่วม

  2. ทำแบบสำรวจพื้นที่การประชุมใหม่ เรียกใช้เมธอด spaces.get เพื่อ ตรวจสอบสถานะการประชุม

    คุณยังติดตามกิจกรรม Meet เพื่อรับการแจ้งเตือนแบบพุช แทนการทำแบบสำรวจได้ด้วย

  3. เริ่มการประชุม เมื่อผู้เข้าร่วมคนแรกคลิก meetingUri ภายในพื้นที่การประชุม การประชุมจะเริ่มขึ้น ระบบจะป้อนข้อมูลactiveConferenceออบเจ็กต์ และตั้งค่าactiveConference.conferenceRecordสตริง

  4. (ไม่บังคับ) รับข้อมูลการประชุม ในระหว่างการประชุมที่ใช้งานอยู่ คุณจะเข้าถึงconferenceRecordค่าบางอย่างได้ เช่น เรียกใช้เมธอด conferenceRecords.participants.list เพื่อดูผู้เข้าร่วมทั้งหมดในการประชุม นอกจากนี้ คุณยังเข้าถึงข้อมูลนี้ได้นานสูงสุด 30 วันหลังจากการประชุม

  5. (ไม่บังคับ) จบการประชุม ในระหว่างการประชุม เจ้าของการประชุม สามารถเรียกใช้เมธอด spaces.endActiveConference เพื่อปิดการประชุมที่ใช้งานอยู่สำหรับผู้เข้าร่วมทุกคนโดยอัตโนมัติ

  6. การประชุมสิ้นสุดลง เมื่อผู้เข้าร่วมคนสุดท้ายออกไป การประชุมทางโทรศัพท์จะสิ้นสุดลง

  7. สำรวจอาร์ติแฟกต์หลังการประชุม การประชุมสิ้นสุดแล้ว (STATE=ENDED) แต่ยังไม่มีการสร้างอาร์ติแฟกต์ ระบบจะสร้างข้อมูล startTime และ endTime สำหรับการประชุมด้วย คุณต้อง สำรวจปลายทางของอาร์ติแฟกต์จนกว่าออบเจ็กต์อาร์ติแฟกต์ STATE จะอ่านค่าเป็น FILE_GENERATED

    คุณสามารถติดตามกิจกรรม Meet เพื่อรับข้อความ Push แทนการทำแบบสำรวจได้

  8. รับอาร์ติแฟกต์หลังการประชุม คุณสามารถดึงข้อมูลอาร์ติแฟกต์ เช่น การบันทึกและข้อความถอดเสียง เมื่อระบบสร้างอาร์ติแฟกต์แล้ว เช่น เรียกเมธอด conferenceRecords.recordings.get เพื่อรับไฟล์บันทึกตามรหัสการบันทึก

    เมื่อพร้อมแล้ว ระบบจะป้อน URI ไปยังออบเจ็กต์อาร์ติแฟกต์และแสดงผลเป็นส่วนหนึ่งของออบเจ็กต์ทรัพยากร