Z tego przewodnika dowiesz się, jak korzystać z
list()
w zasobie Message
interfejsu Google Chat API, aby wyświetlić podział na strony,
filtrowalna lista wiadomości w pokoju.
W interfejsie Chat API wiadomość z Google Chat jest reprezentowana przez
Message
zasób.
Użytkownicy Google Chat mogą wysyłać tylko wiadomości zawierające tekst,
Aplikacje do obsługi czatu mogą korzystać z wielu innych funkcji wiadomości, w tym
używające statycznych lub interaktywnych interfejsów użytkownika i zbierając informacje z
użytkowników i dostarczanie wiadomości prywatnie. Więcej informacji o funkcjach przesyłania wiadomości dostępnych w interfejsie Chat API znajdziesz w artykule Omówienie wiadomości w Google Chat.
Wymagania wstępne
Node.js
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj Node.js Biblioteka klienta Cloud.
-
Utwórz dane uwierzytelniające OAuth dla identyfikatora klienta w przypadku aplikacji komputerowej. Aby uruchomić próbkę w tym
Przewodnika, zapisz dane logowania w pliku JSON o nazwie
client_secrets.json
katalog lokalny.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
- Pokój Google Chat. Aby utworzyć konto za pomocą interfejsu Google Chat API, zapoznaj się z artykułem Tworzenie pokoju Aby utworzyć kanał w Google Chat, zapoznaj się z dokumentacją Centrum pomocy.
Python
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj bibliotekę klienta Cloud w Pythonie.
-
Utwórz dane logowania na podstawie identyfikatora klienta OAuth dla aplikacji komputerowej. Aby uruchomić próbkę w tym
Przewodnika, zapisz dane logowania w pliku JSON o nazwie
client_secrets.json
katalog lokalny.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
- Pokój Google Chat. Aby utworzyć pokój za pomocą interfejsu Google Chat API, zapoznaj się z artykułem Tworzenie pokoju. Aby utworzyć kanał w Google Chat, zapoznaj się z dokumentacją Centrum pomocy.
Java
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj Java Biblioteka klienta Cloud.
-
Utwórz dane logowania na podstawie identyfikatora klienta OAuth dla aplikacji komputerowej. Aby uruchomić przykładowy skrypt w tym przewodniku, zapisz dane logowania jako plik JSON o nazwie
client_secrets.json
w katalogu lokalnym.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
- Pokój Google Chat. Aby utworzyć pokój za pomocą interfejsu Google Chat API, zapoznaj się z artykułem Tworzenie pokoju. Aby utworzyć konto w Google Chat: odwiedź dokumentacji w Centrum pomocy.
Google Apps Script
- Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth.
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę Google Chat.
- Wybierz zakres autoryzacji, który obsługuje uwierzytelnianie użytkowników.
- Pokój Google Chat. Aby utworzyć konto za pomocą interfejsu Google Chat API, zapoznaj się z artykułem Tworzenie pokoju Aby utworzyć kanał w Google Chat, zapoznaj się z dokumentacją Centrum pomocy.
Wyświetlenie listy wiadomości
Aby wyświetlić listę wiadomości z uwierzytelnieniem użytkownika, w żądaniu podaj:
- Określ zakres autoryzacji
chat.messages.readonly
lubchat.messages
. - Wywołaj metodę
ListMessages()
.
Oto przykład wiadomości w pokoju czatu:
Node.js
Python
Java
Google Apps Script
Aby uruchomić ten przykład, zastąp SPACE_NAME
identyfikatorem z
w pomieszczeniu
name
. Aby go uzyskać, wywołaj metodę
ListSpaces()
lub z adresu URL pokoju.
Interfejs Chat API zwraca błąd
lista wiadomości
wysłane w określonym pokoju. Jeśli nie ma żadnych wiadomości z żądania, odpowiedź interfejsu Chat API zwraca pusty obiekt. Gdy używasz protokołu REST/HTTP
, odpowiedź będzie zawierać pusty obiekt JSON, {}
.
Powiązane artykuły
- Formatowanie wiadomości
- Usuwanie wiadomości.
- Sprawdzanie szczegółów wiadomości
- Zaktualizuj wiadomość.
- Wyślij wiadomość.