- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę zdarzeń z pokoju Google Chat. W przypadku każdego zdarzenia payload zawiera najnowszą wersję zasobu Google Chat. Jeśli na przykład wyświetlisz listę zdarzeń dotyczących nowych członków pokoju, serwer zwróci zasoby Membership
, które zawierają najnowsze informacje o członkostwie. Jeśli w wybranym okresie zostali usunięci nowi użytkownicy, ładunek zdarzenia będzie zawierał pusty zasób Membership
.
Wymaga uwierzytelniania użytkownika. Aby wyświetlić listę zdarzeń, uwierzytelniony użytkownik musi być członkiem pokoju.
Przykładowe informacje znajdziesz w artykule Wyświetlanie listy zdarzeń z pokoju Google Chat.
Żądanie HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
To pole jest wymagane. Nazwa zasobu pokoju Google Chat, w którym wystąpiły zdarzenia. Format: |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Opcjonalnie. Maksymalna liczba zwróconych zdarzeń dotyczących pokoju. Usługa może zwrócić mniejszą wartość od tej wartości. Wartości ujemne zwracają błąd |
pageToken |
Token strony odebrany z poprzedniego wywołania zdarzeń związanych z listą. Podaj je, aby pobrać kolejną stronę. W przypadku podziału na strony wszystkie pozostałe parametry dostarczone do wyświetlenia listy zdarzeń pokoju muszą odpowiadać wywołaniu, które podało token strony. Przekazywanie różnych wartości do pozostałych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
To pole jest wymagane. Filtr zapytania. Musisz określić co najmniej 1 typ zdarzenia ( Opcjonalnie możesz też filtrować dane według godziny rozpoczęcia (
Aby podać godzinę rozpoczęcia lub zakończenia, użyj operatora równości Prawidłowe są np. te zapytania:
Te zapytania są nieprawidłowe:
Nieprawidłowe zapytania zostały odrzucone przez serwer z błędem |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Wiadomość z odpowiedzią dotyczącą wyświetlania listy wydarzeń w pokoju.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"spaceEvents": [
{
object ( |
Pola | |
---|---|
spaceEvents[] |
Wyniki są zwracane w porządku chronologicznym (najpierw najstarsze zdarzenia). |
nextPageToken |
Token kontynuacji używany do pobierania kolejnych zdarzeń. Jeśli pominiesz to pole, nie będzie kolejnych stron. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/chat.spaces
https://www.googleapis.com/auth/chat.spaces.readonly
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/chat.messages.readonly
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
https://www.googleapis.com/auth/chat.messages.reactions
https://www.googleapis.com/auth/chat.messages.reactions.readonly
Więcej informacji znajdziesz w przewodniku po autoryzacji.