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 と同じ API を新しい Cloud プロジェクトで有効にすることをおすすめします。
API を有効にするには:
Google Cloud コンソール
- Google Cloud コンソールで、メニュー アイコン > [その他のプロダクト] > [Google Workspace] > [プロダクト ライブラリ] に移動します。
- 有効にする API をクリックします。
- [有効にする] をクリックします。
- さらに API を有効にするには、上記の手順を繰り返します。
Google Cloud CLI
- Google Cloud コマンドライン インターフェース（CLI）をインストールするか、開きます。
-
services enableコマンドを実行して、有効にする API サービスを指定します。gcloud services enable API_SERVICE_ID
Chat API を構成する
新しい Cloud プロジェクトでは、Chat API を使用して Chat 用アプリの名前、説明、アイコンを指定する必要があります。これらの詳細を構成するには、Chat API を構成するをご覧ください。
OAuth 同意画面を構成する
Cloud プロジェクトの OAuth 同意画面を構成する必要がある場合があります。以前に認可に OAuth 2.0 を使用した場合は、同じ認可アクセス スコープを使用します。
- Google Cloud コンソールで、メニュー > > [ブランディング] に移動します。
- をすでに構成している場合は、[ブランディング]、[対象ユーザー]、[データアクセス] で次の OAuth 同意画面の設定を構成できます。[ まだ設定されていません] というメッセージが表示された場合は、[使ってみる] をクリックします。
- [アプリ情報] の [アプリ名] に、アプリ名を入力します。
- [ユーザー サポートメール] で、ユーザーが同意について問い合わせる際に使用するサポートのメールアドレスを選択します。
- [続行] をクリックします。
- [対象ユーザー] で、アプリのユーザータイプを選択します。
- [続行] をクリックします。
- [連絡先情報] で、プロジェクトに対する変更の通知を受け取るメールアドレスを入力します。
- [続行] をクリックします。
- [完了] で、Google API サービスのユーザーデータに関するポリシーを確認し、同意する場合は [Google API サービス: ユーザーデータに関するポリシーに同意します] を選択します。
- [続行] をクリックします。
- [作成] をクリックします。
- ユーザータイプとして [外部] を選択した場合は、テストユーザーを追加します。
- [オーディエンス] をクリックします。
- [テストユーザー] で [ユーザーを追加] をクリックします。
- メールアドレスと他の承認済みテストユーザーを入力し、[保存] をクリックします。
Google Workspace 組織外で使用するアプリを作成する場合は、[データ アクセス] > [スコープの追加または削除] をクリックします。スコープを選択する際は、次のベスト プラクティスをおすすめします。
- アプリに必要な最小限のアクセス権を提供するスコープを選択します。使用可能なスコープの一覧については、Google API の OAuth 2.0 スコープをご覧ください。
- 非機密スコープ、機密スコープ、制限付きスコープの 3 つのセクションにリストされているスコープを確認します。[Your sensitive scopes] セクションまたは [Your restricted scopes] セクションに記載されているスコープについては、不要な追加審査を避けるため、機密性の低い代替スコープを特定してください。
- 一部のスコープでは、Google による追加の審査が必要です。Google Workspace 組織内でのみ使用されるアプリの場合、同意画面にスコープは表示されず、制限付きスコープまたは機密スコープの使用に Google による追加の審査は必要ありません。詳細については、スコープ カテゴリをご覧ください。
- アプリに必要なスコープを選択したら、[保存] をクリックします。
OAuth 同意の構成の詳細については、 スタートガイドをご覧ください。
新しい Cloud プロジェクトに Chat 用アプリを再デプロイする
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: Chat 用アプリのアバターとして表示される、128×128 以上の正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL。
- 説明: Chat 用アプリの目的の説明。Chat 用アプリの名前の下に表示されます。
インタラクティブ機能を有効にするには、ユーザーが Chat 用アプリを操作できるようにする [インタラクティブ機能を有効にする] 切り替えボタンをクリックします。
[接続設定] で [Apps Script プロジェクト] を選択します。
[デプロイ ID] フィールドに、先ほどコピーしたデプロイ ID を貼り付けます。
残りの構成を完了するには、新しい Cloud プロジェクトで 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 から非公開にします。