- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Попробуй это!
Список сообщений в пространстве, участником которого является вызывающий абонент, включая сообщения от заблокированных участников и пространств. Пример см. в разделе Список сообщений . Требует аутентификации пользователя .
HTTP-запрос
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
parent | Необходимый. Имя ресурса пространства, из которого выводится список сообщений. Формат: |
Параметры запроса
Параметры | |
---|---|
pageSize | Максимальное количество возвращаемых сообщений. Служба может возвращать меньше сообщений, чем это значение. Если не указано, возвращается не более 25. Максимальное значение — 1000. Если вы используете значение больше 1000, оно автоматически изменится на 1000. Отрицательные значения возвращают ошибку |
pageToken | Необязательно, если возобновляется предыдущий запрос. Маркер страницы, полученный от предыдущего вызова сообщений списка. Укажите этот параметр, чтобы получить следующую страницу. При разбивке на страницы все остальные предоставленные параметры должны соответствовать вызову, предоставившему токен страницы. Передача других значений другим параметрам может привести к неожиданным результатам. |
filter | Фильтр запроса. Вы можете фильтровать сообщения по дате ( Чтобы отфильтровать сообщения по дате их создания, укажите Для фильтрации по потоку укажите Чтобы отфильтровать по потоку и дате, используйте оператор Например, допустимы следующие запросы:
Недопустимые запросы отклоняются сервером с ошибкой |
orderBy | Необязательно, если возобновляется предыдущий запрос. Как упорядочен список сообщений. Укажите значение для заказа операцией упорядочивания. Допустимые значения операции заказа:
Порядок по умолчанию — |
showDeleted | Включать ли удаленные сообщения. Удаленные сообщения включают время удаления и метаданные об их удалении, но содержимое сообщения недоступно. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{
"messages": [
{
object ( |
Поля | |
---|---|
messages[] | Список сообщений. |
nextPageToken | Вы можете отправить токен как |
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/chat.import
-
https://www.googleapis.com/auth/chat.messages
-
https://www.googleapis.com/auth/chat.messages.readonly
Дополнительные сведения см. в руководстве по авторизации .