サードパーティ データソースを接続する

注: この機能はプレビュー版で、GCP サービス固有の規約の「pre-GA サービス規約」が適用されます。 一般提供前のプロダクトと機能では、サポートが制限されることがあります。また、これらのプロダクトや機能には、他の一般提供前のバージョンと互換性のない変更が行われる場合があります。詳細については、リリース ステージの説明をご覧ください。 さらに、この機能を使用すると、生成 AI プレビュー版の利用規約（以下「プレビュー規約」）に同意したことになります。この機能については、お客様は Cloud のデータ処理に関する追加条項に記載されているとおりに個人データを処理できます。その際、（プレビュー規約に定義されるとおり）本契約で規定されている制限と義務が適用されます。

このページでは、サードパーティのデータソースを Vertex AI Search に接続する方法について説明します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

サードパーティのデータソースを接続すると、Vertex AI Search はデータコネクタを作成し、指定したエンティティのデータストア（エンティティ データストア）をそれに関連付けます。エンティティ タイプは、接続先のデータソースに固有です。たとえば、Jira Cloud のエンティティには、問題、添付ファイル、コメント、ワークログなどがあります。

サードパーティのデータソースは、一般的な検索アプリでのみ使用できます。チャット、おすすめ、エージェント アプリでは、サードパーティのデータソースを使用できません。

サードパーティ製コネクタは CMEK 準拠ではありません。

Google データソースからデータをインポートするには、検索データストアを作成するをご覧ください。

始める前に

1. Google アカウント チームに連絡し、サードパーティのデータソース コネクタの許可リストへの追加を依頼します。

2. 使用するソースのセクションに移動します。

   • Confluence Cloud を接続する
   • Jira Cloud を接続する
   • Salesforce を接続する
   • ServiceNow を接続する
   • SharePoint Online を接続する
   • Slack を接続する
   • Dropbox を接続する
   • Connect Box
   • OneDrive を接続する

Confluence Cloud を接続する

次の手順で、Confluence Cloud から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意してください。

  • インスタンスの URLhttps://EXAMPLE.atlassian.net の形式です。例: https://google.atlassian.net。

  • インスタンス ID。これは cloudid です。https://EXAMPLE.atlassian.net/_edge/tenant_info に移動して cloudId の値をコピーすると確認できます。

• OAuth 2.0 を有効にして、クライアント ID とクライアント シークレットを取得します。

  コールバック URL として https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html を使用します。Confluence Cloud で OAuth 2.0 を有効にしてクライアント ID とクライアント シークレットを取得する方法については、Atlassian デベロッパー ドキュメントの OAuth 2.0（3LO）アプリをご覧ください。

• OAuth 2.0 権限スコープを設定する場合は、次のスコープを構成します。

  スコープを表示する

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

• ユーザー権限を正しく適用するには、各 Confluence Cloud ユーザーがメールアドレスをすべてのユーザーに公開する必要があります。これを行うには、Confluence Cloud でメールの公開設定を変更し、公開設定を Anyone に設定します。詳細については、Atlassian のドキュメントのメールの公開設定をご覧ください。

Console

Google Cloud コンソールを使用して Confluence Cloud から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [新しいデータストア] をクリックします。

4. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[Confluence] を選択します。

5. 認証情報を入力し、[Authenticate] をクリックします。

6. 新しいウィンドウが表示されます。 インスタンスのユーザー名とパスワードを入力します。認証が成功したことを確認してから、[データストアの Confluence ソースの指定] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データ コネクタのリージョンを選択します。

9. データ コネクタの名前を入力します。

10. 同期頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Jira Cloud を接続する

Jira Cloud から Vertex AI Search にデータを同期するには、次の手順を使用します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートした後、データストアがそのソースと同期する頻度を選択できます。

始める前に

接続を設定する前に:

• アクセス制御を設定します。データソースのアクセス制御が適切に構成されていることを確認します。この手順により、承認されたユーザーのみがデータにアクセスして管理できるようになります。詳細については、データソースのアクセス制御を使用するをご覧ください。
• ユーザー権限を正しく適用するには、Jira Cloud ユーザーが共有の同意を提供する必要があります。
• Atlassian アカウント、Jira インスタンス、プロジェクトがあることを確認します。
• Jira インスタンスとプロジェクトに対する管理者権限があることを確認します。

