このガイドでは、次の Space
リソースで create
メソッドを使用する方法について説明します。
名前付きスペースを作成できます。
「
Space
リソース
ユーザーと Chat アプリがメッセージを送信し、
ファイルの共有、共同編集を行えますスペースにはいくつかのタイプがあります。
- ダイレクト メッセージ(DM)とは、2 人のユーザーまたはユーザー間の会話で、 作成することもできます。
- グループ チャットとは、3 人以上のユーザーと Chat 用アプリ。
- 名前付きスペースは、メッセージの送信、ファイルの共有、 考えています
名前付きスペースとは、ユーザーがメッセージを送信したり、ファイルを共有したり、
考えています名前付きスペースに Chat 用アプリを含めることができます。名前付きスペース
名前のないグループ会話やダイレクト メッセージを利用できる
たとえば、管理設定を適用できるスペースの管理者などは、
説明、ユーザーやアプリを追加または削除できます。名前付きスペースを作成したら
そのスペースの唯一のメンバーは認証済みユーザーです。スペースは
他のユーザーやアプリを含めるGoogle Chat アプリとは
作成します。ユーザーを追加するには、
create
メソッド
日付
Member
リソース。
方法については、メンバーシップを作成するをご覧ください。
複数のメンバーが参加する名前付きスペースを作成するには、 ダイレクト メッセージでの会話、またはダイレクト メッセージでの会話に Chat アプリから 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
。
関連トピック
- スペースにユーザーやアプリを追加するには、 メンバーの作成をご覧ください。
- スペースにメッセージを投稿: メッセージの作成をご覧ください。
- スペースの詳細を調べる
- スペースを一覧表示する。
- スペースを更新する。
- スペースを削除する
- スペースを設定します。
- ダイレクト メッセージ スペースを見つけます。
- 特定のユーザーがスペースを検索できるようにする