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

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

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

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

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

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

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

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

כדי להגדיר את נקודות הכניסה שדרכן אפשר להצטרף לפגישות שמתארחות במרחב משותף לפגישות, מגדירים את השדה entryPointAccess באמצעות האובייקט EntryPointAccess. מגדירים את הערך ALL כדי לאפשר את כל נקודות הכניסה, או את הערך CREATOR_APP_ONLY כדי להגביל את נקודות הכניסה רק לאלה שבבעלות הפרויקט ב-Google Cloud שבו נוצר מרחב העבודה המשותף.

יצירת דוח נוכחות

כדי ליצור דוח נוכחות למרחב המשותף, מגדירים את השדה הבווליאני attendanceReportGenerationType באמצעות האובייקט AttendanceReportGenerationType. אם תבקשו דוח, דוח הנוכחות יישמר ב-Google Drive של מארגן הפגישה ב-Google Meet, וגם תישלח הודעה באימייל.

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

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

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

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

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

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

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

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