Google Chat ユーザーとして認証と認可を行う

このガイドでは、ユーザーの認証情報で OAuth 2.0 を使用する方法について説明します。Google 認証情報で アクセスする Chat API。認証と認可 ユーザー認証情報により、Chat アプリはユーザーデータにアクセスし、 ユーザーに代わって操作を実行できます。ユーザーの ID で認証することで、 代わりに、アプリはそのユーザーと同じ権限を持ち、アクションを ユーザーによって実行された場合と同様に処理できます。

認証と認可の後 ユーザー認証情報を使用して API 呼び出しを行うと、Chat アプリは 次のとおりです。

  • Chat スペースを作成する。
  • Chat スペースとグループ会話にユーザーを追加します。
  • 次のような他の Workspace API でユーザーデータを操作する。 <ph type="x-smartling-placeholder">

アプリがユーザー認証を使用してアクションを実行するとき (スペースの作成など)を開始すると、Google Chat に アクションを実行したアプリの名前をユーザーに知らせる できます。

Google Chat アプリによってユーザーのスペースが作成されます。
図 1. Chat アプリがユーザーに代わってスペースを作成したときに、Google Chat が表示する帰属メッセージ。

Chat 用アプリで認証が必要な場合と、 詳しくは、このモジュールの 必要な認証の種類 をご覧ください。

ドメイン全体の委任を使用して認証と認可を行う

ドメイン管理者は、Google Chat のメッセージ履歴を ドメイン全体の権限の委任 アプリケーションのサービス アカウントがユーザーのデータを ユーザーごとに同意を求めることも可能ドメイン全体の委任を設定したら、 サービス アカウントはユーザー アカウントの権限を借用できる。 サービス アカウントは、Kubernetes サービス ドメイン全体の委任はユーザーの権限を借用するため、 ユーザー認証とみなされます。ユーザーによる操作を必要とする ドメイン全体の委任を使用できます。

管理者権限を使用して認証と認可を行う

ドメイン管理者、または管理者権限を持つ委任管理者は、該当するメソッドのリクエストで use_admin_access フィールドを設定することで、管理者権限を使用して Google Chat API の呼び出しを認証および承認できます。詳細については、API リファレンス ドキュメントをご覧ください。

Google Chat アプリが管理者権限で操作を行う場合、その操作を行った Chat アプリの名前や操作を承認した管理者の名前がユーザーに通知されることはありません。ただし、操作が組織の管理者によって行われたということのみがユーザーに通知されます。

前提条件

Java

  • 企業または大企業 以下にアクセスできる Google Workspace アカウント Google Chat
  • Google Cloud プロジェクトを作成します
  • Google Chat API を有効にして構成する。名前、 アプリのアイコン、説明を入力します。
  • JDK 1.7 以降
  • Maven パッケージ管理ツール
  • 初期化された Maven プロジェクト。新しいプロジェクトを初期化するには、 コマンドライン インターフェース:
    mvn archetype:generate -DgroupId=com.google.chat.app.authsample -DartifactId=auth-sample-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Python

Node.js

Apps Script

ステップ 1: OAuth 同意画面を構成し、スコープを指定して、アプリを登録する

認可に OAuth 2.0 を使用する場合、Google は承認画面が プロジェクトの概要、ポリシー、リクエストされた 認可スコープを指定します。アプリの OAuth 同意画面の構成 Google がユーザーやアプリのレビュアーに表示する内容を定義し、アプリを登録します。 後で公開できます

OAuth 2.0 を使用するすべてのアプリには同意画面の設定が必要ですが、 Google Workspace 外部のユーザーによって使用されるアプリのスコープを一覧表示する必要があります できます。

