Полномочия, запрашиваемые надстройками Webex для Google Workspace
После авторизации доступа 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() |
|
Календарь.События.список |
Поиск определенных событий, соответствующих некоторым критериям |
https://developers.google.com/calendar/api/v3/reference/events/list |
|
Calendar.Events.patch |
Обновите специальные метаданные event , чтобы сохранить информацию о совещании Webex |
https://developers.google.com/calendar/api/v3/reference/events/patch |
|
CalendarEvent.посетители |
Свойства для доступа посетителей календаря |
https://developers.google.com/calendar/api/v3/reference/events#resource |
|
CalendarEvent.conferenceData |
Свойства для доступа к данным конференции event-совещания |
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 |
Узнать время начала event-совещания |
https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime() |
|
CalendarEvent.getEndTime |
Получить время окончания event-совещания |
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 |
Get 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 |
Доступ к сохраняющимся полномочиям или настройкам пользователя | |
|
Properties.getProperty |
Получить специальное свойство по ключу |
https://developers.google.com/apps-script/reference/properties/properties#getProperty(String) |
|
Свойства.setСвойства |
Задать новое свойство для ключа и значения |
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) |
|
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 библиотекам.
