- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę użytkowników pokoju. Przykład znajdziesz w artykule Wyświetlanie listy użytkowników i aplikacji Google Chat w pokoju. Wyświetlanie członkostwa z autoryzacją aplikacji wyświetla członkostwo w pokojach, do których ma dostęp aplikacja Google Chat, ale wyklucza członkostwo w Google Chat, w tym własne. Wyświetlanie członkostwa z uwierzytelnianiem użytkownika wyświetla członkostwo w przestrzeniach, do których uwierzytelniony użytkownik ma dostęp.
Obsługuje te typy uwierzytelniania:
Uwierzytelnianie użytkowników Możesz uwierzytelnić i autoryzować tę metodę z uprawnieniami administratora, ustawiając w żądaniu pole
useAdminAccess
.
Żądanie HTTP
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
parent |
Wymagane. Nazwa zasobu pokoju, do którego ma zostać pobrana lista użytkowników. Format: spaces/{space} |
Parametry zapytania
Parametry | |
---|---|
page |
Opcjonalnie: Maksymalna liczba subskrypcji do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwrócimy maksymalnie 100 subskrypcji. 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 |
page |
Opcjonalnie: Token strony otrzymany z poprzedniego wywołania listy członkostw. Podaj ten parametr, aby pobrać kolejną stronę. Podczas podziału na strony wszystkie inne parametry powinny być takie same jak w wywołaniu, które dostarczyło token strony. Przekazywanie innych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
Opcjonalnie: Filtr zapytania. Wspieranie możesz filtrować według roli ( Aby filtrować według roli, ustaw wartość Aby filtrować według typu, ustaw Aby filtrować według roli i typu, użyj operatora Gdy zasada Prawidłowe są na przykład te zapytania:
Te zapytania są nieprawidłowe:
Serwer odrzuca nieprawidłowe zapytania, zwracając błąd |
show |
Opcjonalnie: Gdy |
show |
Opcjonalnie: Gdy Obecnie wymaga uwierzytelniania użytkownika. |
use |
Jeśli zasada jest Użytkownik dzwoniący musi być administratorem Google Workspace z uprawnieniami do zarządzania czatem i rozmowami w pokojach. Wymaga zakresu OAuth 2.0 Wyświetlanie członkostwa w aplikacji w pokoju nie jest obsługiwane, gdy używasz dostępu administratora. |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na listę osób w pokoju.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"memberships": [
{
object ( |
Pola | |
---|---|
memberships[] |
Lista nieuporządkowana. Lista członkostw na stronie, której dotyczy żądanie (lub pierwszej stronie). |
next |
Token, który możesz wysłać jako |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.admin.memberships.readonly
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.readonly
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.