Обзор API Google Чата

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

Аутентификация

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

Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .

Ресурсы и методы API

Ресурсы и методы REST предоставляют асинхронный доступ к пространствам чата, участникам пространства, сообщениям, реакциям на сообщения и вложениям сообщений.

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

Пространства — это места, где люди и приложения могут общаться и обмениваться файлами. Есть несколько типов помещений. Прямые сообщения (DM) — это разговоры один на один между двумя пользователями или пользователем и приложением чата. Групповые чаты — это разговоры между тремя или более пользователями и приложениями чата. Именованные пространства — это постоянные места, где люди отправляют сообщения, обмениваются файлами и сотрудничают.

Ресурс spaces представляет собой пространство.

Пространства поддерживают следующие методы:

Члены

Участники — это пользователи и приложения Chat, которые присоединились к пространству или были приглашены в него.

Ресурс spaces.members представляет члена.

Участники поддерживают следующие методы:

Сообщения

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

Ресурс spaces.messages представляет сообщение.

Сообщения поддерживают следующие методы:

Реакции

Реакции представляют собой смайлы, которые люди используют для реакции на сообщение, например 👍, 🚲 и 🌞.

Ресурс spaces.messages.reactions представляет собой реакцию.

Реакции поддерживают следующие методы:

Медиа и вложения

Медиафайл представляет собой файл, загруженный в Google Chat, например изображения, видео и документы.

media ресурс представляет собой медиафайлы, прикрепленные к сообщениям.

Вложения — это экземпляры медиафайлов, прикрепленных к сообщениям.

Ресурс spaces.messages.attachments представляет собой вложение. Вложение включает в себя медиафайлы и связанные с ними метаданные, прикрепленные к сообщению.

Медиафайлы и вложения поддерживают следующие методы:

Состояния чтения пользователем (предварительная версия для разработчиков)

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

Ресурс users.spaces представляет состояние чтения пользователя в пространстве.

users.spaces.threads представляет состояние чтения пользователя в потоке сообщений.

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