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

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

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

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

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

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

دسترسی به فضاهای جلسه

برای تعیین اینکه چه کسی می تواند بدون ضربه زدن به یک فضای جلسه ملحق شود، فیلد accessType را با استفاده از شی AccessType تنظیم کنید. می‌توانید از میان تنظیمات متعدد، انتخاب کنید که آیا به طور خودکار به شرکت‌کنندگان اجازه ملحق می‌شود. این فیلد به صورت پیش‌فرض روی تنظیمات دسترسی پیش‌فرض کاربر است.

برای تعریف نقاط ورودی که می توانند برای پیوستن به جلسات میزبانی شده در فضای جلسه استفاده شوند، قسمت entryPointAccess را با استفاده از شی EntryPointAccess تنظیم کنید. روی ALL تنظیم کنید تا به همه نقاط ورودی اجازه دهید یا CREATOR_APP_ONLY نقاط ورودی را فقط به مواردی که متعلق به پروژه Google Cloud هستند که فضای جلسه را ایجاد کرده اند اختصاص دهد.

ایجاد گزارش حضور و غیاب

برای ایجاد گزارش حضور و غیاب برای فضای جلسه، فیلد حضوری بولی attendanceReportGenerationType با استفاده از شی AttendanceReportGenerationType تنظیم کنید. اگر گزارشی درخواست شود، Google Meet گزارش حضور را در Google Drive سازمان‌دهنده جلسه ذخیره می‌کند و ایمیلی نیز ارسال می‌شود.

فضاهای ملاقات متوسط

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

برای تعریف محدودیت‌های ویژگی وقتی جلسه تعدیل می‌شود ( moderation on است)، قسمت moderationRestrictions را با استفاده از شی ModerationRestrictions تنظیم کنید. محدودیت‌ها مشخص می‌کند که چه کسی در فضای جلسه اجازه ارسال پیام‌ها یا واکنش‌های چت یا اشتراک‌گذاری صفحه خود را دارد.

برای تنظیم محدودیت‌های ویژگی در فیلد moderationRestrictions ، از فهرست RestrictionType برای اعمال chatRestriction ، reactionRestriction ، presentRestriction استفاده کنید. روی HOSTS_ONLY برای اعمال مجوزها برای سازمان‌دهنده جلسه و میزبان مشترک یا NO_RESTRICTION برای اعمال برای همه شرکت‌کنندگان تنظیم کنید.

برای محدود کردن نقش پیش‌فرض اختصاص داده شده به کاربران به‌عنوان بیننده، فیلد defaultJoinAsViewerType را با استفاده از فهرست DefaultJoinAsViewerType تنظیم کنید. اگر defaultJoinAsViewerType on باشد، کاربران به عنوان بیننده ملحق می شوند. اگر off ، کاربران به عنوان مشارکت‌کننده می‌پیوندند. پیش فرض off است. اگر یک نقش واضح برای یک کاربر در spaces.members تنظیم شده باشد، کاربر به عنوان آن نقش ملحق می شود.

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

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

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

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

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

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

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

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

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

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