Полномочия учетных записей пользователей

Screenshot of the permissions that Webex requests when you enable the scheduler to connect to your Google account
Webex запрашивает указанные далее полномочия
Таблица 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 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

Architecture diagram showing the Google cloud, Webex cloud, and the Google Calendar client, with numbered arrows linking them.
  1. Администратор веб-сайта может включить надстройку Webex для Google Workspace в службе администрирования веб-сайта или Control Hub.

  2. Каждый отдельный пользователь авторизует полномочия надстройки Webex для Google Workspace (если администратор не выполнил авторизацию) и подключает свою учетную запись Google к своей учетной записи Webex.

  3. Webex подписывается на изменения календаря от Google.

  4. Пользователь добавляет совещание Webex в событие Календаря Google, обновляет время или тему либо копирует событие на другую дату и время.

  5. Клиент надстройки 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.

Таблица 2. API Google Apps Script, используемые планировщиком Webex

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 

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 

Получение сведений о получателе 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 

Получение доступа к сохраненному предпочтительному параметру или настройке пользователя 

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 или API Google для создания или обновления совещания; вызов какой-либо сторонней службы не будет совершен 

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

Таблица 3. REST API Google, используемые планировщиком Webex

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 и удаляется по завершении запланированного совещания.

См. https://help.webex.com/ituhp0.

Как обеспечивается защита клиентских данных, "извлекаемых" из этой интеграции?

Мы собираем только необходимые данные и храним их ровно столько, сколько они нам требуются.

Мы собираем информацию о совещаниях Webex и храним ее в облаке Webex. По прошествии отведенного периода времени информация о совещании удаляется. Этот период регулируется вашей политикой хранения, применяемой в Webex.

Какие API используются для подключения к службе Google: общедоступные или частные?

Надстройка запускается на облачной платформе Google и получает доступ непосредственно ко встроенным в Google библиотекам.

См. https://developers.google.com/apps-script/overview.