Method: spaces.messagePins.list

Wyświetla listę przypiętych wiadomości w pokoju. Użytkownicy mogą przypinać ważne wiadomości w pokojach, aby mieć do nich łatwy dostęp. Więcej informacji znajdziesz w artykule Przypinanie i odpinanie rozmów w Google Chat.

Wymaga uwierzytelnienia użytkownika z użyciem jednego z tych zakresów autoryzacji:

  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.spaces

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Przestrzeń nadrzędna, do której należy kolekcja przypiętych elementów. Format: spaces/{space}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba przypiętych wiadomości do zwrócenia. Usługa może zwrócić mniej wiadomości niż ta wartość. Maksymalna wartość to 100. Jeśli użyjesz wartości większej niż 100, zostanie ona automatycznie zmieniona na 100. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 100 przypiętych wiadomości. Wartości ujemne zwracają błąd INVALID_ARGUMENT.
pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania listy przypiętych wiadomości. Podaj ten parametr, aby pobrać następną stronę.

Podczas paginacji wszystkie inne podane parametry powinny być zgodne z wywołaniem, które dostarczyło token strony. Przekazywanie różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość odpowiedzi dotycząca przypiętych wiadomości na liście.

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

Zapis JSON 
{
  "messagePins": [
    {
      object (MessagePin)
    }
  ],
  "nextPageToken": string
}
Pola
messagePins[]

object (MessagePin)

Przypięte wiadomości z określonego pokoju.
nextPageToken

string

Aby pobrać następną stronę wyników, możesz wysłać token jako pageToken. Jeśli jest puste, nie ma kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/chat.spaces.pins
  • https://www.googleapis.com/auth/chat.spaces.pins.readonly
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.