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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר גם להגדיר יצירה אוטומטית של מסמכים מפגישות שנוצרו מיומן Google.

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

כל שדה ממופה לאובייקט דומה, כמו RecordingConfig,‏ TranscriptionConfig ו-SmartNotesConfig. כדי להגדיר כל אובייקט, משתמשים ב-AutoGenerationType כדי להחליף את האובייקט on או off.

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

ההבדל בין תמלילים לבין סיכומים חכמים

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

בטבלה הבאה אפשר לראות את ההבדלים ביניהם:

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

כאשר שתי התכונות מופעלות

אפשר להשתמש בכל אחת מהתכונות בנפרד, אבל אפשר גם להשתמש בתמלילים ובסיכומים חכמים בו-זמנית כדי ליצור מסמכים טובים יותר אחרי הפגישה.

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

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

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

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

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

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

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

המשאב spaces.members כולל את השדות name, user ו-role.

חשוב להבחין בין חבר לבין משתתף. משתתף הוא אדם שהצטרף לשיחה או שמשתמש במצב Companion, צופה בשיחה או משתמש במכשיר בחדר שמחובר לשיחה. יש משאב אחד conferenceRecords.participants לכל אדם.

אפשר לנהל את חברי המרחב בדרכים הבאות:

כל שיטה מקבלת פרמטר נתיב, ובשיטות create ו-list נעשה שימוש בשדה parent כדי לציין את מרחב הפגישה. בשיטות delete ו-get נעשה שימוש בשדה name כדי לסנן את התוצאות על סמך מרחב הפגישה ושם החבר. כל השיטות, חוץ מ-delete, מחזירות מופע של המשאב spaces.members.

כל השיטות, חוץ משיטת המחיקה, תומכות בפרמטר fields ב-SystemParameterContext. אם לא מציינים את הפרמטר fields, תגובת ה-API תהיה "name,email,role,user" כברירת מחדל.

הפרמטר fields מסתמך על FieldMask לסינון התגובה. FieldMask היא דרך שבה מתקשרים עם API יכולים לפרט את השדות שבקשה צריכה להחזיר. זוהי רשימה של שדות שמופרדים בפסיקים, שבה מציינים רק שדות מסוימים באובייקט שבהם רוצים להשתמש, ומשאירים את שאר השדות ללא שינוי. שימוש ב-FieldMask מאפשר ל-API להימנע מעבודה מיותרת ומשפר את הביצועים. מסכת שדות משמשת לשיטות create,‏ get ו-list. מידע נוסף על מסכות שדות זמין במאמר שימוש במסכות שדות ב-Google Sheets API.