Autorizzazioni account utente

Schermata delle autorizzazioni richieste da Webex quando si abilita lo pianificatore per la connessione all'account Google
Webex richiede queste autorizzazioni
Tabella 1. Autorizzazioni richieste e come vengono utilizzate da Webex

Autorizzazione

Ambito

Accesso ai dati eseguito

A cosa consente Webex di utilizzarlo?

Visualizza i messaggio e-mail delle applicazioni quando il componente aggiuntivo è in esecuzione

Gmail

Riga oggetto, data e ora, elenco di invitati

Quando si pianifica una riunione Webex in Gmail, lo strumento di pianificazione legge queste informazioni, che sono i requisiti essenziali per la pianificazione della riunione.

Esegui come componente aggiuntivo Gmail

Gmail

Consente l'esecuzione dello scheduler Webex in Gmail di un utente.

Visualizzare gli eventi aperti in Google Calendar

Calendario

Riga oggetto, data e ora, elenco di invitati

Quando si apre un evento in Google Calendar, lo strumento di pianificazione legge queste informazioni, che sono i requisiti essenziali per la pianificazione della riunione.

Modifica degli eventi aperti in Google Calendar

Calendario

Riga oggetto

Aggiungere le informazioni dei dati della conferenza Webex (UI/proprietà della scheda) all'evento di calendario aperto corrente.

Esegui come componente aggiuntivo Calendario

Calendario

Consente l'esecuzione dello scheduler Webex nel Google calendar di un utente

Visualizza e modifica gli eventi su tutti i calendari

Calendario

Lettura della riga dell'oggetto, della data e dell'ora e dell'elenco degli invitati

Modifica riga oggetto

Consente di supportare scenari di calendario condivisi, come si leggono e si scrivono negli eventi nel calendario di un singolo utente.

Visualizzare le impostazioni del calendario

Calendario

Google OAuth 2.0 richiede questo ambito. Consultare .https://developers.google.com/calendar/api/guides/auth

Visualizzare le informazioni sugli utenti del dominio

Amministratore di Google Workspace

URL del sito Webex in Google User Info

Se è stato impostato un URL del sito Webex nelle informazioni utente Google, è possibile leggere questo URL e accedere a questo sito come valore predefinito dell'utente.

Connetti a un servizio esterno

Script app

Connetti a servizio Webex

Lo pianificatore deve chiamare il servizio Webex per richiedere la creazione,l'aggiornamento/eliminazione della riunione Webex associata.

Consenti l'esecuzione di questa applicazione quando l'utente non è presente

Script app

Accesso all'oggetto evento Google in base al trigger Google

Ciò consente di eseguire lo pianificatore quando l'utente non è presente, in risposta a un trigger Google, ad esempio per aggiornare/eliminare una riunione nel calendario. Consultare .https://developers.google.com/apps-script/guides/triggers/events

Visualizzare e gestire i dati associati all'applicazione

Script app

Cache dell'applicazione

Lo scheduler memorizza nella cache alcune informazioni Webex nello storage Google. Ad esempio, l'URL del sito Webex e il modello riunione Webex.

Visualizza paese, lingua e fuso orario

Script app

Ora corrente dell'utente

Lo pianificatore legge il fuso orario per pianificare o aggiornare la riunione Webex associata

Vedere l'indirizzo e-mail dell'account Google principale

Altro

Indirizzo account Gmail utente

Lo pianificatore legge l'indirizzo e-mail dell'utente per associarlo al relativo account Webex.

Visualizzare le proprie informazioni personali, incluse eventuali informazioni personali rese disponibili pubblicamente

Altro

Nome dell'utente e lingua preferita (predefinito)

Lo strumento di pianificazione legge il nome informazioni utente dell'utente, incluso il nome completo e la lingua preferita da utilizzare come lingua predefinita dell'utente.

Panoramica sull'architettura del pianificatore Webex

