Conversational Analytics API を有効にする

このページでは、 Google Cloud プロジェクトで Conversational Analytics API（geminidataanalytics.googleapis.com からアクセス）を有効にする手順について説明します。Conversational Analytics API は、 Google Cloud コンソールの Data Analytics API with Gemini の最初の機能です。

始める前に

Conversational Analytics API を使用するには、操作するデータにアクセスできる Google Cloud プロジェクトが必要です。プロジェクトを設定する手順は次のとおりです。

  1. Conversational Analytics API で使用するデータを特定します。BigQuery テーブル、Looker Explore、Looker Studio レポートなどのデータソースを使用できます。

  2. Google Cloud コンソールのプロジェクト セレクタ ページで、Conversational Analytics API で使用するデータにアクセスできる Google Cloud プロジェクトを作成します。

    プロジェクト セレクタに移動

必要な API を有効にする

Conversational Analytics API を使用するには、 Google Cloud プロジェクトで一連の必須 API を有効にする必要があります。Colab Enterprise 環境から Conversational Analytics API を使用する場合は、追加の API を有効にする必要もあります。

必要な API

Console

Conversational Analytics API で使用する Google Cloud プロジェクトの Google Cloud コンソールで、次の API を有効にします。

Gemini Data Analytics API を有効にする

Gemini for Google Cloud API を有効にする

BigQuery API を有効にする

gcloud

Google Cloud CLI で、次の gcloud services enable コマンドを実行して、Gemini Data Analytics API、Gemini for Google Cloud API、BigQuery API をそれぞれ有効にします。

gcloud services enable geminidataanalytics.googleapis.com --project=project_id
gcloud services enable cloudaicompanion.googleapis.com --project=project_id
gcloud services enable bigquery.googleapis.com --project=project_id

前のサンプル gcloud CLI コマンドで、project_id は Google Cloud プロジェクトの ID に置き換えます。

Colab Enterprise の API

Colab Enterprise 環境から Conversational Analytics API を使用する場合は、次の API も有効にします。

Dataform API を有効にする

Compute Engine API を有効にする

Vertex AI API を有効にする

必要なロールを付与する

Conversational Analytics API を使用するには、API とのやり取りが必要なプリンシパル（ユーザーやサービス アカウントなど）に、 Google Cloud コンソールで次の Identity and Access Management（IAM）ロールを付与します。

[ロール] に移動

また、エージェントの管理などのアクションの権限は、会話分析 API の IAM ロールと権限を付与するで説明されているように、Gemini データ分析ロールによって制御されます。

VPC Service Controls の追加構成

組織または使用している Google Cloud プロジェクトで VPC Service Controls が有効になっている場合は、Conversational Analytics API で使用される次の API を許可リストに追加します。