Создайте надстройки Google Workspace в Cloud Functions, используя среду выполнения Node.js.
Цели
- Настройте свою среду.
- Создайте и разверните облачную функцию.
- Создайте и разверните надстройку.
- Установите дополнение.
Предпосылки
- Облачный проект Google .
- Убедитесь, что вы включили выставление счетов для своего облачного проекта. Узнайте, как проверить платежный статус ваших проектов .
- Cloud SDK, настроенный для облачного проекта.
Настройте свою среду
Откройте свой облачный проект в консоли Google Cloud.
- В консоли Google Cloud перейдите на страницу «Выбор проекта» .
- Выберите проект Google Cloud, который вы хотите использовать. Или нажмите «Создать проект» и следуйте инструкциям на экране. Если вы создаете проект Google Cloud, вам может потребоваться включить выставление счетов для проекта .
Настройка экрана согласия OAuth
Для дополнений Google Workspace требуется настройка экрана согласия. Настройка экрана согласия OAuth надстройки определяет, что Google показывает пользователям.
- В консоли Google Cloud выберите > API и службы > Экран согласия OAuth .
- Выберите тип пользователя для своего приложения, затем нажмите «Создать» .
- Заполните регистрационную форму приложения, затем нажмите «Сохранить и продолжить» .
На данный момент вы можете пропустить добавление областей и нажать «Сохранить и продолжить» . В будущем, когда вы будете создавать приложение для использования за пределами вашей организации Google Workspace, вы должны будете добавить и проверить области авторизации, необходимые вашему приложению.
- Если вы выбрали Внешний для типа пользователя, добавьте тестовых пользователей:
- В разделе «Проверить пользователей» нажмите «Добавить пользователей» .
- Введите свой адрес электронной почты и любых других авторизованных тестовых пользователей, затем нажмите «Сохранить и продолжить» .
- Просмотрите сводку регистрации приложения. Чтобы внести изменения, нажмите Изменить . Если с регистрацией приложения все в порядке, нажмите «Вернуться к панели управления» .
Создание и развертывание облачной функции
В локальном терминале включите Cloud Functions, Cloud Build и API надстроек Google Workspace:
gcloud services enable cloudfunctions cloudbuild.googleapis.com gsuiteaddons.googleapis.com
В пустом каталоге создайте файл
function.js
со следующим примером кода:/** * Cloud Function that loads the homepage for a * Google Workspace Add-on. * * @param {Object} req Request sent from Google * @param {Object} res Response to send back */ exports.loadHomePage = function addonsHomePage (req, res) { res.send(createAction()); }; /** Creates a card with two widgets. */ function createAction() { return { "action": { "navigations": [ { "pushCard": { "header": { "title": "Cats!" }, "sections": [ { "widgets": [ { "textParagraph": { "text": "Your random cat:" } }, { "image": { "imageUrl": "https://cataas.com/cat" } } ] } ] } } ] } }; }
Разверните функцию:
gcloud functions deploy loadHomePage --runtime nodejs12 --trigger-http
При появлении запроса укажите, что вы не разрешаете вызовы функции без проверки подлинности. Развертывание функции может занять пару минут.
Создание развертывания надстройки
Найдите адрес электронной почты сервисного аккаунта для надстройки:
gcloud workspace-add-ons get-authorization
Назначьте учетной записи службы роль
cloudfunctions.invoker
:gcloud functions add-iam-policy-binding loadHomePage \ --role roles/cloudfunctions.invoker \ --member serviceAccount:SERVICE_ACCOUNT_EMAIL
Получите URL развернутой функции. Чтобы получить URL-адрес, выполните следующую команду и найдите поле
url
в разделеhttpsTrigger
:gcloud functions describe loadHomePage
Создайте файл
deployment.json
со следующим образцом кода. ЗаменитеURL
URL-адресом развернутой функции из предыдущего шага.{ "oauthScopes": ["https://www.googleapis.com/auth/gmail.addons.execute"], "addOns": { "common": { "name": "My HTTP Add-on", "logoUrl": "https://raw.githubusercontent.com/webdog/octicons-png/main/black/beaker.png", "homepageTrigger": { "runFunction": "URL" } }, "gmail": {}, "drive": {}, "calendar": {}, "docs": {}, "sheets": {}, "slides": {} } }
Создайте развертывание:
gcloud workspace-add-ons deployments create quickstart \ --deployment-file=deployment.json
Установить надстройку
Установите развертывание в режиме разработки:
gcloud workspace-add-ons deployments install quickstart
Откройте или перезагрузите Gmail, чтобы просмотреть надстройку. На панели инструментов справа найдите значок стакана.
Щелкните значок, чтобы открыть надстройку. При появлении запроса авторизуйте надстройку.
Необязательно: очистить
Чтобы избежать взимания платы с вашей учетной записи, удалите созданные вами ресурсы:
Удалите надстройку из своего аккаунта Google:
gcloud workspace-add-ons deployments uninstall quickstart
Чтобы избежать взимания платы за ресурсы, используемые в этом кратком руководстве, удалите облачный проект:
gcloud projects delete PROJECT_ID
Замените PROJECT_ID идентификатором облачного проекта, который вы использовали для быстрого запуска. Идентификатор проекта Cloud можно найти в консоли Google Cloud на странице Dashboard .
Следующие шаги
Чтобы добавить дополнительные функции в надстройку Google Workspace, обратитесь к следующим руководствам: