מרחב שיתוף מייצג מקום וירטואלי או אובייקט קבוע (כמו חדר ישיבות) שבו מתקיימות ועידות. מרחב משותף עוזר למשתמשים גם לקיים פגישות ולמצוא משאבים משותפים.
כשיוצרים מרחב עבודה משותף באמצעות השיטה 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 אחד לכל אדם.
אתם יכולים לנהל את חברי המרחב המשותף באמצעות השיטות הבאות:
כל שיטה מקבלת פרמטר נתיב, כאשר בשיטות create ו-list השדה parent משמש לסימון מרחב הישיבות, ובשיטות delete ו-get השדה name משמש לסינון התוצאות על סמך מרחב הישיבות ושם המשתתף.
כל השיטות, מלבד delete, תומכות בפרמטר fields ב-SystemParameterContext. אם משמיטים את הפרמטר fields, תגובת ה-API מוגדרת כברירת מחדל ל-"name,email,role,user".
הפרמטר fields מסתמך על FieldMask לסינון התשובות. FieldMask הוא דרך שמאפשרת למפעילי ה-API לרשום את השדות שהבקשה אמורה להחזיר. זוהי רשימה של שדות מופרדים בפסיקים, שמשמשת לציון שדות מסוימים באובייקט שנעשה בהם שימוש, תוך השארת השדות האחרים ללא שינוי.
שימוש ב-FieldMask מאפשר ל-API להימנע מעבודה מיותרת ולשפר את הביצועים. מסכת שדה משמשת לשיטות create, get ו-list. למידע נוסף על מסיכות שדות, ראו שימוש במסיכות שדות במאמר בנושא Google Sheets API.