Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Google Cloud Firestore-Erweiterung

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Version: 1.4.1

Daten in einer Cloud Firestore-Datenbank erstellen, lesen oder löschen.

Dieser Inhalt enthält eine Referenz zum Konfigurieren und Verwenden dieser Erweiterung. Bevor Sie diese Erweiterung über einen API-Proxy verwenden können, müssen Sie Folgendes tun:

Erstellen Sie in der Firebase Console ein Firebase-Projekt, in dem Ihre Daten gespeichert sind.
Erstellen Sie einen Schlüssel für das Dienstkonto.
Verwenden Sie den Inhalt der resultierenden JSON-Schlüsseldatei, wenn Sie die Erweiterung mithilfe der Konfigurationsreferenz hinzufügen und konfigurieren.

Cloud Firestore

In Cloud Firestore werden Daten in Dokumenten gespeichert, die wiederum in Sammlungen gespeichert sind. Cloud Firestore erstellt Sammlungen und Dokumente implizit, wenn Sie dem Dokument zum ersten Mal Daten hinzufügen. Sie müssen Sammlungen oder Dokumente also nicht explizit anlegen.

Weitere Informationen zu Cloud Firestore finden Sie in der Cloud Firestore-Dokumentation unter Erste Schritte mit Firestore.

Beispiele

Die folgenden Beispiele veranschaulichen, wie Sie die Unterstützung für Cloud Firestore-Erweiterungsaktionen mit der ExtensionCallout-Richtlinie konfigurieren.

Daten hinzufügen

Die folgende ExtensionCallout-Richtlinie fügt der Sammlung users ein Dokument namens freewill@example.com hinzu. Die Property data gibt die Felder und Werte des neuen Dokuments an.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Add-User-Data">
    <DisplayName>Add User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>setDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com",
        "data" : {
            "firstName": "Will",
            "lastName": "Witman",
            "address": "270-8243 Tempor St.",
            "city": "Fort Worth",
            "region": "TX",
            "postalCode": "86519",
            "email": "freewill@example.com",
            "username": "freewill444"
        }
    }]]></Input>
</ConnectorCallout>

Daten abrufen

In diesem Beispiel ruft die ExtensionCallout-Richtlinie den Wert des freewill@example.com Dokuments aus der users Sammlung ab. Hier ist das <Output> Attribut parsed des Elements auf false gesetzt, sodass das zurückgegebene Ergebnis JSON als String und nicht als in ein Objekt geparstes JSON ist. Weitere Informationen finden Sie in der Referenz zum Element <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Get-User-Data">
    <DisplayName>Get User Data</DisplayName>
    <Connector>straut-cloud-firestore-extension</Connector>
    <Action>getDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "freewill@example.com"
    }]]></Input>
    <Output parsed="false">firestore.userdata.retrieved</Output>
</ConnectorCallout>

Die folgende Assign Message-Richtlinie verwendet den Wert der Variablen, in der die Antwort der Erweiterung gespeichert ist, um die Antwortnutzlast zuzuweisen.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyUserDataToResponse">
    <DisplayName>Copy User Data To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.userdata.retrieved}</Payload>
    </Set>
</AssignMessage>

Daten löschen

In diesem Beispiel löscht die ExtensionCallout-Richtlinie das lizzie@example.com Dokument aus der users Sammlung.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Delete-User-Data">
    <DisplayName>Delete User Data</DisplayName>
    <Connector>my-cloud-firestore-extension</Connector>
    <Action>deleteDocument</Action>
    <Input><![CDATA[{
        "colName" : "users",
        "docName" : "lizzie@example.com"
    }]]></Input>
</ConnectorCallout>

Daten abfragen

In diesem Beispiel fragt die ExtensionCallout-Richtlinie eine cities Sammlung ab. Die Abfrageergebnisse werden nach den Feldern state und population gefiltert. Hier ist das <Output> Attribut parsed des Elements auf false gesetzt, sodass das zurückgegebene Ergebnis JSON als String und nicht als in ein Objekt geparstes JSON ist. Weitere Informationen finden Sie in der Referenz zum Element <Output>.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConnectorCallout async="false" continueOnError="true" enabled="true" name="Query-City-Data">
    <DisplayName>Query City Data</DisplayName>
    <Connector>cloud-firestore-extension</Connector>
    <Action>query</Action>
    <Input><![CDATA[{
        "colName":"cities",
        "queryArray":[
          ["state", "==", "CA"],
          ["population","<",1000000]
        ]
    }]]></Input>
    <Output parsed="false">compound-query-output</Output>
</ConnectorCallout>

Die folgende Assign Message-Richtlinie verwendet den Wert der Variablen, in der die Antwort der Erweiterung gespeichert ist, um die Antwortnutzlast zuzuweisen.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage name="CopyQueryResultsToResponse">
    <DisplayName>Copy Query Results To Response</DisplayName>
    <AssignTo type="response" createNew="false"/>
    <Set>
        <Payload contentType="application/json">{firestore.querydata.retrieved}</Payload>
    </Set>
</AssignMessage>

Aktionen

deleteDocument

Löscht ein einzelnes Dokument aus einer Sammlung.

Anfrageparameter

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name"
}]]></Input>

Parameter	Beschreibung	Typ	Standard	Erforderlich
colName	Name der Sammlung, die das zu löschende Dokument enthält.	String	Keine.	Ja.
docName	Name des zu löschenden Dokuments.	String	Keine.	Ja.

Antwort

Keine.

getDocument

Ruft den Inhalt eines einzelnen Dokuments ab.

Anfrageparameter

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name"
}]]></Input>

