Method: spaces.members.create

통화 앱의 사용자 멤버십 또는 앱 멤버십을 만듭니다. 다른 앱의 멤버십은 만들 수 없습니다. 예시는 스페이스에 사용자 또는 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의 ID 123456789을 검색한 다음 membership.group_member.name를 groups/123456789로 설정하여 이름이 지정된 스페이스에 그룹을 추가하거나 초대할 수 있습니다. 그룹 이메일은 지원되지 않으며 Google 그룹은 이름이 지정된 스페이스의 멤버로만 추가할 수 있습니다.

HTTP 요청

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 멤버십을 만들 스페이스의 리소스 이름입니다.

형식: space/{space}

쿼리 매개변수

매개변수
useAdminAccess

boolean

true인 경우 메서드는 사용자의 Google Workspace 관리자 권한을 사용하여 실행됩니다.

통화 사용자는 채팅 및 스페이스 대화 관리 권한이 있는 Google Workspace 관리자여야 합니다.

chat.admin.memberships OAuth 2.0 범위가 필요합니다.

관리자 액세스 권한을 사용하여 앱 멤버십을 만들거나 관리자의 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

자세한 내용은 승인 가이드를 참조하세요.