Method: spaces.findGroupChats

Zwraca wszystkie pokoje z spaceType == GROUP_CHAT, których członkowie będący osobami to dokładnie użytkownik wywołujący i użytkownicy określeni w FindGroupChatsRequest.memberships.

Jeśli użytkownik wywołujący blokuje niektórych użytkowników lub jest przez nich blokowany, a nie znaleziono pokoi z całym określonym zestawem użytkowników, ta metoda zwraca pokoje, które nie obejmują zablokowanych użytkowników ani użytkowników blokujących.

Określony zbiór użytkowników musi zawierać tylko członkostwa osób (nie aplikacji). Żądanie zawierające użytkowników niebędących ludźmi nie zwraca żadnych miejsc.

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

  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.memberships

Żądanie HTTP

GET https://chat.googleapis.com/v1/spaces:findGroupChats

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
user[]

string

Nazwy zasobów wszystkich użytkowników, którzy nie są botami, biorących udział w czacie grupowym z użytkownikiem dzwoniącym. Aplikacji do obsługi czatu nie można uwzględnić w prośbie.

Format: users/{user}, gdzie {user} to id dla osoby z interfejsu People API lub id dla użytkownika z interfejsu Directory API. Aby na przykład znaleźć wszystkie czaty grupowe z użytkownikiem wywołującym i 2 innymi użytkownikami o identyfikatorach profilu w interfejsie People API 123456789 i 987654321, możesz użyć users/123456789 i users/987654321. Możesz też użyć adresu e-mail jako aliasu dla {user}. Na przykład users/example@gmail.com, gdzie example@gmail.com to adres e-mail użytkownika Google Chat.

Gdy użytkownik dzwoniący jest użytkownikiem Google Workspace, wszyscy użytkownicy, do których wysyła prośbę, muszą należeć do tej samej organizacji Google Workspace co użytkownik dzwoniący.
pageSize

integer

Opcjonalnie: Maksymalna liczba zwracanych przestrzeni. Usługa może zwrócić mniej niż ta wartość.

Jeśli nie zostanie podana, zwracanych jest maksymalnie 100 miejsc.

Maksymalna wartość to 1000. Jeśli użyjesz wartości większej niż 1000, zostanie ona automatycznie zmieniona na 1000.

Wartości ujemne zwracają błąd INVALID_ARGUMENT.
pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji wyszukiwania czatów grupowych. Podaj ten parametr, aby pobrać następną stronę.

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

enum (SpaceView)

Rodzaj widoku miejsca, o który prosisz. Jeśli nie jest ustawiony, przyjmuje się domyślnie SPACE_VIEW_RESOURCE_NAME_ONLY. Żądania, które określają SPACE_VIEW_EXPANDED, muszą zawierać zakresy umożliwiające odczytywanie danych pokoju, np. https://www.googleapis.com/auth/chat.spaces lub https://www.googleapis.com/auth/chat.spaces.readonly.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca pokoje rozmów grupowych z użytkownikiem wywołującym i użytkownikami, o których prosi.

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

Zapis JSON 
{
  "spaces": [
    {
      object (Space)
    }
  ],
  "nextPageToken": string
}
Pola
spaces[]

object (Space)

Lista pokoi na żądanej (lub pierwszej) stronie.
nextPageToken

string

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

Więcej informacji znajdziesz w przewodniku po autoryzacji.

SpaceView

Widok, który określa, które pola mają być wypełnione w zasobie Space. Aby zapewnić zgodność z przyszłymi wersjami, zalecamy uwzględnienie w kodzie dodatkowych wartości.

Wartości w polu enum
SPACE_VIEW_UNSPECIFIED Wartość domyślna lub nieokreślona.
SPACE_VIEW_RESOURCE_NAME_ONLY Wypełnia tylko nazwę zasobu Pokój.
SPACE_VIEW_EXPANDED Wypełnia pola zasobu Space. Uwaga: pole permissionSettings nie zostanie wypełnione. Żądania, które określają SPACE_VIEW_EXPANDED, muszą zawierać zakresy umożliwiające odczytywanie danych pokoju, np. https://www.googleapis.com/auth/chat.spaces lub https://www.googleapis.com/auth/chat.spaces.readonly.