Авторизация

Дополнениям требуется авторизация пользователя, прежде чем они смогут работать. Это относится как к опубликованным надстройкам, которые вы установили из Google Workspace Marketplace, так и к надстройкам, которые вы разрабатываете самостоятельно.

Авторизация опубликованных дополнений

После установки опубликованного дополнения сразу начинается процесс авторизации:

  1. Вам будет предложено выбрать учетную запись для установки дополнения.
  2. Затем вам будет представлен список авторизаций, необходимых надстройке для работы, чтобы вы знали, что она пытается сделать. Внимательно просмотрите этот список и, если вы все же хотите предоставить авторизацию, нажмите «Разрешить» . Это позволит использовать надстройку.
  3. Теперь вы можете запустить его из хост-приложения, которое оно расширяет. Если приложение уже было открыто на вкладке браузера, возможно, вам придется обновить вкладку, прежде чем надстройка станет доступной.

Если установленная вами надстройка позднее будет обновлена ​​и потребует дополнительных авторизаций, которые вы еще не предоставили, вам будет предложено предоставить эти разрешения при следующем использовании надстройки.

Авторизация неопубликованных дополнений Google Workspace

Дополнительная карта авторизации

Для неопубликованных надстроек не применяется такой же процесс авторизации, как для опубликованных, поскольку они еще не представлены в Google Workspace Marketplace. После установки неопубликованного дополнения авторизация не запрашивается сразу. Вместо этого процесс авторизации начинается, когда вы впервые пытаетесь использовать надстройку.

Когда надстройка запускается, она определяет, требуется ли какая-либо авторизация пользователя. Если необходима авторизация, дополнение предоставляет карту авторизации. Авторизация всегда требуется при первом запуске надстройки, а также может потребоваться, если новая версия надстройки использует ранее не авторизованную службу. Кнопка «Разрешить доступ» открывает диалоговое окно, в котором пользователь может разрешить или запретить авторизацию для надстройки.

Авторизация сторонних сервисов для надстройки Google Workspace

Надстройка Google Workspace может подключаться к сторонней службе, которая сама требует авторизации. Дополнения Google Workspace, которые подключаются к таким сервисам, требуют от пользователя двух отдельных действий:

  • Авторизация самой надстройки при ее установке или первом запуске.
  • Авторизация стороннего сервиса при первом доступе к нему.

Если надстройке Google Workspace, которую вы разрабатываете, требуется доступ к службе, не принадлежащей Google, с помощью OAuth, вам необходимо настроить соединение для этой службы при создании надстройки.

Если требуется авторизация службы, не принадлежащей Google, надстройка Google Workspace предоставляет пользователю карточку с запросом на авторизацию для этой службы. При желании вы можете настроить этот запрос авторизации или использовать карту по умолчанию.

Более подробную информацию можно найти в руководстве по подключению к сервисам, не принадлежащим Google .

Сторонние системы конференц-связи

Дополнения Google Workspace, расширяющие Календарь Google, также могут добавлять дополнительные решения для конференц-связи , которые позволяют пользователям выбирать стороннюю систему конференц-связи при редактировании событий Календаря Google. Если ваша надстройка предоставляет параметры конференц-связи, требующие от пользователя входа в систему, ваша надстройка должна предоставить пользователю такую ​​возможность.

Если пользователь пытается создать конференцию с помощью вашего дополнения без необходимости входа в систему, метод onCreateFunction решений для конференций должен вернуть объект ConferenceData , содержащий ConferenceError с URL-адресом аутентификации .

Получив этот объект, Календарь Google создает кнопку ВХОД в пользовательский интерфейс редактирования событий, которая ссылается на URL-адрес аутентификации, предоставляемый надстройкой. Затем пользователи могут использовать эту кнопку для входа в стороннюю систему перед дальнейшим использованием надстройки.

Дополнительные сведения об обработке авторизации с помощью ConferenceError . в разделе Создание сторонних конференций .

Авторизация неопубликованных дополнений редактора

Рекомендуется тестировать надстройки редактора по мере их разработки. Процесс авторизации идентичен процессу для опубликованных надстроек редактора , за исключением того, что он запускается при первой попытке протестировать надстройку. Если позже вы повторно протестируете ту же надстройку, вам больше не будет предложено авторизоваться.

Отмена авторизации дополнений

При разработке надстроек может оказаться полезным отменить их авторизацию, чтобы можно было повторно протестировать процесс авторизации.

Вы можете отменить авторизацию надстройки, выполнив следующие действия:

  1. Откройте консоль безопасности вашей учетной записи .
  2. Найдите и щелкните надстройку, авторизацию которой вы хотите отменить.
  3. Нажмите «УДАЛИТЬ ДОСТУП» .

Когда вы снова запускаете надстройку после ее отмены, поток авторизации отображается снова.