Дозволи облікового запису користувача

Знімок екрана з дозволами, які Webex надсилає, коли планувальник підключається до вашого облікового запису Google
Webex запитує ці дозволи
Таблиця 1. Запитувані дозволи і те, як Webex їх використовує

Дозвіл

Область застосування

Отримано доступ до даних

Для чого використовується Webex?

Перегляд метаданих електронного повідомлення під час роботи надбудови

Gmail

Рядок теми, дата та час, список запрошених осіб

Коли ви плануєте зустріч Webex у Gmail, планувальник читає ці частини інформації, які є основними вимогами для планування зустрічі.

Запустити як додаток Gmail

Gmail

Дозволяє планувальнику Webex працювати в Gmail користувача.

Переглянути події, які ви відкриваєте в Календарі Google

Календар

Рядок теми, дата та час, список запрошених осіб

Коли ви відкриваєте подію в Календарі Google, планувальник читає ці відомості, які є основними вимогами для планування зустрічі.

Редагування подій, які ви відкриваєте в Календарі Google

Календар

Рядок теми

Додати дані конференції Webex (користувацький інтерфейс картки/властивість) до поточної відкритої події календаря.

Запустити як надбудову календаря

Календар

Дозволяє планувальнику Webex працювати в календарі Google користувача

Перегляд і редагування подій у всіх ваших календарях

Календар

Читати рядок теми, дату та час, список запрошених

Редагувати рядок теми

Дозволяє нам підтримувати спільні сценарії календаря так само, як ми читаємо і записуємо в події в календарі одного користувача.

Перегляд налаштувань календаря

Календар

Google OAuth 2.0 вимагає цієї області. Див. https://developers.google.com/calendar/api/guides/auth

Переглянути інформацію про користувачів у вашому домені

Адміністратор робочого простору Google

Сайт WebexURL в Інформації про користувача Google

Якщо ви встановили Webex siteURL в інформації про користувача Google, ми можемо прочитати цю URL-адресу та увійти на цей сайт за замовчуванням користувача.

Підключитися до зовнішньої служби

Сценарій програм

Підключитися до служби Webex

Планувальнику потрібно викликати службу Webex, щоб надіслати запит на створення/оновлення/видалення пов 'язаної зустрічі Webex.

Дозвольте цій програмі працювати, коли вас немає

Сценарій програм

Доступ до об 'єкта події Google на основі тригера Google

Це дозволяє Планувальнику запускатися, коли ви відсутні, у відповідь на тригер Google, наприклад, для оновлення/видалення зустрічі у вашому календарі. Див. https://developers.google.com/apps-script/guides/triggers/events

Перегляд даних, пов 'язаних із програмою, і керування ними

Сценарій програм

Кеш програми

Планувальник кешує деяку інформацію Webex у пам 'яті Google. Наприклад, URL-адреса сайту Webex і шаблон зустрічі Webex.

Перегляд країни, мови та часового поясу

Сценарій програм

Поточний час користувача

Планувальник читає ваш часовий пояс, щоб запланувати або оновити пов 'язану зустріч Webex

Перегляньте основну електронну адресу облікового запису Google

Інше

Адреса облікового запису Gmail користувача

Планувальник читає електронну адресу користувача, щоб прив 'язати її до облікового запису Webex.

Перегляньте особисту інформацію, зокрема всі особисті дані, які ви оприлюднили

Інше

Ім 'я користувача та бажана мова (за замовчуванням)

Планувальник зчитує загальнодоступну інформацію користувача, включаючи повне ім 'я та бажану мову, яку буде використовувати користувач за замовчуванням.

Огляд архітектури планувальника Webex

Діаграма архітектури, що показує хмару Google, хмару Webex і клієнт Календаря Google з нумерованими стрілками, що пов 'язують їх.
  1. Адміністратор сайту використовує Центр адміністрування або управління сайтом, щоб увімкнути надбудову Webex для робочого простору Google.

  2. Кожен окремий користувач авторизує дозволи для надбудови Webex для робочого простору Google (якщо ваш адміністратор не авторизує) і пов 'язує свій обліковий запис Google з обліковим записом Webex.

  3. Webex підписується на зміни календаря від Google.

  4. Користувач додає зустріч Webex до події Календаря Google, оновлює час або тему або копіює подію на іншу дату та час.

  5. Клієнт надбудови Webex отримує сповіщення Календаря Google і синхронізується з Webex.

Google API, що використовуються планувальником Webex

Наведені нижче таблиці містять інформацію про API Google, які використовуються планувальником Webex.

У більшості випадків планувальник Webex використовує API скриптів Google App. Для кількох випадків планувальник використовує Google REST API. Як правило, Google App Script API обгортає пов 'язаний з ним Google REST API. Стовпець URL-адреса посилання вказує на API скриптів Google App, де це можливо, але може посилатися на URL-адресу довідки Google REST API, якщо це необхідно.

Таблиця 2. API скриптів Google App, що використовуються планувальником Webex

API скриптів Google App

Що воно робить?

Довідкова URL-адреса

Календар.getID 

Отримати ідентифікатор календаря користувача. Ідентифікатором календаря за замовчуванням є адреса електронної пошти користувача 

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

Календар.getName 

Отримати ім’я календаря 

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

Календар.getTimezone 

Отримати часовий пояс  календаря

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

Календар.Події.список 

Шукати певні події, які відповідають деяким критеріям 

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

Календар.Події.патч 

Оновіть специфічні метадані події  для зберігання інформації про нараду Webex  

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

Подія календаря.відвідувачі 

Властивості для доступу до відвідувачів календаря 

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

КалендарПодія.конференціяДані 

Властивості для доступу до даних конференції події 

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

Подія календаря.getTitle 

Ознайомтеся з темою події календаря. 

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

КалендарEvent.getCreators 

Отримати творця події календаря 

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

Подія календаря.getStartTime 

Отримати час початку події 

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

Подія календаря.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(String)

Cache.put 

Установити певний кеш за допомогою ключа 

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

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(String)

GmailApp.createDraft 

Створіть повідомлення Gmail, яке містить текст електронного листа  Webex  

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

GmailMessage.getFrom 

Отримати електронну пошту відправника Gmail 

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

GmailMessage.getTo 

Отримати gamil receiver 

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()

Властивості.getProperty 

Отримати конкретну властивість за ключем 

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

Властивості.setProperty 

Установити нову властивість для ключа й значення 

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

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(String)

UrlFetchApp.fetch 

Використовуйте цей API, щоб здійснити виклик Webex Addin або API Google для створення/оновлення наради, ми не здійснюватимемо виклик жодній іншій  сторонній службі 

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

Таблиця 3. Google REST API, що використовуються Webex Scheduler

Google REST API

Що воно робить?

Довідкова URL-адреса

публікація 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