Conversational Analytics API aktivieren

Auf dieser Seite wird beschrieben, wie Sie die Conversational Analytics API (Zugriff über geminidataanalytics.googleapis.com) für Ihr Projekt in Google Cloud aktivieren. Die Conversational Analytics API ist die erste Funktion unter der Data Analytics API with Gemini in der Google Cloud Console.

Hinweise

Bevor Sie die Conversational Analytics API verwenden können, benötigen Sie ein Google Cloud Projekt, das auf die Daten zugreifen kann, mit denen Sie arbeiten möchten. So richten Sie Ihr Projekt ein:

  1. Geben Sie die Daten an, die Sie mit der Conversational Analytics API verwenden möchten. Sie können Datenquellen wie BigQuery-Tabellen, Looker-Explores und Looker Studio-Berichte verwenden.

  2. Erstellen Sie in der Google Cloud Console auf der Seite für die Projektauswahl ein Projekt in Google Cloud , das auf die Daten zugreifen kann, die Sie mit der Conversational Analytics API verwenden möchten.

    Zur Projektauswahl

Erforderliche APIs aktivieren

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie eine Reihe von erforderlichen APIs in Ihrem Projekt in Google Cloud aktivieren. Wenn Sie die Conversational Analytics API in einer Colab Enterprise-Umgebung verwenden möchten, müssen Sie auch zusätzliche APIs aktivieren.

Erforderliche APIs

Console

Aktivieren Sie die folgenden APIs in der Google Cloud Console für das Google Cloud Projekt, das Sie mit der Conversational Analytics API verwenden.

Gemini Data Analytics API aktivieren

Gemini für Google Cloud API aktivieren

BigQuery API aktivieren

gcloud

Führen Sie mit der Google Cloud CLI die folgenden gcloud services enable-Befehle aus, um die Gemini Data Analytics API, die Gemini for Google Cloud API und die BigQuery API zu aktivieren:

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

Ersetzen Sie in den vorherigen Beispielbefehlen der gcloud CLI project_id durch die ID Ihres Projekts in Google Cloud .

APIs für Colab Enterprise

Wenn Sie die Conversational Analytics API in einer Colab Enterprise-Umgebung verwenden möchten, aktivieren Sie auch die folgenden APIs:

Dataform API aktivieren

Compute Engine API aktivieren

Vertex AI API aktivieren

Erforderliche Rollen zuweisen

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie den Hauptkonten (z. B. Nutzern oder Dienstkonten), die mit der API interagieren müssen, die folgenden IAM-Rollen (Identity and Access Management) in der Google Cloud Konsole zuweisen:

Zu Rollen

Außerdem werden Berechtigungen für Aktionen wie das Verwalten von Agents über Gemini Data Analytics-Rollen gesteuert, wie unter IAM-Rollen und -Berechtigungen für die Conversational Analytics API zuweisen beschrieben.

Zusätzliche Konfiguration für VPC Service Controls

Wenn VPC Service Controls für Ihre Organisation oder für das Projekt in Google Cloud , das Sie verwenden, aktiviert ist, fügen Sie die folgenden APIs, die von der Conversational Analytics API verwendet werden, der Zulassungsliste hinzu: