REST Resource: spaces.messages

Ресурс: Сообщение

Сообщение в чате Google.

JSON-представление
{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "privateMessageViewer": {
    object (User)
  },
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ],
  "accessoryWidgets": [
    {
      object (AccessoryWidget)
    }
  ]
}
Поля
name

string

Идентификатор. Имя ресурса сообщения.

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

Где {space} — это идентификатор пространства, в котором размещено сообщение, а {message} — это системный идентификатор сообщения. Например, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB .

Если вы задали пользовательский идентификатор при создании сообщения, вы можете использовать этот идентификатор для указания сообщения в запросе, заменив {message} значением из поля clientAssignedMessageId . Например, spaces/AAAAAAAAAAA/messages/client-custom-name . Подробности см. в разделе Name a message .

sender

object ( User )

Только вывод. Пользователь, создавший сообщение. Если ваше приложение Chat аутентифицируется как пользователь , вывод заполняет name пользователя и type .

createTime

string ( Timestamp format)

Необязательно. Неизменяемо. Для пространств, созданных в чате, время создания сообщения. Это поле выводится только, за исключением случаев использования в пространствах режима импорта.

Для пространств в режиме импорта установите в этом поле историческую временную метку, когда сообщение было создано в источнике, чтобы сохранить исходное время создания.

lastUpdateTime

string ( Timestamp format)

Только вывод. Время последнего редактирования сообщения пользователем. Если сообщение никогда не редактировалось, это поле пустое.

deleteTime

string ( Timestamp format)

Только вывод. Время удаления сообщения в Google Chat. Если сообщение никогда не удалялось, это поле пустое.

text

string

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

Информацию о создании текстовых сообщений см. в разделе Отправка сообщения .

formattedText

string

Только вывод. Содержит text сообщения с разметкой, добавленной для передачи форматирования. Это поле может не охватывать все форматирование, видимое в пользовательском интерфейсе, но включает следующее:

  • Синтаксис разметки для полужирного, курсивного, зачеркнутого, моноширинного шрифта, моноширинного блока и маркированного списка.

  • Пользователь упоминает, используя формат <users/{user}> .

  • Пользовательские гиперссылки с использованием формата <{url}|{rendered_text}> , где первая строка — это URL-адрес, а вторая — отображаемый текст, например, <http://example.com|custom text> .

  • Пользовательские эмодзи в формате :{emojiName}: — например, :smile: . Это не относится к эмодзи Unicode, таким как U+1F600 для эмодзи с ухмылкой.

Для получения дополнительной информации см. Просмотр форматирования текста, отправленного в сообщении.

cards[]
(deprecated)

object ( Card )

Устарело: вместо этого используйте cardsV2 .

Богатые, отформатированные и интерактивные карточки, которые можно использовать для отображения элементов пользовательского интерфейса, таких как: отформатированные тексты, кнопки и кликабельные изображения. Карточки обычно отображаются под текстовым текстом сообщения. cards и cardsV2 могут иметь максимальный размер 32 КБ.

cardsV2[]

object ( CardWithId )

Необязательно. Массив карт .

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

Чтобы узнать, как создать сообщение, содержащее карточки, см. раздел Отправка сообщения .

Создавайте и просматривайте открытки с помощью Card Builder.

Откройте конструктор карт

annotations[]

object ( Annotation )

Только вывод. Аннотации, связанные с text в этом сообщении.

thread

object ( Thread )

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

space

object ( Space )

Только вывод. Если ваше приложение Chat аутентифицируется как пользователь , вывод заполняет только name пространства .

fallbackText

string

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

actionResponse

object ( ActionResponse )

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

argumentText

string

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

slashCommand

object ( SlashCommand )

Только вывод. Информация о команде с косой чертой, если применимо.

attachment[]

object ( Attachment )

Необязательно. Загружаемое пользователем вложение.

matchedUrl

object ( MatchedUrl )

Только вывод. URL в spaces.messages.text , который соответствует шаблону предварительного просмотра ссылки. Для получения дополнительной информации см. Предварительный просмотр ссылок .

threadReply

boolean

Только вывод. Если true , сообщение является ответом в ветке ответов. Если false , сообщение отображается в верхнем уровне беседы пространства как первое сообщение в ветке или как сообщение без ответов в ветке.

