В этом разделе объясняется, как приложение Google Chat может вызывать Chat API, который позволяет приложениям Chat выполнять такие действия, как создание пространства, добавление в него людей и публикация сообщения.
Аутентификация
Для вызова Chat API требуется аутентификация. Каждый метод Chat API требует либо аутентификации пользователя (для выполнения действий или доступа к данным от имени пользователя), либо аутентификации приложения (для выполнения действий или доступа к данным в качестве приложения Chat). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.
Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .
Клиентские библиотеки
Большинству разработчиков рекомендуется вызывать API Google Chat с помощью наших официально поддерживаемых облачных клиентских библиотек для предпочитаемого вами языка, например Python, Java или Node.js.
Если вы пишете код с помощью Google Apps Script, используйте службу расширенного чата вместо установки клиентской библиотеки.
Концепции API чата Google
Службы gRPC или ресурсы и методы REST предоставляют доступ к пространствам чата, участникам пространства, сообщениям, реакциям на сообщения, вложениям сообщений, событиям пространства и состояниям чтения пользователя.
- Пространства
Пространства — это места, где люди и приложения могут общаться и обмениваться файлами. Есть несколько типов помещений. Прямые сообщения (DM) — это разговоры один на один между двумя пользователями или пользователем и приложением чата. Групповые чаты — это разговоры между тремя или более пользователями и приложениями чата. Именованные пространства — это постоянные места, где люди отправляют сообщения, обмениваются файлами и сотрудничают.
Ссылка на ресурс:
Пример использования см.:
- Члены
Участники — это пользователи и приложения Chat, которые присоединились к пространству или были приглашены в него.
Ссылка на ресурс:
Пример использования см.:
- Сообщения
Сообщения включают в себя текстовые сообщения и карточки , размещенные в местах. К сообщениям могут быть прикреплены файлы. Люди могут реагировать на сообщения, добавляя к ним смайлы.
Ссылка на ресурс:
Пример использования см.:
- Реакции
Реакции представляют собой смайлы, которые люди используют для реакции на сообщение, например 👍, 🚲 и 🌞.
Ссылка на ресурс:
Пример использования см.:
- Пользовательские смайлы (предварительная версия для разработчиков)
Пользовательские смайлы представляют собой специальные смайлы, созданные и опубликованные внутри организации в Google Chat. Пользовательские смайлы можно включать в содержание сообщения или использовать для реакции на сообщение.
Ссылка на ресурс:
- Медиа и вложения
Медиафайл представляет собой файл, загруженный в Google Chat, например изображения, видео и документы.
Ссылка на медиа-ресурс (недоступно в RPC):
Вложения — это экземпляры медиафайлов, прикрепленных к сообщениям.
Ссылка на ресурс:
Пример использования см.:
- Космические события
События пространства представляют собой изменения в пространстве или его дочерних ресурсах, включая его участников, сообщения и реакции.
Ссылка на ресурс:
Пример использования см.:
- Состояния чтения пользователя
Состояния чтения пользователя — это одноэлементные ресурсы, которые представляют сведения о последнем прочитанном сообщении определенного пользователя в чате Google или цепочке сообщений.
Ссылка на ресурс состояния чтения пространства:
Ссылка на ресурс состояния чтения потока:
Пример использования см.:
- Настройки уведомлений в пользовательском пространстве (предварительная версия для разработчиков)
Настройки уведомлений пользовательского пространства — это одноэлементные ресурсы, которые представляют заданные настройки уведомлений пользователя в пространстве Google Chat.
Ссылка на ресурс:
Связанные темы
- Изучите примеры приложений Google Chat, чтобы начать использовать Chat API.
Помимо вызова Chat API, приложения Chat также могут:
- Получайте и отвечайте на события взаимодействия с приложением Chat , например сообщения, отправленные в приложение Google Chat, в режиме реального времени.
- Подпишитесь на события Google Chat, чтобы принимать меры или реагировать на определенные действия или изменения в Chat, например новые сообщения или изменения в составе.
В этом разделе объясняется, как приложение Google Chat может вызывать Chat API, который позволяет приложениям Chat выполнять такие действия, как создание пространства, добавление в него людей и публикация сообщений.
Аутентификация
Для вызова Chat API требуется аутентификация. Каждый метод Chat API требует либо аутентификации пользователя (для выполнения действий или доступа к данным от имени пользователя), либо аутентификации приложения (для выполнения действий или доступа к данным в качестве приложения Chat). Некоторые методы поддерживают как аутентификацию пользователя, так и аутентификацию приложения.
Дополнительные сведения об аутентификации в чате см. в разделе Обзор аутентификации .
Клиентские библиотеки
Большинству разработчиков рекомендуется вызывать API Google Chat с помощью наших официально поддерживаемых облачных клиентских библиотек для предпочитаемого вами языка, например Python, Java или Node.js.
Если вы пишете код с помощью Google Apps Script, используйте службу расширенного чата вместо установки клиентской библиотеки.
Концепции API чата Google
Службы gRPC или ресурсы и методы REST предоставляют доступ к пространствам чата, участникам пространства, сообщениям, реакциям на сообщения, вложениям сообщений, событиям пространства и состояниям чтения пользователя.
- Пространства
Пространства — это места, где люди и приложения могут общаться и обмениваться файлами. Есть несколько типов помещений. Прямые сообщения (DM) — это разговоры один на один между двумя пользователями или пользователем и приложением чата. Групповые чаты — это разговоры между тремя или более пользователями и приложениями чата. Именованные пространства — это постоянные места, где люди отправляют сообщения, обмениваются файлами и сотрудничают.
Ссылка на ресурс:
Пример использования см.:
- Члены
Участники — это пользователи и приложения Chat, которые присоединились к пространству или были приглашены в него.
Ссылка на ресурс:
Пример использования см.:
- Сообщения
Сообщения включают в себя текстовые сообщения и карточки , размещенные в местах. К сообщениям могут быть прикреплены файлы. Люди могут реагировать на сообщения, добавляя к ним смайлы.
Ссылка на ресурс:
Пример использования см.:
- Реакции
Реакции представляют собой смайлы, которые люди используют для реакции на сообщение, например 👍, 🚲 и 🌞.
Ссылка на ресурс:
Пример использования см.:
- Пользовательские смайлы (предварительная версия для разработчиков)
Пользовательские смайлы представляют собой специальные смайлы, созданные и опубликованные внутри организации в Google Chat. Пользовательские смайлы можно включать в содержание сообщения или использовать для реакции на сообщение.
Ссылка на ресурс:
- Медиа и вложения
Медиафайл представляет собой файл, загруженный в Google Chat, например изображения, видео и документы.
Ссылка на медиа-ресурс (недоступно в RPC):
Вложения — это экземпляры медиафайлов, прикрепленных к сообщениям.
Ссылка на ресурс:
Пример использования см.:
- Космические события
События пространства представляют собой изменения в пространстве или его дочерних ресурсах, включая его участников, сообщения и реакции.
Ссылка на ресурс:
Пример использования см.:
- Состояния чтения пользователя
Состояния чтения пользователя — это одноэлементные ресурсы, которые представляют сведения о последнем прочитанном сообщении определенного пользователя в пространстве Google Chat или цепочке сообщений.
Ссылка на ресурс состояния чтения пространства:
Ссылка на ресурс состояния чтения потока:
Пример использования см.:
- Настройки уведомлений в пользовательском пространстве (предварительная версия для разработчиков)
Настройки уведомлений пользовательского пространства — это одноэлементные ресурсы, которые представляют заданные настройки уведомлений пользователя в пространстве Google Chat.
Ссылка на ресурс:
Связанные темы
- Изучите примеры приложений Google Chat, чтобы начать использовать Chat API.
Помимо вызова Chat API, приложения Chat также могут:
- Получайте и отвечайте на события взаимодействия с приложением Chat , например сообщения, отправленные в приложение Google Chat, в режиме реального времени.
- Подпишитесь на события Google Chat, чтобы принимать меры или реагировать на определенные действия или изменения в Chat, например новые сообщения или изменения в составе.