통화 앱의 사용자 멤버십 또는 앱 멤버십을 만듭니다. 다른 앱의 멤버십은 만들 수 없습니다. 예시는 스페이스에 사용자 또는 Google Chat 앱 초대 또는 추가하기를 참고하세요. 멤버십을 만들 때 지정된 멤버가 자동 수락 정책을 사용 중지한 경우 이 멤버는 초대되며 참여하기 전에 스페이스 초대를 수락해야 합니다. 그 외의 경우에는 멤버십을 만들면 멤버가 지정된 스페이스에 바로 추가됩니다. 사용자 인증이 필요합니다.
추가할 구성원을 지정하려면 사용자 또는 앱 구성원에 대해 membership.member.name
를 설정하거나 그룹 구성원에 대해 membership.group_member.name
를 설정합니다.
두 사용자 간의 스페이스 또는 채팅 메시지에 통화 앱을 추가하려면
users/app
를 사용합니다. 스페이스에 다른 앱을 추가할 수 없습니다.실제 사용자를 추가하려면
users/{user}
를 사용합니다. 여기서{user}
은 사용자의 이메일 주소일 수 있습니다. 동일한 Workspace 조직에 있는 사용자의 경우{user}
은 People API에서 사용자를 위한id
이거나 Directory API에서 사용자의id
가 될 수도 있습니다. 예를 들어user@example.com
의 People API Person 프로필 ID가123456789
이면membership.member.name
를users/user@example.com
또는users/123456789
로 설정하여 스페이스에 사용자를 추가할 수 있습니다.이름이 지정된 스페이스에 Google 그룹을 추가하거나 초대하려면
groups/{group}
를 사용합니다. 여기서{group}
는 Cloud ID Groups API에서 그룹에 대한id
입니다. 예를 들어 Cloud ID 그룹스 lookup API를 사용하여 그룹 이메일group@example.com
의 ID123456789
을 검색한 다음membership.group_member.name
를groups/123456789
로 설정하여 이름이 지정된 스페이스에 그룹을 추가하거나 초대할 수 있습니다. 그룹 이메일은 지원되지 않으며 Google 그룹은 이름이 지정된 스페이스의 멤버로만 추가할 수 있습니다.
HTTP 요청
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 멤버십을 만들 스페이스의 리소스 이름입니다. 형식: space/{space} |
쿼리 매개변수
매개변수 | |
---|---|
useAdminAccess |
true 인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.통화 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.
관리자 액세스 권한을 사용하여 앱 멤버십을 만들거나 관리자의 Google Workspace 조직 외부 사용자를 위한 멤버십을 만드는 기능은 지원되지 않습니다. |
요청 본문
요청 본문에 Membership
의 인스턴스가 포함됩니다.
응답 본문
성공한 경우 응답 본문에 새로 생성된 Membership
의 인스턴스가 포함됩니다.
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/chat.admin.memberships
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
자세한 내용은 승인 가이드를 참조하세요.