กำหนดค่าพื้นที่การประชุมและสมาชิก

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

เมื่อสร้างพื้นที่การประชุมโดยใช้เมธอด 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 เป็น on) ให้ตั้งค่าฟิลด์ moderationRestrictions โดยใช้ออบเจ็กต์ ModerationRestrictions ข้อจำกัดจะกำหนดว่าใครมีสิทธิ์ในพื้นที่การประชุมเพื่อ ส่งข้อความแชทหรือรีแอ็กชัน หรือแชร์หน้าจอ

หากต้องการตั้งค่าข้อจำกัดของฟีเจอร์ในช่อง moderationRestrictions ให้ใช้ RestrictionType enum เพื่อใช้ chatRestriction, reactionRestriction, presentRestriction ตั้งค่าเป็น HOSTS_ONLY เพื่อใช้สิทธิ์กับทั้งผู้จัดการประชุมและผู้ร่วมจัดการประชุม หรือ NO_RESTRICTION เพื่อใช้กับผู้เข้าร่วมทุกคน

หากต้องการจำกัดบทบาทเริ่มต้นที่กำหนดให้กับผู้ใช้เป็นผู้ดู ให้ตั้งค่าบูลีน defaultJoinAsViewerType โดยใช้ Enum DefaultJoinAsViewerType หาก defaultJoinAsViewerType on ผู้ใช้จะเข้าร่วมในฐานะผู้ชม หาก off ผู้ใช้เข้าร่วมในฐานะผู้ร่วมให้ข้อมูล ค่าเริ่มต้นคือ off หากตั้งค่าบทบาทที่ชัดเจนสำหรับผู้ใช้ใน spaces.members ผู้ใช้จะเข้าร่วมในบทบาทนั้น

จัดการอาร์ติแฟกต์อัตโนมัติ

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

คุณสามารถกำหนดค่าอาร์ติแฟกต์อัตโนมัติล่วงหน้าได้เมื่อสร้างพื้นที่การประชุมหรือเมื่อ สร้างพื้นที่การประชุมแล้ว ฟีเจอร์นี้ยังช่วยให้คุณตั้งค่าอาร์ติแฟกต์อัตโนมัติ สำหรับการประชุมที่สร้างจาก Google ปฏิทินได้ด้วย ทั้ง 2 วิธีต้องใช้meetings.space.settingsขอบเขต OAuth ดูข้อมูลเพิ่มเติมได้ที่ขอบเขต OAuth สำหรับการตั้งค่า

หากต้องการตั้งค่าอาร์ติแฟกต์อัตโนมัติ ให้ใช้ออบเจ็กต์ ArtifactConfig ภายในออบเจ็กต์ SpaceConfig ArtifactConfig ประกอบด้วยฟิลด์ recordingConfig, transcriptionConfig และ smartNotesConfig

แต่ละฟิลด์จะได้รับการแมปกับออบเจ็กต์ที่คล้ายกัน เช่น RecordingConfig , TranscriptionConfig และ SmartNotesConfig หากต้องการตั้งค่าแต่ละออบเจ็กต์ ให้ใช้ AutoGenerationType enum บูลีนเพื่อสลับออบเจ็กต์การกำหนดค่า 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.created
https://www.googleapis.com/auth/meetings.space.readonly
อ่านและแก้ไขการตั้งค่าสำหรับพื้นที่การประชุมทั้งหมดที่ผู้ใช้เข้าถึงได้ผ่านแอปอื่นๆ เช่น ปฏิทิน https://www.googleapis.com/auth/meetings.space.settings

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขต OAuth ได้ที่ขอบเขต REST API ของ Meet

จัดการสมาชิกพื้นที่ทำงาน

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

แหล่งข้อมูล spaces.members ประกอบด้วยช่อง name, user และ role

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

คุณจัดการสมาชิกในพื้นที่ทำงานได้โดยใช้วิธีต่อไปนี้

แต่ละวิธีจะใช้พารามิเตอร์เส้นทางที่มีเมธอด create และ list โดยใช้ฟิลด์ parent เพื่อระบุพื้นที่การประชุม และเมธอด delete และ get โดยใช้ฟิลด์ name เพื่อกรองผลลัพธ์ตามพื้นที่การประชุมและชื่อสมาชิก

ทุกเมธอด ยกเว้นเมธอดลบ รองรับพารามิเตอร์ fields ใน SystemParameterContext เมื่อไม่มีพารามิเตอร์ fields การตอบกลับของ API จะมีค่าเริ่มต้นเป็น "name,email,role,user"

พารามิเตอร์ fields อาศัย FieldMask สำหรับการกรองการตอบกลับ FieldMask เป็นวิธีที่ผู้เรียกใช้ API ใช้เพื่อแสดงรายการฟิลด์ที่คำขอควรแสดงผล เป็นรายการฟิลด์ที่คั่นด้วยคอมมาเพื่อระบุว่าใช้เฉพาะ ฟิลด์บางฟิลด์ในออบเจ็กต์เท่านั้นในขณะที่ฟิลด์อื่นๆ ไม่มีการเปลี่ยนแปลง การใช้ FieldMask ช่วยให้ API หลีกเลี่ยงการทำงานที่ไม่จำเป็นและปรับปรุง ประสิทธิภาพได้ ฟิลด์มาสก์ใช้สำหรับเมธอด create, get และ list ดูข้อมูลเพิ่มเติมเกี่ยวกับ Field Mask ได้ที่ใช้ Field Mask ของ Google Sheets API