Diagramma architetturale che mostra il cloud Google, il cloud Webex e il client Google Calendar, con frecce numerate che li collegano.
  1. L'amministratore del sito utilizza amministrazione sito o Control Hub per abilitare il componente aggiuntivo Webex per Google Workspace.

  2. Ogni persona autorizza le autorizzazioni per il componente aggiuntivo Webex per Google Workspace (se l'amministratore non autorizza) e connette il relativo account Google al relativo account Webex.

  3. Webex esegue l'abbonamento alle modifiche di calendario da Google.

  4. Un utente aggiunge una riunione Webex a un evento Google Calendar, aggiorna l'ora o l'argomento o copia un evento in un'altra data e ora.

  5. Il client del componente aggiuntivo Webex riceve le notifiche e la sincronizzazione con Webex di Google Calendar.

API Google utilizzate dallo strumenti di pianificazione Webex

Nelle tabelle seguenti vengono fornite informazioni sulle API Google utilizzate dallo strumenti di pianificazione Webex.

Per la maggior parte dei casi, lo strumenti di pianificazione Webex utilizza l'API google app script. Per alcuni casi, lo scheduler utilizza l'API Google REST. In genere, l'API dello script dell'app Google va a capo dell'API Google REST associata. La colonna URL di riferimento punta all'API di script dell'app Google, ove possibile, ma potrebbe fare riferimento all'URL di riferimento dell'API REST Google, se necessario.

Tabella 2. API script app Google utilizzate dallo strumenti di pianificazione Webex

Google App Script API

Che cosa fa

URL di riferimento

Calendar.getID 

Ottieni ID calendario utente, l'ID del calendario predefinito è l'indirizzo e-mail dell'utente 

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

Calendar.getName 

Ottenere il nome del calendario 

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

Fuso orario Calendar.get 

Ottieni il fuso orario del calendario  

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

Calendar.Events.list 

Cerca eventi  specifici  che corrispondono ad alcuni  criteri 

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

Calendar.Events.patch 

Aggiorna i metadati dell' evento  specifico per memorizzare le informazioni della riunione  webex 

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

CalendarEvent.attendees 

Le proprietà per accedere ai partecipanti del calendario 

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

DatiCalendarEvent.conference 

Le proprietà per accedere ai dati della conferenza evento 

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

CalendarEvent.getTitle 

Ottenere l'argomento dell'evento di calendario. 

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

CalendarEvent.getCreators 

Ottieni  il creatore dell'evento di calendario 

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

CalendarEvent.getStartTime 

Ottieni ora di inizio evento 

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

CalendarEvent.getEndTime 

Ottieni ora di fine evento 

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

CacheService.getUserCache 

Ottenere  la cache dell'utente per recuperare le impostazioni delle preferenze dell'utente  

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

Cache.get 

Impostazione  specifica cache per chiave 

https://developers.google.com/apps-script/reference/cache/cache#get(String)

Cache.put 

Imposta alcune cache specifiche per chiave 

https://developers.google.com/apps-script/reference/cache/cache#put(String,String)

ConferenceDataService. newConferenceDataBuilder 

Crea una struttura dati specifica Google per memorizzare e visualizzare le informazioni della riunione Webex  

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

ConferenceDataBuilder.build 

Genera dati info riunione  webex 

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

GmailApp.getMessageById 

Recupera il messaggio specifico  gmail  

https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)

GmailApp.createDraft 

Crea un messaggio Gmail contenente il  corpo e-mail Webex 

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)

GmailMessage.getFrom 

Richiedi e-mail mittente Gmail 

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

GmailMessage.getTo 

Ricevitore gamil  

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

GmailMessage.getSubject 

Ottieni titolo messaggio Gmail 

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

GmailMessage.getDate 

Ottieni data e ora del messaggio Gmail 

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

PropertiesService.getUserProperties 

Accesso all'impostazione o alla funzione  permanente  dell'utente 

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

Properties.getProperty 

Ottieni proprietà specifica per chiave 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)

Proprietà.setProprietà 

Imposta nuova proprietà per chiave e valore 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)

Session.getEffectiveUser().getEmail 

Ricevi e-mail utente corrente 

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

ScriptApp.newTrigger 

Imposta un nuovo trigger per gestire l'aggiornamento dell'evento 

https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)

UrlFetchApp.fetch 

Usa questa API per chiamare Webex Servizio aggiuntivo o API di Google per creare/aggiornare la riunione, non chiameremo altro 3° parte servizio 

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

Tabella 3. API REST Google utilizzate dallo strumenti di pianificazione Webex

Google REST API

Che cosa fa

URL di riferimento

POST https://accounts.google.com/o/oauth2/token

Ottieni token autenticazione Google

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

GET https://www.googleapis.com/admin/directory/v1/users/{userKey}

Ottieni il sito Webex dell'utente configurato

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

Domande frequenti

In che modo Webex protegge l'integrazione?

Il componente aggiuntivo viene eseguito sul server delle piattaforme cloud Google e nessun dato Google viene salvato tranne le informazioni della riunione Webex (oggetto, elenco di invitati) memorizzate nel back-end Webex e eliminate al termine di riunione pianificata riunione.

Consultare .https://help.webex.com/ituhp0

Come è possibile proteggere i dati dei clienti "estrae" da questa integrazione?

Raccogliamo solo i dati necessari e li archiviaamo solo quando necessario.

Le informazioni delle riunioni Webex vengono raccolte e memorizzate nel cloud Webex. Le informazioni sulla riunione vengono eliminate dopo un determinato periodo di tempo, che vengono controllate con i criteri di conservazione di Webex.

Utilizzare un'API pubblica o privata per eseguire la connessione al servizio Google?

Il componente aggiuntivo viene eseguito sulla piattaforma cloud Google e accede direttamente alle librerie incorporate di Google.

Consultare .https://developers.google.com/apps-script/overview