A Webex bővítmény által a Google Workspace-hez kért engedélyek

Felhasználói fiók engedélyei

Képernyőkép azokról az engedélyekről, amelyeket a Webex kér, amikor engedélyezi az ütemezőnek, hogy csatlakozzon a Google-fiókjához — 1. ábra. A Webex kéri ezeket az engedélyeket

1. táblázat. Kért engedélyek és hogyan használja őket a Webex
Engedély	Hatály	A hozzáféréshez jutott adatok	Mire használja a Webex?
Az e-mail üzenet metaadatainak megtekintése a bővítmény futtatásakor	Gmail	Tárgysor, dátum és idő, meghívottak listája	Amikor webex-értekezletet ütemez a Gmailben, az ütemező elolvassa ezeket az információkat, amelyek az értekezlet ütemezésének alapvető követelményei.
Gmail-bővítményként való futtatás	Gmail	—	Lehetővé teszi a Webex Ütemező számára, hogy a felhasználó Gmailjében fusson.
A Google Naptárban megnyitott események megtekintése	Naptár	Tárgysor, dátum és idő, meghívottak listája	Amikor megnyit egy eseményt a Google Naptárban, az ütemező elolvassa ezeket az információkat, amelyek az értekezlet ütemezésének alapvető követelményei.
A Google Naptárban megnyitott események szerkesztése	Naptár	Tárgysor	Adja hozzá a Webex konferencia adatait (kártya felhasználói felület/tulajdonság) az aktuálisan megnyitott naptáreseményhez.
Futtatás naptár-bővítményként	Naptár	—	Lehetővé teszi a Webex Ütemező számára, hogy a felhasználó Google naptárában fusson
Események megtekintése és szerkesztése az összes naptárban	Naptár	Tárgysor, dátum és idő olvasása, meghívottak listája Tárgysor szerkesztése	Lehetővé teszi számunkra, hogy támogassuk a megosztott naptár-forgatókönyveket, ugyanúgy, ahogy egyetlen felhasználó naptárában olvasunk és írunk az eseményekre.
A naptár beállításainak megtekintése	Naptár	—	A Google OAuth 2.0 megköveteli ezt a hatókört. Látod https://developers.google.com/calendar/api/guides/auth.
A tartomány felhasználóival kapcsolatos információk megtekintése	Google Workspace rendszergazda	Webex siteURL a Google felhasználói adataiban	Ha beállított egy Webex siteURL-t a Google felhasználói adataiban, akkor elolvashatjuk ezt az URL-t, és bejelentkezhetünk erre a webhelyre, mint a felhasználó alapértelmezett.
Csatlakozás külső szolgáltatáshoz	Alkalmazások parancsfájlja	Csatlakozás a Webex szolgáltatáshoz	Az Ütemezőnek fel kell hívnia a Webex szolgáltatást, hogy kérje a társított Webex-értekezlet létrehozását/frissítését/törlését.
Az alkalmazás futtatásának engedélyezése, ha nincs jelen	Alkalmazások parancsfájlja	A Google eseményobjektum elérése a Google trigger alapján	Ez lehetővé teszi az Ütemező számára, hogy akkor fusson, ha ön nincs jelen, válaszul egy Google eseményindítóra, például egy értekezlet frissítésére/törlésére a naptárban. Látod https://developers.google.com/apps-script/guides/triggers/events.
Az alkalmazáshoz társított adatok megtekintése és kezelése	Alkalmazások parancsfájlja	Az alkalmazás gyorsítótára	Az Ütemező gyorsítótárazza a Webex néhány adatát a Google storage-ban. Például a Webex webhely URL-címe és a Webex-értekezletsablon.
Az ország, a nyelv és az időzóna megtekintése	Alkalmazások parancsfájlja	A felhasználó aktuális ideje	Az Ütemező beolvassa az időzónát a társított Webex-értekezlet ütemezéséhez vagy frissítéséhez
Tekintse meg elsődleges Google-fiók e-mail címét	Egyéb	A felhasználó Gmail-fiók címe	Az ütemező beolvassa a felhasználó e-mail címét, hogy a Webex-fiókjához kösse.
Tekintse meg személyes adatait, beleértve a nyilvánosan elérhetővé tett személyes adatokat is	Egyéb	A felhasználó neve és preferált nyelve (alapértelmezett)	Az Ütemező beolvassa a felhasználó nyilvános felhasználói adatait, beleértve a teljes nevet és a felhasználó alapértelmezettként használni kívánt nyelvét.

Webex Scheduler architektúra – áttekintés

Az architektúra diagramja a Google felhőjét, a Webex felhőt és a Google Naptár klienst mutatja, számozott nyilakkal, amelyek összekapcsolják őket.

A webhely rendszergazdája a Site Administration vagy a Control Hub segítségével engedélyezi a Webex bővítményt a Google Workspace számára.
Minden egyes személy engedélyezi a Google Workspace Webex bővítményének engedélyeit (ha a rendszergazda nem engedélyezi), és összekapcsolja Google-fiókját a Webex-fiókjával.
A Webex feliratkozik a Google naptárváltozására.
A felhasználó webex-értekezletet ad hozzá egy Google Naptár-eseményhez, frissíti az időt vagy a témakört, vagy egy eseményt egy másik dátumra és időpontra másol.
A Webex bővítmény kliense megkapja a Google Naptár értesítéseit és szinkronizálja a Webex-et.

A Webex Scheduler által használt Google API-k

Az alábbi táblázatok a Webex Scheduler által használt Google API-król nyújtanak tájékoztatást.

