- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Wyświetla listę użytkowników pokoju. Przykładem jest 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 uwierzytelnieniem użytkownika wyświetla członkostwo w przestrzeniach, do których uwierzytelniony użytkownik ma dostęp.
Obsługuje te typy uwierzytelniania:
Uwierzytelnianie użytkownika – możesz uwierzytelnić i autoryzować tę metodę przy użyciu uprawnień 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 |
Wymagany. Nazwa zasobu pokoju, z którego chcesz pobrać listę członków. Format: spaces/{space} |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Opcjonalnie: Maksymalna liczba wspierających 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 |
pageToken |
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 różnych wartości do innych parametrów może prowadzić do nieoczekiwanych wyników. |
filter |
Opcjonalnie: Filtr zapytania. Możesz filtrować członkostwa według roli ( Aby filtrować według roli, ustaw wartość Aby filtrować według typu, ustaw wartość Aby filtrować według roli i typu, użyj operatora Gdy element Na przykład te zapytania są prawidłowe:
Te zapytania są nieprawidłowe:
Serwer odrzuca nieprawidłowe zapytania, zwracając błąd |
showGroups |
Opcjonalnie: Gdy |
showInvited |
Opcjonalnie: Jeśli Obecnie wymaga uwierzytelnienia użytkownika. |
useAdminAccess |
Opcjonalnie: Jeśli Użytkownik dzwoniący musi być administratorem Google Workspace z uprawnieniami do zarządzania czatem i rozmowami w pokojach. Wymaga zakresu 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). |
nextPageToken |
Token, który możesz wysłać jako |
Zakresy autoryzacji
Wymaga jednego z tych zakresów 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.