Google Chat API

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

Сервис: chat.googleapis.com

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

Документ открытия

Документ обнаружения (Discovery Document) — это машиночитаемая спецификация для описания и использования REST API. Он используется для создания клиентских библиотек, плагинов IDE и других инструментов, взаимодействующих с API Google. Один сервис может предоставлять несколько документов обнаружения. Этот сервис предоставляет следующий документ обнаружения:

Конечная точка службы

Конечная точка сервиса — это базовый URL-адрес, который определяет сетевой адрес сервиса API. Один сервис может иметь несколько конечных точек сервиса. Этот сервис имеет следующую конечную точку сервиса, и все указанные ниже URI относятся к этой конечной точке сервиса:

  • https://chat.googleapis.com

Ресурс REST: v1.customEmojis

Методы
create POST /v1/customEmojis
Создает пользовательский эмодзи.
delete DELETE /v1/{name=customEmojis/*}
Удаляет пользовательский эмодзи.
get GET /v1/{name=customEmojis/*}
Возвращает сведения о пользовательском эмодзи.
list GET /v1/customEmojis
Список пользовательских эмодзи, которые видны аутентифицированному пользователю.

Ресурс REST: v1.media

Методы
download GET /v1/media/{resourceName=**}
Загрузки медиафайлов.
upload POST /upload/v1/{parent=spaces/*}/attachments:upload
Загружает вложение.

Ресурс REST: v1.spaces

Методы
completeImport POST /v1/{name=spaces/*}:completeImport
Завершает процесс импорта указанного пространства и делает его видимым для пользователей.
create POST /v1/spaces
Создает пространство.
delete DELETE /v1/{name=spaces/*}
Удаляет именованное пространство.
findDirectMessage GET /v1/spaces:findDirectMessage
Возвращает существующее прямое сообщение с указанным пользователем.
findGroupChats GET /v1/spaces:findGroupChats
Возвращает все пространства с spaceType == GROUP_CHAT , в состав которых входит именно вызывающий пользователь, а также пользователи, указанные в FindGroupChatsRequest.memberships .
get GET /v1/{name=spaces/*}
Возвращает подробную информацию о пространстве.
list GET /v1/spaces
Выводит список пространств, членом которых является звонящий.
patch PATCH /v1/{space.name=spaces/*}
Обновляет пространство.
search GET /v1/spaces:search
Возвращает список пространств в организации Google Workspace на основе поиска администратора.
setup POST /v1/spaces:setup
Создает пространство и добавляет в него указанных пользователей.

Ресурс REST: v1.spaces.members

Методы
create POST /v1/{parent=spaces/*}/members
Создает членство для вызывающего приложения чата, пользователя или группы Google.
delete DELETE /v1/{name=spaces/*/members/*}
Удаляет членство.
get GET /v1/{name=spaces/*/members/*}
Возвращает сведения о членстве.
list GET /v1/{parent=spaces/*}/members
Список членств в пространстве.
patch PATCH /v1/{membership.name=spaces/*/members/*}
Обновляет членство.

Ресурс REST: v1.spaces.messages

Методы
create POST /v1/{parent=spaces/*}/messages
Создает сообщение в чате Google.
delete DELETE /v1/{name=spaces/*/messages/*}
Удаляет сообщение.
get GET /v1/{name=spaces/*/messages/*}
Возвращает подробную информацию о сообщении.
list GET /v1/{parent=spaces/*}/messages
Выводит список сообщений в пространстве, участником которого является звонящий, включая сообщения от заблокированных участников и пространств.
patch PATCH /v1/{message.name=spaces/*/messages/*}
Обновляет сообщение.
update PUT /v1/{message.name=spaces/*/messages/*}
Обновляет сообщение.

Ресурс REST: v1.spaces.messages.attachments

Методы
get GET /v1/{name=spaces/*/messages/*/attachments/*}
Получает метаданные вложения сообщения.

Ресурс REST: v1.spaces.messages.reactions

Методы
create POST /v1/{parent=spaces/*/messages/*}/reactions
Создает реакцию и добавляет ее к сообщению.
delete DELETE /v1/{name=spaces/*/messages/*/reactions/*}
Удаляет реакцию на сообщение.
list GET /v1/{parent=spaces/*/messages/*}/reactions
Перечисляет реакции на сообщение.

Ресурс REST: v1.spaces.spaceEvents

Методы
get GET /v1/{name=spaces/*/spaceEvents/*}
Возвращает событие из пространства Google Chat.
list GET /v1/{parent=spaces/*}/spaceEvents
Перечисляет события из пространства Google Chat.

Ресурс REST: v1.users.spaces

Методы
getSpaceReadState GET /v1/{name=users/*/spaces/*/spaceReadState}
Возвращает сведения о состоянии чтения пользователя в пространстве, используемые для идентификации прочитанных и непрочитанных сообщений.
updateSpaceReadState PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}
Обновляет состояние прочтения пользователя в пространстве, используемом для определения прочитанных и непрочитанных сообщений.

Ресурс REST: v1.users.spaces.spaceNotificationSetting

Методы
get GET /v1/{name=users/*/spaces/*/spaceNotificationSetting}
Получает настройку уведомлений о пространстве.
patch PATCH /v1/{spaceNotificationSetting.name=users/*/spaces/*/spaceNotificationSetting}
Обновляет настройки уведомлений о пространстве.

Ресурс REST: v1.users.spaces.threads

Методы
getThreadReadState GET /v1/{name=users/*/spaces/*/threads/*/threadReadState}
Возвращает сведения о состоянии чтения пользователя в потоке, используемые для идентификации прочитанных и непрочитанных сообщений.