Если пространство не поддерживает ответы в цепочках, это поле всегда имеет false .

clientAssignedMessageId

string

Необязательно. Пользовательский идентификатор для сообщения. Вы можете использовать поле для идентификации сообщения или для получения, удаления или обновления сообщения. Чтобы задать пользовательский идентификатор, укажите поле messageId при создании сообщения. Подробности см. в разделе Имя сообщения .

emojiReactionSummaries[]

object ( EmojiReactionSummary )

Только вывод. Список эмодзи-реакций на сообщение.

privateMessageViewer

object ( User )

Необязательно. Неизменяемое. Ввод для создания сообщения, в противном случае только вывод. Пользователь, который может просматривать сообщение. Если установлено, сообщение является приватным и видно только указанному пользователю и приложению Chat. Чтобы включить это поле в запрос, необходимо вызвать API Chat с использованием аутентификации приложения и опустить следующее:

Подробную информацию см. в разделе «Отправить личное сообщение» .

deletionMetadata

object ( DeletionMetadata )

Только вывод. Информация об удаленном сообщении. Сообщение удаляется, когда установлено deleteTime .

quotedMessageMetadata

object ( QuotedMessageMetadata )

Только вывод. Информация о сообщении, которое цитирует пользователь Google Chat в пространстве. Пользователи Google Chat могут цитировать сообщение, чтобы ответить на него.

attachedGifs[]

object ( AttachedGif )

Только вывод. GIF-изображения, прикрепленные к сообщению.

accessoryWidgets[]

object ( AccessoryWidget )

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

Создание сообщения с помощью дополнительных виджетов требует аутентификации приложения .

CardWithId

Карточка в сообщении Google Chat.

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

Создавайте и просматривайте открытки с помощью Card Builder.

Откройте конструктор карт

JSON-представление
{
  "cardId": string,
  "card": {
    object (Card)
  }
}
Поля
cardId

string

Обязательно, если сообщение содержит несколько карт. Уникальный идентификатор карты в сообщении.

card

object ( Card )

Карточка. Максимальный размер 32 КБ.

Аннотация

Только вывод. Аннотации, связанные с текстовым текстом сообщения. Чтобы добавить базовое форматирование к текстовому сообщению, см. Форматирование текстовых сообщений .

Пример текста сообщения:

Hello @FooBot how are you!"

Соответствующие метаданные аннотаций:

"annotations":[{
  "type":"USER_MENTION",
  "startIndex":6,
  "length":7,
  "userMention": {
    "user": {
      "name":"users/{user}",
      "displayName":"FooBot",
      "avatarUrl":"https://goo.gl/aeDtrS",
      "type":"BOT"
    },
    "type":"MENTION"
   }
}]
JSON-представление
{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  },
  "richLinkMetadata": {
    object (RichLinkMetadata)
  },
  "customEmojiMetadata": {
    object (CustomEmojiMetadata)
  }
  // End of list of possible types for union field metadata.
}
Поля
type

enum ( AnnotationType )

Тип этой аннотации.

length

integer

Длина подстроки в текстовом теле сообщения, которой соответствует эта аннотация.

startIndex

integer

Начальный индекс (начиная с 0 включительно) в тексте сообщения, которому соответствует эта аннотация.

metadata поля объединения. Дополнительные метаданные об аннотации. metadata могут быть только одними из следующих:
userMention

object ( UserMentionMetadata )

Метаданные упоминания пользователя.

slashCommand

object ( SlashCommandMetadata )

Метаданные для команды с косой чертой.

customEmojiMetadata

object ( CustomEmojiMetadata )

Метаданные для пользовательского эмодзи.

Тип аннотации

Тип аннотации.

Перечисления
ANNOTATION_TYPE_UNSPECIFIED Значение по умолчанию для перечисления. Не использовать.
USER_MENTION Упоминается пользователь.
SLASH_COMMAND Вызывается команда с косой чертой.
CUSTOM_EMOJI Пользовательская аннотация с эмодзи.

UserMentionМетаданные

Метаданные аннотаций для упоминаний пользователей (@).

JSON-представление
{
  "user": {
    object (User)
  },
  "type": enum (Type)
}
Поля
user

object ( User )

Пользователь упомянул.

type

enum ( Type )

