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 をインストールしてinitializeします。
Cloud プロジェクトを作成するには、gcloud projects create コマンドを使用します。
PROJECT_ID は、作成するプロジェクトの ID を設定して置き換えます。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
OAuth 同意画面を構成する
Cloud プロジェクトの OAuth 同意画面の構成が必要になる場合があります。以前に OAuth 2.0 を承認に使用した場合は、同じアクセスの承認スコープを使用します。
- Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。
- アプリのユーザータイプを選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して次へ] をクリックします。
Google Workspace 組織外で使用するアプリを作成する場合は、[スコープを追加または削除] をクリックします。スコープを選択する際は、次のベスト プラクティスをおすすめします。
- アプリに必要な最小レベルのアクセスレベルを提供するスコープを選択します。使用可能なスコープのリストについては、Google API の OAuth 2.0 スコープをご覧ください。
- 3 つのセクション（機密でないスコープ、機密性の高いスコープ、制限付きスコープ）のそれぞれに表示されているスコープを確認します。「機密性の高いスコープ」または「制限付きのスコープ」に記載されているスコープについては、不要な追加の審査を避けるため、機密性の低い別のスコープを特定するようにしてください。
- 一部のスコープは、Google による追加審査が必要です。Google Workspace 組織によって内部的にのみ使用されるアプリの場合、スコープは同意画面に表示されません。制限付きスコープまたはプライベート スコープの使用については、Google による追加審査は必要ありません。詳細については、スコープのカテゴリをご覧ください。
- アプリに必要なスコープを選択したら、[Save and Continue] をクリックします。
- ユーザーの種類に [外部] を選択した場合は、テストユーザーを追加します。
- [テストユーザー] で [ユーザーを追加] をクリックします。
- メールアドレスとその他の承認済みテストユーザーを入力し、[保存して次へ] をクリックします。
- アプリ登録の概要を確認します。変更するには、[編集] をクリックします。アプリ登録に問題がない場合は、[Back to Dashboard] をクリックします。
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 プロジェクトで Chat アプリを構成する
Python や Java などの言語でビルドされた Chat アプリを再デプロイするには、新しい Cloud プロジェクトで Chat アプリを構成します。
Google Cloud コンソールで「Google Chat API」を検索し、[Google Chat API]、[管理] の順にクリックします。
[Configuration] タブをクリックし、次の必要な情報を入力します。
- アプリ名: Chat アプリの操作時に使用する名前。
- アバター URL: Chat アプリのアバターとして表示される、128x128 以上の正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL。
- 説明: Chat アプリの名前の下に表示される、Chat アプリの本来の目的の説明。
インタラクティブ機能をオンにするには、[インタラクティブ機能を有効にする] 切り替えボタンをクリックして、ユーザーが Chat アプリを操作できるようにします。次の表を使用して構成を完了します。
項目 説明 機能 Chat アプリがユーザーとやり取りする方法を決定する一連のフィールド: - 1 対 1 のメッセージの受信: Google Chat で直接 Chat アプリを見つけてメッセージを送信できます。
- スペースとグループの会話に参加する: Chat アプリをスペースとグループ会話に追加できます。
接続設定 Chat アプリのエンドポイント。次のいずれかです。 - アプリの URL: Chat アプリの実装をホストする HTTPS エンドポイント。
- Apps Script プロジェクト: Chat アプリを実装する Apps Script プロジェクトのデプロイ ID。
- Cloud Pub/Sub トピック名: Chat アプリがエンドポイントとしてサブスクライブする Pub/Sub トピック。
- Dialogflow: Dialogflow のインテグレーションに Chat アプリを登録します。詳細については、自然言語を理解する Dialogflow Google Chat アプリを作成するをご覧ください。
スラッシュ コマンド Google Chat 内でユーザーに表示できるコマンド。ユーザーが Google Chat 内の Chat アプリのコア アクションを確認して、やり取りしたい特定のアクションを選択できるようにします。詳しくは、Chat アプリとしてスラッシュ コマンドに応答するをご覧ください。 リンク プレビュー ユーザーがリンクを送信したときに、Chat アプリが認識して追加コンテンツを提供する URL パターン。詳細については、プレビュー リンクをご覧ください。 公開設定 Chat アプリを表示およびインストールできる最大 5 人または 1 つ以上の Google グループ。この項目を使用して、Chat アプリをテストしたり、Chat アプリをチームと共有したりできます。詳しくは、Chat アプリの公開設定と公開の設定をご覧ください。 Chat アプリがエラーを返すたびにエラーを Cloud Logging に記録するには、[Logging にエラーを記録する] チェックボックスをオンにします。詳細については、Chat アプリのエラーログのクエリをご覧ください。
[保存] をクリックします。Chat アプリの構成を保存すると、Google Workspace 組織内の指定したユーザーが 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]、[管理] の順にクリックします。
[Configuration] タブをクリックし、次の必要な情報を入力します。
- アプリ名: Chat アプリの操作時に使用する名前。
- アバター URL: Chat アプリのアバターとして表示される、128x128 以上の正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL。
- 説明: Chat アプリの名前の下に表示される、Chat アプリの本来の目的の説明。
インタラクティブ機能を有効にするには、[インタラクティブ機能を有効にする] 切り替えボタンをクリックして、ユーザーが Chat アプリを操作できるようにします。
[接続設定] で、[Apps Script プロジェクト] を選択します。
[デプロイ 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 に移動します。
ダイレクト メッセージまたはスペースをクリックします。
スペースまたはユーザーの名前の横にあるプルダウンをクリックし、[アプリと統合] を選択します。
[アプリを追加] をクリックします。
アプリの名前を入力し、リストからアプリを選択して、[Add] をクリックします。
Chat アプリを追加するすべてのスペースまたはダイレクト メッセージに対して、上記の手順を繰り返します。
Chat スペースから従来の Chat アプリを削除する
Chat に移動します。
ダイレクト メッセージまたはスペースをクリックします。
スペースまたはユーザーの名前の横にあるプルダウンをクリックし、[アプリと統合] を選択します。
移行していない古い Chat アプリの横にあるその他のオプション アイコン をクリックし、[スペースから削除] をクリックします。
古い Chat アプリを削除するすべてのスペースまたはダイレクト メッセージに対して、上記の手順を繰り返します。
以前の Chat アプリを無効にする
ユーザーが古い Chat アプリを使用できないようにし、ユーザーに新しい Chat アプリの使用を促すには、古い Chat アプリを無効にして Google Workspace Marketplace で公開を停止します。