Method: spaces.messages.reactions.list

Lista reakcji na wiadomość. Przykład znajdziesz w artykule Wyświetlanie reakcji na wiadomość.

Wymaga uwierzytelniania użytkownika.

Żądanie HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*/messages/*}/reactions

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. wiadomość, na którą użytkownicy zareagowali;

Format: spaces/{space}/messages/{message}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba zwróconych reakcji. Usługa może zwrócić mniej reakcji niż ta wartość. Jeśli nie zostanie podana, wartością domyślną jest 25. Maksymalna wartość to 200; wartości powyżej 200 są zmieniane na 200.

pageToken

string

Opcjonalnie. (jeśli wznawiasz działanie po poprzednim zapytaniu).

Token strony otrzymany z poprzedniego wywołania funkcji reakcji na listę. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wartość filtra powinna być zgodna z wywołaniem, które dostarczyło token strony. Podanie innej wartości może prowadzić do nieoczekiwanych wyników.

filter

string

Opcjonalnie. Filtr zapytania.

Reakcje możesz filtrować według emotikonów (emoji.unicode lub emoji.custom_emoji.uid) oraz użytkowników (user.name).

Aby filtrować reakcje dotyczące wielu emotikonów lub użytkowników, złącz podobne pola za pomocą operatora OR, takiego jak emoji.unicode = "🙂" OR emoji.unicode = "👍" i user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Aby filtrować reakcje według emotikonów i użytkowników, użyj operatora AND, np. emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Jeśli w zapytaniu występują zarówno AND, jak i OR, zgrupuj je za pomocą nawiasów.

Na przykład te zapytania są prawidłowe:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Te zapytania są nieprawidłowe:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

Nieprawidłowe zapytania są odrzucane z błędem INVALID_ARGUMENT.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie wyświetlenia reakcji na liście.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
Pola
reactions[]

object (Reaction)

Lista reakcji na żądanej (lub pierwszej) stronie.

nextPageToken

string

tokena kontynuacji do pobrania następnej strony wyników. Na ostatniej stronie wyników jest puste.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.