Method: spaces.create

스페이스를 만듭니다. Import mode에서 명명된 스페이스 또는 그룹 채팅을 만드는 데 사용할 수 있습니다. 예를 보려면 스페이스 만들기를 참고하세요.

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

  • 앱 인증: 관리자 승인 및 다음 승인 범위 중 하나를 사용

    • https://www.googleapis.com/auth/chat.app.spaces.create
    • https://www.googleapis.com/auth/chat.app.spaces
  • 사용자 인증: 다음 승인 범위 중 하나를 사용

    • https://www.googleapis.com/auth/chat.spaces.create
    • https://www.googleapis.com/auth/chat.spaces
    • https://www.googleapis.com/auth/chat.import (가져오기 모드 스페이스만 해당)

앱으로 인증할 때는 요청에서 space.customer 필드를 설정해야 합니다.

앱으로 인증할 때는 Chat 앱이 스페이스의 구성원으로 추가됩니다. 하지만 사용자 인증과 달리 Chat 앱은 스페이스 관리자로 추가되지 않습니다. 기본적으로 모든 스페이스 구성원이 스페이스에서 Chat 앱을 삭제할 수 있습니다. 스페이스 관리자만 스페이스에서 앱을 삭제하도록 허용하려면 space.permission_settings.manage_appsmanagersAllowed로 설정합니다.

생성 시 스페이스 멤버십은 스페이스가 Import mode에서 생성되는지 여부에 따라 달라집니다.

  • 가져오기 모드: 구성원이 생성되지 않습니다.
  • 기타 모든 모드: 호출 사용자가 구성원으로 추가됩니다. 다음과 같습니다.
    • 앱 인증을 사용하는 경우 앱 자체
    • 사용자 인증을 사용하는 경우 실제 사용자

스페이스를 만들 때 ALREADY_EXISTS 오류 메시지가 표시되면 다른 displayName을 사용해 보세요. Google Workspace 조직 내의 기존 스페이스에서 이미 이 표시 이름을 사용하고 있을 수 있습니다.

HTTP 요청

POST https://chat.googleapis.com/v1/spaces

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

쿼리 매개변수

파라미터
requestId

string

선택사항입니다. 이 요청의 고유 ID입니다. 임의의 UUID를 사용하는 것이 좋습니다. 요청 ID를 지정하면 요청이 멱등해지므로 동일한 요청 ID가 있는 여러 동일한 요청으로 인해 스페이스가 하나만 생성됩니다. 요청된 세부정보가 현재 상태와 다르더라도 동일한 요청 ID가 있는 후속 요청은 기존 스페이스를 반환하고 스페이스를 업데이트하지 않습니다.

이 필드를 효과적으로 사용하려면 다음 단계를 따르세요.

  • 후속 요청이 동일하고 원래 요청과 동일한 인증 사용자 인증 정보를 사용하는지 확인합니다.
  • 제공된 요청 ID로 스페이스가 이미 생성된 경우 요청은 해당 스페이스를 반환합니다. 반환된 스페이스가 완전히 채워지지 않을 수 있습니다. API는 시스템 할당 리소스 이름이 채워진 요청의 스페이스를 에코합니다. 스페이스의 최신 메타데이터를 검색하려면 spaces.get을 호출하세요.
  • 인증된 사용자가 다른 기존 요청 ID를 재사용하면 오류가 발생합니다.

요청 본문

요청 본문에 Space의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Space의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/chat.app.spaces.create
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.create

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