Activer l'API Conversational Analytics

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Cette page décrit la procédure à suivre pour activer l'API Conversational Analytics (accessible via geminidataanalytics.googleapis.com) pour votre projet Google Cloud . L'API Conversational Analytics est la première fonctionnalité de l'API Data Analytics avec Gemini de la console Google Cloud .

Avant de commencer

Avant de pouvoir utiliser l'API Conversational Analytics, vous devez disposer d'un projet Google Cloud ayant accès aux données avec lesquelles vous souhaitez travailler. Pour configurer votre projet, procédez comme suit :

1. Identifiez les données que vous souhaitez utiliser avec l'API Conversational Analytics. Vous pouvez utiliser des sources de données telles que des tables BigQuery, des explorations Looker, des rapports Looker Studio et des données provenant d'AlloyDB, de GoogleSQL pour Spanner, de Cloud SQL et de Cloud SQL pour PostgreSQL.

2. Dans la console Google Cloud, sur la page de sélection du projet, créez un projet Google Cloud ayant accès aux données que vous souhaitez utiliser avec l'API Conversational Analytics.

   Remarque : À ce stade, aucune facturation n'est appliquée pour l'API Conversational Analytics.

   Accéder au sélecteur de projet

Activer les API requises

Pour utiliser l'API Conversational Analytics, vous devez activer un ensemble d'API requises dans votre projet Google Cloud . Si vous prévoyez d'utiliser l'API Conversational Analytics à partir d'un environnement Colab Enterprise, vous devez également activer des API supplémentaires.

API requises

Remarque : Si vous ne disposez pas des autorisations nécessaires pour activer les API, demandez à l'administrateur de votre projet de le faire pour vous depuis le tableau de bord "API et services". L'administrateur de votre projet peut également vous attribuer le rôle Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin) dans la console Google Cloud afin de vous autoriser à activer et désactiver les API pour le projet actuel.

Console

Activez les API suivantes dans la console Google Cloud pour le projet Google Cloud que vous utiliserez avec l'API Conversational Analytics.

Activer l'API Gemini Data Analytics

Activer l'API Gemini pour Google Cloud

Activer l'API BigQuery

Remarque : Lorsque vous activez une API, vous devrez peut-être actualiser la page de la console Google Cloud pour confirmer qu'elle est activée.

gcloud

Avec la Google Cloud CLI, exécutez les commandes gcloud services enable suivantes pour activer respectivement l'API Gemini Data Analytics, l'API Gemini pour Google Cloud et l'API BigQuery :

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

Dans les exemples de commandes gcloud CLI précédents, remplacez project_id par l'ID de votre projet Google Cloud .

API pour Colab Enterprise

Si vous prévoyez d'utiliser l'API Conversational Analytics à partir d'un environnement Colab Enterprise, activez également les API suivantes :

Activer l'API Dataform

Activer l'API Compute Engine

Activer l'API Vertex AI

Remarque : Lorsque vous activez une API, vous devrez peut-être actualiser la page de la console Google Cloud pour confirmer qu'elle est activée.

Attribuer les rôles requis

Pour utiliser l'API Conversational Analytics, accordez les rôles IAM (Identity and Access Management) suivants dans la console Google Cloud aux comptes principaux (tels que les utilisateurs ou les comptes de service) qui doivent interagir avec l'API :

Accéder à la page "Rôles"

• Utilisateur Gemini pour Google Cloud (roles/cloudaicompanion.user) : requis pour créer des conversations gérées par Google Cloud.
• Utilisateur de l'instance Looker (roles/looker.instanceUser) : requis pour accéder aux données d'une instance Looker (Google Cloud Core)
• Utilisateur BigQuery (roles/bigquery.user) : requis pour accéder aux données dans BigQuery
• Utilisateur BigQuery Studio (roles/bigquery.studioUser) : obligatoire si vous utilisez BigQuery Studio et le canevas de données
• Utilisateur de base de données AlloyDB (roles/alloydb.databaseUser) : requis pour accéder aux données d'une instance AlloyDB
• Utilisateur Cloud SQL et Cloud SQL pour PostgreSQL Studio (roles/cloudsql.studioUser) : requis pour utiliser la console Google Cloud afin d'afficher et de gérer les instances Cloud SQL et Cloud SQL pour PostgreSQL
• Utilisateur d'instance Cloud SQL et Cloud SQL pour PostgreSQL (roles/cloudsql.instanceUser) : requis pour se connecter aux instances Cloud SQL et Cloud SQL pour PostgreSQL.
• Lecteur de bases de données Spanner (roles/spanner.databaseReader) : requis pour lire les données d'une base de données GoogleSQL pour Spanner

De plus, les autorisations pour des actions telles que la gestion des agents sont contrôlées par les rôles Gemini Data Analytics, comme décrit dans Attribuer des rôles et des autorisations IAM pour l'API Conversational Analytics.

Configuration supplémentaire pour VPC Service Controls

Si VPC Service Controls est activé pour votre organisation ou pour le projet Google Cloud que vous utilisez, ajoutez les API suivantes à la liste d'autorisation, car l'API Conversational Analytics les utilise :

• Depuis geminidataanalytics.googleapis.com, autorisez l'API suivante :
  • projects.locations.chat
• Depuis aiplatform.googleapis.com, autorisez l'API suivante :
  • projects.locations.endpoints.generateContent
• Depuis datacatalog.googleapis.com, autorisez les API suivantes :
  • entries.lookup
  • catalog.search
• Depuis bigquery.googleapis.com, autorisez les API suivantes :
  • jobs.query
  • jobs.insert
  • jobs.getQueryResults