Jira で認証と権限を設定する

次のセクションの手順に沿って、Jira インスタンスに必要な認証情報と管理者権限があることを確認します。Atlassian Developer Console でクライアント ID とクライアント シークレットを作成し、必要な OAuth 2.0 スコープを構成して、ユーザーの権限を設定します。最後に、インスタンスの URL と ID を取得し、ロールを構成して認証し、Jira Cloud と Vertex AI Search の間でデータを同期します。

クライアント ID とクライアント シークレットを作成する

注: OAuth 2.0 を有効にしてクライアント ID とシークレットを取得するには、Atlassian デベロッパー ドキュメントの OAuth 2.0（3LO）アプリをご覧ください。

1. developer.atlassian.com にログインします。
2. 右上のプロフィール アイコンをクリックし、[デベロッパー コンソール] を選択します。
3. [Create] をクリックし、[OAuth 2.0 Integration] を選択します。
4. アプリの名前を入力します。
   • 利用規約のチェックボックスをオンにします。
   • [作成] をクリックします。

5. [概要]、[配信]、[権限]、[認証]、[設定] の 5 つのオプションが表示されます。まず [認可] から始めます。

   a. [承認] をクリックします。

   b. [認証タイプ] テーブルで、[OAuth 2.0（3LO）] の [追加] を選択します。

