Create a collection of Firestore documents (async)
Stay organized with collections
Save and categorize content based on your preferences.
Create a collection of Firestore documents (async).
Explore further
For detailed documentation that includes this code sample, see the following:
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis content demonstrates how to create a collection of Firestore documents asynchronously using Python.\u003c/p\u003e\n"],["\u003cp\u003eThe code provided showcases the creation of a "cities" collection, which further contains subcollections of "landmarks" for various cities such as SF, LA, DC, TOK, and BJ.\u003c/p\u003e\n"],["\u003cp\u003eEach landmark document within the subcollections has a "name" and "type" field, illustrating different landmarks and their corresponding categories.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation offers resources on authentication and how to perform simple and compound queries within Cloud Firestore for further exploration.\u003c/p\u003e\n"],["\u003cp\u003eThe example shows how to use \u003ccode\u003eawait\u003c/code\u003e to set each document's data, providing an example of an asynchronous operation.\u003c/p\u003e\n"]]],[],null,["# Create a collection of Firestore documents (async).\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Perform simple and compound queries in Cloud Firestore](https://firebase.google.com/docs/firestore/query-data/queries)\n- [Query and filter data](/firestore/native/docs/query-data/queries)\n\nCode sample\n-----------\n\n### Python\n\n\nTo authenticate to Firestore, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n cities = db.collection(\"cities\")\n\n sf_landmarks = cities.document(\"SF\").collection(\"landmarks\")\n await sf_landmarks.document().set({\"name\": \"Golden Gate Bridge\", \"type\": \"bridge\"})\n await sf_landmarks.document().set({\"name\": \"Legion of Honor\", \"type\": \"museum\"})\n la_landmarks = cities.document(\"LA\").collection(\"landmarks\")\n await la_landmarks.document().set({\"name\": \"Griffith Park\", \"type\": \"park\"})\n await la_landmarks.document().set({\"name\": \"The Getty\", \"type\": \"museum\"})\n dc_landmarks = cities.document(\"DC\").collection(\"landmarks\")\n await dc_landmarks.document().set({\"name\": \"Lincoln Memorial\", \"type\": \"memorial\"})\n await dc_landmarks.document().set(\n {\"name\": \"National Air and Space Museum\", \"type\": \"museum\"}\n )\n tok_landmarks = cities.document(\"TOK\").collection(\"landmarks\")\n await tok_landmarks.document().set({\"name\": \"Ueno Park\", \"type\": \"park\"})\n await tok_landmarks.document().set(\n {\"name\": \"National Museum of Nature and Science\", \"type\": \"museum\"}\n )\n bj_landmarks = cities.document(\"BJ\").collection(\"landmarks\")\n await bj_landmarks.document().set({\"name\": \"Jingshan Park\", \"type\": \"park\"})\n await bj_landmarks.document().set(\n {\"name\": \"Beijing Ancient Observatory\", \"type\": \"museum\"}\n )\n\nWhat's next\n-----------\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=firestore)."]]