Тип упоминания пользователя.

Тип

Перечисления
TYPE_UNSPECIFIED Значение по умолчанию для перечисления. Не использовать.
ADD Добавить пользователя в пространство.
MENTION Упомяните пользователя в поле.

SlashCommandМетаданные

Метаданные аннотаций для команд с косой чертой (/).

JSON-представление
{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}
Поля
bot

object ( User )

Приложение чата, команда которого была вызвана.

type

enum ( Type )

Тип команды слэш.

commandName

string

Имя вызванной слэш-команды.

commandId

string ( int64 format)

Идентификатор вызванной слэш-команды.

triggersDialog

boolean

Указывает, предназначена ли команда с косой чертой для диалога.

Тип

Перечисления
TYPE_UNSPECIFIED Значение по умолчанию для перечисления. Не использовать.
ADD Добавьте приложение «Чат» в пространство.
INVOKE Вызовите команду слэш в пробеле.

RichLinkМетаданные

Расширенная ссылка на ресурс.

JSON-представление
{
  "uri": string,
  "richLinkType": enum (RichLinkType),

  // Union field data can be only one of the following:
  "driveLinkData": {
    object (DriveLinkData)
  },
  "chatSpaceLinkData": {
    object (ChatSpaceLinkData)
  }
  // End of list of possible types for union field data.
}
Поля
uri

string

URI этой ссылки.

data поля объединения. Данные для связанного ресурса. data могут быть только одними из следующих:

RichLinkType

Тип ссылки rich. В будущем могут быть добавлены и другие типы.

Перечисления
DRIVE_FILE Тип расширенной ссылки Google Диска.
CHAT_SPACE Тип ссылки на чат-пространство. Например, космический смарт-чип.

DriveLinkData

Данные для ссылок Google Диска.

JSON-представление
{
  "driveDataRef": {
    object (DriveDataRef)
  },
  "mimeType": string
}
Поля
driveDataRef

object ( DriveDataRef )

DriveDataRef , ссылающийся на файл Google Диска.

mimeType

string

Тип MIME связанного ресурса Google Диска.

ChatSpaceLinkData

Данные для ссылок на чат-пространство.

JSON-представление
{
  "space": string,
  "thread": string,
  "message": string
}
Поля
space

string

Пространство связанного ресурса пространства чата.

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

thread

string

Ветка связанного ресурса чат-пространства.

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

message

string

Сообщение связанного ресурса чат-пространства.

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

ПользовательскиеEmojiMetadata

Метаданные аннотаций для пользовательских эмодзи.

JSON-представление
{
  "customEmoji": {
    object (CustomEmoji)
  }
}
Поля
customEmoji

object ( CustomEmoji )

Пользовательские эмодзи.

Нить

Тред в пространстве Google Chat. Пример использования см. в разделе Начать или ответить на тред сообщений .

Если вы указываете ветку при создании сообщения, вы можете задать поле messageReplyOption , чтобы определить, что произойдет, если соответствующая ветка не будет найдена.

JSON-представление
{
  "name": string,
  "threadKey": string
}
Поля
name

string

Идентификатор. Имя ресурса потока.

Пример: spaces/{space}/threads/{thread}

threadKey

string

Необязательно. Ввод для создания или обновления потока. В противном случае только вывод. Идентификатор потока. Поддерживает до 4000 символов.

Этот идентификатор уникален для приложения Chat, которое его устанавливает. Например, если несколько приложений Chat создают сообщение, используя один и тот же ключ потока, сообщения публикуются в разных потоках. Чтобы ответить в потоке, созданном человеком или другим приложением Chat, укажите вместо этого поле name потока.

ДействиеОтвет

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

JSON-представление
{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  },
  "updatedWidget": {
    object (UpdatedWidget)
  }
}
Поля
type

enum ( ResponseType )

Только ввод. Тип ответа приложения чата.

url

string

Только ввод. URL-адрес для аутентификации или настройки пользователей. (Только для типов ответов REQUEST_CONFIG .)

dialogAction

object ( DialogAction )

Только ввод. Ответ на событие взаимодействия, связанное с диалогом . Должен сопровождаться ResponseType.Dialog .

updatedWidget

object ( UpdatedWidget )

Только ввод. Ответ обновленного виджета.

Тип ответа

