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

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

เมื่อคุณสร้างพื้นที่การประชุมโดยใช้เมธอด spaces.create() ระบบจะแสดงอินสแตนซ์ของทรัพยากร spaces ทรัพยากรประกอบด้วยออบเจ็กต์ SpaceConfig ซึ่งเป็นการกำหนดค่าสำหรับพื้นที่ทำงาน รวมถึงออบเจ็กต์ ActiveConference ซึ่งเป็นลิงก์ไปยังทรัพยากร conferenceRecords ปัจจุบันภายในพื้นที่การประชุม ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการพื้นที่การประชุมได้ที่หัวข้อทํางานกับพื้นที่การประชุม

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

ตั้งค่าการดูแลและการเข้าถึงการประชุม

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

ฟิลด์ moderation คือโหมดการดูแลที่กำหนดค่าไว้ล่วงหน้าสำหรับการประชุม โดยค่าเริ่มต้นจะควบคุมโดยนโยบายของผู้ใช้ โดยใช้ออบเจ็กต์ Moderation เมื่อเปิดโหมดการดูแล ผู้จัดการประชุมจะควบคุมการประชุมได้ด้วยฟีเจอร์ต่างๆ เช่น การจัดการผู้ร่วมจัดการประชุม (ดูspaces.members) และข้อจำกัดของฟีเจอร์ (ดู moderationRestrictions) ดูข้อมูลเพิ่มเติมเกี่ยวกับสมาชิกได้ที่จัดการสมาชิกพื้นที่ทำงาน

ช่อง moderationRestrictions จะบังคับใช้ข้อจำกัดการดูแลการประชุมเมื่อ moderation เปิดอยู่ โดยใช้ออบเจ็กต์ ModerationRestrictions ข้อจำกัดจะกำหนดว่าใครมีสิทธิ์ส่งข้อความแชทและรีแอ็กชัน แชร์หน้าจอ และกำหนดว่าจะจำกัดบทบาทเริ่มต้นที่กำหนดให้ผู้ใช้เป็นผู้ดูหรือไม่ moderationRestrictions ช่องใช้ RestrictionType เพื่อใช้ข้อจํากัด 3 ข้อแรก RestrictionType สามารถใช้กับผู้จัดการประชุมและผู้ร่วมจัดการประชุม หรือกับผู้เข้าร่วมทุกคนก็ได้ ตัวเลือก DefaultJoinAsViewerType จะใช้สิทธิ์สุดท้ายซึ่งผู้ใช้จะเข้าร่วมในฐานะผู้มีส่วนร่วมโดยค่าเริ่มต้น แต่โฮสต์สามารถจำกัดให้ผู้ใช้เข้าร่วมในฐานะผู้ชมได้เช่นกัน

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

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

ผู้จัดการประชุมสามารถเข้าร่วมการประชุมได้โดยไม่ต้องขอเข้าร่วมเสมอ แต่ตอนนี้คุณยังกำหนดค่าสมาชิกที่เข้าร่วมการประชุมได้โดยไม่ต้องขอเข้าร่วมได้ด้วย นอกจากนี้ คุณยังกำหนดค่าให้สมาชิกมีบทบาทในการประชุมได้ด้วย เช่น 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

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

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

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

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

แต่ละช่องจะจับคู่กับออบเจ็กต์ที่คล้ายกัน เช่น RecordingConfig , TranscriptionConfig และ SmartNotesConfig ระบบจะตั้งค่าออบเจ็กต์แต่ละรายการโดยใช้ AutoGenerationType บูลีนเพื่อเปิดหรือปิดออบเจ็กต์การกําหนดค่า

ขอบเขต 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 ได้ที่ ขอบเขต Meet REST API