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

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