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

Малюнок 1. Webex запитує ці дозволи
Знімок екрана з дозволами, які Webex надсилає, коли планувальник підключається до вашого облікового запису Google
Таблиця 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-адреса

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

Calendar.Events.list 

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

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

Calendar.Events.patch 

Оновити вказані метадані події для зберігання інформації про зустріч 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)

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 

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

Properties.getProperty 

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

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

Properties.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 Service або Google API для створення/оновлення зустрічі, ми не будемо викликати будь-яку іншу сторонню службу 

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.