6. [Callback URL] フィールドに https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html を入力し、[Save changes] をクリックします。

   注: [アプリに API がありません。アプリに API を追加する。これは次のセクションで説明します。

7. [権限] を選択します。

   a. [Jira API] に移動し、[追加]、[構成] の順にクリックします。

   注: [追加] をクリックすると、ボタンが [設定] に変わります。

   b. [従来のスコープ] タブに移動し、[スコープを編集] をクリックします。次のスコープを選択します。

   ビュー スコープ

   • read:avatar:jira
   • read:audit-log:jira
   • read:group:jira
   • read:issue-security-level:jira
   • read:issue-security-scheme:jira
   • read:jira-user
   • read:jira-work
   • read:user:jira

   7 つのスコープが選択されていることを確認して、変更を保存します。

8. [配信] をクリックし、[編集] を選択して、次の操作を行います。

   • 他のフィールドの編集を有効にするには、まず [共有] ラジオボタンを選択します。
   • 残りのフィールドに入力します。
   • Does your app store personal data? と尋ねられたら [Yes] を選択します。

9. [設定] を選択して、[クライアント ID] と [クライアント シークレット] をコピーします。

インスタンスの URL とインスタンス ID を取得する

インスタンスの URL を取得する手順は次のとおりです。

1. atlassian.net に移動し、管理者アカウントでログインします。
2. 同期するアプリを選択します。たとえば、最初のアプリを同期します。
3. インスタンス URL（アドレスバーのサブドメイン）を確認します。Assign appropriate permissions のようになります。

インスタンス ID を取得する手順は次のとおりです。

1. 新しいタブを開き、インスタンスの URL をコピーして、インスタンスの URL に /_edge/tenant_info を追加します。例: https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info
2. リンクに移動して、cloudId 値を確認します。cloudId はインスタンス ID です。

権限とロールを設定する

1. 管理者アカウントで atlassian.com にログインします。
2. 左上のメニュー アイコンをクリックするか、admin.atlassian.com に移動します。

3. [管理] ページで [ユーザーを管理] をクリックし、[グループ] ページに移動します。

4. [グループを作成] をクリックします。 グループの名前を入力して作成します。

5. 新しいグループのページの [グループ商品アクセス] セクションで、[グループに商品を追加] をクリックします。

6. Jira の場合は、プロダクトのロールとして [ユーザー アクセス管理者] を選択します。

7. [Jira 管理者] で、プロダクト ロールとして [プロダクト管理者] を選択し、変更を保存します。

8. [グループ] ページで [グループ メンバーを追加] をクリックし、コネクタが認証するユーザーまたはアカウントを追加します。

Jira Cloud コネクタを作成する

Console

Google Cloud コンソールを使用して Jira Cloud から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[Jira] を選択します。

5. 認証情報を入力し、[Authenticate] をクリックします。

6. 新しいウィンドウが表示されます。 インスタンスのユーザー名とパスワードを入力します。認証が成功したことを確認してから、[データストアの Jira ソースの指定] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのリージョンを選択します。

9. データストアの名前を入力します。

10. 同期頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Salesforce を接続する

次の手順で、Salesforce から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意してください。Salesforce でクライアント ID とクライアント シークレットを設定する方法については、Salesforce ドキュメントの OAuth 2.0 クライアント認証情報フローの接続済みアプリを構成するをご覧ください。

  • インスタンス URL: Salesforce インスタンスのドメイン名。[My domain] を検索し、my.salesforce.com で終わるドメインをコピーして、先頭に https:// を追加します。
  • クライアント ID: [顧客の詳細を管理] をクリックして、接続されているアプリからクライアント ID をコピーします。更新トークンが有効になっている場合は、トークンが更新されていることを確認して、データストアを作成するときに最新のトークンを指定します。
  • クライアント シークレット: [Manage customer details] をクリックして、接続されているアプリからクライアント シークレットをコピーします。更新トークンが有効になっている場合は、トークンが更新されていることを確認して、データストアを作成するときに最新のトークンを指定します。

• ユーザーの権限が正しく適用されるようにするには、Salesforce ユーザーが共有の同意を提供する必要があります。

• Enterprise プランまたはデベロッパー プランを使用します。試用アカウントはサポートされていません。

• Sales Cloud を使用していることを確認します。Service Cloud はサポートされていません。

• Google Cloud を Salesforce CORS 許可リストに追加しました。このタスクをすでに完了している場合は、アプリを作成するセクションに進みます。

  • Salesforce のドキュメントの手順に沿って、CORS 許可リストを構成します。
  • オリジン URL として https://console.cloud.google.com/ を入力し、構成を保存します。

アプリの作成

Salesforce では次のアプリがサポートされています。

1. 接続済みアプリ。
2. 外部クライアント アプリ。

接続されているアプリを作成する

Google Cloud と統合するために Salesforce で接続アプリを設定するには、次の操作を行います。

1. Salesforce にログインします。
2. 歯車アイコンをクリックして [設定] に移動します。
3. [設定] メニューで [アプリ マネージャー] に移動します。
4. [新規接続アプリケーション] をクリックします。

5. 接続アプリケーションを構成するには:

   a. 接続アプリの作成ページで、次の操作を行います。

   • [OAuth 設定を有効にする] をオンにします。
   • コールバック URL を https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html に設定します。
   • 次の OAuth スコープを選択します。
     • 完全アクセス（full）。
     • リクエストを随時実行する（refresh_token, offline_access）。

   b. フローを有効にします。

   • クライアント認証情報フロー。
   • 認証コードと認証情報のフロー。
   • 認証コードと認証情報フローの POST 本文内のユーザー認証情報。
   • [クライアント認証情報フロー] で、[Run as] フィールドにユーザー名を割り当てます。コネクタが抽出できるすべてのエンティティに対する読み取り権限が必要です。

接続アプリを作成したら、次の操作を行います。

1. アプリポリシーを編集する:

   • [アプリ マネージャー] に移動し、新しく作成したアプリを編集します。
   • [IP Relaxation] を Relax IP restrictions に設定します。
   • 必要に応じて、更新トークン ポリシーを Valid until revoked またはより制限の厳しい設定に構成します。
   • [許可されているユーザー] が All users may self-authorize に設定されていることを確認します。

2. IP 制限を構成します。

   • [組織レベルの IP 範囲の適用] が有効になっている場合は、[セキュリティ] > [ネットワーク アクセス] で [信頼できる IP 範囲] を設定します。詳細については、接続されたアプリの IP 緩和と継続的な IP 適用のドキュメントをご覧ください。
   • IP 制限が不要な場合は、[リクエストごとにログイン IP 範囲を適用する] を無効にします。

3. OAuth 接続アプリを構成します。

   • OAuth 接続アプリを構成するには、次のガイドを使用します。
     • 接続アプリの基本。
     • API の統合。
     • クライアント認証情報の設定。

4. 接続済みのアプリを保存します。

   • 保存して、接続済みのアプリを終了します。
   • 検索バーで「OAuth and OpenId connect settings」を検索します。
   • [認可コードと認証情報のフローを許可する] と [OAuth ユーザー名とパスワードのフロー] を有効にします。

外部クライアント アプリを作成する

統合で OAuth ベースの認証を有効にするために、Salesforce で外部クライアント アプリを作成して構成するには、次の操作を行います。

1. クライアント ID とクライアント シークレットを取得します。

   • Salesforce にログインします。
   • 歯車アイコンをクリックして [設定] に移動します。
   • [設定] > [アプリ] > [外部クライアント アプリ] に移動します。
   • [新しい外部クライアント アプリ] をクリックします。

2. 必要な情報を入力します。

   • アプリ名とメールアドレスを入力します。API 名はデフォルトで自動的に入力されます。
   • [Distribution state] は Local のままにします。

3. OAuth 設定を有効にします。

   • [API (Enable OAuth Settings)] を開き、[Enable OAuth] を選択します。
   • 構成:
     • コールバック URL: https://login.salesforce.com/services/oauth2/callback
     • OAuth スコープ: API を介してユーザーデータを管理します（api）。
     • [フロー有効化] で、[クライアント認証情報フローを有効にする] を選択します。
     • [作成] をクリックして外部クライアント アプリを作成します。[外部クライアント アプリ] マネージャーに移動して、リストに追加したアプリを表示します。

4. アプリポリシーを編集する:

   • 作成したアプリを開きます。
   • [ポリシー] に移動し、[編集] をクリックします。
   • [OAuth フローおよび外部クライアント アプリの機能強化] で、[クライアント認証情報フローを有効にする] をオンにします。
   • [Run as] フィールドに Salesforce のユーザー名を入力します。

5. OAuth 認証情報にアクセスする:

   • [設定] をクリックします。
   • [OAuth 設定] をクリックします。
   • [コンシューマ キーとコンシューマ シークレット] をクリックして認証情報にアクセスします。確認コードがメールアドレスに送信されます。
   • 確認コードを入力し、[確認] をクリックします。
   • コンシューマ キーをコピーして、クライアント ID として使用します。
   • コンシューマ シークレットをコピーして、クライアント シークレットとして使用します。

Salesforce コネクタを作成する

Console

Google Cloud コンソールを使用して Salesforce から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースの選択] ページで、スクロールするか [Salesforce] を検索して、サードパーティ ソースを接続します。