Parameter	Beschreibung	Typ	Standard	Erforderlich
colName	Name der Sammlung, aus der das Dokument abgerufen werden soll.	String	Keine.	Ja.
docName	Name des abzurufenden Dokuments.	String	Keine.	Ja.

Antwort

Objekt mit dem Inhalt des Dokuments im JSON-Format.

Abfrage

Fragt eine Sammlung ab, indem Bedingungen angegeben werden, die einen Filter bilden.

Der Parameter queryArray dieser Aktion gibt ein Array von Arrays an (oder ein leeres Array für keine Filterbedingungen). Jedes innere Array gibt eine Bedingung eines Filters an. Mehrere innere Arrays stellen mehrere Bedingungen dar, die durch einen AND-Operator verknüpft sind.

Jedes Element in einem inneren Bedingungsarray stellt einen Teil der Bedingung dar. Ein Bedingungsarray hat immer die folgenden drei Elemente:

Ein linkes Element, das das Sammlungsfeld angibt.
Ein mittleres Element, das den Operator angibt.
Ein rechtes Element, das den Wert des Sammlungsfelds angibt.

Im folgenden Beispiel werden zwei Bedingungsarrays angegeben, um nach den Feldern state und population der Sammlung zu filtern:

<Input><![CDATA[{
  "colName":"cities",
  "queryArray":[
    ["state", "==", "CA"],
    ["population","<",1000000]
  ]
}]]></Input>

Zur Laufzeit wird diese Aktion als Abfrage wie die folgende interpretiert:

Alle Städte auswählen, in denen der Bundesstaat = „CA“ und die Bevölkerung < 1.000.000 ist

Eine Abfrage mit mehreren Bedingungen muss in Cloud Firestore durch einen zusammengesetzten Index unterstützt werden. Weitere Informationen finden Sie unter Indexarten in Cloud Firestore.

Anfrageparameter

Syntax

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "queryArray" : "queryArray": query-condition-array
}]]></Input>

Beispiel

In diesem Beispiel gibt der Parameter queryArray zwei Bedingungen an, nach denen die durch den Parameter colName angegebene Sammlung cities gefiltert werden soll.

Eine Abfrage mit mehreren Bedingungen muss in Cloud Firestore durch einen zusammengesetzten Index unterstützt werden. Weitere Informationen finden Sie unter Indexarten in Cloud Firestore.

<Input><![CDATA[{
  "colName":"cities",
  "queryArray":[["state", "==", "CA"],["population","<",1000000]]
}]]></Input>

Zur Laufzeit wird diese Aktion als Abfrage wie die folgende interpretiert:

Alle Städte auswählen, in denen der Bundesstaat = „CA“ und die Bevölkerung < 1.000.000 ist

Parameter	Beschreibung	Typ	Standard	Erforderlich
colName	Name der Sammlung, die abgefragt werden soll.	String	Keine.	Ja.
queryArray	Ein Array von Bedingungsarrays, die zusammen die Teile eines Filters angeben. Geben Sie ein leeres Array an, um Bedingungen zu entfernen (Ergebnisse nicht zu filtern).	Array	Keine.	Ja.

Antwort

Objekt mit dem Inhalt des Dokuments im JSON-Format.

setDocument

Kopiert ein Dokument in eine Cloud Firestore-Sammlung. Wenn das Dokument bereits in der Sammlung vorhanden ist, wird es überschrieben.

Anfrageparameter

<Input><![CDATA[{
  "colName" : "firestore-collection-name",
  "docName" : "firestore-document-name",
  "data" : "data-to-copy"
}]]></Input>

Parameter	Beschreibung	Typ	Standard	Erforderlich
colName	Name der Sammlung, in der das Dokument erstellt werden soll.	String	Keine.	Ja.
docName	Name des Dokuments, in das `data` kopiert werden soll.	String	Keine.	Ja.
data	Daten, die in `docName` kopiert werden sollen. Dies muss ein gültiges JSON-Objekt sein. Arrays werden nicht unterstützt.	Objekt	Keine.	Nein.

Antwort

Keine.

Konfigurationsreferenz

Verwenden Sie die folgenden Informationen, wenn Sie diese Erweiterung für die Verwendung in API-Proxys konfigurieren und bereitstellen. Eine Anleitung zum Konfigurieren einer Erweiterung mit der Apigee-Konsole finden Sie unter Erweiterung hinzufügen und konfigurieren.

Allgemeine Erweiterungseigenschaften

Für jede Erweiterung sind die folgenden Eigenschaften vorhanden.

Attribut	Beschreibung	Standard	Erforderlich
`name`	Der Name, den Sie dieser Konfiguration der Erweiterung zuweisen.	–	Ja
`packageName`	Name des Erweiterungspakets, wie von Apigee Edge angegeben.	–	Ja
`version`	Versionsnummer für das Erweiterungspaket, von dem Sie eine Erweiterung konfigurieren.	–	Ja
`configuration`	Konfigurationswert speziell für die Erweiterung, die Sie hinzufügen. Weitere Informationen finden Sie unter Eigenschaften für dieses Erweiterungspaket.	–	Ja

Eigenschaften für dieses Erweiterungspaket

Attribut	Beschreibung	Standard	Erforderlich
firestoreDB	URL zur Cloud Firestore-Datenbank, die von dieser Erweiterung für Anfragen verwendet werden soll. Diese URL hat normalerweise das Format `https://DATABASE_NAME.firebaseio.com`.	Keine.	Ja.
Anmeldedaten	Wenn in der Apigee Edge-Konsole eingegeben, ist dies der Inhalt der Schlüsseldatei, die Sie mit der Firebase-Anleitung generiert haben. Wenn sie über die Management API gesendet wird, ist sie ein Base64-codierter Wert, der aus der Schlüsseldatei generiert wurde.	Keine.	Ja.