Method: spaces.messages.reactions.list

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

Wymaga uwierzytelniania użytkownika za pomocą jednego z tych zakresów autoryzacji:

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

Żą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 określisz wartości, stosowana jest wartość domyślna (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.