Ten przewodnik wyjaśnia, jak użyć metody list()
w zasobach Message
interfejsu Google Chat API, aby wyświetlić ponumerowane i możliwe do filtrowania listy wiadomości w pokoju.
W interfejsie Chat API wiadomość w Google Chat jest reprezentowana przez zasób Message
.
Użytkownicy Google Chat mogą wysyłać tylko wiadomości tekstowe, ale aplikacje Google Chat mogą korzystać z wielu innych funkcji wiadomości, w tym wyświetlać statyczne lub interaktywne interfejsy użytkownika, zbierać informacje od użytkowników i wysyłać 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, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud dla Node.js.
-
Utwórz identyfikator 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ć 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, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud w Pythonie.
-
Utwórz identyfikator 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ć 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, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Zainstaluj bibliotekę klienta Cloud w Javie.
-
Utwórz identyfikator 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ć kanał w Google Chat, zapoznaj się z dokumentacją 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, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
- Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę czatu.
- 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.
Lista 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()
.
W tym przykładzie wymieniono wiadomości w pokoju czatu:
Node.js
Python
Java
Google Apps Script
Aby uruchomić ten przykład, zastąp wartość SPACE_NAME
identyfikatorem z pola name
w pokoju. Identyfikator możesz uzyskać, wywołując metodę ListSpaces()
lub korzystając z adresu URL pokoju.
Interfejs Chat API zwraca listę wiadomości wysłanych w określonym pokoju. Jeśli nie ma żadnych wiadomości z żądania, odpowiedź interfejsu Chat API zwraca pusty obiekt. W przypadku interfejsu REST/HTTP odpowiedź zawiera pusty obiekt JSON, {}
.
Powiązane artykuły
- Sformatować wiadomość.
- Usuwanie wiadomości.
- Wyświetlanie szczegółów wiadomości
- Zaktualizuj wiadomość.
- Wyślij wiadomość.