Дозволи, запрошені надбудовою Webex для робочого простору Google
Коли ви авторизуєте Webex для доступу до свого облікового запису Google, надбудова запитує дозволи на доступ до даних користувача. У цьому розділі наведено список необхідних дозволів, навіщо вони нам потрібні та як ми обробляємо ваші дані.
Дозволи облікового запису користувача
Дозвіл |
Область застосування |
Отримано доступ до даних |
Для чого використовується 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
-
Адміністратор сайту використовує Центр адміністрування або управління сайтом, щоб увімкнути надбудову Webex для робочого простору Google.
-
Кожен окремий користувач авторизує дозволи для надбудови Webex для робочого простору Google (якщо ваш адміністратор не авторизує) і пов 'язує свій обліковий запис Google з обліковим записом Webex.
-
Webex підписується на зміни календаря від Google.
-
Користувач додає зустріч Webex до події Календаря Google, оновлює час або тему або копіює подію на іншу дату та час.
-
Клієнт надбудови 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, якщо це необхідно.
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 | |
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 | |
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 |
Доступ до постійного дозволу користувача або налаштувань | |
Властивості.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) |
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 і видаляється після завершення запланованої зустрічі.
- Як нам захистити дані клієнтів, які ми "витягуємо" з цієї інтеграції?
-
Ми збираємо лише ті дані, які нам потрібні, і зберігаємо їх лише стільки, скільки нам потрібно.
Ми збираємо інформацію про зустрічі Webex і зберігаємо її в хмарі Webex. Ми видаляємо інформацію про зустріч через певний проміжок часу, який ви контролюєте відповідно до своєї політики збереження Webex.
- Чи використовуємо ми загальнодоступний або приватний API для підключення до служби Google?
-
Додаток працює на хмарній платформі Google і має безпосередній доступ до вбудованих бібліотек Google.