הרשאות חשבון משתמש

איור 1. בקשות Webex הרשאות אלה
צילום מסך של ההרשאות ש - Webex מבקשת כאשר אתה מאפשר למתזמן להתחבר לחשבון Google שלך
טבלה 1. ההרשאות המבוקשות וכיצד Webex משתמשת בהן

הרשאה

היקף

גישה לנתונים

למה Webex משתמשת בו?

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

Gmail

שורת נושא, תאריך ושעה, רשימת מוזמנים

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

הפעל כתוסף Gmail

Gmail

מאפשר ל - Webex Scheduler לפעול ב - Gmail של משתמש.

ראה את האירועים שאתה פותח ביומן Google

לוח שנה

שורת נושא, תאריך ושעה, רשימת מוזמנים

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

ערוך את האירועים שאתה פותח ביומן Google

לוח שנה

שורת נושא

הוסף מידע על ועידת Webex (ממשק משתמש/נכס) לתוך אירוע לוח השנה הנוכחי שנפתח.

הפעל כתוסף לוח שנה

לוח שנה

מאפשר ל - Webex Scheduler לפעול ביומן Google של המשתמש

הצג וערוך אירועים בכל לוחות השנה שלך

לוח שנה

קרא את שורת הנושא, התאריך והשעה, רשימת המוזמנים

ערוך שורת נושא

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

הצגת ההגדרות של לוח השנה

לוח שנה

Google OAuth 2.0 דורש היקף זה. ראה https://developers.google.com/calendar/api/guides/auth.

הצגת מידע על משתמשים בדומיין שלך

מנהל סביבת העבודה של Google

Webex siteURL בפרטי המשתמש של Google

אם הגדרת Webex siteURL בפרטי המשתמש של Google, נוכל לקרוא כתובת אתר זו ולהתחבר לאתר זה כברירת המחדל של המשתמש.

התחברות לשירות חיצוני

סקריפט יישומים

התחברות לשירות Webex

המתזמן צריך להתקשר לשירות Webex כדי לבקש ליצור/לעדכן/למחוק את הפגישה המשויכת ל - Webex.

אפשר ליישום זה לפעול כאשר אינך נוכח

סקריפט יישומים

גישה לאובייקט האירוע של Google המבוסס על ההדק של Google

פעולה זו מאפשרת למתזמן לפעול כאשר אינך נוכח, בתגובה להפעלת Google, לדוגמה כדי לעדכן/למחוק פגישה ביומן שלך. ראה https://developers.google.com/apps-script/guides/triggers/events.

הצג ונהל נתונים המשויכים ליישום

סקריפט יישומים

המטמון של היישום

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

הצג את הארץ, השפה ואזור הזמן שלך

סקריפט יישומים

השעה הנוכחית של המשתמש

המתזמן קורא את אזור הזמן שלך כדי לתזמן או לעדכן את פגישת Webex המשויכת

ראה את כתובת הדוא"ל הראשית של חשבון Google שלך

אחר

כתובת חשבון Gmail של המשתמש

המתזמן קורא את כתובת הדוא"ל של המשתמש כדי לקשור אותה לחשבון ה - Webex שלו.

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

אחר

שם המשתמש והשפה המועדפת (ברירת מחדל)

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

סקירה כללית של ארכיטקטורת מתזמן Webex

תרשים ארכיטקטורה המציג את הענן של Google, את הענן של Webex ואת הלקוח של יומן Google, עם חיצים ממוספרים המקשרים ביניהם.
  1. מנהל האתר שלך משתמש ב - Site Administration או ב - Control Hub כדי להפעיל את ההרחבה Webex עבור Google Workspace.

  2. כל אדם מאשר הרשאות עבור ההרחבה Webex עבור Google Workspace (אם מנהל המערכת שלך לא מאשר) ומחבר את חשבון Google שלו עם חשבון Webex שלו.

  3. Webex נרשמת לשינויים ביומן מ - Google.

  4. משתמש מוסיף פגישת Webex לאירוע של יומן Google, מעדכן את השעה או הנושא או מעתיק אירוע לתאריך ושעה אחרים.

  5. לקוח ההרחבה של Webex מקבל התראות של יומן Google ומסנכרן אותן עם Webex.

ממשקי API של Google המשמשים את מתזמן Webex

הטבלאות שלהלן מספקות מידע על ממשקי ה - API של Google המשמשים את מתזמן Webex.


ברוב המקרים, מתזמן ה - Webex משתמש בממשק ה - API של Google App Script. במקרים ספורים, המתזמן משתמש בממשק API של Google REST. באופן כללי, ממשק ה - API של Google App Script עוטף את ממשק ה - API של Google REST המשויך אליו. העמודה כתובת URL של הפניה מצביעה על ממשק ה - API של Google App Script במידת האפשר, אך עשויה להתייחס לכתובת ה - URL של Google REST API להפניה במידת הצורך.

טבלה 2. ממשקי API של Google App Script המשמשים את Webex Scheduler

ממשק API של Google App Script

מה הוא עושה?

