В этом руководстве объясняется, как использовать метод list()
в ресурсе Message
API Google Chat, чтобы просмотреть разбитый на страницы фильтруемый список сообщений в пространстве.
В API чата сообщение чата представлено ресурсом Message
. Хотя пользователи чата могут отправлять только текстовые сообщения, приложения чата могут использовать множество других функций обмена сообщениями, включая отображение статических или интерактивных пользовательских интерфейсов, сбор информации от пользователей и частную доставку сообщений. Дополнительную информацию о функциях обмена сообщениями, доступных для Chat API, см. в обзоре сообщений Google Chat .
Предварительные условия
Node.js
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat , указав имя, значок и описание для вашего приложения Chat.
- Установите облачную клиентскую библиотеку Node.js.
- Создайте учетные данные идентификатора клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде файла JSON с именем
client_secrets.json
в локальном каталоге.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
- Пространство Google Chat. Чтобы создать его с помощью Google Chat API, см. раздел Создание пространства . Чтобы создать его в Chat, посетите документацию Справочного центра .
Питон
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat , указав имя, значок и описание для вашего приложения Chat.
- Установите облачную клиентскую библиотеку Python.
- Создайте учетные данные идентификатора клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде файла JSON с именем
client_secrets.json
в локальном каталоге.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
- Пространство Google Chat. Чтобы создать его с помощью Google Chat API, см. раздел Создание пространства . Чтобы создать его в Chat, посетите документацию Справочного центра .
Ява
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat , указав имя, значок и описание для вашего приложения Chat.
- Установите облачную клиентскую библиотеку Java.
- Создайте учетные данные идентификатора клиента OAuth для настольного приложения. Чтобы запустить пример из этого руководства, сохраните учетные данные в виде файла JSON с именем
client_secrets.json
в локальном каталоге.
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
- Пространство Google Chat. Чтобы создать его с помощью Google Chat API, см. раздел Создание пространства . Чтобы создать его в Chat, посетите документацию Справочного центра .
Скрипт приложений
- Аккаунт Google Workspace для бизнеса или предприятия с доступом к Google Chat .
- Настройте свою среду:
- Создайте проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите и настройте API Google Chat , указав имя, значок и описание для вашего приложения Chat.
- Создайте автономный проект Apps Script и включите расширенную службу чата .
- Выберите область авторизации , которая поддерживает аутентификацию пользователей.
- Пространство Google Chat. Чтобы создать его с помощью Google Chat API, см. раздел Создание пространства . Чтобы создать его в Chat, посетите документацию Справочного центра .
Список сообщений
Чтобы получить список сообщений с аутентификацией пользователя , передайте в запросе следующее:
- Укажите область
chat.messages.readonly
chat.messages
. - Вызовите метод
ListMessages()
.
В следующем примере перечислены сообщения в чат-группе:
Node.js
Питон
Ява
Скрипт приложений
Чтобы запустить этот пример, замените SPACE_NAME
идентификатором из поля name
пространства. Вы можете получить идентификатор, вызвав метод ListSpaces()
или по URL-адресу пространства.
API чата возвращает список сообщений, отправленных в указанное пространство. Если сообщений по запросу нет, ответ Chat API возвращает пустой объект. При использовании интерфейса REST/HTTP ответ содержит пустой объект JSON {}
.
Связанные темы
- Отформатируйте сообщение .
- Удалить сообщение .
- Получите подробную информацию о сообщении .
- Обновить сообщение .
- Отправить сообщение .