Method: spaces.members.create

호출 Chat 앱, 사용자 또는 Google 그룹의 멤버십을 만듭니다. 다른 Chat 앱의 멤버십 생성은 지원되지 않습니다. 멤버십을 만들 때 지정된 멤버의 자동 수락 정책이 사용 중지되어 있으면 해당 멤버가 초대되며, 스페이스에 참여하기 전에 스페이스 초대를 수락해야 합니다. 그렇지 않으면 멤버십을 만들면 지정된 스페이스에 멤버가 바로 추가됩니다.

다음 유형의 인증을 지원합니다.

  • 관리자 승인 및 승인 범위가 있는 앱 인증:

    • https://www.googleapis.com/auth/chat.app.memberships

  • 다음 승인 범위 중 하나를 사용한 사용자 인증

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (호출 앱을 스페이스에 추가)
    • https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당)
    • 사용자 인증은 관리자 계정이 인증되고 useAdminAccess이 true이며 다음 승인 범위가 사용될 때 관리자 권한을 부여합니다.
      • https://www.googleapis.com/auth/chat.admin.memberships

다음 사용 사례에서는 앱 인증이 지원되지 않습니다.

  • 스페이스를 소유한 Workspace 조직 외부의 사용자를 초대합니다.
  • 스페이스에 Google 그룹 추가
  • 스페이스에 Chat 앱 추가

사용 예시는 다음을 참고하세요.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

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

형식: spaces/{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.app.memberships
  • 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

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