스페이스 만들기

이 가이드에서는 Google Chat API의 Space 리소스에서 create 메서드를 사용하여 이름이 지정된 스페이스를 만드는 방법을 설명합니다.

Space 리소스는 사용자와 채팅 앱이 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 위치를 나타냅니다. 스페이스에는 다음과 같은 여러 유형이 있습니다.

• 채팅 메시지 (DM)는 두 사용자 또는 사용자와 채팅 앱 간의 대화입니다.
• 그룹 채팅은 3명 이상의 사용자와 채팅 앱 간의 대화입니다.
• 이름이 지정된 스페이스는 사용자가 계속해서 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 공간입니다.

이름이 지정된 스페이스는 사용자가 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 공간입니다. 이름이 지정된 스페이스에는 채팅 앱이 포함될 수 있습니다. 이름이 지정된 스페이스에는 관리 설정, 설명을 적용하고 사용자와 앱을 추가하거나 삭제할 수 있는 스페이스 관리자와 같이 이름이 지정되지 않은 그룹 대화와 채팅 메시지에 없는 추가 기능이 포함됩니다. 이름이 지정된 스페이스를 만든 후에는 인증된 사용자만 스페이스의 구성원이 됩니다. 스페이스를 만든 채팅 앱뿐만 아니라 다른 사용자나 앱은 스페이스에 포함되지 않습니다. 사용자를 추가하려면 Member 리소스의 create 메서드를 호출하여 스페이스에서 멤버십을 만듭니다. 방법을 알아보려면 멤버십 만들기를 참고하세요.

여러 멤버가 있는 이름이 지정된 스페이스(예: 3명 이상의 사용자 간 이름 없는 그룹 채팅, 두 사용자 간의 채팅 메시지 대화, 사용자와 Chat API를 호출하는 채팅 앱)를 만들려면 스페이스를 설정하세요.

기본 요건

Python

• Python 3.6 이상
• pip 패키지 관리 도구

• 최신 Python용 Google 클라이언트 라이브러리입니다. 이를 설치하거나 업데이트하려면 명령줄 인터페이스에서 다음 명령어를 실행합니다.

  pip3 install --upgrade google-api-python-client google-auth-oauthlib
  

• Google Chat API가 사용 설정 및 구성된 Google Cloud 프로젝트 단계는 Google Chat 앱 빌드를 참고하세요.

• 채팅 앱에 구성된 승인. 스페이스를 만들려면 chat.spaces.create 또는 chat.spaces 승인 범위의 사용자 인증이 필요합니다.

Node.js

• Node.js 및 npm

• Node.js용 최신 Google 클라이언트 라이브러리입니다. 설치하려면 명령줄 인터페이스에서 다음 명령어를 실행하세요.

  npm install @google-cloud/local-auth @googleapis/chat
  

• Google Chat API가 사용 설정 및 구성된 Google Cloud 프로젝트 단계는 Google Chat 앱 빌드를 참고하세요.

• 채팅 앱에 구성된 승인. 스페이스를 만들려면 chat.spaces.create 또는 chat.spaces 승인 범위의 사용자 인증이 필요합니다.

이름이 지정된 스페이스 만들기

이름이 지정된 스페이스를 만들려면 요청에 다음을 전달합니다.

• chat.spaces.create 또는 chat.spaces 승인 범위를 지정합니다.
• Space 리소스에서 create 메서드를 호출합니다.
• spaceType를 SPACE로 설정합니다.
• displayName을 사용자에게 표시되는 스페이스 이름으로 설정합니다. 다음 예에서 displayName는 API-made로 설정됩니다.
• 필요한 경우 spaceDetails(사용자에게 표시되는 스페이스 설명 및 가이드라인 집합)와 같은 다른 스페이스 속성도 설정합니다.

이름이 지정된 스페이스를 만드는 방법은 다음과 같습니다.

Python

1. 작업 디렉터리에서 chat_space_create_named.py라는 파일을 만듭니다.

2. chat_space_create_named.py에 다음 코드를 포함합니다.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Define your app's authorization scopes.
   # When modifying these scopes, delete the file token.json, if it exists.
   SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"]
   
   def main():
       '''
       Authenticates with Chat API via user credentials,
       then creates a Chat space.
       '''
   
       # Authenticate with Google Workspace
       # and get user authorization.
       flow = InstalledAppFlow.from_client_secrets_file(
                         'client_secrets.json', SCOPES)
       creds = flow.run_local_server()
   
       # Build a service endpoint for Chat API.
       chat = build('chat', 'v1', credentials=creds)
   
       # Use the service endpoint to call Chat API.
       result = chat.spaces().create(
   
         # Details about the space to create.
         body = {
   
           # To create a named space, set spaceType to SPACE.
           'spaceType': 'SPACE',
   
           # The user-visible name of the space.
           'displayName': 'API-made'
         }
   
         ).execute()
   
       # Prints details about the created membership.
       print(result)
   
   if __name__ == '__main__':
       main()
   

3. 작업 디렉터리에서 샘플을 빌드하고 실행합니다.

   python3 chat_space_create_named.py
   

Node.js

1. 작업 디렉터리에서 create-space.js라는 파일을 만듭니다.

2. create-space.js에 다음 코드를 포함합니다.

   const chat = require('@googleapis/chat');
   const {authenticate} = require('@google-cloud/local-auth');
   
   /**
   * Creates a new chat space.
   * @return {!Promise<!Object>}
   */
   async function createSpace() {
     const scopes = [
       'https://www.googleapis.com/auth/chat.spaces.create',
     ];
   
     const authClient =
         await authenticate({scopes, keyfilePath: 'client_secrets.json'});
   
     const chatClient = await chat.chat({version: 'v1', auth: authClient});
   
     return await chatClient.spaces.create(
         {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}});
   }
   
   createSpace().then(console.log);
   

3. 작업 디렉터리에서 샘플을 실행합니다.

   node create-space.js
   

이름이 지정된 스페이스가 만들어집니다. 스페이스로 이동하려면 스페이스의 리소스 ID를 사용하여 스페이스의 URL을 작성합니다. 리소스 ID는 Google Chat 응답 본문의 name 스페이스에서 찾을 수 있습니다. 예를 들어 스페이스의 name가 spaces/1234567인 경우 다음 URL을 사용하여 스페이스로 이동할 수 있습니다. https://mail.google.com/chat/u/0/#chat/space/1234567

관련 주제

• 구성원을 만들어 스페이스에 사용자와 앱을 추가합니다.
• 메시지를 만들어 스페이스에 메시지를 게시합니다.
• 스페이스 세부정보 확인하기
• 스페이스 나열
• 스페이스 업데이트하기
• 스페이스 삭제하기
• 스페이스를 설정합니다.
• 채팅 메시지 스페이스를 찾습니다.