Обзор

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

Google Chat поддерживает командную работу, предоставляя следующие возможности:

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

Сообщения и пробелы

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

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

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

  • Сообщения между Google Chat и приложением Chat имеют определенный формат сообщений , где каждое сообщение состоит из объекта JSON, компоненты которого определяют идентификатор пользователя, стиль, содержание и другие аспекты сообщения. Приложения чата могут отправлять следующие типы сообщений:

    • Текстовые сообщения содержат обычный текстовый контент с ограниченным форматированием текста.
    • Сообщения карточек определяют формат, содержание и поведение карточек, отображаемых в пространстве. Например, сообщение-карточка может включать кнопку со ссылкой, открывающей диалог для сбора информации от пользователя.
  • В Google Chat пространства могут иметь следующие контексты:

    • Именованное или групповое пространство видно нескольким пользователям.
    • Прямое сообщение видно только пользователю в этом пространстве.

Случаи использования

Добавление приложений чата на диалоговую платформу, такую ​​как Chat, позволяет людям задавать вопросы и отдавать команды без изменения контекста. На своей серверной стороне приложение чата может получать доступ к другим системам, выступая в качестве посредника для этих систем.

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

  • Управление рабочим процессом
  • Настройка и конфигурация
  • Генерация заказа
  • Поиск
  • Сбор данных

Вот некоторые примеры того, что вы можете попросить приложение Chat сделать из пространства Chat:

  • Поиск информации. Приложение чата может получать информацию на основе структурированных или произвольных текстовых запросов, введенных пользователем.
  • Заявки на файлы. Приложение чата может генерировать отчеты об инцидентах или другие артефакты, используя информацию, предоставленную пользователем.
  • Координируйте усилия. Приложение чата может улучшить взаимодействие членов команды друг с другом, например, обеспечивая «командную память» или планирование ресурсов.

Создавайте интерактивные приложения для чата

Многие приложения чата позволяют пользователям отправлять сообщения и напрямую взаимодействовать с приложением чата. Приложения интерактивного чата могут выполнять любое из следующих действий:

  • Отвечайте на @mentions , косую черту или прямые сообщения текстовым сообщением или карточкой.
  • Откройте диалоговое окно , которое поможет пользователям выполнить многоэтапные процессы, например заполнение данных формы.
  • Предварительный просмотр ссылок , прикрепив карточки с полезной информацией, которая позволит пользователям совершать действия непосредственно в беседе.

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

Создавайте неинтерактивные приложения чата

Приложения Google Chat также могут быть неинтерактивными для пользователей, когда пользователи не могут напрямую взаимодействовать с приложением Chat, но приложение Chat напрямую вызывает API Google Chat. Например, вы можете создать приложение чата, которое отправляет сообщение в пространство, но пользователи не могут ответить на него. Этот тип архитектуры приложения чата полезен для таких вещей, как отчеты о тревогах. Дополнительную информацию см. в обзоре API Google Chat .

Создавайте чат-приложения, управляемые событиями

Приложение Chat может подписаться на события, связанные с ресурсами Chat, с помощью API Google Workspace Events. Подписка позволяет вашему приложению Chat получать информацию о событиях, которые представляют собой изменения в подписанном ресурсе Google Workspace. Например, приложение Chat может реагировать на изменения в пространстве, на которое оно подписано, например отправлять приветственное сообщение новым участникам, добавленным в пространство. Дополнительную информацию см. в разделе «Подписка на события Google Chat» .

Выберите архитектуру приложения Chat

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

  • Таблица приложений
  • Скрипт Google Apps
  • Паб/Саб
  • Google Cloud или локальный HTTP-сервер.

Дополнительные сведения см. в разделе Выбор архитектуры приложений Chat .

Доступ приложения к пользовательским данным

Когда приложение чата вызывается, ему необходимо знать, кто его вызывает, в каком контексте и как обращаться к вызывающему. Чтобы получить доступ к данным, выходящим за рамки этих основных идентификационных данных, приложению Chat необходимо предоставить доступ посредством аутентификации .

  • По умолчанию приложения чата могут считывать только базовые идентификационные данные пользователей, которые их вызывают, или пользователей, @упомянутых в том же сообщении, которое вызывает приложение. Эта информация включает отображаемое имя пользователя, идентификатор пользователя, адрес электронной почты и изображение аватара.
  • Для приложений чата, которые просматривают ссылки , приложение чата может считывать URL-адреса, добавленные в сообщение, которые соответствуют настроенным шаблонам URL-адресов приложения чата.

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

Хотите увидеть API Google Chat в действии?
Канал разработчиков Google Workspace предлагает видеоролики с советами, рекомендациями и новейшими функциями.