<ph type="x-smartling-placeholder">
  1. Google Cloud コンソールで、メニュー に移動します。 &gt; API とサービス &gt; OAuth 同意画面

    [OAuth 同意画面] に移動

  2. アプリのユーザータイプを選択し、[Create] をクリックします。

  3. アプリ登録フォームに入力し、[保存して次へ] をクリックします。

  4. [スコープを追加または削除] をクリックします。以下を [Update] をクリックしてから [Save and Continue] をクリックします。

  5. アプリ登録の概要を確認します。[編集] をクリックして変更を加える [ダッシュボードに戻る] をクリックします。

ステップ 2: Google Cloud コンソールで OAuth クライアント ID の認証情報を作成する

エンドユーザーとして認証し、アプリでユーザーデータにアクセスするには、次のことを行う必要があります。 OAuth 2.0 クライアント ID を 1 つ以上作成します。クライアント ID は Google の OAuth サーバーに送信します。アプリが複数の Google Cloud 使用する場合、それぞれ個別のクライアント ID を作成する必要があります。 プラットフォームごとに異なります。

<ph type="x-smartling-placeholder">で確認できます。

OAuth クライアント ID を作成する

アプリケーションの種類を選択して、OAuth クライアント ID の作成方法を確認します。

ウェブ アプリケーション

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [ウェブ アプリケーション] をクリックします。
  4. [名前] フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. アプリに関連する承認済み URI を追加します。 <ph type="x-smartling-placeholder">
      </ph>
    • クライアントサイド アプリ(JavaScript) - [承認済みの JavaScript 生成元] で [URI を追加] をクリックします。次に、ブラウザ リクエストに使用する URI を入力します。アプリケーションが OAuth 2.0 サーバーに API リクエストを送信できるドメインを識別します。
    • サーバーサイド アプリ(Java、Python など) - [承認済みのリダイレクト URI] で [URI を追加] をクリックします。次に、OAuth 2.0 サーバーがレスポンスを送信できるエンドポイント URI を入力します。
  6. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。

    クライアント ID をメモします。クライアント シークレットはウェブ アプリケーションには使用されません。

  7. [OK] をクリックします。新しく作成された認証情報が [OAuth 2.0 クライアント ID] に表示されます。

Android

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [Android] をクリックします。
  4. [名前] 欄フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [Package name](パッケージ名)フィールドに、AndroidManifest.xml ファイルのパッケージ名を入力します。
  6. [SHA-1 証明書フィンガープリント]フィールドに、生成された SHA-1 証明書フィンガープリントを入力します。
  7. [作成] をクリックします。OAuth クライアントの作成画面が開き、新しいクライアント ID が表示されます。
  8. [OK] をクリックします。新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。

iOS

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [iOS] をクリックします。
  4. [名前] 欄フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [バンドル ID] に入力します。フィールドに、アプリの Info.plist ファイルに記載されているバンドル ID を入力します。
  6. 省略可: アプリが Apple App Store に表示されている場合は、App Store ID を入力します。
  7. 省略可: [チーム ID]フィールドに、Apple によって生成され、チームに割り当てられている一意の 10 文字の文字列を入力します。
  8. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。
  9. [OK] をクリックします。新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。

Chrome アプリ

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [Chrome アプリ] をクリックします。
  4. [名前] 欄フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [アプリケーション ID] 欄フィールドに、アプリの一意の 32 文字の ID 文字列を入力します。この ID 値は、アプリの Chrome ウェブストア URL と Chrome ウェブストア デベロッパー ダッシュボードで確認できます。
  6. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。
  7. [OK] をクリックします。新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。

デスクトップ アプリ

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [デスクトップ アプリ] をクリックします。
  4. [名前] フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。
  6. [OK] をクリックします。新しく作成された認証情報が [OAuth 2.0 クライアント ID] に表示されます。

