Method: spaces.messages.reactions.list

Wyświetla listę reakcji na wiadomość. Informacje na ten temat znajdziesz w artykule Wyświetlanie listy 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ą zareagowali użytkownicy.

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 określono inaczej, wartość domyślna to 25. Maksymalna wartość to 200, a wartości powyżej 200 są zmieniane na 200.

pageToken

string

Opcjonalnie. (Jeśli wznawiam od poprzedniego zapytania).

Token strony odebrany z poprzedniego wywołania reakcji na liście. Podaj je, aby pobrać kolejną stronę.

W przypadku podziału na strony wartość filtra powinna odpowiadać wywołaniu, które dostarczyło token strony. Przekazywanie innej wartości może spowodować nieoczekiwane wyniki.

filter

string

Opcjonalnie. Filtr zapytania.

Możesz filtrować reakcje według emotikonów (emoji.unicode lub emoji.custom_emoji.uid) oraz użytkownika (user.name).

Aby filtrować reakcje na wiele emotikonów lub użytkowników, połą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żytkownika, użyj operatora AND, na przykład emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Jeśli zapytanie używa zarówno właściwości AND, jak i OR, pogrupuj je za pomocą nawiasów.

Prawidłowe są np. te zapytania:

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 zostały odrzucone przez serwer z błędem INVALID_ARGUMENT.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na prośbę o reakcje w ramach listy.

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

Token kontynuacji, aby pobrać następną stronę wyników. To pole jest puste w przypadku ostatniej strony wyników.

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 po autoryzacji.