Data Analytics API with Gemini

Die Data Analytics API mit Gemini (geminidataanalytics.googleapis.com) bietet Methoden zum Abfragen und Analysieren von Daten in natürlicher Sprache sowie zum Erstellen und Verwalten von Daten-Agenten, die mit Ihren Daten in unterstützten Datenquellen interagieren.

Wählen Sie den Endpunktpfad aus, der Ihren Stabilitätsanforderungen entspricht:

  • v1: Empfohlen für allgemein verfügbare Funktionen, die in Produktionsumgebungen integriert werden können.
  • v1beta: Empfohlen für die Einbindung neuer Funktionen in Produktionsumgebungen während der Vorschauphase.
  • v1alpha: Zum Testen neuer und zukünftiger Funktionen. Diese Funktionen können sich ändern oder entfernt werden, was möglicherweise Aktualisierungen Ihres Codes erfordert.

Weitere Informationen zu den Markteinführungsphasen von Google Cloud-Produkten

Detaillierte Implementierungsleitfäden finden Sie in der Übersicht über die konversationelle Analyse API.

Dienst: geminidataanalytics.googleapis.com

Wir empfehlen, diesen Dienst mit den von Google bereitgestellten Clientbibliotheken aufzurufen. Wenn Ihre Anwendung diesen Dienst mit Ihren eigenen Bibliotheken aufrufen muss, sollten Sie die folgenden Informationen verwenden, wenn Sie die API-Anfragen senden.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente bereitstellen. Dieser Dienst stellt folgende Discovery-Dokumente bereit:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://geminidataanalytics.googleapis.com

REST-Ressource: v1beta.a2a.projects.locations.dataAgents.v1

Methoden
getCard GET /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card
GetAgentCard gibt die Agentenkarte für den Agenten zurück.

REST-Ressource: v1beta.a2a.projects.locations.dataAgents.v1.message

Methoden
send POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send
Nachricht an den KI-Agenten senden.
stream POST /v1beta/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream
SendStreamingMessage ist ein Streamingaufruf, der einen Stream von Aufgabenaktualisierungsereignissen zurückgibt, bis die Aufgabe unterbrochen oder beendet wird.

REST-Ressource: v1beta.projects.locations

