فضاهای جلسه و اعضا را پیکربندی کنید

فضای جلسه نشان دهنده یک مکان مجازی یا یک شی ثابت (مانند اتاق جلسه) است که در آن کنفرانس ها برگزار می شود. فضای جلسه همچنین به کاربران کمک می کند تا منابع مشترک را پیدا کنند.

هنگامی که با استفاده از متد spaces.create() یک فضای جلسه ایجاد می کنید، نمونه ای از یک منبع spaces را برمی گرداند. این منبع شامل شی SpaceConfig است که پیکربندی فضای جلسه است. همچنین حاوی شی ActiveConference است که پیوندی به منبع conferenceRecords فعلی در فضای جلسه است. برای اطلاعات بیشتر در مورد مدیریت یک فضای جلسه، به کار با فضاهای جلسه مراجعه کنید.

بخش‌های زیر نحوه پیکربندی فضای جلسه با استفاده از چندین شیء و روش بتا جدید را شرح می‌دهد.

تنظیم نظارت و دسترسی به جلسه

از طریق اشیاء بتا جدید، اکنون می توانید حالت های تعدیل، محدودیت های ویژگی و مجوزهایی را که کاربران هنگام پیوستن به جلسه دریافت می کنند، تنظیم کنید. اینها از طریق شی SpaceConfig به روز شده تنظیم می شوند.

فیلد moderation یک حالت نظارت از پیش پیکربندی شده برای یک جلسه است که پیش‌فرض توسط خط‌مشی‌های کاربر کنترل می‌شود. از شی Moderation استفاده می کند. وقتی حالت نظارت روشن است، سازمان‌دهنده جلسه با ویژگی‌هایی مانند مدیریت میزبان مشترک (به spaces.members مراجعه کنید) و محدودیت‌های ویژگی (به moderationRestrictions مراجعه کنید) کنترل جلسه را در اختیار دارد. برای اطلاعات بیشتر درباره اعضا، به مدیریت اعضای فضا مراجعه کنید.

وقتی moderation فعال است، قسمت moderationRestrictions محدودیت‌های تعدیل را برای جلسه اعمال می‌کند. از شی ModerationRestrictions استفاده می کند. محدودیت‌ها تعیین می‌کنند که چه کسی اجازه ارسال پیام‌ها و واکنش‌های چت، اشتراک‌گذاری صفحه نمایش خود را دارد و آیا نقش پیش‌فرض اختصاص داده شده به کاربران به عنوان بیننده را محدود کند. فیلد moderationRestrictions برای اعمال سه محدودیت اول به یک RestrictionType متکی است. RestrictionType را می توان برای سازمان دهنده جلسه و میزبان مشترک یا برای همه شرکت کنندگان اعمال کرد. DefaultJoinAsViewerType مجوز نهایی را اعمال می‌کند که در آن کاربران به‌طور پیش‌فرض به‌عنوان مشارکت‌کننده ملحق می‌شوند، اما میزبان‌ها همچنین می‌توانند کاربران را برای پیوستن به عنوان بیننده محدود کنند.

فیلد firstJoinerType تعیین می کند که آیا کاربران می توانند قبل از میزبان برای کنفرانس های این فضای جلسه بپیوندند یا خیر. مشخص می کند که کدام کاربران می توانند ابتدا به جلسه بپیوندند و اگر دیگران در حالت انتظار هستند. از شی FirstJoinerType استفاده می کند.

اعضای فضا را مدیریت کنید

یک سازمان‌دهنده جلسه همیشه می‌تواند بدون در زدن وارد جلسه شود، اما اکنون می‌توانید اعضایی را پیکربندی کنید که بتوانند بدون در زدن به جلسه بپیوندند. علاوه بر این، اعضا را می‌توان طوری پیکربندی کرد که نقشی در جلسه داشته باشند، مانند COHOST که به آنها توانایی‌های مشابهی را برای مدیریت جلسه می‌دهد که سازمان‌دهنده جلسه. برای اطلاعات بیشتر در مورد دسترسی به فضای جلسه بدون در زدن، AccessType ببینید.

منبع spaces.members شامل name ، user و فیلدهای role است.

توجه داشته باشید که یک عضو با یک شرکت کننده متفاوت است. شرکت‌کننده فردی است که به یک تماس ملحق شده است یا از حالت همراه استفاده می‌کند، به‌عنوان بیننده تماشا می‌کند، یا یک دستگاه اتاق متصل به تماس. برای هر فرد یک منبع conferenceRecords.participants وجود دارد.

می توانید اعضای فضایی را با استفاده از روش های زیر مدیریت کنید:

هر متد یک پارامتر مسیر را با متدهای ایجاد و لیست با استفاده از فیلد parent برای نشان دادن فضای جلسه و متدهای حذف و دریافت با استفاده از فیلد name برای فیلتر کردن نتایج بر اساس فضای جلسه و نام اعضا می گیرد.

همه روش ها، به جز حذف، از پارامتر fields در SystemParameterContext پشتیبانی می کنند. هنگامی که پارامتر fields حذف می شود، پاسخ API به طور پیش فرض روی "name,email,role,user" است.

پارامتر fields برای فیلتر کردن پاسخ به یک FieldMask متکی است. FieldMask راهی برای تماس‌گیرندگان API برای فهرست کردن فیلدهایی است که درخواست باید برگرداند. این یک لیست از فیلدها با کاما است که مشخص می کند فقط فیلدهای خاصی در یک شی مورد استفاده قرار می گیرند و بقیه فیلدها بدون تغییر باقی می مانند. استفاده از FieldMask به API اجازه می دهد تا از کارهای غیر ضروری جلوگیری کند و عملکرد را بهبود بخشد. یک فیلد ماسک برای متدهای ایجاد، دریافت و فهرست استفاده می شود. برای اطلاعات بیشتر در مورد ماسک‌های فیلد، به استفاده از ماسک‌های فیلد در API Google Sheets مراجعه کنید.

مصنوعات خودکار را مدیریت کنید

سازمان‌دهندگان جلسه، اما نه میزبان‌های مشترک، می‌توانند ضبط خودکار، رونوشت‌های خودکار و "یادداشت برداری برای من" را در فضای جلسه از قبل پیکربندی کنند. وقتی این تنظیمات فعال می‌شوند، به‌طور خودکار فضای جلسه ضبط می‌شود، رونوشت‌ها تولید می‌شوند و یادداشت‌های جلسه به‌طور خودکار در Google Docs ضبط و سازمان‌دهی می‌شوند. هر ویژگی مستقل است و در هر فضای جلسه تنظیم می شود. زیرنویس‌های ضبط فقط به زبان انگلیسی در دسترس هستند.

می‌توانید هنگام ایجاد فضای جلسه یا پس از ایجاد فضای جلسه، مصنوعات خودکار را از قبل پیکربندی کنید. این ویژگی همچنین به شما امکان می دهد مصنوعات خودکار را برای جلسات ایجاد شده از Google Calendar تنظیم کنید. هر دو روش به حوزه meetings.space.settings OAuth نیاز دارند. برای اطلاعات بیشتر، تنظیمات OAuth را ببینید.

آرتیفکت‌های خودکار از طریق شی ArtifactConfig ، در زیر شی SpaceConfig ، که بخشی از منبع spaces است، تنظیم می‌شوند. ArtifactConfig از فیلدهای recordingConfig ، transcriptionConfig و smartNotesConfig تشکیل شده است.

هر فیلد به یک شی مشابه مانند RecordingConfig ، TranscriptionConfig و SmartNotesConfig نگاشت می شود. هر شی با استفاده از Enum بولین 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 مراجعه کنید.