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

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

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

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

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

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

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

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

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

מארגני פגישות תמיד יכלו להצטרף לפגישה בלי לשלוח בקשת הצטרפות, אבל עכשיו אפשר להגדיר משתמשים נוספים שגם יוכלו להצטרף בלי לשלוח בקשה. בנוסף, אפשר להגדיר למשתתפים תפקיד בפגישה, כמו 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.

ניהול פריטי מידע שנוצרים בתהליך פיתוח (Artifacts) באופן אוטומטי

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

אפשר להגדיר מראש את פריטי המידע שנוצרו בתהליך הפיתוח (artifacts) באופן אוטומטי כשיוצרים מרחב עבודה לפגישות או אחרי שיוצרים אותו. התכונה הזו מאפשרת גם להגדיר יצירה אוטומטית של פריטים לפגישות שנוצרו ביומן Google. בשתי השיטות נדרש היקף OAuth‏ meetings.space.settings. מידע נוסף זמין במאמר היקפי הרשאות OAuth להגדרות.

אובייקטים אוטומטיים מוגדרים באמצעות האובייקט ArtifactConfig, שמופיע מתחת לאובייקט SpaceConfig, שהוא חלק מהמשאב spaces. השדה ArtifactConfig מורכב מהשדות recordingConfig,‏ transcriptionConfig ו-smartNotesConfig.

כל שדה ממופה לאובייקט דומה, כמו RecordingConfig,‏ TranscriptionConfig ו-SmartNotesConfig. כל אובייקט מוגדר באמצעות המאפיין הבוליאני 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
לקרוא ולערוך את ההגדרות של כל מרחבי הפגישות שהמשתמשים יכולים לגשת אליהם דרך כל אפליקציה אחרת, כמו יומן Google. https://www.googleapis.com/auth/meetings.space.settings

מידע נוסף על היקפי ההרשאות של OAuth זמין במאמר היקפי ההרשאות של API ל-REST.