Method: spaces.messages.create

Создает сообщение. Пример см. в разделе Создание сообщения .

Требует аутентификации .

Создание текстового сообщения поддерживает как аутентификацию пользователя , так и аутентификацию приложения . Для аутентификации пользователя требуется область авторизации chat.messages или chat.messages.create .

Для создания карточного сообщения требуется аутентификация приложения

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

HTTP-запрос

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Необходимый. Имя ресурса пространства, в котором нужно создать сообщение.

Формат: spaces/{space}

Параметры запроса

Параметры
threadKey
(deprecated)

string

Необязательный. Устарело: вместо этого используйте thread.thread_key . Непрозрачный идентификатор потока. Чтобы начать или добавить в поток, создайте сообщение и укажите threadKey или thread.name . Пример использования см. в разделе Начать цепочку сообщений или ответить на нее .

requestId

string

Необязательный. Уникальный идентификатор запроса для этого сообщения. Указание существующего идентификатора запроса возвращает сообщение, созданное с этим идентификатором, вместо создания нового сообщения.

messageReplyOption

enum ( MessageReplyOption )

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

messageId

string

Необязательный. Пользовательское имя для сообщения чата, назначенное при создании. Должен начинаться с client- и содержать только строчные буквы, цифры и дефисы длиной до 63 символов. Укажите это поле, чтобы получить, обновить или удалить сообщение с указанным значением. Присвоение пользовательского имени позволяет приложению Chat отозвать сообщение без сохранения name сообщения из тела ответа , возвращенного при создании сообщения. Назначение пользовательского имени не заменяет сгенерированное поле name , имя ресурса сообщения. Вместо этого он задает пользовательское имя в качестве поля clientAssignedMessageId , на которое можно ссылаться при обработке последующих операций, таких как обновление или удаление сообщения. Пример использования см. в разделе Имя созданного сообщения .

Тело запроса

Тело запроса содержит экземпляр 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

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

MessageReplyOption

Указывает, как ответить на сообщение. В будущем могут быть добавлены дополнительные штаты.

перечисления
MESSAGE_REPLY_OPTION_UNSPECIFIED По умолчанию. Запускает поток.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Создает сообщение в качестве ответа на поток, указанный thread ID или threadKey . Если это не удается, вместо этого сообщение запускает новый поток.
REPLY_MESSAGE_OR_FAIL Создает сообщение в качестве ответа на поток, указанный thread ID или threadKey . В случае сбоя вместо этого возвращается ошибка NOT_FOUND .