5. Salesforce の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. 同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

ServiceNow を接続する

次の手順で、ServiceNow から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の認証情報を用意してください。

  • https://<domain-name>.service-now.com/ 形式のインスタンス URL。
  • クライアント ID とクライアント シークレット。エンドポイントの設定とクライアント ID とクライアント シークレットの取得については、ServiceNow のドキュメントのクライアントがインスタンスにアクセスするためのエンドポイントを作成するをご覧ください。

  • 次のいずれかの ServiceNow ロールタイプのユーザー名とパスワード:

    • 管理者ロールです。ServiceNow のドキュメントの基本システムロールをご覧ください。

    • カスタムの ServiceNow ロール。これは、管理者ロールを使用する代わりに使用できます。カスタム ServiceNow ロールを使用するには、次のフィールドを使用してアクセス制御ルールを作成します。

      ビューに関するフィールド

      • タイプ: record
      • オペレーション: read
      • 名前（それぞれに個別のアクセス制御ルールが必要です）:
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • 必要なロール: カスタムロールの名前

      詳細については、ServiceNow のドキュメントでロールを作成するとACL ルールを作成するをご覧ください。

Console

Google Cloud コンソールを使用して ServiceNow から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[ServiceNow] を選択します。

5. ServiceNow の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データ コネクタのリージョンを選択します。

8. データ コネクタの名前を入力します。

9. 同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データ コネクタ名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

SharePoint Online を接続する

