Google Workspace 組織を統合する場合は、Chat アプリを移行して引き続き機能するようにする必要があります。
Chat アプリを移行する前に、管理設定が影響しているかどうかを組織の管理者に確認してください。管理設定を変更すると、Chat アプリの機能が完全に復元され、移行が不要になる場合があります。たとえば、Google Workspace 管理者が Chat アプリを許可リストに追加したり、ユーザーに Chat アプリのインストールを許可したりする必要があります。詳しくは、Google Workspace 組織の統合後に Google Chat アプリを移行する必要があるかどうかを判断するをご覧ください。
Chat アプリを移行する必要があることが判明したら、次の 3 つのステップで移行を完了します。
- 統合された組織に Google Cloud プロジェクトを作成し、API を有効にして、必要に応じて OAuth 2.0 同意画面を構成して、Chat アプリの環境を設定します。
- 新しい Cloud プロジェクトから Chat アプリを再デプロイします。
- 再作成した Chat アプリを Chat スペースまたは会話に追加し、元の Chat アプリをオフにします。
統合された組織に Cloud プロジェクトを作成し、API を有効にする
新しい Cloud プロジェクトを作成し、統合された Google Workspace 組織で Chat アプリの API を有効にすると、Chat アプリへのアクセスを許可したユーザーとグループがエラーなくアクセスできるようになります。
Cloud プロジェクトを作成する
Google Cloud コンソール
- Google Cloud コンソールで、メニュー > [IAM と管理] > [プロジェクトを作成] に移動します。
-
[プロジェクト名] フィールドに、プロジェクトのわかりやすい名前を入力します。
省略可: プロジェクト ID を編集するには、[編集] をクリックします。プロジェクトの作成後にプロジェクト ID を変更することはできないため、プロジェクトのライフタイムを考慮してニーズに合った ID を選択してください。
- [ロケーション] フィールドで [参照] をクリックして、プロジェクトの候補となるロケーションを表示します。[選択] をクリックします。
- [作成] をクリックします。Google Cloud コンソールがダッシュボード ページに移動し、数分以内にプロジェクトが作成されます。
gcloud CLI
次のいずれかの開発環境で、Google Cloud CLI（gcloud）にアクセスします。
-
Cloud Shell: gcloud CLI がすでに設定されているオンライン ターミナルを使用するには、Cloud Shell をアクティブにします。
Cloud Shell を有効にする -
ローカルシェル: ローカル開発環境を使用するには、gcloud CLI をインストールして初期化します。
Cloud プロジェクトを作成するには、gcloud projects createコマンドを使用します。gcloud projects create PROJECT_ID
API を有効にする
すべての Chat アプリで Google Chat API を有効にする必要があります。Chat アプリの構築方法によっては、他の API を有効にする必要があります。たとえば、Google Cloud Functions を使用して Chat アプリを構築した場合は、Cloud Build API、Cloud Functions API、Pub/Sub API、Cloud Logging API、Artifact Registry API、Cloud Run API を有効にします。移行したアプリが確実に機能するようにするには、古い Cloud プロジェクトで有効になっている API を新しい Cloud プロジェクトでも有効にすることをおすすめします。
API を有効にするには、次の操作を行います。
Google Cloud コンソール
- Google Cloud コンソールで、メニュー > [その他のプロダクト] > [Google Workspace] > [プロダクト ライブラリ] に移動します。
- 有効にする API をクリックします。
- [有効にする] をクリックします。
- 他の API を有効にするには、上記の手順を繰り返します。
Google Cloud CLI
- Google Cloud コマンドライン インターフェース（CLI）をインストールまたは開きます。
-
有効にする API サービスを指定して、
services enableコマンドを実行します。gcloud services enable API_SERVICE_ID
Chat API を構成する
新しい Cloud プロジェクトで、Chat API を使用して Chat アプリの名前、説明、アイコンを指定する必要があります。これらの詳細を構成するには、Chat API を構成するをご覧ください。
OAuth 同意画面を構成する
Cloud プロジェクトの OAuth 同意画面を構成することが必要になる場合があります。以前に認可に OAuth 2.0 を使用していた場合は、同じアクセスの認可スコープを使用します。
- Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。
- アプリのユーザータイプを選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して続行] をクリックします。
Google Workspace 組織の外部で使用するアプリを作成する場合は、[スコープを追加または削除] をクリックします。スコープを選択する際は、次のベスト プラクティスをおすすめします。
- アプリに必要な最小レベルのアクセス権を提供するスコープを選択します。使用可能なスコープの一覧については、Google API の OAuth 2.0 スコープをご覧ください。
- [非機密のスコープ]、[機密のスコープ]、[制限付きスコープ] の 3 つのセクションに表示されているスコープを確認します。[機密性の高いスコープ] または [制限付きスコープ] セクションに表示されているスコープについては、機密性のない代替のスコープを特定して、不要な追加審査を回避してください。
- スコープによっては、Google による追加の審査が必要になる場合があります。Google Workspace 組織内でのみ使用されるアプリの場合、スコープは同意画面に表示されず、制限付きスコープまたは機密スコープを使用する場合でも、Google による追加の審査は必要ありません。詳細については、スコープ カテゴリをご覧ください。
- アプリに必要なスコープを選択したら、[保存して次へ] をクリックします。
- ユーザータイプに [外部] を選択した場合は、テストユーザーを追加します。
- [テストユーザー] で [ユーザーを追加] をクリックします。
- メールアドレスと他の承認済みテストユーザーを入力し、[保存して次へ] をクリックします。
- アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリの登録に問題がなければ、[ダッシュボードに戻る] をクリックします。
Chat アプリを新しい Cloud プロジェクトに再デプロイする
Chat アプリが Apps Script、AppSheet、または Python や Java などの別の接続タイプで構築されているかどうかに応じて、Chat アプリの再デプロイ方法は若干異なります。どちらの場合も、コードをすべて再作成する必要はありませんが、一部の変更を行う必要があります。
Chat アプリのロジックを移行する
Chat アプリのアーキテクチャに応じて、他のサービスを新しい Cloud プロジェクトに移行することが必要になる場合があります。
- HTTP アプリの場合は、Cloud Functions、Cloud Run、App Engine を使用して構築された残りのアプリ ロジックも移行する必要があります。
- 自然言語を使用する会話型 Chat アプリの場合は、Dialogflow エージェントも移行する必要があります。
- ファイアウォールの背後に構築された Chat アプリの場合は、Pub/Sub トピックも移行する必要があります。
新しい Cloud プロジェクトでインタラクティブ機能を構成する
Python や Java などの言語で構築された Chat アプリを再デプロイするには、新しい Cloud プロジェクトで Chat アプリを構成します。
インタラクティブな機能を設定するには、ユーザー操作を受け取って応答するをご覧ください。
Apps Script Chat アプリを再デプロイする
Apps Script でビルドされた Chat アプリを再デプロイするには、Apps Script プロジェクトが関連付けられている Cloud プロジェクト番号を、新しい Cloud プロジェクトに属するプロジェクト番号に変更します。次に、Apps Script のデプロイ ID をコピーし、Google Cloud コンソールの Chat アプリの構成ページに貼り付けます。
Cloud プロジェクト番号をコピーする
- Google Cloud コンソールで、メニュー > [IAM と管理] > [設定] に移動します。
- [プロジェクト番号] フィールドで値をコピーします。
Apps Script プロジェクトで Google Cloud プロジェクト番号を設定する
Apps Script に移動します。
Chat アプリの Apps Script プロジェクトで、[プロジェクトの設定] をクリックします。
[Google Cloud Platform（GCP）プロジェクト] で、[プロジェクトを変更] をクリックします。
[GCP プロジェクト番号] に、Google Cloud プロジェクト番号を貼り付けます。
[プロジェクトを設定] をクリックします。
Apps Script プロジェクトのデプロイ ID をコピーする
- Apps Script の右上で、[デプロイ] > [デプロイを管理] をクリックします。
- [デプロイ ID] で [コピー] をクリックします。
- [完了] をクリックします。
Chat アプリを再構成して再デプロイする
Google Cloud コンソールで「Google Chat API」を検索し、[Google Chat API]、[管理] の順にクリックします。
[構成] タブをクリックし、次の必須情報を入力します。
- アプリ名: ユーザーが Chat アプリを操作する際に使用する名前。
- アバターの URL: 正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL。サイズは 128 x 128 ピクセル以上で、Chat アプリのアバターとして表示されます。
- 説明: Chat アプリの名前の下に表示される、Chat アプリの目的の説明。
インタラクティブ機能を有効にするには、ユーザーが Chat アプリを操作できるようにする [インタラクティブ機能を有効にする] 切り替えボタンをクリックします。
[接続設定] で [Apps Script プロジェクト] を選択します。
[Deployment ID] フィールドに、先ほどコピーしたデプロイ ID を貼り付けます。
残りの構成を完了するには、新しい Cloud プロジェクトで Chat アプリを構成するの表をご覧ください。
[保存] をクリックします。
AppSheet Chat アプリを再デプロイする
AppSheet でビルドされた Chat アプリを新しい Cloud プロジェクトに再デプロイするには、アプリを新しい Cloud プロジェクトにコピーします。
サービス アカウントを更新する
Chat アプリがアプリとして認証され、サービス アカウントを使用して Google API を呼び出す場合は、Chat アプリのサービス アカウントの詳細を更新します。詳細については、Chat アプリとして認証するをご覧ください。
Chat アプリを共有する
新しい組織のユーザーが Chat アプリを使用できるようになるまでに、管理者が Chat アプリへのアクセスを手動で許可しなければならない場合があります。詳しくは、Google Workspace 管理者が Chat アプリをインストールする方法をご覧ください。
新しい Chat アプリに切り替える
Chat アプリが新しい組織に移行されたので、公開します。Chat スペースまたはダイレクト メッセージに追加し、古い Chat アプリを削除して、移行した Chat アプリにのみメッセージを送信できるようにします。
新しい Chat アプリを Chat スペースに追加する
Chat に移動します。
ダイレクト メッセージまたはスペースをクリックします。
スペースまたはユーザーの名前の横にあるプルダウンをクリックし、[アプリとインテグレーション] を選択します。
[アプリを追加] をクリックします。
アプリの名前を入力し、リストからアプリを選択して、[追加] をクリックします。
Chat アプリを追加するスペースまたはダイレクト メッセージごとに、上記の手順を繰り返します。
Chat スペースから従来の Chat アプリを削除する
Chat に移動します。
ダイレクト メッセージまたはスペースをクリックします。
スペースまたはユーザーの名前の横にあるプルダウンをクリックし、[アプリとインテグレーション] を選択します。
移行されていない古い Chat アプリの横にあるその他アイコン 、[スペースから削除] の順にクリックします。
従来の Chat アプリを削除するスペースまたはダイレクト メッセージごとに、上記の手順を繰り返します。
従来の Chat アプリを無効にする
ユーザーが従来の Chat アプリを使用しないようにし、新しい Chat アプリの使用を促すには、従来の Chat アプリを無効にして、Google Workspace Marketplace から公開を停止します。