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