次の手順で、SharePoint Online から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 管理者の同意を得ます。同意を付与する方法については、Microsoft のドキュメントのテナント全体の管理者によるアプリへの同意を付与するをご覧ください。

• 設定時に使用する次の SharePoint Online 認証情報を準備します。

  • インスタンスの URLhttp://DOMAIN_OR_SERVER/[sites/]WEBSITE の形式です。URL の詳細については、SharePoint のドキュメントの SharePoint の URL とトークンをご覧ください。

  • テナント ID、クライアント ID、クライアント シークレット。アプリケーションを登録するには、ログイン オーディエンスに [この組織ディレクトリ内のアカウントのみ] を選択し、この認証情報を探します。詳細については、Microsoft のドキュメントのクイックスタート: Microsoft Identity Platform にアプリケーションを登録するをご覧ください。

  • アプリを登録する際は、ウェブ コールバック URL として https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html を使用します。

  • アプリケーションの権限を構成するときに、Graph API に次のアプリケーション権限を追加します。

    スコープを表示する

    • GroupMember.Read.All
    • Sites.FullControl.All
    • User.Read.All

  • アプリケーションの権限を設定するときに、Sharepoint REST API の次の委任された権限を追加します。

    スコープを表示する

    • AllSites.FullControl

• 次の表に、構成に推奨されるロールとその制限事項を示します。

  ロールを表示する

  ロール	クライアント アプリケーションの登録	すべてのエンティティのコンテンツを取得できる	ACL を取得できる	ID を取得できる	メモ
  サイトの管理者	×	○	○	○
  サイト コレクション管理者	×	○	○	○
  グローバル管理者	○	いいえ	○	×	制限事項: ID やコメント、添付ファイルのエンティティを取得できない
  サイト所有者	×	○	○	×	制限事項: ID を取得できない
  アプリケーション管理者	○	該当なし	なし	該当なし	アプリケーション管理者のロールは、Microsoft 365 管理センター / Entra 管理センターに関連しています。これは SharePoint に固有のものではありません。

Console

Google Cloud コンソールを使用して Sharepoint Online から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[Sharepoint Online] を選択します。

5. SharePoint Online の認証情報を入力し、[Authenticate] をクリックします。

6. 新しいウィンドウが表示されます。インスタンスのユーザー名とパスワードを入力します。認証が成功したことを確認してから、[データストアの SharePoint Online ソースの指定] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのリージョンを選択します。

9. データストアの名前を入力します。

10. データストアの同期頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Slack を接続する

次の手順で、Slack から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• ワークスペースに新しいアプリをインストールする権限を付与するよう、Workspace のオーナーに依頼します。

• 次の Slack 認証情報を準備します。

  • ワークスペース ID: Slack のドキュメントのデータストアの Slack ソースの指定の手順に沿って、ワークスペース ID を取得します。
  • アクセス トークン: クライアント アプリを作成し、必要なスコープを定義します。詳細については、Slack のドキュメントのクイックスタートとSlack API トークンをすばやく取得して使用する方法をご覧ください。
  • OAuth 2.0 権限スコープを設定する場合は、次のスコープを構成します。

    スコープを表示する

    • users:read.email
    • channels:history
    • channels:read
    • groups:history
    • groups:read
    • im:history
    • im:read
    • mpim:history
    • mpim:read
    • team:read
    • users:read
    • files:read

• デフォルトでは、Slack はプライベート チャンネル、グループ メッセージ、ダイレクト メッセージからのコンテンツのクロールと同期を制限しています。

Slack アプリを構成する

Vertex AI Search が Slack ワークスペースからドキュメントを取り込むことができるように、アクセス トークンを取得します。

注: Slack アプリを作成し、要件に応じてボット トークン（Generate a bot token）またはユーザー トークン（Generate a user token）を選択します。

bot トークンを生成する

ボット トークンを生成して、非公開チャンネル、インスタント メッセージ（IM）、マルチパーティ インスタント メッセージ（MPIM）に安全にアクセスします。ボット トークンは、自分がメンバーではない公開チャンネルをクロールできません。公開チャンネルに参加すると、参加メッセージが生成されます。

