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ą 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 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 reakcji na listę. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wartość filtra powinna odpowiadać wywołaniu, które dostarczyło token strony. Podanie 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 według wielu emotikonów lub użytkowników, złącz podobne pola za pomocą operatora OR, np. emoji.unicode = "🙂" OR emoji.unicode = "👍" i user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Aby filtrować reakcje według emotikona i użytkownika, 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.

Prawidłowe są na przykład 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 są odrzucane przez serwer z błędem INVALID_ARGUMENT.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na prośbę o wyświetlenie listy reakcji.

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, który pozwala pobrać następną stronę 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 na temat autoryzacji.