Тип ответа приложения чата.

Перечисления
TYPE_UNSPECIFIED Тип по умолчанию, который обрабатывается как NEW_MESSAGE .
NEW_MESSAGE Опубликовать как новое сообщение в теме.
UPDATE_MESSAGE Обновить сообщение приложения Chat. Это разрешено только для события CARD_CLICKED , где тип отправителя сообщения — BOT .
UPDATE_USER_MESSAGE_CARDS Обновить карточки в сообщении пользователя. Это разрешено только в ответ на событие MESSAGE с соответствующим URL-адресом или событие CARD_CLICKED , где тип отправителя сообщения — HUMAN . Текст игнорируется.
REQUEST_CONFIG В частном порядке запросите у пользователя дополнительную аутентификацию или настройку.
DIALOG Представляет диалог .
UPDATE_WIDGET Запрос параметров автозаполнения текста виджета.

ДиалогДействие

Содержит диалог и код статуса запроса.

JSON-представление
{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}
Поля
actionStatus

object ( ActionStatus )

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

action поля союза. Действие для выполнения. action может быть только одним из следующих:
dialog

object ( Dialog )

Только ввод. Диалог для запроса.

Диалог

Обертка вокруг тела карточки диалога.

JSON-представление
{
  "body": {
    object (Card)
  }
}
Поля
body

object ( Card )

Только ввод. Тело диалога, отображаемое в модальном окне. Приложения Google Chat не поддерживают следующие сущности карт: DateTimePicker , OnChangeAction .

ДействиеСтатус

Представляет статус запроса на вызов или отправку диалога .

JSON-представление
{
  "statusCode": enum (Code),
  "userFacingMessage": string
}
Поля
statusCode

enum ( Code )

Код статуса.

userFacingMessage

string

Сообщение для отправки пользователям о статусе их запроса. Если не установлено, отправляется общее сообщение на основе statusCode .

Код

Канонические коды ошибок для API gRPC.

Иногда могут применяться несколько кодов ошибок. Службы должны возвращать наиболее конкретный код ошибки, который применяется. Например, предпочитайте OUT_OF_RANGE вместо FAILED_PRECONDITION , если применяются оба кода. Аналогично предпочитайте NOT_FOUND или ALREADY_EXISTS вместо FAILED_PRECONDITION .

Перечисления
OK

Это не ошибка; возвращается в случае успешного выполнения.

HTTP-сопоставление: 200 OK

CANCELLED

Операция была отменена, как правило, звонившим.

HTTP-сопоставление: 499 Клиент закрыл запрос

UNKNOWN

Неизвестная ошибка. Например, эта ошибка может быть возвращена, когда значение Status полученное из другого адресного пространства, принадлежит пространству ошибок, которое неизвестно в этом адресном пространстве. Также ошибки, вызванные API, которые не возвращают достаточно информации об ошибках, могут быть преобразованы в эту ошибку.

HTTP-сопоставление: 500 Внутренняя ошибка сервера

INVALID_ARGUMENT

Клиент указал недопустимый аргумент. Обратите внимание, что это отличается от FAILED_PRECONDITION . INVALID_ARGUMENT указывает на аргументы, которые являются проблемными независимо от состояния системы (например, неправильно сформированное имя файла).

HTTP-сопоставление: 400 Bad Request

DEADLINE_EXCEEDED

Крайний срок истек до того, как операция могла быть завершена. Для операций, которые изменяют состояние системы, эта ошибка может быть возвращена, даже если операция была успешно завершена. Например, успешный ответ от сервера мог быть задержан достаточно надолго, чтобы истечь крайний срок.

HTTP-сопоставление: 504 Истекло время ожидания шлюза

NOT_FOUND

Некоторая запрошенная сущность (например, файл или каталог) не найдена.

Примечание для разработчиков сервера: если запрос отклонен для целого класса пользователей, например, постепенное развертывание функций или недокументированный список разрешенных, можно использовать NOT_FOUND . Если запрос отклонен для некоторых пользователей в классе пользователей, например, управление доступом на основе пользователей, необходимо использовать PERMISSION_DENIED .

HTTP-сопоставление: 404 Не найдено

ALREADY_EXISTS

Объект, который клиент пытался создать (например, файл или каталог), уже существует.

