- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę wiadomości w pokoju, do którego należy rozmówca, w tym wiadomości od zablokowanych użytkowników i pokoi. Przykładem może być Wyświetlanie listy wiadomości. Wymaga uwierzytelniania użytkownika.
Żądanie HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/messages
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Wymagane. Nazwa zasobu pokoju, z którego wyświetlane są wiadomości. Format: |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Maksymalna liczba zwróconych wiadomości. Usługa może zwrócić mniej wiadomości niż ta wartość. Jeśli nie określono inaczej, zwracanych jest maksymalnie 25. Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000. Wartości ujemne zwracają błąd |
pageToken |
Opcjonalne, jeśli wznawiam od poprzedniego zapytania. Token strony odebrany z poprzedniego wywołania komunikatów listy. Podaj ten parametr, aby pobrać kolejną stronę. W przypadku podziału na strony wszystkie pozostałe parametry powinny być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do pozostałych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
Filtr zapytania. Wiadomości możesz filtrować według daty ( Aby filtrować wiadomości według daty utworzenia, podaj Aby filtrować według wątku, podaj element Aby filtrować zarówno według wątku, jak i daty, użyj w zapytaniu operatora Prawidłowe są np. te zapytania:
Nieprawidłowe zapytania zostały odrzucone przez serwer z błędem |
orderBy |
Opcjonalne, jeśli wznawiam od poprzedniego zapytania. Jak jest uporządkowana lista wiadomości. Określ wartość do sortowania według operacji sortowania. Prawidłowe wartości operacji sortowania są następujące:
Domyślna kolejność to |
showDeleted |
Określa, czy uwzględnić usunięte wiadomości. Usunięte wiadomości zawierają czas i metadane dotyczące usunięcia, ale treść wiadomości jest niedostępna. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Wiadomość z odpowiedzią na listę wiadomości.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"messages": [
{
object ( |
Pola | |
---|---|
messages[] |
Lista wiadomości. |
nextPageToken |
Możesz wysłać token jako |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
Więcej informacji znajdziesz w przewodniku po autoryzacji.