이 가이드에서는 membership
리소스에서 list
메서드를 사용하는 방법을 설명합니다.
스페이스의 참여자를 페이지로 나눈 필터링 가능한 목록으로 나열할 수 있는 Google Chat API
몇 가지 옵션을 제공합니다 멤버십 등록 기준
앱 인증
채팅 앱에서 보유한 스페이스의 멤버십이 나열됩니다.
액세스할 수 있지만 다음을 포함한 채팅 앱 멤버십은 제외됩니다.
있습니다. 멤버십 등록 기준
사용자 인증
인증된 사용자가 액세스할 수 있는 스페이스의 멤버십이 나열됩니다.
이
Membership
리소스
사람 또는 Google Chat 앱이 초대되었는지 여부를 나타냅니다.
공백의 일부이거나 비어 있는 경우일 수 있습니다.
기본 요건
Python
- 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
- 환경을 설정합니다.
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud 프로젝트를 만듭니다.
- OAuth 동의 화면 구성
- Google Chat API를 사용 설정 및 구성합니다. 아이콘, 채팅 앱 설명이 있습니다.
- 설치 Python Google API 클라이언트 라이브러리를 참조하세요.
- Google Chat API에서 인증하려는 방법에 따라 액세스 사용자 인증 정보를 만듭니다.
요청:
<ph type="x-smartling-placeholder">
- </ph>
- Chat 사용자로 인증하려면 다음 단계를 따르세요.
OAuth 클라이언트 ID 만들기
사용자 인증 정보를 만들고 사용자 인증 정보를
client_secrets.json
을 로컬 디렉터리로 복사합니다. - 채팅 앱으로 인증하려면 다음 단계를 따르세요.
서비스 계정 만들기
사용자 인증 정보를 만들고 사용자 인증 정보를
credentials.json
입니다.
- Chat 사용자로 인증하려면 다음 단계를 따르세요.
OAuth 클라이언트 ID 만들기
사용자 인증 정보를 만들고 사용자 인증 정보를
- <ph type="x-smartling-placeholder"></ph> 사용자로 인증할 것인지, 아니면 다음으로 인증할 것인지에 따라 승인 범위를 선택합니다. 채팅 앱
사용자 인증을 통해 스페이스의 멤버 나열
스페이스에 사용자, Google 그룹스, Chat 앱을 나열하려는 경우 액세스 권한이 있는 경우 요청에 다음을 전달합니다.
- 다음으로 바꿉니다.
사용자 인증
chat.memberships.readonly
또는chat.memberships
승인을 지정합니다. 범위를 제공합니다 - 먼저
list
메서드 에membership
리소스. - Google 그룹스를 나열하려면 쿼리 매개변수
showGroups
를true
로 설정합니다.
다음 예는 다음에 공개되는 Google 그룹, 사람, 앱 구성원을 나열합니다. 확인할 수 있습니다
Python
- 작업 디렉터리에
chat_member_list_user.py
라는 파일을 만듭니다. chat_member_list_user.py
에 다음 코드를 포함합니다.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()
코드에서
SPACE
을 스페이스 이름으로 바꿉니다. GCP 콘솔에서spaces.list
메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.작업 디렉터리에서 샘플을 빌드하고 실행합니다.
python3 chat_member_list_user.py
Google Chat API는 지정할 수 있습니다.
앱 인증이 있는 스페이스의 멤버 나열
스페이스에 사용자와 채팅 앱을 표시하려면 다음 단계를 따르세요. 액세스할 수 있는 경우 요청에 다음을 전달합니다.
- 다음으로 바꿉니다.
앱 인증
chat.bot
승인 범위를 지정합니다. - 먼저
list
메서드 에member
리소스. - Google 그룹스를 나열하려면 쿼리 매개변수
showGroups
를true
로 설정합니다.
다음 예에는 스페이스 관리자가 아닌 다음 사용자에게 표시되는 사용자 스페이스 구성원 목록이 나와 있습니다. 채팅 앱:
Python
- 작업 디렉터리에
chat_member_list_app.py
라는 파일을 만듭니다. chat_member_list_app.py
에 다음 코드를 포함합니다.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)
코드에서
SPACE
을 스페이스 이름으로 바꿉니다. GCP 콘솔에서spaces.list
메서드 Chat API 또는 스페이스의 URL에서 가져올 수 있습니다.작업 디렉터리에서 샘플을 빌드하고 실행합니다.
python3 chat_member_list_app.py
Google Chat API는 사용자 스페이스 구성원 (스페이스 제외)의 목록을 반환합니다. 관리자)가 있어야 합니다.
페이지로 나누기 맞춤설정 또는 목록 필터링
멤버십을 나열하려면 다음 쿼리 매개변수를 나열된 멤버십의 페이지로 나누기를 맞춤설정하거나 필터링합니다.
pageSize
: 반환할 최대 멤버십 수입니다. 서비스는 이 값보다 적은 값을 반환합니다. 지정하지 않으면 최대 100개의 공백이 반환합니다. 최댓값은 1,000입니다. 1,000을 초과하는 값은 자동으로 1,000으로 변경되었습니다.pageToken
: 이전 스페이스 목록 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 토큰을 제공하세요. 페이지로 나누기 시 필터 값이 페이지 토큰을 제공한 호출과 일치해야 합니다. 예기치 않은 결과가 발생할 수 있습니다filter
: 쿼리 필터입니다. 요구사항 사용자 인증 지원되는 쿼리 세부정보는 다음을 참조하세요.spaces.members.list
메서드
관련 주제
- 사용자 또는 채팅 앱의 멤버십 세부정보 확인하기
- 스페이스에 사용자 또는 채팅 앱을 초대하거나 추가합니다.
- Google Chat 스페이스에서 사용자의 멤버십 업데이트하기
- 스페이스에서 사용자 또는 채팅 앱 삭제하기