Data Analytics API with Gemini

L'API Data Analytics avec Gemini (geminidataanalytics.googleapis.com) fournit des méthodes pour interroger et analyser des données à l'aide du langage naturel, et pour créer et gérer les agents de données qui interagissent avec vos données dans les sources de données compatibles.

Ce service est en version bêta et soumis aux Conditions des offres avant disponibilité générale. Les développeurs doivent sélectionner le chemin d'accès au point de terminaison approprié en fonction de leurs exigences de stabilité :

  • v1bêta : recommandée pour l'intégration dans les environnements de production pendant la période d'aperçu.
  • v1alpha : destinée à tester les fonctionnalités en accès anticipé. Ces fonctionnalités peuvent être modifiées ou supprimées, ce qui peut nécessiter des mises à jour de votre code.

En savoir plus sur les étapes de lancement des produits Google Cloud

Pour obtenir des guides d'implémentation détaillés, consultez la présentation de l'API Conversational Analytics.

Service : geminidataanalytics.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, conformez-vous aux informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit les documents de découverte suivants :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut posséder plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://geminidataanalytics.googleapis.com

Ressource REST : v1beta.projects.locations

Méthodes
chat POST /v1beta/{parent=projects/*/locations/*}:chat
Répond à une question sur les données en générant un flux d'objets Message.
get GET /v1beta/{name=projects/*/locations/*}
Récupère les informations concernant un emplacement.
list GET /v1beta/{name=projects/*}/locations
Répertorie les informations concernant les emplacements compatibles avec ce service.
queryData POST /v1beta/{parent=projects/*/locations/*}:queryData
Interroge les données à partir d'une requête utilisateur en langage naturel.

Ressource REST : v1beta.projects.locations.conversations

Méthodes
create POST /v1beta/{parent=projects/*/locations/*}/conversations
Crée une conversation pour conserver l'historique des conversations.
delete DELETE /v1beta/{name=projects/*/locations/*/conversations/*}
Supprime une conversation.
get GET /v1beta/{name=projects/*/locations/*/conversations/*}
Récupère les informations d'une seule conversation à l'aide de l'ID de conversation et du parent.
list GET /v1beta/{parent=projects/*/locations/*}/conversations
Liste toutes les conversations d'un parent donné.

Ressource REST : v1beta.projects.locations.conversations.messages

Méthodes
list GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages
Liste tous les messages d'une conversation donnée.

Ressource REST : v1beta.projects.locations.dataAgents

Méthodes
create POST /v1beta/{parent=projects/*/locations/*}/dataAgents
Crée une ressource DataAgent dans un projet et un emplacement donnés.
createSync POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync
Crée une ressource DataAgent dans un projet et un emplacement donnés de manière synchrone.
delete DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}
Supprime une seule ressource DataAgent.
deleteSync DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Supprime une seule ressource DataAgent de manière synchrone.
get GET /v1beta/{name=projects/*/locations/*/dataAgents/*}
Récupère les détails d'une seule ressource DataAgent.
getIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Obtient la stratégie IAM de la ressource DataAgent.
list GET /v1beta/{parent=projects/*/locations/*}/dataAgents
Liste les ressources DataAgent dans un projet et un emplacement donnés.
listAccessible GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible
Liste les ressources DataAgent accessibles à l'appelant dans un projet et un emplacement donnés.
patch PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Met à jour les paramètres d'une seule ressource DataAgent.
setIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Définit la stratégie IAM pour une ressource DataAgent.
updateSync PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Met à jour les paramètres d'un seul DataAgent de manière synchrone.

Ressource REST : v1beta.projects.locations.operations

Méthodes
cancel POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel
Démarre l'annulation asynchrone sur une opération de longue durée.
delete DELETE /v1beta/{name=projects/*/locations/*/operations/*}
Supprime une opération de longue durée.
get GET /v1beta/{name=projects/*/locations/*/operations/*}
Récupère le dernier état d'une opération de longue durée.
list GET /v1beta/{name=projects/*/locations/*}/operations
Liste les opérations qui correspondent au filtre spécifié dans la requête.

Ressource REST : v1alpha.projects.locations

Méthodes
chat POST /v1alpha/{parent=projects/*/locations/*}:chat
Répond à une question sur les données en générant un flux d'objets Message.
get GET /v1alpha/{name=projects/*/locations/*}
Récupère les informations concernant un emplacement.
list GET /v1alpha/{name=projects/*}/locations
Répertorie les informations concernant les emplacements compatibles avec ce service.
queryData POST /v1alpha/{parent=projects/*/locations/*}:queryData
Interroge les données à partir d'une requête utilisateur en langage naturel.

Ressource REST : v1alpha.projects.locations.conversations

Méthodes
create POST /v1alpha/{parent=projects/*/locations/*}/conversations
Crée une conversation pour conserver l'historique des conversations.
delete DELETE /v1alpha/{name=projects/*/locations/*/conversations/*}
Supprime une conversation.
get GET /v1alpha/{name=projects/*/locations/*/conversations/*}
Récupère les informations d'une seule conversation à l'aide de l'ID de conversation et du parent.
list GET /v1alpha/{parent=projects/*/locations/*}/conversations
Liste toutes les conversations d'un parent donné.

Ressource REST : v1alpha.projects.locations.conversations.messages

Méthodes
list GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages
Liste tous les messages d'une conversation donnée.

Ressource REST : v1alpha.projects.locations.dataAgents

Méthodes
create POST /v1alpha/{parent=projects/*/locations/*}/dataAgents
Crée une ressource DataAgent dans un projet et un emplacement donnés.
createSync POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync
Crée une ressource DataAgent dans un projet et un emplacement donnés de manière synchrone.
delete DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Supprime une seule ressource DataAgent.
deleteSync DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Supprime une seule ressource DataAgent de manière synchrone.
get GET /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Récupère les détails d'une seule ressource DataAgent.
getIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Obtient la stratégie IAM de la ressource DataAgent.
list GET /v1alpha/{parent=projects/*/locations/*}/dataAgents
Liste les ressources DataAgent dans un projet et un emplacement donnés.
listAccessible GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible
Liste les ressources DataAgent accessibles à l'appelant dans un projet et un emplacement donnés.
patch PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Met à jour les paramètres d'une seule ressource DataAgent.
setIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Définit la stratégie IAM pour une ressource DataAgent.
updateSync PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Met à jour les paramètres d'un seul DataAgent de manière synchrone.

Ressource REST : v1alpha.projects.locations.operations

Méthodes
cancel POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel
Démarre l'annulation asynchrone sur une opération de longue durée.
delete DELETE /v1alpha/{name=projects/*/locations/*/operations/*}
Supprime une opération de longue durée.
get GET /v1alpha/{name=projects/*/locations/*/operations/*}
Récupère le dernier état d'une opération de longue durée.
list GET /v1alpha/{name=projects/*/locations/*}/operations
Répertorie les opérations qui correspondent au filtre spécifié dans la requête.