스페이스 만들기

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

Space 리소스 는 사람과 채팅 앱이 메시지를 보낼 수 있는 위치를 나타냅니다. 파일 공유, 공동작업 등이 가능합니다 다음과 같은 여러 유형의 스페이스가 있습니다.

  • 채팅 메시지 (DM)는 사용자 2명 또는 상대방과 채팅 앱
  • 그룹 채팅은 세 명 이상의 사용자와 채팅 앱
  • 이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고, 공동작업도 가능합니다

이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고, 협업할 수 있습니다 이름이 지정된 스페이스에는 Chat 앱이 포함될 수 있습니다. 이름이 지정된 스페이스 이름이 지정되지 않은 그룹 대화 및 채팅 메시지에 추가 기능이 포함되어 있습니다. 사용자(예: 관리 설정을 적용할 수 있는 스페이스 관리자)와 사용자 및 앱을 추가 또는 삭제할 수 있습니다. 이름이 지정된 스페이스를 만든 후 스페이스의 유일한 멤버는 인증된 사용자입니다. 스페이스에 일부 콘텐츠가 표시되지 않음 다른 사용자 또는 앱을 포함하는 행위 채팅 앱도 마찬가지입니다 생성합니다. 사용자를 추가하려면 create 메서드Member 리소스. 방법을 알아보려면 멤버십 만들기를 참고하세요.

여러 멤버가 있는 이름이 지정된 스페이스 만들기(이름이 지정되지 않은 그룹 채팅) 세 명 이상의 사용자, 두 사람 간의 채팅 메시지 대화, 또는 통화 중인 채팅 앱이 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 승인 범위를 지정합니다.
  • 먼저 create 메서드Space 리소스.
  • spaceTypeSPACE로 설정합니다.
  • 설정 displayName 사용자에게 표시되는 스페이스의 이름입니다. 다음 예에서 displayNameAPI-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 space.
        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.