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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי להגדיר את ההגבלות על התכונות בשדה moderationRestrictions, משתמשים ב-enum‏ RestrictionType כדי להחיל את הערכים chatRestriction, ‏ reactionRestriction,‏ presentRestriction. מגדירים את הערך HOSTS_ONLY כדי להחיל את ההרשאות על מארגן הפגישה ועל המארח הנוסף, או את הערך NO_RESTRICTION כדי להחיל את ההרשאות על כל המשתתפים.

כדי להגביל את תפקיד ברירת המחדל שמוקצה למשתמשים כצופים, צריך להגדיר את השדה הבוליאני defaultJoinAsViewerType באמצעות הערך DefaultJoinAsViewerType enum. אם הערך של defaultJoinAsViewerType הוא on, המשתמשים מצטרפים כצופים. אם off, המשתמשים מצטרפים כמשתתפים. ברירת המחדל היא off. אם הוגדר תפקיד מפורש למשתמש ב-spaces.members, המשתמש יצטרף עם התפקיד הזה.

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

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

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

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

כל שדה ממופה לאובייקט דומה, כמו RecordingConfig , TranscriptionConfig , ו- SmartNotesConfig . כדי להגדיר כל אובייקט, משתמשים ב-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 זמין במאמר היקפי הרשאות של Meet REST API.

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

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