1. Slack API アプリにログインします。
2. [Create new app] をクリックします。
3. [From scratch] を選択します。
4. アプリの名前を入力し、統合するワークスペースを選択します。
5. [アプリを作成] をクリックします。
6. [OAuth & Permissions] をクリックします。

7. [Bot token scopes] で、次の必須スコープを追加します。

   スコープを表示する

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • team:read
   • users:read
   • files:read

   デフォルトでは、bot は #general チャネルと #random チャネルから読み取ります。クロール機能を有効にするには、次の操作を行います。

   • 公開チャンネルの場合は、channels:join スコープを付与して、ボットが自動的にチャンネルに参加できるようにします。
   • プライベート チャネルの場合は、bot を手動で招待します。

8. [Install to your username workspace] をクリックします。

9. 画面上の手順に沿ってアプリをインストールし、ボット トークンを取得します。

ユーザー トークンを生成する

ユーザー トークンを生成して、事前にチャンネルに参加することなくすべての公開チャンネルにアクセスします。ユーザーがアクセス権を持っていない場合、ユーザー トークンは非公開チャンネル、IM、MPIM をクロールできません。

1. Slack API アプリにログインします。
2. [Create new app] をクリックします。
3. [From scratch] を選択します。
4. アプリの名前を入力し、統合するワークスペースを選択します。
5. [アプリを作成] をクリックします。
6. [OAuth & Permissions] をクリックします。

7. [ユーザー トークンのスコープ] で、次の必須スコープを追加します。

   スコープを表示する

   • users:read.email
   • channels:history
   • channels:read
   • groups:history
   • groups:read
   • im:history
   • im:read
   • mpim:history
   • mpim:read
   • users:read
   • files:read

8. [Install to your username workspace] をクリックします。

9. 画面上の手順に沿ってアプリをインストールし、ユーザー トークンを取得します。

Slack Cloud コネクタを作成する

Console

Google Cloud コンソールを使用して Slack から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、スクロールするか [Slack] を検索してサードパーティ ソースを接続します。

5. Slack の認証情報を入力します。

   • インスタンス ID（ワークスペース ID）: ブラウザからログインして Slack ワークスペースから取得します。ワークスペース ID は、URL の /client の後の部分です。
   • 認証トークン: 前のセクションで取得したトークンを使用します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Dropbox を接続する

次の手順で、Dropbox から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。詳細については、データソースのアクセス制御を使用するをご覧ください。

• 次の Dropbox 認証情報を用意します。これらのパラメータの設定については、Dropbox ドキュメントの OAuth ガイドをご覧ください。

  • クライアント ID
  • クライアント シークレット

Console

Google Cloud コンソールを使用して Dropbox から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、[サードパーティ ソース] セクションに移動し、[Dropbox] を選択します。

5. Dropbox の認証情報を入力し、[認証] をクリックします。新しいウィンドウが表示されます。

6. アカウントを認証し、認証が成功したことを確認してから、[データストアの Dropbox ソースの指定] ページに戻ります。

7. 同期するエンティティを選択し、[続行] をクリックします。

8. データストアのロケーションを選択します。

9. データストアの名前を入力します。

10. データストアの同期頻度を選択します。

11. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

12. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。[ドキュメント] タブで、エンティティが正しく取り込まれていることを確認します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアが設定された後に検索結果が表示される様子をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

Connect Box

次の手順で、Box から Vertex AI Search にデータを同期します。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の Box 認証情報を用意します。これらのパラメータの設定については、Box デベロッパー ドキュメントの JWT Auth をご覧ください。

  • 企業 ID
  • クライアント ID
  • クライアント シークレット
  • 公開鍵 ID
  • 秘密鍵
  • パスフレーズ

• JWT エンドポイントを作成するときに、次のスコープを構成します。

  スコープを表示する

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

コメントの増分変更の同期には、設定された頻度間隔よりも時間がかかることがあります。エンティティを含むフォルダがコピーまたは移動された場合、増分変更の同期に、設定された頻度間隔よりも時間がかかることがあります。

Box アプリを作成する

