스페이스의 멤버십을 나열합니다. 예시를 보려면 스페이스에서 사용자 및 Google Chat 앱 나열을 참고하세요. 앱 인증을 사용하여 멤버십을 나열하면 채팅 앱에서 액세스할 수 있는 스페이스의 멤버십이 표시되지만 자체 채팅 앱 멤버십은 제외됩니다. 사용자 인증을 사용하여 멤버십을 나열하면 인증된 사용자가 액세스할 수 있는 스페이스의 멤버십이 나열됩니다.
HTTP 요청
GET https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 멤버십 목록을 가져올 스페이스의 리소스 이름입니다. 형식: space/{space} |
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
선택사항입니다. 반환할 최대 멤버십 수입니다. 서비스는 이 값보다 더 적은 수의 값을 반환할 수 있습니다. 지정하지 않으면 최대 100개의 멤버십이 반환됩니다. 최댓값은 1,000입니다. 1,000 이상의 값을 사용하면 1,000으로 자동 변경됩니다. 음수 값은 |
pageToken |
선택사항입니다. 멤버십을 나열하기 위한 이전 호출에서 수신된 페이지 토큰입니다. 후속 페이지를 검색하려면 이 매개변수를 제공합니다. 페이지로 나눌 때 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 다른 매개변수에 다른 값을 전달하면 예상치 못한 결과가 발생할 수 있습니다. |
filter |
선택사항입니다. 쿼리 필터 회원의 역할 ( 역할별로 필터링하려면 유형별로 필터링하려면 역할과 유형을 모두 기준으로 필터링하려면
예를 들어 유효한 쿼리는 다음과 같습니다.
다음 쿼리가 잘못되었습니다.
잘못된 쿼리는 |
showGroups |
선택사항입니다. |
showInvited |
선택사항입니다. 현재 사용자 인증이 필요합니다. |
useAdminAccess |
true 인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.전화를 거는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.
관리 액세스 권한을 사용하는 경우 스페이스에 앱 멤버십을 나열할 수 없습니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
스페이스 멤버십 나열에 대한 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"memberships": [
{
object ( |
필드 | |
---|---|
memberships[] |
순서가 지정되지 않은 목록입니다. 요청된 (또는 첫 번째) 페이지의 멤버십 목록입니다. |
nextPageToken |
결과의 다음 페이지를 검색하기 위해 |
승인 범위
다음 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
자세한 내용은 승인 가이드를 참조하세요.