Есть 5 минут? Помогите нам улучшить документацию для разработчиков Google Chat, пройдя небольшой опрос .

Обзор

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

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

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

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

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

  • Сообщения могут иметь следующие взаимодействия:

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

    • Чат
    • Личное сообщение

Сообщения

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

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

К приложениям

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

Из приложений

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

  • Текст содержит обычный текстовый контент с ограниченным форматированием текста.
  • Карты определяют формат, содержание и поведение карточек, которые будут отображаться в целевом пространстве.

В следующем примере приложение для управления проектами отвечает на запрос, создавая список данных в структуру карточных данных и возвращая его в чат. Затем Google Chat отображает карточку:

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

Пространства

Пространство в Google Chat — это обобщение пространств чата и прямых сообщений. Хотя каждый тип пространства имеет определенные свойства (например, пространство чата видно нескольким пользователям, а личное сообщение — нет), часто используется общая концепция пространства.

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

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