สถานที่ประชุมแสดงถึงสถานที่เสมือนจริงหรือออบเจ็กต์ถาวร (เช่น ห้องประชุม) ที่ใช้ในการจัดการประชุม พื้นที่ทำงานยังช่วยให้ผู้ใช้พบปะและค้นหาแหล่งข้อมูลที่แชร์ได้ด้วย
เมื่อคุณสร้างพื้นที่การประชุมโดยใช้เมธอด spaces.create ระบบจะแสดงผลอินสแตนซ์ของทรัพยากร spaces ทรัพยากรมีออบเจ็กต์ SpaceConfig ซึ่งเป็นการกำหนดค่าสำหรับพื้นที่การประชุม รวมถึงออบเจ็กต์ ActiveConference ที่ลิงก์ไปยังแหล่งข้อมูล conferenceRecords ปัจจุบันภายในพื้นที่ทำงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการพื้นที่ทำงานของการประชุมได้ที่หัวข้อสร้างและจัดการพื้นที่ทำงานของการประชุม
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีกำหนดค่าพื้นที่การประชุมโดยใช้ออบเจ็กต์และเมธอดเหล่านี้
ตั้งค่าการดูแลและการเข้าถึงการประชุม
คุณสามารถตั้งค่าวิธีเข้าร่วมการประชุมของผู้ใช้ โหมดการดูแล โหมดการจำกัดฟีเจอร์ และสิทธิ์ที่ผู้ใช้จะได้รับเมื่อเข้าร่วมการประชุมผ่านออบเจ็กต์ SpaceConfig
เข้าถึงพื้นที่การประชุม
หากต้องการกำหนดผู้ที่มีสิทธิ์เข้าร่วมพื้นที่ทำงานของการประชุมโดยไม่ต้องขอเข้าร่วม ให้ตั้งค่าaccessType
ช่องโดยใช้ออบเจ็กต์ AccessType
คุณเลือกการตั้งค่าได้หลายแบบว่าจะอนุญาตให้ผู้เข้าร่วมเข้าร่วมโดยอัตโนมัติหรือไม่ ช่องนี้จะมีค่าเริ่มต้นเป็นการตั้งค่าการเข้าถึงเริ่มต้นของผู้ใช้
หากต้องการกำหนดจุดแรกเข้าที่ใช้เข้าร่วมการประชุมที่โฮสต์ในพื้นที่ทำงาน ให้ตั้งค่าช่อง entryPointAccess โดยใช้ออบเจ็กต์ EntryPointAccess ตั้งค่าเป็น ALL เพื่ออนุญาตจุดแรกเข้าทั้งหมด หรือ CREATOR_APP_ONLY เพื่อจำกัดจุดแรกเข้าเฉพาะของโปรเจ็กต์ Google Cloud ที่สร้างพื้นที่ทำงานร่วมกัน
สร้างรายงานการเข้าร่วม
หากต้องการสร้างรายงานการเข้าร่วมสำหรับพื้นที่การประชุม ให้ตั้งค่าช่องบูลีน attendanceReportGenerationType โดยใช้ออบเจ็กต์ AttendanceReportGenerationType หากมีการขอรายงาน Google Meet จะบันทึกรายงานการเข้าร่วมไว้ใน Google ไดรฟ์ของผู้จัดการประชุมและส่งอีเมลด้วย
พื้นที่การประชุมระดับปานกลาง
หากต้องการดูแลการประชุม คุณสามารถตั้งค่าช่องบูลีน moderation โดยใช้ออบเจ็กต์ Moderation
เมื่อโหมด moderation เป็น on ผู้จัดการประชุมจะควบคุมการประชุมได้ด้วยฟีเจอร์ต่างๆ เช่น การจัดการผู้ร่วมจัดการประชุม (ดูspaces.members) และข้อจำกัดของฟีเจอร์โดยใช้ช่อง moderationRestrictions ดูข้อมูลเพิ่มเติมเกี่ยวกับสมาชิกได้ที่จัดการสมาชิกพื้นที่ทำงาน
หากต้องการกำหนดข้อจำกัดของฟีเจอร์เมื่อการประชุมได้รับการดูแล (moderation is
on) ให้ตั้งค่าช่อง moderationRestrictions โดยใช้ออบเจ็กต์ ModerationRestrictions
ข้อจำกัดจะกำหนดว่าใครมีสิทธิ์ภายในพื้นที่การประชุมในการส่งข้อความแชทหรือรีแอ็กชัน หรือแชร์หน้าจอ
หากต้องการตั้งค่าข้อจำกัดฟีเจอร์ในช่อง moderationRestrictions ให้ใช้ enumeration ของ RestrictionType เพื่อใช้ chatRestriction, reactionRestriction และ presentRestriction ตั้งค่าเป็น HOSTS_ONLY เพื่อใช้สิทธิ์กับทั้งผู้จัดการประชุมและผู้ร่วมจัดการประชุม หรือ NO_RESTRICTION เพื่อใช้กับทุกคนที่เข้าร่วม
หากต้องการจํากัดบทบาทเริ่มต้นที่กําหนดให้กับผู้ใช้เป็นผู้ดู ให้ตั้งค่าช่องบูลีน defaultJoinAsViewerType โดยใช้ลิสต์แบบจำกัด DefaultJoinAsViewerType หาก defaultJoinAsViewerType เป็น on ผู้ใช้จะเข้าร่วมในฐานะผู้ชม หากเป็น off ผู้ใช้จะเข้าร่วมในฐานะผู้ร่วมให้ข้อมูล ค่าเริ่มต้นคือ off หากตั้งค่าบทบาทที่ชัดเจนให้กับผู้ใช้ใน spaces.members ผู้ใช้จะเข้าร่วมด้วยบทบาทนั้น
จัดการอาร์ติแฟกต์อัตโนมัติ
ผู้จัดการประชุม (แต่ไม่ใช่ผู้ร่วมจัดการประชุม) สามารถกำหนดค่าการบันทึกอัตโนมัติ การถอดเสียงอัตโนมัติ และ"จดโน้ตให้ฉัน" ล่วงหน้าภายในพื้นที่การประชุม เมื่อเปิดใช้การตั้งค่าเหล่านี้ ระบบจะบันทึกพื้นที่ในการประชุม สร้างข้อความถอดเสียง และบันทึกโน้ตการประชุม รวมถึงจัดระเบียบโน้ตการประชุมไว้ใน Google เอกสารโดยอัตโนมัติ ฟีเจอร์แต่ละรายการจะแยกกันต่างหากและตั้งค่าตามพื้นที่ในการประชุม คำบรรยายแทนเสียงของไฟล์บันทึกเสียงมีให้บริการเป็นภาษาอังกฤษเท่านั้น
คุณสามารถกําหนดค่าอาร์ติแฟกต์อัตโนมัติล่วงหน้าได้เมื่อสร้างพื้นที่ทำงานของการประชุมหรือเมื่อสร้างพื้นที่ทำงานของการประชุมแล้ว นอกจากนี้ ฟีเจอร์นี้ยังให้คุณตั้งค่ารายการต่างๆ โดยอัตโนมัติสำหรับการประชุมที่สร้างจาก Google ปฏิทินได้ด้วย ทั้ง 2 วิธีต้องใช้ขอบเขต OAuth meetings.space.settings ดูข้อมูลเพิ่มเติมได้ที่ขอบเขต OAuth
สําหรับการตั้งค่า
หากต้องการตั้งค่าอาร์ติแฟกต์อัตโนมัติ ให้ใช้ออบเจ็กต์ ArtifactConfig ในส่วนออบเจ็กต์ SpaceConfig ArtifactConfig ประกอบด้วยช่อง recordingConfig,
transcriptionConfig และ smartNotesConfig
แต่ละช่องจะจับคู่กับออบเจ็กต์ที่คล้ายกัน เช่น
RecordingConfig
,
TranscriptionConfig
และ
SmartNotesConfig
หากต้องการตั้งค่าออบเจ็กต์แต่ละรายการ ให้ใช้ Enumeration แบบบูลีน AutoGenerationType เพื่อสลับออบเจ็กต์การกําหนดค่า on หรือ off
ขอบเขต OAuth สําหรับการตั้งค่า
การตั้งค่าหรือเข้าถึงการตั้งค่าการประชุมต้องใช้ขอบเขต OAuth ต่อไปนี้
| กรณีการใช้งาน | รหัสขอบเขต |
|---|---|
| ตั้งค่าการสร้างรายการต่างๆ โดยอัตโนมัติสำหรับพื้นที่ทำงานที่สร้างโดยแอปอื่นๆ | https://www.googleapis.com/auth/meetings.space.settings |
| รับหรือแสดงรายการอาร์ติแฟกต์จากการประชุมที่แอปอื่นๆ สร้างขึ้น | https://www.googleapis.com/auth/meetings.space.readonly |
| ดูหรือแสดงการตั้งค่าอื่นๆ ก่อนการประชุมของพื้นที่การประชุมที่สร้างโดยแอปของบุคคลที่สาม | https://www.googleapis.com/auth/meetings.space.createdhttps://www.googleapis.com/auth/meetings.space.readonly |
| อ่านและแก้ไขการตั้งค่าสำหรับพื้นที่ทำงานทั้งหมดที่ผู้ใช้เข้าถึงได้ผ่านแอปอื่นๆ เช่น ปฏิทิน | https://www.googleapis.com/auth/meetings.space.settings |
ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth ได้ที่ขอบเขต Meet REST API
จัดการสมาชิกพื้นที่ทำงาน
แม้ว่าผู้จัดการประชุมจะเข้าร่วมการประชุมได้โดยไม่ต้องขอเข้าร่วมทุกครั้ง แต่คุณยังกำหนดค่าให้สมาชิกคนอื่นๆ เข้าร่วมการประชุมได้โดยไม่ต้องขอเข้าร่วมด้วย
นอกจากนี้ คุณยังกำหนดค่าให้สมาชิกมีบทบาทในการประชุมได้ เช่น COHOST ซึ่งจะทำให้สมาชิกมีสิทธิ์จัดการการประชุมเช่นเดียวกับผู้จัดการประชุม ดูข้อมูลเพิ่มเติมเกี่ยวกับการเข้าถึงพื้นที่การประชุมโดยไม่ต้อง "เคาะประตู" ได้ที่ AccessType
แหล่งข้อมูล spaces.members ประกอบด้วยช่อง name, user และ role
โปรดทราบว่าสมาชิกแตกต่างจากผู้เข้าร่วม ผู้เข้าร่วมคือบุคคลที่เข้าร่วมการโทรหรือใช้โหมดแยกหน้าจอประชุม ดูในฐานะผู้ชม หรืออุปกรณ์ในห้องที่เชื่อมต่อกับการโทร โดยจะมีแหล่งข้อมูล 1 รายการconferenceRecords.participantsสำหรับแต่ละคน
คุณจัดการสมาชิกพื้นที่ทำงานได้โดยใช้วิธีต่อไปนี้
โดยแต่ละเมธอดจะใช้พารามิเตอร์เส้นทางที่มีเมธอดสร้างและแสดงรายการโดยใช้ช่อง parent เพื่อระบุพื้นที่การประชุม และเมธอดลบและรับโดยใช้ช่อง name เพื่อกรองผลลัพธ์ตามพื้นที่การประชุมและชื่อสมาชิก
เมธอดทั้งหมดยกเว้น delete รองรับพารามิเตอร์ fields ใน SystemParameterContext
เมื่อไม่ระบุพารามิเตอร์ fields การตอบกลับของ API จะเป็น "name,email,role,user" โดยค่าเริ่มต้น
พารามิเตอร์ fields จะใช้ FieldMask ในการกรองคำตอบ FieldMask เป็นวิธีที่ผู้เรียก API แสดงรายการช่องที่คำขอควรแสดงผล รายการฟิลด์ที่คั่นด้วยคอมมาเพื่อระบุเฉพาะฟิลด์บางฟิลด์ในออบเจ็กต์ที่จะใช้ โดยไม่เปลี่ยนแปลงฟิลด์อื่นๆ
การใช้ FieldMask ช่วยให้ API หลีกเลี่ยงการทำงานที่ไม่จำเป็นและปรับปรุงประสิทธิภาพได้ หน้ากากฟิลด์ใช้สำหรับเมธอดสร้าง รับ และแสดงรายการ ดูข้อมูลเพิ่มเติมเกี่ยวกับมาสก์ช่องได้ที่ใช้มาสก์ช่องของ Google ชีต API