이 가이드에서는 다음의 Space
리소스에서 create
메서드를 사용하는 방법을 설명합니다.
Google Chat API를 사용하여 이름이 지정된 스페이스를 만듭니다.
이
Space
리소스
는 사람과 채팅 앱이 메시지를 보낼 수 있는 위치를 나타냅니다.
파일 공유, 공동작업 등이 가능합니다 다음과 같은 여러 유형의 스페이스가 있습니다.
- 채팅 메시지 (DM)는 사용자 2명 또는 상대방과 채팅 앱
- 그룹 채팅은 세 명 이상의 사용자와 채팅 앱
- 이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고, 협업할 수 있습니다
이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고,
협업할 수 있습니다 이름이 지정된 스페이스에는 Chat 앱이 포함될 수 있습니다. 이름이 지정된 스페이스
이름이 지정되지 않은 그룹 대화 및 채팅 메시지에 추가 기능이 포함되어 있습니다.
사용자(예: 관리 설정을 적용할 수 있는 스페이스 관리자)와
사용자 및 앱을 추가 또는 삭제할 수 있습니다. 이름이 지정된 스페이스를 만든 후
스페이스의 유일한 멤버는 인증된 사용자입니다. 스페이스에 일부 콘텐츠가 표시되지 않음
다른 사용자 또는 앱을 포함하는 행위 채팅 앱도 마찬가지입니다
생성합니다. 사용자를 추가하려면
create
메서드
에
Member
리소스.
방법을 알아보려면 멤버십 만들기를 참고하세요.
여러 멤버가 있는 이름이 지정된 스페이스 만들기(이름이 지정되지 않은 그룹 채팅) 세 명 이상의 사용자, 두 사람 간의 채팅 메시지 대화, 또는 통화 중인 채팅 앱이 Chat API: 스페이스 설정 하세요.
기본 요건
Python
- 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
- 환경을 설정합니다.
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud 프로젝트를 만듭니다.
- OAuth 동의 화면 구성
- Google Chat API를 사용 설정 및 구성합니다. 아이콘, 채팅 앱 설명이 있습니다.
- 설치 Python Google API 클라이언트 라이브러리를 참조하세요.
- <ph type="x-smartling-placeholder"></ph>
데스크톱 애플리케이션용 OAuth 클라이언트 ID 사용자 인증 정보 만들기 이 실습에서 샘플을 실행하려면
가이드에서 사용자 인증 정보를
client_secrets.json
이라는 JSON 파일로 로컬 디렉터리에 저장합니다
- <ph type="x-smartling-placeholder"></ph> 사용자 인증을 지원하는 승인 범위를 선택합니다.
Node.js
- 비즈니스 또는 기업 다음 액세스 권한이 있는 Google Workspace 계정 Google Chat
- 환경을 설정합니다.
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud 프로젝트를 만듭니다.
- OAuth 동의 화면 구성
- Google Chat API를 사용 설정 및 구성합니다. 아이콘, 채팅 앱 설명이 있습니다.
- 설치 Node.js Google API 클라이언트 라이브러리를 참조하세요.
- <ph type="x-smartling-placeholder"></ph>
데스크톱 애플리케이션용 OAuth 클라이언트 ID 사용자 인증 정보 만들기 이 실습에서 샘플을 실행하려면
가이드에서 사용자 인증 정보를
client_secrets.json
이라는 JSON 파일로 로컬 디렉터리에 저장합니다
- <ph type="x-smartling-placeholder"></ph> 사용자 인증을 지원하는 승인 범위를 선택합니다.
이름이 지정된 스페이스 만들기
이름이 지정된 스페이스를 만들려면 요청에 다음을 전달합니다.
chat.spaces.create
또는chat.spaces
승인 범위를 지정합니다.- 먼저
create
메서드 에Space
리소스. spaceType
를SPACE
로 설정합니다.- 설정
displayName
드림 사용자에게 표시되는 스페이스의 이름입니다. 다음 예에서displayName
는API-made
로 설정됩니다. - 원하는 경우
spaceDetails
드림 (스페이스에 대한 사용자에게 표시되는 설명 및 일련의 가이드라인)
이름이 지정된 스페이스를 만드는 방법은 다음과 같습니다.
Python
- 작업 디렉터리에
chat_space_create_named.py
라는 파일을 만듭니다. 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()
작업 디렉터리에서 샘플을 빌드하고 실행합니다.
python3 chat_space_create_named.py
Node.js
- 작업 디렉터리에
create-space.js
라는 파일을 만듭니다. 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);
작업 디렉터리에서 샘플을 실행합니다.
node create-space.js
이름이 지정된 스페이스가 생성됩니다. 스페이스로 이동하려면 스페이스의 리소스 ID를 사용하세요.
스페이스의 URL을 만듭니다. 스페이스에서 리소스 ID를 찾을 수 있습니다.
Google Chat 응답 본문의 name
예를 들어 스페이스의
name
이(가) spaces/1234567
상태인 경우 다음을 사용하여 스페이스로 이동할 수 있습니다.
URL: https://mail.google.com/chat/u/0/#chat/space/1234567
.
관련 주제
- 다음 방법으로 스페이스에 사용자와 앱을 추가하세요. 구성원 만들기
- 다음 날짜까지 스페이스에 메시지 게시 메시지 만들기를 참조하세요.
- 스페이스에 관한 세부정보 확인하기
- 스페이스 나열
- 스페이스 업데이트하기
- 스페이스 삭제하기
- 스페이스를 설정합니다.
- 채팅 메시지 공간 찾기
- 특정 사용자가 스페이스를 검색할 수 있도록 설정합니다.