호출하는 Chat 앱, 사용자 또는 Google 그룹의 멤버십을 만듭니다. 다른 Chat 앱의 멤버십을 만드는 작업은 지원되지 않습니다. 멤버십을 만들 때 지정된 회원의 자동 수락 정책이 사용 중지된 경우 초대를 받게 되며, 초대를 수락해야만 스페이스에 참여할 수 있습니다. 그렇지 않으면 멤버십을 만들면 구성원이 지정된 스페이스에 바로 추가됩니다.
다음 유형의 인증을 지원합니다.
개발자 프리뷰에서 관리자 승인과 함께 앱 인증 및 승인 범위:
https://www.googleapis.com/auth/chat.app.memberships
다음 승인 범위 중 하나를 사용하여 사용자 인증:
https://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.app(스페이스에 호출 앱 추가)https://www.googleapis.com/auth/chat.import(가져오기 모드 스페이스만 해당)- 관리자 계정이 인증되고
useAdminAccess이true이며 다음 승인 범위가 사용될 때 사용자 인증으로 관리자 권한이 부여됩니다.https://www.googleapis.com/auth/chat.admin.memberships
사용 예시는 다음을 참고하세요.
HTTP 요청
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
parent |
필수 항목입니다. 멤버십을 만들 스페이스의 리소스 이름입니다. 형식: spaces/{space} |
쿼리 매개변수
| 매개변수 | |
|---|---|
useAdminAccess |
선택사항입니다. 호출하는 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.
관리 액세스를 사용하여 앱 멤버십을 만들거나 관리자의 Google Workspace 조직 외부의 사용자를 위한 멤버십을 만드는 것은 지원되지 않습니다. |
요청 본문
요청 본문에 Membership의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Membership의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/chat.app.membershipshttps://www.googleapis.com/auth/chat.admin.membershipshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.membershipshttps://www.googleapis.com/auth/chat.memberships.app
자세한 내용은 승인 가이드를 참고하세요.