Дозволи, запрошені надбудовою 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-адреса |
|---|---|---|
|
Calendar.getID |
Отримати ідентифікатор календаря користувача, ідентифікатором календаря за замовчуванням є адреса електронної пошти користувача |
https://developers.google.com/apps-script/reference/calendar/calendar#getId() |
|
Calendar.getName |
Отримайте ім’я календаря |
https://developers.google.com/apps-script/reference/calendar/calendar#getName() |
|
Calendar.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 |
|
CalendarEvent.attendees |
Властивості для доступу до відвідувачів календаря |
https://developers.google.com/calendar/api/v3/reference/events#resource |
|
CalendarEvent.conferenceData |
Властивості для доступу до даних конференції події |
https://developers.google.com/calendar/api/v3/reference/events#resource |
|
CalendarEvent.getTitle |
Ознайомтеся з темою події календаря. |
https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle() |
|
CalendarEvent.getCreators |
Отримати творця події календаря |
https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators() |
|
CalendarEvent.getStartTime |
Отримати час початку події |
https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime() |
|
CalendarEvent.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) |
|
Служба даних конференції. 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 приймач |
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 Служба додаткових компонентів або Google API щоб створити/оновити нараду, ми не будемо викликати жодної іншої наради 3-й вечірка служби |
https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String) |
|
Google REST API |
Що воно робить? |
Довідкова URL-адреса |
|---|---|---|
|
POST 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.