1. 管理者アカウントで Box デベロッパー コンソールにログインします。
2. [Create new app] をクリックします。
3. アプリの種類として [カスタムアプリ] を選択します。
4. アプリ名を入力します。
5. アプリの目的（統合、AI、Google Cloud Agent Builder）を設定します。
6. [JWT を使用したサーバー認証] を選択します。

Box アプリを設定

Box アプリの設定を構成します。

公開鍵と秘密鍵を作成する

1. Box Developer Console に移動します。

2. [構成] タブで、[公開鍵/秘密鍵ペアを生成する] をクリックします。

   • 公開鍵は ID とともに自動的にコンソールにアップロードされます。この ID は、接続を作成するときに使用されます。
   • 秘密鍵とパスフレーズを含む構成ファイルをローカルにダウンロードできます。この構成ファイルを後で使用できるように保管してください。
   • 必要に応じて、独自の鍵を生成する場合は、Box 鍵ペアの設定ガイドをご覧ください。

必要な権限を構成する

1. [アプリケーション スコープ] セクションで、次の権限を選択します。
   • Box に保存されているすべてのファイルとフォルダを読み取る。

アプリを承認する

1. [認証] タブで [確認して送信] をクリックし、管理者の承認を待ちます。
2. 管理者は、管理コンソールでアプリを承認できます。

承認後、Box がアプリを完全に設定します。

Box コネクタを作成する

Console

Google Cloud コンソールを使用して Box から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースを選択] ページで、スクロールするか [Box] を検索してサードパーティ ソースを接続します。

5. 認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアが設定された後に検索結果が表示される様子をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。

OneDrive を接続する

OneDrive から Vertex AI Search にデータを同期する手順は次のとおりです。

プレビュー: サードパーティのコネクタは、許可リスト付きのプレビュー版です。この機能を使用するには、許可リストに登録されている必要があります。

データソースを設定してデータを初めてインポートすると、データストアは設定時に選択した頻度でそのソースからデータを同期します。

始める前に

接続を設定する前に:

• データソースのアクセス制御を設定します。アクセス制御の設定については、データソースのアクセス制御を使用するをご覧ください。

• 次の OneDrive 認証情報を用意してください。

  • クライアント ID、クライアント シークレット、テナント ID。これらのパラメータの設定については、Microsoft のドキュメントのクイックスタート: Microsoft Identity Platform にアプリケーションを登録するをご覧ください。

  • アクセスのスコープを指定します。管理者のロールが必要です。詳細については、Microsoft のドキュメントの クイックスタート: ウェブ API にアクセスするようにクライアント アプリケーションを構成するをご覧ください。

    次のスコープを構成します。

    スコープを表示する

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

Console

Google Cloud コンソールを使用して OneDrive から Vertex AI Search にデータを同期する手順は次のとおりです。

1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

   Agent Builder

2. ナビゲーション メニューで [データストア] をクリックします。

3. [データストアを作成] をクリックします。

4. [データソースの選択] ページで、[サードパーティ ソース] セクションに移動し、[OneDrive] を選択します。

5. OneDrive の認証情報を入力します。

6. 同期するエンティティを選択し、[続行] をクリックします。

7. データストアのリージョンを選択します。

8. データストアの名前を入力します。

9. データストアの同期頻度を選択します。

10. [作成] をクリックします。Vertex AI Search によってデータストアが作成され、[データストア] ページにデータストアが表示されます。

11. 取り込みのステータスを確認するには、[データストア] ページに移動し、データストア名をクリックして、[データ] ページで詳細を表示します。データの同期が開始されると、コネクタの状態が [作成中] から [実行中] に変わります。取り込みが完了すると、ステータスが [有効] に変わり、データソースへの接続がセットアップされ、次回のスケジュール設定された同期を待機していることを示します。

    取り込みには、データのサイズに応じて、数分から数時間かかることがあります。

次のステップ

• データストアをアプリにアタッチするには、検索アプリを作成するの手順に沿ってアプリを作成し、データストアを選択します。

• アプリとデータストアが設定された後に検索結果が表示される様子をプレビューするには、検索結果を取得するをご覧ください。サードパーティのアクセス制御を使用した場合は、サードパーティのアクセス制御が設定されたアプリの結果をプレビューするをご覧ください。