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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Цели

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

Предпосылки

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

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

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

  1. Перейдите в консоль Google Cloud .
  2. Рядом с Google Cloud нажмите стрелку вниз . Появится диалоговое окно со списком текущих проектов.
  3. Выберите свой проект и нажмите «Открыть» . Консоль открывает ваш проект.

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

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

Все приложения, использующие 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 .
  • Диалоговые окна запуска. Диалоговые окна представляют собой оконные интерфейсы на основе карточек, которые ваше приложение может открыть для взаимодействия с пользователем. Несколько карточек можно соединять последовательно, что помогает пользователям выполнять многоэтапные процессы, такие как заполнение данных формы.