- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Опция ответа сообщения
- Попробуй это!
Создает сообщение в чате Google. Пример см. в разделе Создание сообщения .
Вызов этого метода требует аутентификации и поддерживает следующие типы аутентификации:
- Для текстовых сообщений поддерживается аутентификация пользователя или аутентификация приложения.
- Для карточных сообщений поддерживается только аутентификация приложения. (Только приложения чата могут создавать карточные сообщения.)
HTTP-запрос
POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
parent | Необходимый. Имя ресурса пространства, в котором создается сообщение. Формат: |
Параметры запроса
Параметры | |
---|---|
threadKey | Необязательный. Устарело: вместо этого используйте |
requestId | Необязательный. Уникальный идентификатор запроса для этого сообщения. Указание существующего идентификатора запроса возвращает сообщение, созданное с этим идентификатором, вместо создания нового сообщения. |
messageReplyOption | Необязательный. Указывает, запускает ли сообщение цепочку или отвечает на нее. Поддерживается только в именованных пространствах. |
messageId | Необязательный. Пользовательское имя для сообщения чата, назначенное при создании. Должен начинаться с |
Тело запроса
Тело запроса содержит экземпляр Message
.
Тело ответа
В случае успеха тело ответа содержит вновь созданный экземпляр Message
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/chat.bot
-
https://www.googleapis.com/auth/chat.import
-
https://www.googleapis.com/auth/chat.messages
-
https://www.googleapis.com/auth/chat.messages.create
Дополнительную информацию см. в руководстве по авторизации .
Опция ответа сообщения
Указывает, как ответить на сообщение. В будущем могут быть добавлены и другие штаты.
Перечисления | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED | По умолчанию. Начинает новую тему. Использование этой опции игнорирует любой включенный thread ID или . |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD | Создает сообщение как ответ на поток, указанный thread ID или . Если это не удается, вместо этого сообщение запускает новый поток. |
REPLY_MESSAGE_OR_FAIL | Создает сообщение как ответ на поток, указанный thread ID или . Если используется новый threadKey , создается новый поток. Если создать сообщение не удалось, вместо этого возвращается ошибка NOT_FOUND . |