HTTP-сопоставление: конфликт 409

PERMISSION_DENIED

У вызывающего нет разрешения на выполнение указанной операции. PERMISSION_DENIED нельзя использовать для отклонений, вызванных исчерпанием некоторого ресурса (вместо этого используйте RESOURCE_EXHAUSTED для таких ошибок). PERMISSION_DENIED нельзя использовать, если вызывающего невозможно идентифицировать (вместо этого используйте UNAUTHENTICATED для таких ошибок). Этот код ошибки не означает, что запрос действителен или запрошенная сущность существует или удовлетворяет другим предварительным условиям.

HTTP-сопоставление: 403 Запрещено

UNAUTHENTICATED

Запрос не имеет действительных учетных данных аутентификации для операции.

HTTP-сопоставление: 401 Неавторизованный

RESOURCE_EXHAUSTED

Какой-то ресурс исчерпан, возможно, квота для каждого пользователя или вся файловая система переполнена.

HTTP-сопоставление: 429 Слишком много запросов

FAILED_PRECONDITION

Операция отклонена, поскольку система не находится в состоянии, требуемом для выполнения операции. Например, удаляемый каталог непустой, операция rmdir применяется к не-каталогу и т. д.

Разработчики сервисов могут использовать следующие рекомендации для выбора между FAILED_PRECONDITION , ABORTED и UNAVAILABLE : (a) Используйте UNAVAILABLE , если клиент может повторить только неудачный вызов. (b) Используйте ABORTED , если клиент должен повторить попытку на более высоком уровне. Например, когда указанный клиентом test-and-set терпит неудачу, указывая, что клиент должен перезапустить последовательность read-modify-write. (c) Используйте FAILED_PRECONDITION , если клиент не должен повторять попытку, пока состояние системы не будет явно исправлено. Например, если "rmdir" терпит неудачу из-за того, что каталог не пустой, следует вернуть FAILED_PRECONDITION , поскольку клиент не должен повторять попытку, пока файлы не будут удалены из каталога.

HTTP-сопоставление: 400 Bad Request

ABORTED

Операция была прервана, как правило, из-за проблемы параллелизма, такой как сбой проверки секвенсора или прерывание транзакции.

См. приведенные выше рекомендации по выбору между FAILED_PRECONDITION , ABORTED и UNAVAILABLE .

HTTP-сопоставление: конфликт 409

OUT_OF_RANGE

Была предпринята попытка выполнить операцию за пределами допустимого диапазона. Например, поиск или чтение за пределами конца файла.

В отличие от INVALID_ARGUMENT эта ошибка указывает на проблему, которая может быть исправлена ​​при изменении состояния системы. Например, 32-битная файловая система сгенерирует INVALID_ARGUMENT , если ее попросят прочитать со смещением, которое не находится в диапазоне [0,2^32-1], но она сгенерирует OUT_OF_RANGE если ее попросят прочитать со смещения, выходящего за пределы текущего размера файла.

Между FAILED_PRECONDITION и OUT_OF_RANGE есть довольно много совпадений. Мы рекомендуем использовать OUT_OF_RANGE (более конкретную ошибку), когда она применяется, чтобы вызывающие, которые итерируют по пространству, могли легко искать ошибку OUT_OF_RANGE , чтобы определить, когда они закончили.

HTTP-сопоставление: 400 Bad Request

UNIMPLEMENTED

Операция не реализована или не поддерживается/не включена в данной услуге.

HTTP-сопоставление: 501 не реализовано

INTERNAL

Внутренние ошибки. Это означает, что некоторые инварианты, ожидаемые базовой системой, были нарушены. Этот код ошибки зарезервирован для серьезных ошибок.

HTTP-сопоставление: 500 Внутренняя ошибка сервера

UNAVAILABLE

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

См. приведенные выше рекомендации по выбору между FAILED_PRECONDITION , ABORTED и UNAVAILABLE .

HTTP-сопоставление: 503 Служба недоступна

DATA_LOSS

Невосстановимая потеря или повреждение данных.

HTTP-сопоставление: 500 Внутренняя ошибка сервера

ОбновленныйВиджет

Для виджетов selectionInput возвращает предложения автозаполнения для меню с множественным выбором.

