You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jun 24, 2025. It is now read-only.
Copy file name to clipboardExpand all lines: tutorial-demos/firestore-demo/README.md
+13-10Lines changed: 13 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
# Apigee Firestore Quickstart & Adapter
2
-
This repository contains a quickstart proxy for the [Apige API Management](cloud.google.com/apigee) platform to connect to a collection in a [Firestore](cloud.google.com/firestore) database. The API provided by the proxy can then be easily used by any REST clients, including [AppSheet](cloud.google.com/appsheet) no-code apps.
2
+
This repository contains a quickstart proxy for the [Apige API Management](https://cloud.google.com/apigee) platform to connect to a collection in a [Firestore](https://firebase.google.com/products/firestore) database. The API provided by the proxy can then be easily used by any REST clients, including [AppSheet](https://cloud.google.com/appsheet) no-code apps.
3
3
4
4
## Prerequisites
5
5
Firestore is a great document database for storing any kind of unstructured data, however we do need some structures to automatically use any database with this quickstart.
@@ -18,20 +18,21 @@ As you can see, only primitive data types are supported in the Firestore documen
18
18
## Quickstart deploy
19
19
The fastest way to deploy and spin up an API offering CRUD operations on your Firestore database is to import the **Firestore Quickstart** proxy bundle in Apigee, and then set these properties:
20
20
21
-
1. In the default Endpoint PreFlow, replace the following variables in the 1st policy **Set-Firestore-Variables** to your own values:
21
+
1. Download the [Apigee Firebase Quickstart Proxy 0.8.zip](https://github.com/apigee/api-platform-samples/releases/tag/v0.8-beta) bundle and import it into your Apigee environment.
22
+
2. In the default Endpoint PreFlow, replace the following variables in the 1st policy **Set-Firestore-Variables** to your own values:
22
23
1.**GCP_PROJECT** - replace with the GCP project name where your Firestore database is located.
23
24
2.**firestore.key** - in case the **id** index field isn't named **id** in the Firestore documents (see prerequisites above), then you should set the correct name here (it is recommended to just use **id**).
24
25
3.**GCP_SVC_KEY** - set this to your GCP service account private key (which has the permissions to access Firestore in your GCP project) from the **private_key** field in the key JSON file (beginning with -----BEGIN PRIVATE KEY----- and ending with -----END PRIVATE KEY-----)
25
26
4.**GCP_SVC_EMAIL** - set this to the GCP service account email address from the **client_email** field in the private key JSON file.
26
-
2. Change the proxy basepath to something meaningful (default is **/importantstuff**, for no particular reason)
27
-
3. Deploy the proxy. By default an API key is activated for the proxy, disable the 2nd policy in the PreFlow if you want to test without one. Now you can call https://host/basepath/collection/document to all CRUD operations on your Firestore data, using simple JSON payload messages. WooHoo!
28
-
4. You can also use this proxy as an API data source in an AppSheet app, it will just work.
27
+
3. Change the proxy basepath to something meaningful (default is **/importantstuff**, for no particular reason)
28
+
4. Deploy the proxy. By default an API key is activated for the proxy, disable the 2nd policy in the PreFlow if you want to test without one. Now you can call https://host/basepath/collection/document to all CRUD operations on your Firestore data, using simple JSON payload messages. WooHoo!
29
+
5. You can also use this proxy as an API data source in an AppSheet app, it will just work.
29
30
30
31
## Example
31
32
An example is deployed for this Firestore data structure:
0 commit comments