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

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

وقتی یک فضای جلسه با استفاده از متد 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 مراجعه کنید.

،

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

وقتی یک فضای جلسه با استفاده از متد 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 مراجعه کنید.