- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę wiadomości z pokoju, do którego należy rozmówca, w tym wiadomości od zablokowanych użytkowników i pokoi. Jeśli wyświetlisz wiadomości z pokoju, w którym nie ma żadnych wiadomości, odpowiedź będzie pustym obiektem. W przypadku interfejsu REST/HTTP odpowiedź zawiera pusty obiekt JSON, {}
. Przykład: 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 mają być wyświetlane wiadomości. Format: |
Parametry zapytania
Parametry | |
---|---|
page |
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 |
page |
Opcjonalne, jeśli wznawiasz działanie po poprzednim zapytaniu. Token strony otrzymany z poprzedniego wywołania listy wiadomości. Podaj ten parametr, aby pobrać kolejną stronę. Podczas dzielenia na strony wszystkie pozostałe parametry powinny być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
Filtr zapytania. Możesz filtrować wiadomości według daty ( Aby filtrować wiadomości według daty ich utworzenia, wpisz Aby filtrować według wątku, podaj element Aby filtrować wyniki zarówno według wątku, jak i daty, użyj w zapytaniu operatora Prawidłowe są na przykład te zapytania:
Serwer odrzuca nieprawidłowe zapytania, zwracając błąd |
order |
Opcjonalne, jeśli wznawiasz działanie po poprzednim zapytaniu. Określ kolejność wyświetlania wiadomości. Określ wartość do posortowania za pomocą operacji sortowania. Prawidłowe wartości operacji sortowania:
Domyślna kolejność to |
show |
Określa, czy mają być uwzględniane usunięte wiadomości. Usunięte wiadomości zawierają informacje o czasie usunięcia i metadane dotyczące jego usunięcia, ale treść wiadomości jest niedostępna. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na wiadomość o wyświetleniu wiadomości.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"messages": [
{
object ( |
Pola | |
---|---|
messages[] |
Lista wiadomości. |
next |
Aby pobrać następną stronę wyników, możesz wysłać token jako |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.