הגדרת מרחבים משותפים ומשתתפים לפגישות

מרחב ישיבות מייצג מקום וירטואלי או אובייקט קבוע (כמו חדר ישיבות) שבו מתקיימים כנסים. א' מתחם הישיבות גם עוזר למשתמשים להיפגש ולמצוא משאבים משותפים.

כשיוצרים מרחב ישיבות באמצעות spaces.create, מחזירה מופע של משאב spaces. כולל את אובייקט SpaceConfig את ההגדרות של מרחב הישיבות. הוא מכיל גם את אובייקט ActiveConference זה קישור מקור מידע על conferenceRecords במרחב הישיבות.

בחלקים הבאים מוסבר איך להגדיר מרחב לפגישות באמצעות אובייקטים ושיטות בטא.

הגדרת ניהול וגישה לפגישה

באמצעות אובייקטי הבטא החדשים אפשר להגדיר מצבי ניהול, להפעיל ההגבלות, וההרשאות שהמשתמשים מקבלים כשהם מצטרפים לפגישה. האלה מוגדרות דרך הגרסה המעודכנת SpaceConfig לאובייקט.

השדה moderation הוא מצב ניהול מוגדר מראש לפגישה, עם ברירת המחדל שנשלטת על ידי המדיניות של המשתמש. היא משתמשת ב Moderation לאובייקט. כשמצב הניהול מופעל, הבעלים של הפגישה שולטים של פגישות בעזרת תכונות כמו ניהול מארחים נוספים (ראו spaces.members) והגבלות של תכונות (ראו moderationRestrictions). מידע נוסף על מידע נוסף זמין במאמר ניהול רשימת המשתתפים במרחב המשותף.

השדה moderationRestrictions אוכף הגבלות על ניהול התגובות הפגישה כשmoderation מופעל. היא משתמשת ב ModerationRestrictions לאובייקט. ההגבלות מגדירות למי יש הרשאה לשלוח הודעות בצ'אט ותגובות, לשתף את המסך ולקבוע אם להגביל תפקיד ברירת המחדל שהוקצה למשתמשים כצופים. moderationRestrictions מבוססת על RestrictionType להחיל את שלוש ההגבלות הראשונות. אפשר להחיל את RestrictionType על לבעלים ולמארחים הנוספים של הפגישה, או לכל המשתתפים. DefaultJoinAsViewerType מחילה את ההרשאה הסופית שבה משתמשים מצטרפים כשותפים כברירת מחדל, אבל שבהם המארחים יכולים גם להגביל משתמשים להצטרף כצופים.

השדה firstJoinerType קובע אם המשתמשים יכולים להצטרף לפני המארח של שיחות ועידה במרחב הישיבות הזה. היא מגדירה אילו משתמשים יכולים להצטרף לפגישה תחילה ואם אחרים נמצאים במצב המתנה. היא משתמשת ב FirstJoinerType לאובייקט.

ניהול רשימת המשתתפים במרחב המשותף

הבעלים של הפגישה תמיד יכול להצטרף אליה בלי לשלוח בקשת הצטרפות, אבל עכשיו אתם יכולים להגדיר חברים שיוכלו להצטרף לפגישה גם בלי לשלוח בקשת הצטרפות. בנוסף אפשר להגדיר למשתמשים תפקיד בפגישה, למשל COHOST, נותן לו את אותן היכולת לנהל את הפגישה כמו הבעלים של הפגישה. עבור מידע נוסף על גישה למרחב ישיבות בלי לשלוח בקשת הצטרפות: AccessType

spaces.members המשאב כולל את השדות name, user ו-role.

שימו לב שחבר שונה למשתתפים. המשתתף הוא אדם שהצטרף לשיחה או שמשתמשת במצב Companion מצב , לצפות כצופה או במכשיר שמחובר לשיחה. יש אחד conferenceRecords.participants משאב לכל אדם.

אפשר לנהל את רשימת המשתתפים במרחב המשותף בדרכים הבאות:

כל שיטה מקבלת פרמטר נתיב עם שיטות היצירה והרשימה באמצעות השדה parent לציון המרחב לפגישה, ושיטות המחיקה והאחזור באמצעות בשדה name כדי לסנן את התוצאות לפי המרחב המשותף והחבר/ה לפגישה שם.

כל השיטות, מלבד מחיקה, תומכות בפרמטר fields ב- SystemParameterContext הקצר הזה. התשובות שלך יעזרו לנו להשתפר. אם משמיטים את הפרמטר fields, ברירת המחדל של תגובת ה-API היא "name,email,role,user".

הפרמטר fields מסתמך על FieldMask לסינון תגובות. בעזרת FieldMask, מתקשרים ל-API יכולים לרשום שדות הבקשה אמורה לחזור. זוהי רשימת שדות שמופרדת בפסיקים שצריך לציין רק אפשר להשתמש בשדות מסוימים באובייקט ולהשאיר את שאר השדות ללא שינוי. השימוש ב-FieldMask מאפשר ל-API להימנע מעבודה מיותרת ומשפר את הביצועים או של ביצועים. נעשה שימוש במסכת שדות כדי ליצור, לקבל ולפרט את השיטות. לקבלת מידע נוסף מידע על מסיכות שדות זמין בקטע שימוש בשדה 'שימוש' ב-Google Sheets API מסכות.