Conversational Analytics API aktivieren

Private Vorabversion

Dieses Produkt oder Feature unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Features sind „wie gesehen“ verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

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.

Hinweis: Wenn Sie die Conversational Analytics API verwenden möchten, benötigen Sie Zugriff auf die private Vorabversion. Wenn Sie Interesse haben, füllen Sie das Antragsformular für die Vorabversion aus.

Vorbereitung

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie die folgenden Voraussetzungen erfüllen und die erforderlichen IAM-Rollen (Identity and Access Management) für Ihr Projekt in Google Cloud haben.

Voraussetzungen

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.

   Hinweis: Derzeit erfolgt keine Abrechnung für die Conversational Analytics API.

   Zur Projektauswahl

Erforderliche Rollen

Prüfen Sie, ob Sie die folgenden IAM-Rollen für das Projekt in Google Cloud haben, das Sie mit der Conversational Analytics API verwenden:

Zu Rollen

• Gemini for Google Cloud (roles/cloudaicompanion.user)
• BigQuery User (roles/bigquery.user)
• BigQuery Studio User (roles/bigquery.studioUser) (wenn Sie BigQuery Studio und Data Canvas verwenden)

Erforderliche APIs aktivieren

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie die erforderlichen APIs in Ihrem Projekt in Google Cloud aktivieren. Wenn Sie eine API aktivieren, müssen Sie die Seite möglicherweise aktualisieren, um zu bestätigen, dass die API aktiviert wurde.

Hinweis: Wenn Sie nicht berechtigt sind, die APIs zu aktivieren, bitten Sie Ihren Projektadministrator, die APIs für Sie über das Dashboard „APIs und Dienste“ zu aktivieren. Alternativ kann Ihr Projektadministrator Ihnen in der Google Cloud Console die Rolle Service Usage Admin (roles/serviceusage.serviceUsageAdmin) zuweisen. Damit können Sie APIs für das aktuelle Projekt aktivieren und deaktivieren.

Gemini Data Analytics API aktivieren

Wenn Sie die Conversational Analytics API verwenden möchten, aktivieren Sie die Gemini Data Analytics API über die Google Cloud Console oder die Google Cloud CLI.

Console

Aktivieren Sie die Gemini Data Analytics API in der Google Cloud Console.

• Gemini Data Analytics API aktivieren

gcloud

Wenn Sie die Gemini Data Analytics API mit der Google Cloud CLI aktivieren möchten, führen Sie den Befehl gcloud services enable so aus:

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

Ersetzen Sie im vorherigen Beispiel project_id durch die ID Ihres Projekts in Google Cloud .

Zusätzliche erforderliche APIs aktivieren

Wenn Sie die Conversational Analytics API verwenden möchten, müssen Sie außerdem die folgenden APIs im Projekt in Google Cloud aktivieren, das Sie mit der Conversational Analytics API verwenden:

• Cloudaicompanion API aktivieren

• BigQuery API aktivieren

APIs für Colab Enterprise aktivieren

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

• Dataform API aktivieren

• Compute Engine API aktivieren

• Vertex AI API aktivieren

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:

• Lassen Sie in geminidataanalytics.googleapis.com die folgende API zu:
  • projects.locations.chat
• Lassen Sie in aiplatform.googleapis.com die folgende API zu:
  • projects.locations.endpoints.generateContent
• Lassen Sie in datacatalog.googleapis.com die folgenden APIs zu:
  • entries.lookup
  • catalog.search
• Lassen Sie in bigquery.googleapis.com die folgenden APIs zu:
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults