Data Analytics API with Gemini

La API de Data Analytics con Gemini (geminidataanalytics.googleapis.com) proporciona métodos para consultar y analizar datos con lenguaje natural, y para crear y administrar los agentes de datos que interactúan con tus datos en las fuentes de datos compatibles.

Este servicio se encuentra en versión preliminar y está sujeto a las Condiciones de las Ofertas de Fase Previa a la DG. Los desarrolladores deben seleccionar la ruta de endpoint adecuada según sus requisitos de estabilidad:

  • v1beta: Se recomienda para la integración en entornos de producción durante el período de vista previa.
  • v1alpha: Se diseñó para probar funciones de acceso anticipado. Es posible que estas funciones cambien o se quiten, lo que podría requerir actualizaciones en tu código.

Obtén más información sobre las etapas de lanzamiento de los productos de Google Cloud.

Para obtener guías de implementación detalladas, consulta la descripción general de la API de Conversational Analytics.

Servicio: geminidataanalytics.googleapis.com

Para llamar a este servicio, te recomendamos que uses las bibliotecas cliente que proporciona Google. Si tu aplicación necesita usar tus propias bibliotecas para llamar a este servicio, usa la información que se indica más abajo cuando realices las solicitudes a la API.

Documento de descubrimiento

Un documento de descubrimiento es una especificación procesable para describir y consumir las APIs de REST. Se usa para compilar bibliotecas cliente, complementos IDE y otras herramientas que interactúan con las API de Google. Un servicio puede proporcionar varios documentos de descubrimiento. Este servicio proporciona los siguientes documentos de descubrimiento:

Extremo de servicio

Un extremo de servicio es una URL base que especifica la dirección de red de un servicio de API. Un servicio puede tener varios extremos de servicio. Este servicio tiene el siguiente extremo, y todos los URI que se muestran a continuación son relativos a él:

  • https://geminidataanalytics.googleapis.com

Recurso de REST: v1beta.projects.locations

Métodos
chat POST /v1beta/{parent=projects/*/locations/*}:chat
Responde una pregunta sobre datos generando un flujo de objetos Message.
get GET /v1beta/{name=projects/*/locations/*}
Obtiene información sobre una ubicación.
list GET /v1beta/{name=projects/*}/locations
Enumera la información sobre las ubicaciones compatibles con este servicio.
queryData POST /v1beta/{parent=projects/*/locations/*}:queryData
Consulta datos a partir de una búsqueda del usuario en lenguaje natural.

Recurso de REST: v1beta.projects.locations.conversations

Métodos
create POST /v1beta/{parent=projects/*/locations/*}/conversations
Crea una conversación nueva para conservar el historial de conversaciones.
delete DELETE /v1beta/{name=projects/*/locations/*/conversations/*}
Borra una conversación.
get GET /v1beta/{name=projects/*/locations/*/conversations/*}
Obtiene detalles de una sola conversación usando el ID de conversación y el elemento superior.
list GET /v1beta/{parent=projects/*/locations/*}/conversations
Enumera todas las conversaciones de un elemento superior determinado.

Recurso de REST: v1beta.projects.locations.conversations.messages

Métodos
list GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages
Enumera todos los mensajes de una conversación determinada.

Recurso de REST: v1beta.projects.locations.dataAgents

Métodos
create POST /v1beta/{parent=projects/*/locations/*}/dataAgents
Crea un nuevo DataAgent en un proyecto y una ubicación determinados.
createSync POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync
Crea un nuevo DataAgent en un proyecto y una ubicación determinados de forma síncrona.
delete DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}
Borra un solo DataAgent.
deleteSync DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Borra un solo DataAgent de forma síncrona.
get GET /v1beta/{name=projects/*/locations/*/dataAgents/*}
Obtiene detalles de un solo DataAgent.
getIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Obtiene la política de IAM para DataAgent
list GET /v1beta/{parent=projects/*/locations/*}/dataAgents
Enumera DataAgents en una ubicación y un proyecto determinados.
listAccessible GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible
Enumera los DataAgents a los que puede acceder el llamador en una ubicación y un proyecto determinados.
patch PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Actualiza los parámetros de un solo DataAgent.
setIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Establece la política de IAM para un DataAgent.
updateSync PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Actualiza los parámetros de un solo DataAgent de forma síncrona.

Recurso de REST: v1beta.projects.locations.operations

Métodos
cancel POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel
Inicia la cancelación asíncrona de una operación de larga duración.
delete DELETE /v1beta/{name=projects/*/locations/*/operations/*}
Borra una operación de larga duración.
get GET /v1beta/{name=projects/*/locations/*/operations/*}
Obtiene el último estado de una operación de larga duración.
list GET /v1beta/{name=projects/*/locations/*}/operations
Enumera las operaciones que coinciden con el filtro especificado en la solicitud.

Recurso de REST: v1alpha.projects.locations

Métodos
chat POST /v1alpha/{parent=projects/*/locations/*}:chat
Responde una pregunta sobre datos generando un flujo de objetos Message.
get GET /v1alpha/{name=projects/*/locations/*}
Obtiene información sobre una ubicación.
list GET /v1alpha/{name=projects/*}/locations
Enumera la información sobre las ubicaciones compatibles con este servicio.
queryData POST /v1alpha/{parent=projects/*/locations/*}:queryData
Consulta datos a partir de una búsqueda del usuario en lenguaje natural.

Recurso de REST: v1alpha.projects.locations.conversations

Métodos
create POST /v1alpha/{parent=projects/*/locations/*}/conversations
Crea una conversación nueva para conservar el historial de conversaciones.
delete DELETE /v1alpha/{name=projects/*/locations/*/conversations/*}
Borra una conversación.
get GET /v1alpha/{name=projects/*/locations/*/conversations/*}
Obtiene detalles de una sola conversación usando el ID de conversación y el elemento superior.
list GET /v1alpha/{parent=projects/*/locations/*}/conversations
Enumera todas las conversaciones de un elemento superior determinado.

Recurso de REST: v1alpha.projects.locations.conversations.messages

Métodos
list GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages
Enumera todos los mensajes de una conversación determinada.

Recurso de REST: v1alpha.projects.locations.dataAgents

Métodos
create POST /v1alpha/{parent=projects/*/locations/*}/dataAgents
Crea un nuevo DataAgent en un proyecto y una ubicación determinados.
createSync POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync
Crea un nuevo DataAgent en un proyecto y una ubicación determinados de forma síncrona.
delete DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Borra un solo DataAgent.
deleteSync DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Borra un solo DataAgent de forma síncrona.
get GET /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Obtiene detalles de un solo DataAgent.
getIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Obtiene la política de IAM para DataAgent
list GET /v1alpha/{parent=projects/*/locations/*}/dataAgents
Enumera DataAgents en una ubicación y un proyecto determinados.
listAccessible GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible
Enumera los DataAgents a los que puede acceder el llamador en una ubicación y un proyecto determinados.
patch PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Actualiza los parámetros de un solo DataAgent.
setIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Establece la política de IAM para un DataAgent.
updateSync PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Actualiza los parámetros de un solo DataAgent de forma síncrona.

Recurso de REST: v1alpha.projects.locations.operations

Métodos
cancel POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel
Inicia la cancelación asíncrona de una operación de larga duración.
delete DELETE /v1alpha/{name=projects/*/locations/*/operations/*}
Borra una operación de larga duración.
get GET /v1alpha/{name=projects/*/locations/*/operations/*}
Obtiene el último estado de una operación de larga duración.
list GET /v1alpha/{name=projects/*/locations/*}/operations
Enumera las operaciones que coinciden con el filtro especificado en la solicitud.