A legtöbb esetben a Webex Scheduler a Google App Script API-t használja. Néhány esetben az ütemező a Google REST API-t használja. A Google App Script API általában becsomagolja a társított Google REST API-t. A Hivatkozás URL-oszlopa lehetőség szerint a Google App Script API-ra mutat, de szükség esetén hivatkozhat a Google REST API hivatkozási URL-címére.

2. táblázat. A Webex Scheduler által használt Google App Script API-k
Google App Script API	Mit csinál	Hivatkozás URL-címe
Naptár.getID	Felhasználói naptárazonosító bekérte, az alapértelmezett naptár azonosítója a felhasználó e-mail címe	https://developers.google.com/apps-script/reference/calendar/calendar#getId()
Naptár.getName	A naptár nevének lekérte	https://developers.google.com/apps-script/reference/calendar/calendar#getName()
Calendar.getTimezone	A naptár időzónájának lekérve	https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()
Naptár.Események.lista	Bizonyos feltételeknek megfelelő események keresése	https://developers.google.com/calendar/api/v3/reference/events/list
Calendar.Events.patch	Az adott esemény metaadatainak frissítése a webex-értekezletek adatainak tárolásához	https://developers.google.com/calendar/api/v3/reference/events/patch
CalendarEvent.résztvevők	A naptár résztvevőinek eléréséheztulajdonságok	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.conferenceData	Az eseménykonferencia-adatok eléréséhez megtenszve tulajdonságok	https://developers.google.com/calendar/api/v3/reference/events#resource
CalendarEvent.getTitle	A naptáresemény témájának lekérte.	https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()
CalendarEvent.getCreators	A naptáresemény létrehozójának lekérte	https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()
CalendarEvent.getStartTime	Az esemény kezdési időpontjának lekérte	https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()
CalendarEvent.getEndTime	Az esemény befejezési idejének lekérte	https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()
CacheService.getUserCache	A felhasználó gyorsítótárának lekérése a felhasználó beállítási beállításainak lekéréséhez	https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()
Cache.get	Adott gyorsítótár-beállítás lekérte kulccsal	https://developers.google.com/apps-script/reference/cache/cache#get(String)
Cache.put	Adott gyorsítótár beállítása kulcs szerint	https://developers.google.com/apps-script/reference/cache/cache#put(String,String)
ConferenceDataService. újConferenceDataBuilder	Hozzon létre egy google specifikus adatstruktúrát a webex értekezlet adatainak tárolásához és megjelenítéséhez	https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()
KonferenciaDataBuilder.build	Webex értekezlet-információs adatok létrehozása	https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()
GmailApp.getMessageById	A gmail-üzenet lekérése	https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)
GmailApp.createDraft	Hozzon létre egy Gmail üzenetet, amely tartalmazza a webex e-mail törzs	https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)
GmailMessage.getAlbum:	Gmail-feladó e-mailek bekéréséhez	https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()
GmailMessage.getTo	Gamil vevő bekeverő	https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()
GmailMessage.getSubject	Gmail üzenet címe	https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()
GmailMessage.getDate	Gmail-üzenet dátuma és időpontja	https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()
PropertiesService.getUserProperties	Hozzáférés a tartós felhasználói perferencia vagy beállítás eléréséhez	https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()
Properties.getProperty	Adott tulajdonság lekérte kulccsal	https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)
Properties.setProperty	Új tulajdonság beállítása kulcshoz és értékhez	https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)
Session.getEffectiveUser().getEmail	Aktuális felhasználói e-mailek lekérte	https://developers.google.com/apps-script/reference/base/user#getEmail()
ScriptApp.newTrigger	Új eseményindító beállítása az eseményfrissítés kezelésére	https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)
UrlFetchApp.fetch	Ezzel az API-val hívja a Webex Addin Service-t vagy a Google API-t értekezlet létrehozásához/frissítéséhez, nem hívunk más harmadik féltől származó szolgáltatást	https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

3. táblázat. A Webex Scheduler által használt Google REST API-k
Google REST API	Mit csinál	Hivatkozás URL-címe
POSTA https://accounts.google.com/o/oauth2/token	Google hitelesítési jogkivonat beküldése	https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code
GET https://www.googleapis.com/admin/directory/v1/users/{userKey}	A konfigurált felhasználói webex webhely lekérte	https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

Gyakran ismételt kérdések

Hogyan biztosítja a Webex az integrációt?

A bővítmény a Google felhőplatformok szerverén fut, és a rendszer nem menti a Google-adatokat, kivéve a Webex-értekezletek adatait (tárgy, meghívott lista), amelyet a Webex háttérkörnyezetben tárolnak, és az ütemezett értekezlet befejezése után törölnek.

Látod https://help.webex.com/ituhp0.

Hogyan biztosíthatjuk azokat az ügyféladatokat, amelyeket "kihúzunk" ebből az integrációból?

Csak olyan adatokat gyűjtünk, amelyekre szükségünk van, és csak addig tároljuk őket, ameddig szükséges.

Webex értekezlet-információkat gyűjtünk és tárolunk a Webex felhőben. Az értekezlet adatait egy adott idő elteltével töröljük, amelyet Ön a Webex megőrzési szabályzatával szabályoz.

Nyilvános vagy privát API-t használunk a Google szolgáltatáshoz való csatlakozáshoz?

Az Addon a Google felhőplatformján fut, és közvetlenül a Google beépített könyvtáraihoz fér hozzá.

Látod https://developers.google.com/apps-script/overview.