Gmail で OAuth 用にメールチャネルを構成する

このページでは、 Google Cloud を使用して Contact Center AI Platform（CCAI Platform）のメールチャネルを構成するための OAuth 認証情報を作成する方法について説明します。

始める前に

以下のものがあることを確認してください。

また、 Google Cloud プロジェクトで課金が有効になっていることを確認します。詳細については、プロジェクトの課金ステータスを確認するをご覧ください。

OAuth 認証情報を作成する

Google Cloud を使用して、OAuth 認証情報（クライアント ID とクライアント シークレット）を作成できます。同意画面をまだ構成していない場合は、OAuth 認証情報を作成する前に構成する必要があります。OAuth の詳細については、OAuth 2.0 を使用して Google API にアクセスするをご覧ください。

OAuth 認証情報を作成して同意画面を構成するには、次の操作を行います。

  1. Google Cloud コンソールで、プロジェクト選択ツール ダッシュボードに移動し、OAuth 認証情報の作成に使用するプロジェクトを選択します。

    プロジェクト セレクタ ダッシュボード

  2. [API とサービス] ページに移動し、ナビゲーション メニューで [認証情報] をクリックします。

    認証情報

  3. この Google Cloudプロジェクトの同意画面をまだ構成していない場合は、[同意画面を構成] ボタンが表示されます。その場合は、次の手順で同意画面を構成します。それ以外の場合は、手順 4 に進みます。

    1. [同意画面を構成] をクリックします。[OAuth 同意画面] ページが表示されます。

    2. ユースケースに応じて、[内部] または [外部] を選択し、[作成] をクリックします。[OAuth 同意画面] ペインが表示されます。

    3. [アプリ情報] ページで画面上の手順に沿って情報を入力し、[保存して次へ] をクリックします。[スコープ] ペインが表示されます。

    4. [スコープを追加または削除] をクリックします。[選択したスコープを更新] ペインが表示されます。

    5. ユースケースに適したスコープを選択し、[更新] をクリックします。

    6. [保存して次へ] をクリックします。[テストユーザー] ペインが表示されます。

    7. アプリへのテストアクセスにユーザーを追加する場合は、[ユーザーを追加] をクリックします。[ユーザーを追加] ペインが表示されます。

    8. 空のフィールドに Google アカウントのメールアドレスを 1 つ以上追加し、[追加] をクリックします。

    9. [保存して次へ] をクリックします。[概要] ペインが表示されます。

    10. OAuth 同意画面の情報を確認し、[ダッシュボードに戻る] をクリックします。

    11. アプリを今すぐ製品版で公開する場合は、[アプリを公開] をクリックし、確認ダイアログで [確認] をクリックします。同意画面が構成されている。

  4. ナビゲーション メニューで [認証情報] をクリックします。

  5. [認証情報を作成]、[OAuth クライアント ID] の順にクリックします。

  6. [アプリケーションの種類] フィールドで、[ウェブ アプリケーション] をクリックします。

  7. [名前] フィールドに、クライアントの名前を入力します。

  8. [承認済みの JavaScript 生成元] 領域で [IRI を追加] をクリックします。

  9. [URI] フィールドに https://TENANT_NAME.ccaiplatform.com と入力します。TENANT_NAME はテナント名に置き換えます。

  10. [承認済みのリダイレクト URI] 領域で、[URI を追加] をクリックします。

  11. [URI] フィールドに https://TENANT_NAME.ccaiplatform.com/v1/email_accounts/oauth_callback を入力します。TENANT_NAME はテナント名に置き換えます。

  12. [作成] をクリックします。[OAuth クライアントを作成しました] ダイアログが表示されます。

  13. [JSON をダウンロード] をクリックして、クライアント ID とクライアント シークレットを含む JSON ファイルをパソコンにダウンロードし、[OK] をクリックします。

クライアント ID とクライアント シークレットを取得する

OAuth 認証情報を作成すると、クライアント ID とクライアント シークレットをいつでも取得できます。

クライアント ID とクライアント シークレットを取得するには、次の操作を行います。

  1. Google Cloud コンソールで、[API とサービス] ページに移動します。ナビゲーション メニューで [認証情報] をクリックします。

    認証情報

  2. [OAuth 2.0 クライアント ID] 領域で、クライアント ID とクライアント シークレットを取得するクライアントをクリックします。クライアント ID とクライアント シークレットが [追加情報] 領域に表示されます。

メールチャネルの SSO 設定を構成する

OAuth 認証情報を作成するで作成したクライアント ID とクライアント シークレットを使用して、メールチャネルのシングル サインオン（SSO）設定を構成します。

SSO 設定を構成する手順は次のとおりです。

  1. CCAI Platform ポータルで、 メニューをクリックし、[設定> デベロッパー設定] をクリックします。

  2. [メール アカウントの管理] ペインに移動し、[メール アカウントを管理] をクリックします。

  3. [メール アカウントの管理] ページで、[メール SSO] をクリックします。

  4. [メール SSO] ペインで、次のリストに示すように設定を構成します。

    • 認可 URL。「https://accounts.google.com/o/oauth2/v2/auth?prompt=select_account consent」と入力します。

    • トークン URL。「https://oauth2.googleapis.com/token」と入力します。

    • クライアント ID。OAuth 認証情報を作成するで作成したクライアント ID を入力します。クライアント ID を保存していない場合は、クライアント ID とクライアント シークレットを取得するをご覧ください。

    • クライアント シークレット。OAuth 認証情報を作成するで作成したクライアント シークレットを入力します。クライアント シークレットを保存していない場合は、クライアント ID とクライアント シークレットを取得するをご覧ください。

    • 範囲。「https://mail.google.com/」と入力します。

    • Stateこのフィールドは空白のままにします。

    • アクセスタイプ。「offline」と入力します。

    • グラントタイプ。「Authorization Code」と入力します。

    • [Include the Grant Type as part of the Authorization URL and Token URL]（認証 URL とトークン URL の一部として付与タイプを含める）チェックボックスをオフにします。

    • [リダイレクト URL を認証 URL とトークン URL の一部として含める] チェックボックスをオンにして、[保存] をクリックします。メールチャンネルが OAuth 用に構成されている。