Methoden
chat POST /v1beta/{parent=projects/*/locations/*}:chat
Beantwortet eine Datenfrage, indem ein Stream von Message-Objekten generiert wird.
get GET /v1beta/{name=projects/*/locations/*}
Ruft Informationen zu einer Zone ab.
list GET /v1beta/{name=projects/*}/locations
Listet Informationen zu den unterstützten Zonen für diesen Dienst auf.
queryData POST /v1beta/{parent=projects/*/locations/*}:queryData
Fragt Daten aus einer Nutzeranfrage in natürlicher Sprache ab.
retrieveAgentOpsObservability GET /v1beta/{parent=projects/*/locations/*}:retrieveAgentOpsObservability
Ruft die Einstellungen für die Beobachtbarkeit von KI-Agenten und den Status der erforderlichen Dienste ab.

REST-Ressource: v1beta.projects.locations.conversations

Methoden
create POST /v1beta/{parent=projects/*/locations/*}/conversations
Erstellt eine neue Unterhaltung, um den Unterhaltungsverlauf beizubehalten.
delete DELETE /v1beta/{name=projects/*/locations/*/conversations/*}
Löscht eine Unterhaltung.
get GET /v1beta/{name=projects/*/locations/*/conversations/*}
Ruft Details zu einer einzelnen Unterhaltung anhand der Unterhaltungs-ID und des übergeordneten Elements ab.
list GET /v1beta/{parent=projects/*/locations/*}/conversations
Listet alle Unterhaltungen für ein bestimmtes übergeordnetes Element auf.

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

Methoden
list GET /v1beta/{parent=projects/*/locations/*/conversations/*}/messages
Listet alle Nachrichten für eine bestimmte Unterhaltung auf.

REST-Ressource: v1beta.projects.locations.dataAgents

Methoden
create POST /v1beta/{parent=projects/*/locations/*}/dataAgents
Erstellt einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
createSync POST /v1beta/{parent=projects/*/locations/*}/dataAgents:createSync
Erstellt synchron einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
delete DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}
Löscht einen einzelnen DataAgent.
deleteSync DELETE /v1beta/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Löscht einen einzelnen DataAgent synchron.
get GET /v1beta/{name=projects/*/locations/*/dataAgents/*}
Ruft Details zu einem einzelnen DataAgent ab.
getIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Ruft die IAM-Richtlinie für DataAgent ab.
list GET /v1beta/{parent=projects/*/locations/*}/dataAgents
Listet DataAgents in einem Projekt und an einem Standort auf.
listAccessible GET /v1beta/{parent=projects/*/locations/*}/dataAgents:listAccessible
Listet DataAgents auf, auf die der Aufrufer in einem Projekt und an einem Standort zugreifen kann.
patch PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Aktualisiert die Parameter eines einzelnen DataAgent.
setIamPolicy POST /v1beta/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Legt die IAM-Richtlinie für einen DataAgent fest.
updateSync PATCH /v1beta/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Aktualisiert die Parameter eines einzelnen DataAgent synchron.

REST-Ressource: v1beta.projects.locations.observabilitySettings

Methoden
setAgentOpsObservability POST /v1beta/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability
Aktiviert oder deaktiviert erforderliche Google Cloud-Dienste und konfiguriert die Einstellungen für die Beobachtbarkeit von KI-Agenten.

REST-Ressource: v1beta.projects.locations.operations

Methoden
cancel POST /v1beta/{name=projects/*/locations/*/operations/*}:cancel
Startet den asynchronen Abbruch eines Vorgangs mit langer Ausführungszeit.
delete DELETE /v1beta/{name=projects/*/locations/*/operations/*}
Löscht einen Vorgang mit langer Ausführungszeit.
get GET /v1beta/{name=projects/*/locations/*/operations/*}
Ruft den letzten Status eines Vorgangs mit langer Ausführungszeit ab.
list GET /v1beta/{name=projects/*/locations/*}/operations
Listet Vorgänge auf, die zu dem angegebenen Filter in der Anfrage passen.

REST-Ressource: v1alpha.projects.locations

Methoden
chat POST /v1alpha/{parent=projects/*/locations/*}:chat
Beantwortet eine Datenfrage, indem ein Stream von Message-Objekten generiert wird.
get GET /v1alpha/{name=projects/*/locations/*}
Ruft Informationen zu einer Zone ab.
list GET /v1alpha/{name=projects/*}/locations
Listet Informationen zu den unterstützten Zonen für diesen Dienst auf.
queryData POST /v1alpha/{parent=projects/*/locations/*}:queryData
Fragt Daten aus einer Nutzeranfrage in natürlicher Sprache ab.
retrieveAgentOpsObservability GET /v1alpha/{parent=projects/*/locations/*}:retrieveAgentOpsObservability
Ruft die Einstellungen für die Beobachtbarkeit von KI-Agenten und den Status der erforderlichen Dienste ab.

REST-Ressource: v1alpha.projects.locations.conversations

Methoden
create POST /v1alpha/{parent=projects/*/locations/*}/conversations
Erstellt eine neue Unterhaltung, um den Unterhaltungsverlauf beizubehalten.
delete DELETE /v1alpha/{name=projects/*/locations/*/conversations/*}
Löscht eine Unterhaltung.
get GET /v1alpha/{name=projects/*/locations/*/conversations/*}
Ruft Details zu einer einzelnen Unterhaltung anhand der Unterhaltungs-ID und des übergeordneten Elements ab.
list GET /v1alpha/{parent=projects/*/locations/*}/conversations
Listet alle Unterhaltungen für ein bestimmtes übergeordnetes Element auf.

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

Methoden
list GET /v1alpha/{parent=projects/*/locations/*/conversations/*}/messages
Listet alle Nachrichten für eine bestimmte Unterhaltung auf.

REST-Ressource: v1alpha.projects.locations.dataAgents

Methoden
create POST /v1alpha/{parent=projects/*/locations/*}/dataAgents
Erstellt einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
createSync POST /v1alpha/{parent=projects/*/locations/*}/dataAgents:createSync
Erstellt synchron einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
delete DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Löscht einen einzelnen DataAgent.
deleteSync DELETE /v1alpha/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Löscht einen einzelnen DataAgent synchron.
get GET /v1alpha/{name=projects/*/locations/*/dataAgents/*}
Ruft Details zu einem einzelnen DataAgent ab.
getIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Ruft die IAM-Richtlinie für DataAgent ab.
list GET /v1alpha/{parent=projects/*/locations/*}/dataAgents
Listet DataAgents in einem Projekt und an einem Standort auf.
listAccessible GET /v1alpha/{parent=projects/*/locations/*}/dataAgents:listAccessible
Listet DataAgents auf, auf die der Aufrufer in einem Projekt und an einem Standort zugreifen kann.
patch PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Aktualisiert die Parameter eines einzelnen DataAgent.
setIamPolicy POST /v1alpha/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Legt die IAM-Richtlinie für einen DataAgent fest.
updateSync PATCH /v1alpha/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Aktualisiert die Parameter eines einzelnen DataAgent synchron.

REST-Ressource: v1alpha.projects.locations.observabilitySettings

Methoden
setAgentOpsObservability POST /v1alpha/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability
Aktiviert oder deaktiviert erforderliche Google Cloud-Dienste und konfiguriert die Einstellungen für die Beobachtbarkeit von KI-Agenten.

REST-Ressource: v1alpha.projects.locations.operations

Methoden
cancel POST /v1alpha/{name=projects/*/locations/*/operations/*}:cancel
Startet den asynchronen Abbruch eines Vorgangs mit langer Ausführungszeit.
delete DELETE /v1alpha/{name=projects/*/locations/*/operations/*}
Löscht einen Vorgang mit langer Ausführungszeit.
get GET /v1alpha/{name=projects/*/locations/*/operations/*}
Ruft den letzten Status eines Vorgangs mit langer Ausführungszeit ab.
list GET /v1alpha/{name=projects/*/locations/*}/operations
Listet Vorgänge auf, die zu dem angegebenen Filter in der Anfrage passen.

REST-Ressource: v1.a2a.projects.locations.agents.v1

Methoden
getCard GET /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/card
GetAgentCard gibt die Agentenkarte für den Agenten zurück.

REST-Ressource: v1.a2a.projects.locations.agents.v1.message

Methoden
send POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:send
Nachricht an den KI-Agenten senden.
stream POST /v1/a2a/{tenant=projects/*/locations/*/agents/*}/v1/message:stream
SendStreamingMessage ist ein Streamingaufruf, der einen Stream von Aufgabenaktualisierungsereignissen zurückgibt, bis die Aufgabe unterbrochen oder beendet wird.

REST-Ressource: v1.a2a.projects.locations.dataAgents.v1

Methoden
getCard GET /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/card
GetAgentCard gibt die Agentenkarte für den Agenten zurück.

REST-Ressource: v1.a2a.projects.locations.dataAgents.v1.message

Methoden
send POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:send
Nachricht an den KI-Agenten senden.
stream POST /v1/a2a/{tenant=projects/*/locations/*/dataAgents/*}/v1/message:stream
SendStreamingMessage ist ein Streamingaufruf, der einen Stream von Aufgabenaktualisierungsereignissen zurückgibt, bis die Aufgabe unterbrochen oder beendet wird.

REST-Ressource: v1.projects.locations

Methoden
chat POST /v1/{parent=projects/*/locations/*}:chat
Beantwortet eine Datenfrage, indem ein Stream von Message-Objekten generiert wird.
get GET /v1/{name=projects/*/locations/*}
Ruft Informationen zu einer Zone ab.
list GET /v1/{name=projects/*}/locations
Listet Informationen zu den unterstützten Zonen für diesen Dienst auf.
retrieveAgentOpsObservability GET /v1/{parent=projects/*/locations/*}:retrieveAgentOpsObservability
Ruft die Einstellungen für die Beobachtbarkeit von KI-Agenten und den Status der erforderlichen Dienste ab.

REST-Ressource: v1.projects.locations.conversations

Methoden
create POST /v1/{parent=projects/*/locations/*}/conversations
Erstellt eine neue Unterhaltung, um den Unterhaltungsverlauf beizubehalten.
delete DELETE /v1/{name=projects/*/locations/*/conversations/*}
Löscht eine Unterhaltung.
get GET /v1/{name=projects/*/locations/*/conversations/*}
Ruft Details zu einer einzelnen Unterhaltung anhand der Unterhaltungs-ID und des übergeordneten Elements ab.
list GET /v1/{parent=projects/*/locations/*}/conversations
Listet alle Unterhaltungen für ein bestimmtes übergeordnetes Element auf.

REST-Ressource: v1.projects.locations.conversations.messages

Methoden
list GET /v1/{parent=projects/*/locations/*/conversations/*}/messages
Listet alle Nachrichten für eine bestimmte Unterhaltung auf.

REST-Ressource: v1.projects.locations.dataAgents

Methoden
create POST /v1/{parent=projects/*/locations/*}/dataAgents
Erstellt einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
createSync POST /v1/{parent=projects/*/locations/*}/dataAgents:createSync
Erstellt synchron einen neuen DataAgent in einem bestimmten Projekt und an einem bestimmten Standort.
delete DELETE /v1/{name=projects/*/locations/*/dataAgents/*}
Löscht einen einzelnen DataAgent.
deleteSync DELETE /v1/{name=projects/*/locations/*/dataAgents/*}:deleteSync
Löscht einen einzelnen DataAgent synchron.
get GET /v1/{name=projects/*/locations/*/dataAgents/*}
Ruft Details zu einem einzelnen DataAgent ab.
getIamPolicy POST /v1/{resource=projects/*/locations/*/dataAgents/*}:getIamPolicy
Ruft die IAM-Richtlinie für DataAgent ab.
list GET /v1/{parent=projects/*/locations/*}/dataAgents
Listet DataAgents in einem Projekt und an einem Standort auf.
listAccessible GET /v1/{parent=projects/*/locations/*}/dataAgents:listAccessible
Listet DataAgents auf, auf die der Aufrufer in einem Projekt und an einem Standort zugreifen kann.
patch PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}
Aktualisiert die Parameter eines einzelnen DataAgent.
setIamPolicy POST /v1/{resource=projects/*/locations/*/dataAgents/*}:setIamPolicy
Legt die IAM-Richtlinie für einen DataAgent fest.
updateSync PATCH /v1/{dataAgent.name=projects/*/locations/*/dataAgents/*}:updateSync
Aktualisiert die Parameter eines einzelnen DataAgent synchron.

REST-Ressource: v1.projects.locations.observabilitySettings

Methoden
setAgentOpsObservability POST /v1/{parent=projects/*/locations/*}/observabilitySettings:setAgentOpsObservability
Aktiviert oder deaktiviert erforderliche Google Cloud-Dienste und konfiguriert die Einstellungen für die Beobachtbarkeit von KI-Agenten.

REST-Ressource: v1.projects.locations.operations

Methoden
cancel POST /v1/{name=projects/*/locations/*/operations/*}:cancel
Startet den asynchronen Abbruch eines Vorgangs mit langer Ausführungszeit.
delete DELETE /v1/{name=projects/*/locations/*/operations/*}
Löscht einen Vorgang mit langer Ausführungszeit.
get GET /v1/{name=projects/*/locations/*/operations/*}
Ruft den letzten Status eines Vorgangs mit langer Ausführungszeit ab.
list GET /v1/{name=projects/*/locations/*}/operations
Listet Vorgänge auf, die zu dem angegebenen Filter in der Anfrage passen.