Autorisations du compte utilisateur

Capture d’écran des permissions que Webex demande lorsque vous autorisez le programmeur à se connecter à votre compte Google
Webex demande ces autorisations
Tableau 1. Autorisations demandées et comment Webex les utilise

Autorisation

Informations

Données accédées

À quoi Webex l’utilise-t-il ?

Afficher les métadonnées de votre message électronique lorsque l’add-on est en cours d’exécution

Gmail

Ligne objet, date et heure, liste des invités

Lorsque vous programmez une réunion Webex dans Gmail, le scheduler lit ces informations, qui sont les exigences essentielles pour programmer la réunion.

Exécuter comme add-on Gmail

Gmail

Permet au scheduler Webex de s’exécuter dans Gmail d’un utilisateur.

Voir les événements que vous ouvrez dans Google Agenda

Calendrier

Ligne objet, date et heure, liste des invités

Lorsque vous ouvrez un événement dans Google Agenda, le scheduler lit ces informations, qui sont les exigences essentielles pour programmer la réunion.

Modifier les événements que vous ouvrez dans Google Agenda

Calendrier

Nom du sujet

Ajouter les informations des données de conférence Webex (IU/propriété de la carte) dans l’événement actuel du calendrier ouvert.

Exécuter en tant qu’add-on de calendrier

Calendrier

Permet au scheduler Webex de s’exécuter dans le calendrier Google d’un utilisateur

Afficher et modifier des événements sur tous vos calendriers

Calendrier

Lire la ligne de l’objet, la date et l’heure, la liste des invités

Modifier la ligne d’objet

Nous permet de prendre en charge les scénarios de calendrier partagés, de la même façon que nous lisons et écrivons aux événements dans le calendrier d’un seul utilisateur.

Afficher les paramètres de votre calendrier

Calendrier

Google OAuth 2.0 nécessite cette portée. Voir .https://developers.google.com/calendar/api/guides/auth

Voir les informations concernant les utilisateurs sur votre domaine

Administration de Google Workspace

URL du site Webex dans Google User Info

Si vous avez créé une URL de site Webex dans Infos sur l’utilisateur de Google, alors nous pouvons lire cette URL et nous connecter à ce site comme paramètre par défaut de l’utilisateur.

Se connecter à un service externe

Script des applications

Se connecter à l Service Webex

Le programmeur doit appeler l’Service Webex pour demander la création/mise à jour/la suppression de la réunion Webex associée.

Autoriser cette application à s’exécuter en votre présence

Script des applications

Accéder à l’objet d’événement Google en fonction du déclencheur Google

Ceci permet au scheduler de s’exécuter lorsque vous n’êtes pas présent, en réponse à un déclencheur Google, par exemple pour mettre à jour/supprimer une réunion dans votre calendrier. Voir .https://developers.google.com/apps-script/guides/triggers/events

Afficher et gérer les données associées à l’application

Script des applications

Cache de l’application

Le programmeur cache certaines informations Webex dans le stockage Google. Par exemple, l’URL du site Webex et les modèle de réunion Webex.

Afficher votre pays, la langue et le fuseau horaire

Script des applications

Heure actuelle de l’utilisateur

Le programmeur lit votre fuseau horaire pour programmer ou mettre à jour la réunion Webex associée

Voir l’adresse électronique principale de votre compte Google

Autre

Adresse du compte Gmail de l’utilisateur

Le programmeur lit l’adresse électronique des utilisateurs pour la lier à leur compte Webex.

Consultez vos informations personnelles, y compris les informations personnelles que vous avez rendues publiques.

Autre

Nom de l’utilisateur et langue préférée (par défaut)

Le programmeur lit l’Infos utilisateur publique de l’utilisateur, incluant le nom complet et la langue préférée à utiliser comme paramètre par défaut de l’utilisateur.

Aperçu de l’architecture du programme Webex

Diagramme d’architecture montrant le Cloud Google, le Cloud Webex et le client Google Agenda, avec des flèches numéroées les liant.
  1. L’administrateur de votre site Administration du site ou Control Hub pour activer l’add-on Webex pour Google Workspace.

  2. Chaque personne autorise les permissions pour l’add-on Webex pour Google Workspace (si votre administrateur n’autorise pas) et connecte son compte Google avec son compte Webex.

  3. Webex s’abonne aux modifications du calendrier de Google.

  4. Un utilisateur ajoute une réunion Webex à un événement Google Agenda, met à jour l’heure ou le sujet ou copie un événement à une autre date et heure.

  5. Le client d’add-on Webex reçoit les notifications et les synchronisations Google Agenda avec Webex.

API Google utilisées par le scheduler Webex

Les tableaux ci-dessous fournissent des informations sur les API Google utilisées par le scheduler Webex.

