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

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

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