Краткое руководство по приложению Google Apps Script Chat

Создайте приложение Google Chat, в которое вы можете напрямую отправлять сообщения и которое отвечает, повторяя ваши сообщения.

Цели

• Настройте свою среду.
• Настройте скрипт.
• Опубликуйте приложение.
• Запустите скрипт.

Предпосылки

• Аккаунт Google Workspace с доступом к чату .
• Облачный проект Google .

Настройте свою среду

Откройте свой облачный проект в консоли Google Cloud.

Если он еще не открыт, откройте облачный проект, который вы собираетесь использовать для этого примера:

1. В консоли Google Cloud перейдите на страницу «Выбор проекта» .

   Выберите облачный проект

2. Выберите проект Google Cloud, который вы хотите использовать. Или нажмите «Создать проект» и следуйте инструкциям на экране. Если вы создаете проект Google Cloud, вам может потребоваться включить выставление счетов для проекта .

Включите API чата

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

• В консоли Google Cloud включите API Google Chat.

  Включить API

Настройка экрана согласия OAuth

Все приложения, использующие OAuth 2.0, требуют настройки экрана согласия. Настройка экрана согласия OAuth вашего приложения определяет, что отображается для пользователей и рецензентов приложения, и регистрирует ваше приложение, чтобы вы могли опубликовать его позже.

1. В консоли Google Cloud выберите > API и службы > Экран согласия OAuth .

   Перейти к экрану согласия OAuth

2. Выберите тип пользователя для своего приложения, затем нажмите «Создать» .
3. Заполните регистрационную форму приложения, затем нажмите «Сохранить и продолжить» .

4. На данный момент вы можете пропустить добавление областей и нажать «Сохранить и продолжить» . В будущем, когда вы будете создавать приложение для использования за пределами вашей организации Google Workspace, вы должны будете добавить и проверить области авторизации, необходимые вашему приложению.

5. Если вы выбрали Внешний для типа пользователя, добавьте тестовых пользователей:
   1. В разделе «Тестовые пользователи» нажмите «Добавить пользователей» .
   2. Введите свой адрес электронной почты и любых других авторизованных тестовых пользователей, затем нажмите «Сохранить и продолжить» .
6. Просмотрите сводку регистрации приложения. Чтобы внести изменения, нажмите Изменить . Если с регистрацией приложения все в порядке, нажмите «Вернуться к панели управления» .

Настроить скрипт

Чтобы настроить сценарий, вы используете шаблон, а затем устанавливаете свой облачный проект в сценарии приложений.

Создать скрипт из шаблона

1. Перейдите на страницу «Начало работы со скриптом приложений » .
2. Щелкните шаблон приложения чата . Возможно, вам придется прокрутить вниз, чтобы увидеть этот шаблон.
3. Щелкните Проект без названия , введите Quickstart app и щелкните Переименовать .

Скопируйте номер облачного проекта

1. Перейдите в свой облачный проект в консоли Google Cloud .
2. Щелкните Настройки и утилиты > Настройки проекта .
3. Скопируйте номер проекта .

Установите облачный проект проекта скрипта приложений

1. В проекте сценария приложений приложения Chat щелкните Параметры проекта. .
2. В разделе Проект Google Cloud Platform (GCP) нажмите Изменить проект .
3. В поле Номер проекта GCP вставьте номер проекта Google Cloud.
4. Щелкните Задать проект .

Теперь у вас есть работающий код приложения, который вы можете опробовать (как описано в следующих шагах), а затем настроить в соответствии со своими требованиями.

Убедитесь, что вы вошли в правильную учетную запись Google, когда открываете шаблон Apps Script. Текущая учетная запись может иногда переключаться на вашу учетную запись по умолчанию без вашего ведома.

Создайте тестовое развертывание

Вам нужен идентификатор развертывания для этого проекта скрипта приложений, чтобы вы могли использовать его на следующем шаге.

Чтобы получить идентификатор головного развертывания, выполните следующие действия.

1. В проекте сценария приложений приложения Chat щелкните Развернуть > Тестовые развертывания .
2. Скопируйте идентификатор развертывания Head для использования на следующем этапе и нажмите «Готово» .

Опубликовать приложение чата

Опубликуйте приложение Chat из консоли Google Cloud.

1. В консоли Google Cloud найдите Google Chat API и нажмите Google Chat API .
2. Щелкните Управление .

3. Нажмите «Конфигурация» и настройте приложение «Чат»:

   1. В поле Имя приложения введите Quickstart app .
   2. В поле URL-адрес аватара введите https://developers.google.com/chat/images/quickstart-app-avatar.png .
   3. В поле Описание введите Quickstart app .
   4. В разделе Функциональность выберите Получать сообщения 1:1 и Присоединяйтесь к пространствам и групповым беседам .
   5. В разделе «Параметры подключения» выберите проект «Скрипт приложений» и вставьте идентификатор развертывания в поле.
   6. В разделе Разрешения выберите Определенные люди и группы в вашем домене и введите свой адрес электронной почты.

4. Нажмите Сохранить и обновите страницу.

5. На странице конфигурации в разделе Статус приложения установите статус Активно — доступно для пользователей .

6. Нажмите Сохранить .

Приложение Chat готово отвечать на сообщения.

Запустить скрипт

1. Открытый чат .
2. Отправьте новое прямое сообщение в приложение, нажав Начать в чат > Найти приложения .
3. На странице «Поиск приложений» найдите Quickstart App .
4. Рядом с приложением Quickstart нажмите Чат .
5. В новом прямом сообщении с приложением введите Hello и нажмите enter .

Приложение благодарит вас за добавление и повторяет ваше сообщение.

Следующие шаги

• Создание интерактивных карточек. Сообщения карточек поддерживают определенный макет, интерактивные элементы пользовательского интерфейса, такие как кнопки, и мультимедийные элементы, такие как изображения. Используйте карточные сообщения, чтобы предоставить подробную информацию, собрать информацию от пользователей и направить пользователей к следующему шагу.
• Поддержка команд с косой чертой. Команды с косой чертой позволяют регистрировать и рекламировать определенные команды, которые пользователи могут давать вашему приложению, вводя команду, начинающуюся с косой черты ( / ), например /help .
• Диалоговые окна запуска. Диалоговые окна представляют собой оконные интерфейсы на основе карточек, которые ваше приложение может открыть для взаимодействия с пользователем. Несколько карточек можно соединять последовательно, что помогает пользователям выполнять многоэтапные процессы, такие как заполнение данных формы.