כתובת אתר לסימוכין

Calendar.getID 

קבל את מזהה לוח השנה של המשתמש, המזהה של לוח השנה המוגדר כברירת מחדל הוא כתובת הדוא"ל של המשתמש 

https://developers.google.com/apps-script/reference/calendar/calendar#getId()

לוח שנה.getName 

קבל את שם לוח השנה 

https://developers.google.com/apps-script/reference/calendar/calendar#getName()

Calendar.getTimezone 

הצגת אזור הזמן של לוח השנה 

https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()

לוח שנה.Events.list 

חיפוש אירועים ספציפיים שתואמים לקריטריונים מסוימים 

https://developers.google.com/calendar/api/v3/reference/events/list

לוח שנה.Events.patch 

עדכן את המטא נתונים של האירוע הספציפי כדי לאחסן את פרטי הפגישה של Webex 

https://developers.google.com/calendar/api/v3/reference/events/patch

CalendarEvent.tendees 

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

https://developers.google.com/calendar/api/v3/reference/events#resource

לוח שנהEvent.conferenceData 

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

https://developers.google.com/calendar/api/v3/reference/events#resource

CalendarEvent.getTitle 

קבל את הנושא של אירוע לוח השנה. 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()

CalendarEvent.getCreators 

קבל את יוצר האירוע של היומן 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()

CalendarEvent.getStartTime 

קבל את שעת ההתחלה של האירוע 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()

CalendarEvent.getEndTime 

קבל את שעת הסיום של האירוע 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()

CacheService.getUserCache 

קבל את המטמון של המשתמש כדי לאחזר את הגדרות ההעדפה של המשתמש 

https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()

Cache.get 

קבל הגדרת מטמון ספציפית לפי מפתח 

https://developers.google.com/apps-script/reference/cache/cache#get(מחרוזת)

Cache.put 

הגדר מטמון ספציפי לפי מפתח 

https://developers.google.com/apps-script/reference/cache/cache#put(מחרוזת,מחרוזת)

ConferenceDataService. newConferenceDataBuilder 

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

https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()

ConferenceDataBuilder.build 

צור נתוני פגישות של Webex 

https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()

GmailApp.getMessageById 

אחזר את הודעת ה  - Gmail הספציפית 

https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(מחרוזת)

GmailApp.createDraft 

צור הודעת Gmail המכילה את גוף הדוא"ל של Webex 

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(מחרוזת,מחרוזת,מחרוזת)

GmailMessage.getFrom 

קבל דוא"ל שולח Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()

GmailMessage.getTo 

קבל מקלט גאמיל 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()

GmailMessage.getSubject 

קבל כותרת הודעת Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()

GmailMessage.getDate 

קבל את תאריך ושעת ההודעה של Gmail 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()

PropertiesService.getUserProperties 

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

https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()

Properties.getProperty 

קבל נכס ספציפי לפי מפתח 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(מחרוזת)

Properties.setProperty 

הגדר נכס חדש עבור מפתח וערך 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(מחרוזת,מחרוזת)

Session.getEffectiveUser ().getEmail 

קבל דוא"ל משתמש נוכחי 

https://developers.google.com/apps-script/reference/base/user#getEmail()

ScriptApp.newTrigger 

הגדר הדק חדש לטיפול בעדכון אירועים 

https://developers.google.com/apps-script/reference/script/script-app#newTrigger(מחרוזת)

UrlFetchApp.fetch 

השתמש ב - API זה כדי להתקשר לשירות ההרחבה של Webex או ל - API של Google כדי ליצור/לעדכן פגישה, לא נתקשר לאף שירות צד שלישי אחר 

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(מחרוזת)

טבלה 3. ממשקי API למנוחה של Google המשמשים את מתזמן Webex

Google REST API

מה הוא עושה?

כתובת אתר לסימוכין

פרסם HTTPS://ACCOUNTS.GOOGLE.COM/O/OAUTH2/TOKEN

קבל אסימון אימות של Google

https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code

קבל https://www.googleapis.com/admin/directory/v1/users/{ userKey}

קבל את אתר ה - Webex של המשתמש המוגדר

https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

שאלות נפוצות

איך Webex מאבטחת את האינטגרציה?

ההרחבה פועלת בשרת של פלטפורמות הענן של Google, ולא נשמרים נתוני Google, למעט פרטי הפגישה של Webex (נושא, רשימת מוזמנים) המאוחסנים ב - Webex ונמחקים לאחר סיום פגישה מתוזמנת.

ראה https://help.webex.com/ituhp0.

כיצד אנו מאבטחים את נתוני הלקוחות שאנו "מושכים" משילוב זה?

אנחנו אוספים רק מידע שאנחנו צריכים, ואנחנו מאחסנים אותו רק כל עוד אנחנו צריכים.

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

האם אנו משתמשים בממשק API ציבורי או פרטי כדי להתחבר לשירות Google?

ההרחבה פועלת בפלטפורמת הענן של Google וגישה ישירה לספריות המובנות של Google.

ראה https://developers.google.com/apps-script/overview.