После авторизации доступа 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 Workspace | URL веб-сайта Webex в информации о пользователе Google | Если в информации о пользователе Google указан URL веб-сайта Webex, приложение сможет считать этот 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 Workspace в службе администрирования веб-сайта или Control Hub.
Каждый отдельный пользователь авторизует полномочия надстройки Webex для Google Workspace (если администратор не выполнил авторизацию) и подключает свою учетную запись Google к своей учетной записи Webex.
Webex подписывается на изменения календаря от Google.
Пользователь добавляет совещание Webex в событие Календаря Google, обновляет время или тему либо копирует событие на другую дату и время.
Клиент надстройки Webex получает уведомления Календаря Google и синхронизируется с Webex.
API Google, используемые планировщиком Webex
В таблицах ниже приведена информация об API Google, используемых планировщиком Webex.
В большинстве случаев планировщик Webex использует API Google Apps Script. В некоторых случаях планировщик использует REST API Google. Как правило, API Google Apps Script упаковывает связанный с ним API Google REST. По возможности в столбце Reference URL (URL-адрес ссылки) указывается API Google Apps Script, однако при необходимости может быть приведен URL-адрес ссылки на API Google REST. |
API Google Apps Script | Назначение | 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 | |
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 | Получение сведений о получателе Gmail | 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 | Получение доступа к сохраненному предпочтительному параметру или настройке пользователя | |
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 или API Google для создания или обновления совещания; вызов какой-либо сторонней службы не будет совершен | https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String) |
REST API Google | Назначение | URL-адрес ссылки |
---|---|---|
POST https://accounts.google.com/o/oauth2/token | Получение токена аутентификации Google | https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code |
GET 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 библиотекам.