Dans la plupart des cas, le scheduleur Webex utilise l’API du script de l’application Google. Dans certains cas, le programmeur utilise l’API Google REST. Généralement, l’API du script de l’application Google wrappant l’API Google REST associée. La colonne URL de référence pointe vers l’API du script de l’application Google si possible mais peut se référer à l’URL de référence de l’API Google REST si nécessaire.

Tableau 2. API des scripts de l’application Google utilisées par le scheduler Webex

API du script de l’application Google

Ce que cela fait

URL de référence

Calendar.getID 

Obtenir l'ID du calendrier de l'utilisateur, l'id du calendrier par défaut est l'adresse électronique de l'utilisateur  

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

Calendar.getName 

Obtenez le nommément désigné du calendrier 

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

Calendar.getTimezone 

Obtenir le  fuseau horaire  du calendrier

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

Calendar.Events.list 

Rechercher des  événements spécifiques  qui correspondent à certains  critères 

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

Calendar.Events.patch 

Mettre à jour les métadonnées  spécifiques de l’éventualité  pour stocker  les informations de la réunion Webex  

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

CalendarEvent.attendees 

Les propriétés pour accéder aux invités du calendrier 

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

CalendarEvent.conferenceData 

Les propriétés permettant d'accéder aux données de la conférence d'éventualité 

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

CalendarEvent.getTitle 

Obtenir le sujet de l’événement du calendrier. 

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

CalendarEvent.getCreators 

Obtenir le créateur de l’éventualité du calendrier 

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

CalendarEvent.getStartTime 

Obtenir l'éventualité du début du minutage  

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

CalendarEvent.getEndTime 

Obtenir l'éventualité de la fin du minutage  

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

CacheService.getUserCache 

Obtenir le cache de l'utilisateur pour récupérer les paramètres de préférence de l'utilisateur 

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

Cache.get 

Obtenir un paramètre de cache spécifique par clé 

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

Cache.put 

Définir un cache spécifique par clé 

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

ConferenceDataService. newConferenceDataBuilder 

Créer une structure de données spécifique à Google pour stocker et afficher  les informations de la réunion Webex  

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

ConferenceDataBuilder.build 

Générer les  données d'informations sur la réunion Webex  

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

GmailApp.getMessageById 

Récupérer le message spécifique  gmail  

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

GmailApp.createDraft 

Créer un message Gmail contenant l'organe du courrier électronique  webex   

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

GmailMessage.getFrom 

Obtenir l'e-mail de l'expéditeur Gmail 

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

GmailMessage.getTo 

Obtenir gamil receiver 

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

GmailMessage.getSubject 

Obtenir le titre du message Gmail 

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

GmailMessage.getDate 

Obtenir la date et le minutage du message Gmail  

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

PropriétésService.getUserProperties 

Accéder au paramètre ou perférence persistant de l'utilisateur 

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

Propriétés.getProperty 

Obtenir une propriété spécifique par clé 

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

Propriétés.setProperty 

Définir une nouvelle propriété pour la clé et la valeur 

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

Session.getEffectiveUser().getEmail 

Obtenir l'adresse électronique actuelle de l'utilisateur 

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

ScriptApp.newTrigger 

Configurer un nouveau déclencheur pour gérer la mise à jour de l'éventualité 

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

UrlFetchApp.fetch 

Utilisez cette API pour passer à  Webex  Addin Service ou à Google API pour créer/mettre à jour une réunion, nous ne passerons à aucun autre service tiers  

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

Tableau 3. API Google REST utilisées par le scheduler Webex

Google REST API

Ce que cela fait

URL de référence

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

Obtenir le jeton d’authentification Google

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

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

Obtenir le site Webex de l’utilisateur configuré

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

Foire aux questions

Comment Webex sécurisation de l’intégration ?

L’add-on fonctionne sur le serveur des plateformes Google du Cloud et aucune donnée Google n’est enregistrée à l’exception des infos de la réunion Webex (sujet, liste des invités) qui est stockées dans le backend Webex et supprimées à la fin d’a programmé une réunion.

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

Comment pouvons-nous sécuriser les données des clients que nous « tirez » de cette intégration ?

Nous collectons uniquement les données dont nous avons besoin et nous les stockons uniquement aussi longtemps que nous le devons.

Nous collectons les informations sur les réunions Webex et les stockons dans le Cloud Webex. Nous supprimons les informations sur la réunion après une période de temps que vous contrôlez avec votre politique de rétention Webex.

Utilisons-nous une API publique ou privée pour se connecter au service Google ?

Addon fonctionne directement sur la plateforme Google du Cloud et accède directement aux bibliothèques intégrées de Google.

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