JSON-представление
{
  "widget": string,

  // Union field updated_widget can be only one of the following:
  "suggestions": {
    object (SelectionItems)
  }
  // End of list of possible types for union field updated_widget.
}
Поля
widget

string

Идентификатор обновленного виджета. Идентификатор должен совпадать с идентификатором виджета, который вызвал запрос на обновление.

Поле объединения updated_widget . Виджет обновляется в ответ на действие пользователя. updated_widget может быть только одним из следующих:
suggestions

object ( SelectionItems )

Список результатов автозаполнения виджета

ВыборЭлементы

Список результатов автозаполнения виджета.

JSON-представление
{
  "items": [
    {
      object (SelectionItem)
    }
  ]
}
Поля
items[]

object ( SelectionItem )

Массив объектов SelectionItem.

SlashCommand

Метаданные о команде с косой чертой в Google Chat.

JSON-представление
{
  "commandId": string
}
Поля
commandId

string ( int64 format)

Идентификатор команды слеша.

СовпавшийUrl

Соответствующий URL в сообщении чата. Приложения чата могут просматривать соответствующие URL. Для получения дополнительной информации см. Предварительный просмотр ссылок .

JSON-представление
{
  "url": string
}
Поля
url

string

Только вывод. URL, который был сопоставлен.

EmojiReactionРезюме

Количество людей, отреагировавших на сообщение определенным эмодзи.

JSON-представление
{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}
Поля
emoji

object ( Emoji )

Только вывод. Эмодзи, связанные с реакциями.

reactionCount

integer

Только вывод. Общее количество реакций с использованием соответствующего эмодзи.

УдалениеМетаданных

Информация об удаленном сообщении. Сообщение удаляется, когда установлено deleteTime .

JSON-представление
{
  "deletionType": enum (DeletionType)
}
Поля
deletionType

enum ( DeletionType )

Указывает, кто удалил сообщение.

Тип удаления

Кто удалил сообщение и как оно было удалено. В будущем могут быть добавлены дополнительные значения. Подробнее о том, когда сообщения можно удалять, см. в разделе Редактировать или удалить сообщение в Google Chat.

Перечисления
DELETION_TYPE_UNSPECIFIED Это значение не используется.
CREATOR Пользователь удалил свое сообщение.
SPACE_OWNER Менеджер пространства удалил сообщение.
ADMIN Администратор Google Workspace удалил сообщение. Администраторы могут удалять любые сообщения в пространстве, включая сообщения, отправленные любым участником пространства или приложением Chat.
APP_MESSAGE_EXPIRY Приложение Chat удалило собственное сообщение по истечении срока его действия.
CREATOR_VIA_APP Приложение Chat удалило сообщение от имени создателя (используя аутентификацию пользователя).
SPACE_OWNER_VIA_APP Приложение Chat удалило сообщение от имени менеджера пространства (используя аутентификацию пользователя).
SPACE_MEMBER Участник пространства удалил сообщение. Пользователи могут удалять сообщения, отправленные приложениями.

QuotedMessageМетаданные

Информация о цитируемом сообщении.

JSON-представление
{
  "name": string,
  "lastUpdateTime": string
}
Поля
name

string

Только вывод. Имя ресурса цитируемого сообщения.

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

lastUpdateTime

string ( Timestamp format)

Только вывод. Временная метка, когда было создано цитируемое сообщение или когда цитируемое сообщение было обновлено в последний раз.

ПрикрепленныйGif

GIF-изображение, указанное по URL-адресу.

JSON-представление
{
  "uri": string
}
Поля
uri

string

Только вывод. URL, на котором размещено изображение GIF.

АксессуарВиджет

Один или несколько интерактивных виджетов, которые появляются в нижней части сообщения. Подробнее см. в разделе Добавление интерактивных виджетов в нижнюю часть сообщения .

JSON-представление
{

  // Union field action can be only one of the following:
  "buttonList": {
    object (ButtonList)
  }
  // End of list of possible types for union field action.
}
Поля
action поля Союза. Тип действия. action может быть только одним из следующих:
buttonList

object ( ButtonList )

Список кнопок.

Методы

create

Создает сообщение в чате Google.

delete

Удаляет сообщение.

get

Возвращает сведения о сообщении.

list

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

patch

Обновляет сообщение.

update

Обновляет сообщение.