Autorizzazioni richieste dal componente aggiuntivo Webex per Google Workspace
list-menuFeedback?
Quando autorizza Webex ad accedere al suo account Google, il componente aggiuntivo richiede le autorizzazioni per accedere ai dati degli utenti. Questo argomento elenca le autorizzazioni che richiediamo, perché ci servono e come gestiamo i suoi dati.

Autorizzazioni dell'account utente

Il suo amministratore di Google Workspace deve abilitare Google Drive, Google Docs e Google Apps Script per il suo account utente prima di poter accedere al Webex Scheduler per Google Workspace. Se non riesce ad accedere, chieda al suo amministratore di verificare che questi servizi siano abilitati.
Screenshot of the permissions that Webex requests when you enable the scheduler to connect to your Google account
Webex richiede queste autorizzazioni
Tabella 1. Autorizzazioni richieste e come le utilizza Webex

Autorizzazione

Ambito

Dati a cui ha avuto accesso

Per cosa lo usa Webex?

Visualizza i metadati dei suoi messaggi e-mail quando il componente aggiuntivo è in esecuzione

Gmail

Oggetto, data e ora, elenco degli invitati

Quando pianifica una riunione Webex in Gmail, lo scheduler legge queste informazioni, che sono i requisiti essenziali per programmare la riunione.

Esegui come componente aggiuntivo di Gmail

Gmail

—

Consente l'esecuzione di Webex Scheduler nel Gmail di un utente.

Guarda gli eventi che apre in Google Calendar

Calendario

Oggetto, data e ora, elenco degli invitati

Quando apre un evento in Google Calendar, lo scheduler legge queste informazioni, che sono i requisiti essenziali per programmare la riunione.

Modifica gli eventi che apre in Google Calendar

Calendario

Oggetto

Aggiungere le informazioni sui dati della conferenza Webex (interfaccia utente della scheda/proprietà) nell'evento di calendario aperto corrente.

Run as a Calendar add-on

Calendario

—

Consente l'esecuzione di Webex Scheduler nel calendario Google di un utente

Visualizzare e modificare gli eventi su tutti i suoi calendari

Calendario

Leggi l'oggetto, la data e l'ora, l'elenco degli invitati

Modificare la riga dell'oggetto

Ci consente di supportare scenari di calendario condivisi, nello stesso modo in cui leggiamo e scriviamo eventi nel calendario di un singolo utente.

Visualizzi le impostazioni del suo calendario

Calendario

—

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

Vedi le informazioni sugli utenti del suo dominio

Amministratore di Google Workspace

URL del sito Webex nelle informazioni utente di Google

Se ha impostato un WebEx SiteURL nelle informazioni utente di Google, allora possiamo leggere questo URL e accedere a questo sito come predefinito dell'utente.

Si connetta a un servizio esterno

App Script

Si connetta al servizio Webex

Lo Scheduler deve chiamare il servizio Webex per richiedere la creazione/aggiornamento/eliminazione della riunione Webex associata.

Permetta a questa applicazione di funzionare quando Lei non è presente

App Script

Accedere all'oggetto evento di Google in base al trigger di Google

Ciò consente allo Scheduler di funzionare quando Lei non è presente, in risposta a un trigger di Google, ad esempio per aggiornare/eliminare una riunione nel suo calendario. Vedere https://developers.google.com/apps-script/guides/triggers/events.

Visualizzare e gestire i dati associati all'applicazione

App Script

La cache dell'applicazione

Lo Scheduler memorizza nella cache alcune informazioni Webex nell'archivio di Google. Ad esempio, l'URL del sito Webex e il modello di riunione Webex.

Visualizzi il suo Paese, la sua lingua e il suo fuso orario

App Script

Ora attuale dell'utente

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

Vedi l'indirizzo email principale del suo account Google

Altro

Indirizzo dell'account Gmail dell'utente

Lo Scheduler legge l'indirizzo email dell'utente per associarlo al suo account Webex.

Vedi le sue informazioni personali, comprese tutte le informazioni personali che ha reso disponibili al pubblico

Altro

Nome utente e lingua preferita (impostazione predefinita)

Lo Scheduler legge le informazioni pubbliche sull'utente, incluso il nome completo, e la lingua preferita da utilizzare come predefinita dell'utente.

Panoramica dell'architettura Webex Scheduler

Architecture diagram showing the Google cloud, Webex cloud, and the Google Calendar client, with numbered arrows linking them.
  1. L'amministratore del suo sito utilizza Site Administration o Control Hub per abilitare il componente aggiuntivo Webex per Google Workspace.

    Il suo amministratore di Google Workspace deve abilitare anche Google Drive, Google Docs e Google Apps Script per gli utenti che devono accedere al Webex Scheduler per Google Workspace.

  2. Ogni individuo autorizza le autorizzazioni per il componente aggiuntivo Webex per Google Workspace (se il suo amministratore non lo autorizza) e collega il proprio account Google al proprio account Webex.

  3. Webex si iscrive alle modifiche al calendario di Google.

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

  5. Il client aggiuntivo Webex riceve le notifiche di Google Calendar e si sincronizza con Webex.