テレビ、入力デバイスが制限される

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [テレビ、入力デバイスが制限される
  4. [名前] 欄フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。
  6. [OK] をクリックします。新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。

ユニバーサル Windows プラットフォーム(UWP)

  1. Google Cloud コンソールで、メニュー &gt; [API と[サービス] &gt; [認証情報] に移動します。

    [認証情報] に移動

  2. [認証情報を作成] &gt; [OAuth クライアント ID] をクリックします。
  3. [アプリケーションの種類] &gt; [Universal Windows Platform (UWP)] をクリックします。
  4. [名前] 欄フィールドに、認証情報の名前を入力します。この名前は Google Cloud コンソールにのみ表示されます。
  5. [Store ID] で、欄に、アプリの一意の 12 文字の Microsoft Store ID 値を入力します。この ID は、アプリの Microsoft Store の URL とパートナー センターで確認できます。
  6. [作成] をクリックします。OAuth クライアントの作成画面が表示され、新しいクライアント ID とクライアント シークレットが表示されます。
  7. [OK] をクリックします。新しく作成した認証情報が [OAuth 2.0 クライアント ID] に表示されます。

クライアント シークレットの JSON ファイルをダウンロードする

クライアント シークレット ファイルは、OAuth クライアント ID の JSON 表現です Chat 用アプリが参照できる認証情報を 認証情報を提供します。

  1. Google Cloud コンソールで、メニュー に移動します。 &gt; API とサービス &gt; [認証情報] をタップします。

    [認証情報] に移動

  2. [OAuth 2.0 クライアント ID] で、作成したクライアント ID をクリックします。

  3. [JSON をダウンロード] をクリックします。

  4. ファイルを client_secrets.json として保存します。

ステップ 3: Google クライアント ライブラリとその他の依存関係をインストールする

Google クライアント ライブラリと、プロジェクトに必要なその他の依存関係をインストールします。

Java

Google クライアント ライブラリとその他の必要な依存関係を Maven プロジェクトの場合は、プロジェクトのディレクトリにある pom.xml ファイルを編集し、 依存関係が存在します。

<dependencies>
  <!-- ... existing dependencies ... -->
  <dependency>
    <groupId>com.google.apis</groupId>
    <artifactId>google-api-services-chat</artifactId>
    <version>v1-rev20230905-2.0.0</version>
  </dependency>
  <dependency>
    <groupId>com.google.auth</groupId>
    <artifactId>google-auth-library-oauth2-http</artifactId>
    <version>1.19.0</version>
  </dependency>
  <dependency>
    <groupId>com.google.oauth-client</groupId>
    <artifactId>google-oauth-client-jetty</artifactId>
    <version>1.34.1</version>
  </dependency>
  <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
  </dependency>
</dependencies>

Python

Python 用の Google クライアント ライブラリをまだインストールしていない場合は、次のコマンドを実行します。 コマンドライン インターフェースで次のコマンドを実行します。

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

Node.js

Google クライアント ライブラリとその他の必要な依存関係を プロジェクトのディレクトリに移動して、次のコマンドを実行します。 コマンドを使用します。

npm install "@googleapis/chat" open server-destroy

Apps Script

このサンプルでは、 高度な Chat サービス Google Chat API を呼び出すことができます。組織でサービスを有効にするには、 Apps Script プロジェクト:

  1. 左側の [エディタ] をクリックします。
  2. 左側の [サービス] の横にある [サービスを追加] をクリックします。
  3. [Google Chat API] を選択します。
  4. [バージョン] で [v1] を選択します。
  5. [追加] をクリックします。

Google Cloud でサポートされているすべての言語を クライアント ライブラリ

ステップ 4: Chat API を呼び出すスクリプトを作成する

OAuth 認証を使用した API の呼び出しは、複数のステップからなるプロセスです。ウェブまたは アプリケーションの場合、通常は次のようなプロセスになります。

  1. アプリがユーザーを、ユーザーのアクセスをリクエストする認証ページに誘導する 認可スコープで指定されたデータにアクセスできます。アプリはクライアントによって自身を識別し、 ID 認証情報。
  2. ユーザーがアプリから要求された権限を確認し、 リクエストできます。
  3. Google の認証サーバーがブラウザをアプリの HTTP にリダイレクトする 認証コードと一緒に渡されます。
  4. アプリケーションは、Google の承認サーバーに別のリクエストを送信して、 認証コードをアクセス トークンと交換します。
  5. アプリケーションはアクセス トークンを使用して、ユーザーの代わりに API を呼び出します。

OAuth 承認プロセスについて詳しくは、このモジュールの Using OAuth 2.0 to Access Google APIs Guide(OAuth 2.0 を使用した Google API へのアクセスに関するガイド)

以下の Java、Python、Node.js のコードサンプルでは、 クライアント ライブラリ OAuth 認可フローを実行します。ローカルの HTTP サーバーを開いて 認可サーバーから認可コードを受け取り、認可サーバーから アクセス トークンと交換します。 Apps Script コードサンプルでは、この承認フローは Apps Script によって処理されます。

認証フローが完了すると、スクリプトは Chat API。ユーザーのアクセス トークンを使用します。 スペースが作成されます。

Java

  1. プロジェクトのディレクトリで、 src/main/java/com/google/chat/app/authsample/App.java
  2. App.java の内容を次のコードに置き換えます。

    package com.google.chat.app.authsample;
    
    import com.google.api.client.auth.oauth2.Credential;
    import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp;
    import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver;
    import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
    import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
    import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
    import com.google.api.client.http.HttpTransport;
    import com.google.api.client.json.JsonFactory;
    import com.google.api.client.json.gson.GsonFactory;
    import com.google.api.client.util.store.FileDataStoreFactory;
    import com.google.api.services.chat.v1.HangoutsChat;
    import com.google.api.services.chat.v1.model.Space;
    
    import java.io.InputStreamReader;
    import java.util.Collection;
    import java.util.Collections;
    
    /**
     * Authenticates with Chat API via user credentials, then creates a Chat space.
     */
    public class App {
        // Application OAuth credentials.
        private static final String KEYS_RESOURCE_URI = "/client_secrets.json";
    
        // Define your app's authorization scopes.
        private static final Collection<String> SCOPES =
            Collections.singleton("https://www.googleapis.com/auth/chat.spaces.create");
    
        // Directory to store user credentials.
        private static final java.io.File DATA_STORE_DIR =
            new java.io.File(System.getProperty("user.home"), ".store/auth-sample-app");
    
        // Global instance of the JSON factory.
        private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();
    
        // Global instance of the HTTP transport.
        private static HttpTransport httpTransport;
    
        // Global instance of the DataStoreFactory. The best practice is to make it a single
        // globally shared instance across your application.
        private static FileDataStoreFactory dataStoreFactory;
    
        public static void main( String[] args ) {
            try {
                // Run app.
                httpTransport = GoogleNetHttpTransport.newTrustedTransport();
                dataStoreFactory = new FileDataStoreFactory(DATA_STORE_DIR);
                Credential userCredential = authorize();
                Space response = App.createChatSpace(userCredential);
                // Print details about the created space.
                System.out.println(response);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    
        /**
         * Authorizes the installed application to access user's protected data.
         */
        private static Credential authorize() throws Exception {
            // Load client secrets.
            GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY,
                new InputStreamReader(App.class.getResourceAsStream("/client_secrets.json")));
            // Set up authorization code flow.
            GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
                httpTransport, JSON_FACTORY, clientSecrets, SCOPES)
                .setDataStoreFactory(dataStoreFactory)
                .build();
            // Authorize.
            return new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
        }
    
        /**
         * Creates a Chat space.
         */
        private static Space createChatSpace(Credential userCredential) throws Exception {
            // Build the Chat API client and authenticate with the user account.
            HangoutsChat chatService = new HangoutsChat.Builder(
                httpTransport, JSON_FACTORY, userCredential)
                .setApplicationName("auth-sample-app")
                .build();
    
            // Create a Chat space.
            Space space = new Space()
                // To create a named space, set spaceType to SPACE.
                .setSpaceType("SPACE")
                // The user-visible name of the space.
                .setDisplayName("API-made");
            return chatService.spaces().create(space).execute();
        }
    }
    
  3. プロジェクトのディレクトリ内に resources という名前の新しいサブディレクトリを作成します。

  4. ファイル client_secrets.jsonresources サブディレクトリにコピーします。

  5. プロジェクト パッケージにクライアント シークレット ファイルを含めるように Maven を構成するには: プロジェクトのディレクトリにある pom.xml ファイルを編集し、以下を追加します。 <build> セクションに追加します。

    <build>
      <!-- ... existing configurations ... -->
      <resources>
        <resource>
          <directory>resources</directory>
        </resource>
      </resources>
    </build>
    
  6. プロジェクト パッケージに依存関係を含めるように Maven を構成するには、 アプリケーションのメインクラスを実行するには、アプリケーションの pom.xml ディレクトリを作成し、このファイルに次の構成を <plugins> セクション:

    <plugins>
      <!-- ... existing configurations ... -->
      <plugin>
        <artifactId>maven-assembly-plugin</artifactId>
        <configuration>
          <archive>
            <manifest>
              <mainClass>com.google.chat.app.authsample.App</mainClass>
            </manifest>
          </archive>
          <descriptorRefs>
            <descriptorRef>jar-with-dependencies</descriptorRef>
          </descriptorRefs>
        </configuration>
      </plugin>
    </plugins>
    

Python

  1. 次のコードを chat_space_create_named.py という名前のファイルに保存します。 client_secrets.json と同じディレクトリです。

    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.
      '''
    
      flow = InstalledAppFlow.from_client_secrets_file(
                        'client_secrets.json', SCOPES)
      creds = flow.run_local_server()
    
      # Build a service endpoint for Chat API.
      service = build('chat', 'v1', credentials=creds)
    
      # Use the service endpoint to call Chat API.
      result = service.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()
    

Node.js

  1. 次のコードを chat_space_create_named.js という名前のファイルに保存します。 Node.js プロジェクトと client_secrets.json を保持するのと同じディレクトリです。

    const fs = require('fs');
    const path = require('path');
    const http = require('http');
    const url = require('url');
    const destroyer = require('server-destroy');
    
    const chat = require('@googleapis/chat');
    
    // Application OAuth credentials.
    const keys = require('./client_secrets.json').installed;
    
    // Define your app's authorization scopes.
    // When modifying these scopes, delete the file token.json, if it exists.
    const scopes = ["https://www.googleapis.com/auth/chat.spaces.create"];
    
    // Create a new OAuth2 client with the configured keys.
    const oauth2Client = new chat.auth.OAuth2(
      keys.client_id,
      keys.client_secret,
      'http://localhost:3000'
    );
    
    /**
     * Opens an HTTP server to accept the OAuth callback.
     * In this simple example, the only request to our webserver is to /?code=<code>.
     */
    async function authenticate(scopes) {
      const opn = (await import('open')).default;
    
      return new Promise((resolve, reject) => {
        // Generate the URL for authorization.
        const authorizeUrl = oauth2Client.generateAuthUrl({
          access_type: 'offline',
          scope: scopes.join(' '),
        });
        // Start the HTTP server to listen for the callback.
        const server = http
          .createServer(async (req, res) => {
            try {
              const qs = new url.URL(req.url, 'http://localhost:3000').searchParams;
              res.end('Authentication successful! Please return to the console.');
              server.destroy();
              const { tokens } = await oauth2Client.getToken(qs.get('code'));
              oauth2Client.credentials = tokens;
              resolve(oauth2Client);
            } catch (e) {
              reject(e);
            }
          })
          .listen(3000, () => {
            // Open the browser to the authorize URL to start the workflow.
            opn(authorizeUrl, { wait: false }).then(cp => cp.unref());
          });
        destroyer(server);
      });
    }
    
    /**
     * Authenticates with Chat API via user credentials, then creates a Chat space.
     */
    async function createSpace() {
      // Create the Chat API client and authenticate with the authorized user.
      const chatClient = await chat.chat({
        version: 'v1',
        auth: oauth2Client
      });
    
      // Call the Chat API to create a space.
      const result = await chatClient.spaces.create({
    
        // Details about the space to create.
        requestBody: {
    
          // To create a named space, set spaceType to SPACE.
          'spaceType': 'SPACE',
    
          // The user-visible name of the space.
          'displayName': 'API-made'
    
        }
    
      });
      return result;
    }
    
    // Authenticate the user, execute the function,
    // then print details about the created space.
    authenticate(scopes)
      .then(createSpace)
      .then(console.log);
    

Apps Script

  1. Apps Script エディタで、appsscript.json ファイルを編集します。 API の呼び出しに必要な OAuth スコープを追加します。

      "oauthScopes": [
        "https://www.googleapis.com/auth/chat.spaces.create"
      ]
    
  2. 次のコードを ChatSpaceCreateNamed.gs という名前のファイルに保存します。 Apps Script プロジェクト:

    /**
     * Authenticates with Chat API via user credentials, then creates a
     * Chat space.
     */
    function createSpace() {
      try {
        // Details about the space to create.
        // To create a named space, set spaceType to SPACE.
        // The user-visible name of the space is displayName.
        const space = {'displayName': 'API-made', 'spaceType': 'SPACE'};
    
        // Call Chat API with user credentials to create the space.
        const result = Chat.Spaces.create(space);
    
        // Log details about the created space.
        console.log(result);
      } catch (err) {
        // TODO (developer) - Handle exception
        console.log('Failed to create space with error %s', err.message);
      }
    }
    

ステップ 5: サンプル スクリプトを実行する

サンプルを実行するには、コマンドラインから、 次に、次のコマンドを実行します。

Java

mvn compile assembly:single
java -jar target/auth-sample-app-1.0-SNAPSHOT-jar-with-dependencies.jar

Python

python3 chat_space_create_named.py

Node.js

node chat_space_create_named.js

Apps Script

Apps Script で ChatSpaceCreateNamed.gs ファイルを開きます エディタで [実行] をクリックします。

ブラウザが開き、Google アカウントへのログインを求められます。

ログインして Chat 用アプリを認可する。

図 2. アプリを認証するアカウントを選択する OAuth 同意画面

ログインすると、OAuth 同意画面が表示され、権限の付与を求められます。 権限をアプリに付与する必要があります。

アクセスを許可すると、スクリプトは Chat API があります。この API は、 表示名が API-made の Chat スペース。コンソールに 詳細が表示されます。スペースを見つけるには、 できます。

サンプルをトラブルシューティングする

chat_space_create_named.py を実行すると、次のようなエラーが発生することがあります。

Expected a JSON object with a single property for a "web" or "installed" application

このエラー メッセージは、ダウンロードした client_secrets.json ファイルが "web" または "installed" で始まらない プロパティです。ダウンロードしたファイルで認証した後、コードが アクセス トークンを token.json などの新しいファイルに保存すると、アクセス トークンは次のようになります。 これは client_secrets.json に書き込まれるため、後続の 承認の試行回数の上限を引き上げます

このエラーを解決するには、Google Cloud コンソールからクライアント シークレット ファイルをダウンロードします 現在のファイルの場所に新しいファイルを保存します。

  • アプリケーションでスコープ外のユーザー トークンを引き続き使用する必要がある場合 トークンを保存して後で再利用できます。この例では アプリケーションでユーザー トークンを安全に処理し、更新を処理する必要がある トークンの取り消しと有効期限を管理できます。詳細については、次をご覧ください: OAuth 2.0 の使用に関するベスト プラクティス ガイド

  • Chat API のその他の機能については、 Chat API リファレンス ドキュメント