- Żą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 ładunek zawiera najnowszą wersję zasobu Google Chat. Jeśli na przykład wyświetlisz listę zdarzeń dotyczących nowych osób w pokoju, serwer zwróci zasoby Membership
, które zawierają najnowsze szczegóły członkostwa. Jeśli w wybranym okresie nowi użytkownicy zostali usunięci, ł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ład 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 |
Wymagane. Nazwa zasobu pokoju Google Chat, w którym wystąpiły zdarzenia. Format: |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Opcjonalnie: Maksymalna liczba zwróconych zdarzeń dla pokoju. Usługa może zwrócić mniej niż ta wartość. Wartości ujemne zwracają błąd |
pageToken |
Token strony otrzymany z poprzedniego wywołania zdarzeń w pokoju listy. Podaj go, aby pobrać kolejną stronę. Podczas dzielenia na strony wszystkie pozostałe parametry służące do wyświetlania listy zdarzeń pokoju muszą być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie innych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
Wymagane. Filtr zapytania. Musisz określić co najmniej 1 typ zdarzenia ( Możesz też filtrować dane według czasu rozpoczęcia (
Aby określić godzinę rozpoczęcia lub zakończenia, użyj operatora równa się Prawidłowe są na przykład te zapytania:
Te zapytania są nieprawidłowe:
Nieprawidłowe zapytania są odrzucane przez serwer z błędem |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Komunikat z odpowiedzią na listę zdarzeń 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 (od najstarszego 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 protokołu 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 na temat autoryzacji.