Z tego przewodnika dowiesz się, jak używać metody list
w zasobie membership
interfejsu Google Chat API do wyświetlania użytkowników w pokoju w postaci podzielonej na strony listy, którą można filtrować
w pomieszczeniu. Członkostwo w usłudze z
uwierzytelnianie aplikacji
wyświetla listę użytkowników w pokojach dostępnych w aplikacji Google Chat.
dostępu do aplikacji Google Chat, ale nie obejmuje tej funkcji,
i w swojej organizacji. Członkostwo w usłudze z
Uwierzytelnianie użytkowników
zawiera listę użytkowników w pokojach, do których ma dostęp uwierzytelniony użytkownik.
Membership
zasób
wskazuje, czy zaproszeni jest człowiek czy aplikacja Google Chat;
które znajdują się w pokoju lub w ogóle ich nie ma.
Wymagania wstępne
Python
- Firmy lub przedsiębiorstwa Konto Google Workspace z dostępem do Google Chat.
- Skonfiguruj środowisko:
- Utwórz projekt Google Cloud.
- Skonfiguruj ekran zgody OAuth
- Włącz i skonfiguruj interfejs Google Chat API pod nazwą. ikonę i opis aplikacji Google Chat.
- Zainstaluj Python Biblioteka klienta interfejsów API Google.
- Utwórz dane uwierzytelniające na podstawie sposobu uwierzytelniania w interfejsie Google Chat API
żądanie:
- Aby uwierzytelnić się jako użytkownik Google Chat:
utwórz identyfikator klienta OAuth
dane logowania i zapisz je w pliku JSON o nazwie
client_secrets.json
do katalogu lokalnego. - Aby uwierzytelnić się jako aplikacja Google Chat:
utwórz konto usługi
dane logowania i zapisz je w pliku JSON o nazwie
credentials.json
- Aby uwierzytelnić się jako użytkownik Google Chat:
utwórz identyfikator klienta OAuth
dane logowania i zapisz je w pliku JSON o nazwie
- Wybierz zakres autoryzacji w zależności od tego, czy chcesz się uwierzytelnić jako użytkownik, czy jako aplikacja Google Chat.
Wyświetlanie listy użytkowników w pokoju z uwierzytelnianiem użytkowników
Aby wyświetlić listę użytkowników, Grup dyskusyjnych Google i aplikacji Google Chat w pokoju do którego ma dostęp uwierzytelniony użytkownik, przekaż w żądaniu:
- Na
uwierzytelnianie użytkownika,
określ autoryzację
chat.memberships.readonly
lubchat.memberships
zakresu. - Wywołaj funkcję
Metoda
list
wmembership
zasób. - Aby wyświetlić listę Grup dyskusyjnych Google, ustaw parametr zapytania
showGroups
natrue
.
Poniżej znajduje się przykład listy członków grupy dyskusyjnej Google, osób i aplikacji, dla których są widoczni uwierzytelnionego użytkownika.
Python
- W katalogu roboczym utwórz plik o nazwie
chat_member_list_user.py
. Umieść w pliku
chat_member_list_user.py
ten kod:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.memberships.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then lists Google Group, human, and app members in a specified space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().members().list( # The space for which to list memberships. parent = 'spaces/SPACE', # Set this parameter to list Google Groups. showGroups = 'true' ).execute() # Prints the list of memberships. print(result) if __name__ == '__main__': main()
W kodzie zastąp
SPACE
nazwą pokoju, która który znajdziesz w Metodaspaces.list
w interfejsie Chat API lub z adresu URL pokoju.W katalogu roboczym skompiluj i uruchom przykład:
python3 chat_member_list_user.py
Interfejs Google Chat API zwraca listę użytkowników grupy dyskusyjnej Google, użytkowników i aplikacji z w określonym miejscu.
Wyświetlanie listy użytkowników w pokoju z uwierzytelnianiem aplikacji
Wyświetlanie listy użytkowników i aplikacji Google Chat w pokoju do których ma dostęp uwierzytelniona aplikacja, przekaż w żądaniu te informacje:
- Na
uwierzytelnianie aplikacji,
określić zakres autoryzacji
chat.bot
. - Wywołaj funkcję
Metoda
list
wmember
zasób. - Aby wyświetlić listę Grup dyskusyjnych Google, ustaw parametr zapytania
showGroups
natrue
.
Przykład poniżej zawiera listę użytkowników pokoju (nie menedżerów pokoju) widocznych dla: aplikacji Google Chat:
Python
- W katalogu roboczym utwórz plik o nazwie
chat_member_list_app.py
. Umieść w pliku
chat_member_list_app.py
ten kod:from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Use the service endpoint to call Chat API. result = chat.spaces().members().list( # The space for which to list memberships. parent = 'spaces/SPACE', # An optional filter that returns only human space members. filter = 'member.type = "HUMAN" AND role = "ROLE_MEMBER"' ).execute() print(result)
W kodzie zastąp
SPACE
nazwą pokoju, która który znajdziesz w Metodaspaces.list
w interfejsie Chat API lub z adresu URL pokoju.W katalogu roboczym skompiluj i uruchom przykład:
python3 chat_member_list_app.py
Interfejs Google Chat API zwraca listę użytkowników pokoju (z wyłączeniem pokoju) menedżerów) z określonego pokoju.
Dostosuj podział na strony lub filtruj listę
Aby wyświetlić listę członków, przekaż następujące parametry zapytania do dostosować podział na strony lub filtrować listy członków:
pageSize
: maksymalna liczba subskrypcji do zwrócenia. Usługa może zwraca mniej niż ta wartość. Jeśli nie określono inaczej, maksymalnie 100 spacji . Maksymalna wartość to 1000. wartości powyżej 1000 są automatycznie został zmieniony na 1000.pageToken
: token strony otrzymany z poprzedniego wywołania listy pokoi. Podaj ten token, aby pobrać kolejną stronę. Przy dzieleniu na strony wartość filtra powinna pasować do wywołania, które dostarczyło token strony. Podanie wyniku może prowadzić do nieoczekiwanych rezultatów.filter
: filtr zapytania. Wymagane uwierzytelnianie użytkownika. Szczegółowe informacje o obsługiwanych zapytaniach znajdziesz w Metodaspaces.members.list
.
Powiązane artykuły
- Uzyskiwanie informacji o subskrypcji użytkownika lub w aplikacji Google Chat
- Zapraszanie i dodawanie użytkowników lub aplikacji Google Chat do pokoju oraz dodawanie ich do pokoju
- Aktualizowanie subskrypcji użytkownika w pokoju Google Chat
- Usuwanie użytkownika lub aplikacji do obsługi czatu z pokoju