API di Google utilizzate dal Webex Scheduler

Le tabelle seguenti forniscono informazioni sulle API di Google utilizzate dal Webex Scheduler.

Nella maggior parte dei casi, Webex Scheduler utilizza l'API Google App Script. In alcuni casi, lo scheduler utilizza l'API REST di Google. In genere, l'API Google App Script racchiude l'API REST di Google associata. La colonna URL di riferimento rimanda all'API Google App Script ove possibile, ma può fare riferimento all'URL di riferimento dell'API REST di Google, se necessario.

Tabella 2. API Google App Script utilizzate da Webex Scheduler

API Google App Script

Cosa fa

URL di riferimento

Calendario.getID 

Ottenga l'ID del calendario dell'utente, l'ID del calendario predefinito è l'indirizzo email dell'utente 

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

Calendar.getName 

Chieda il nome del calendario 

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

calendario.getTimeZone 

Consulti il fuso orario del calendario 

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

calendar.events.list 

Cerca eventi specifici che soddisfano alcuni criteri 

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

calendar.events.patch 

Aggiornare i metadati specifici degli eventi per memorizzare le informazioni sulle riunioni Webex 

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

Evento di calendario. Partecipanti 

Le proprietà per accedere al calendario dei partecipanti 

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

Calendarevent.Dati della conferenza 

Le proprietà per accedere ai dati della conferenza dell'evento 

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

CalendarEvent.getTitle 

Consulti l'argomento dell'evento del calendario. 

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

calendarevent.getCreators 

Chiami il creatore dell'evento del calendario 

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

CalendarEvent.getStartTime 

Ottieni l'ora di inizio dell'evento 

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

Evento del calendario. GetEndTime 

Scopri l'ora di fine dell'evento 

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

cacheService.getUserCache 

Accedi alla cache dell'utente per recuperare le impostazioni delle preferenze dell'utente 

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

cache.get 

Ottieni un'impostazione specifica della cache per chiave 

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

cache.put 

Impostare una cache specifica per chiave 

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

Conference Data Service. Nuovo Conference Data Builder 

Creare una struttura dati specifica per Google per archiviare e visualizzare le informazioni sulle riunioni Webex 

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

ConferenceDatabuilder.build 

Genera dati informativi sulle riunioni Webex 

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

App Gmail. GetMessageByID 

Recupera il messaggio specifico di Gmail 

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

App Gmail. CreateDraft 

Crei un messaggio Gmail che contenga il corpo dell'email webex 

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

Messaggio Gmail.Ottieni da 

Ricevi l'email del mittente di Gmail 

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

Messaggio Gmail.Getto 

Richieda un ricevitore di posta 

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

gmailmessage.getSubject 

Ottenga il titolo del messaggio di Gmail 

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

Messaggio Gmail.getDate 

Ricevi la data e l'ora del messaggio di Gmail 

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

Propertiesservice.getUserProperties 

Accedere alla preferenza o all'impostazione persistente dell'utente 

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

Properties.getProperty 

Ottenga una proprietà specifica per chiave 

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

Properties.setProperty 

Imposta una nuova proprietà per chiave e valore 

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

session.getEffectiveUser () .getEmail 

Ricevi l'email dell'utente attuale 

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

Scriptapp.NewTrigger 

Configura un nuovo trigger per gestire l'aggiornamento degli eventi 

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

URLfetchapp.fetch 

Usa questa API per chiamare Webex Addin Service o Google API per creare/aggiornare una riunione, non chiameremo nessun altro servizio di terze parti 

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

Tabella 3. API REST di Google utilizzate da Webex Scheduler

API REST di Google

Cosa fa

URL di riferimento

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

Ottenga il token di autenticazione Google

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

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

Accedere al sito Webex 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 di Google e non viene salvato alcun dato di Google ad eccezione delle informazioni sulla riunione Webex (oggetto, elenco degli invitati) che vengono archiviate nel backend Webex ed eliminate al termine di una riunione programmata.

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

Come possiamo proteggere i dati dei clienti che «estraiamo» da questa integrazione?

Raccogliamo solo i dati di cui abbiamo bisogno e li archiviamo solo per il tempo necessario.

Raccogliamo le informazioni sulle riunioni Webex e le archiviamo nel cloud Webex. Eliminiamo le informazioni sulla riunione dopo un determinato periodo di tempo, che Lei controlla con la sua politica di conservazione Webex.

Utilizziamo un'API pubblica o privata per connetterci al servizio Google?

L'addon funziona sulla piattaforma cloud di Google e accede direttamente alle librerie integrate di Google.

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

Questo articolo è stato utile?
Questo articolo è stato utile?