Menambahkan dokumen Firestore menggunakan ID yang dibuat secara otomatis
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menambahkan dokumen Firestore menggunakan ID yang dibuat secara otomatis
Mempelajari lebih lanjut
Untuk dokumentasi mendetail yang menyertakan contoh kode ini, lihat artikel berikut:
Contoh kode
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],[],[[["\u003cp\u003eThis page demonstrates how to add a new document to a Firestore collection with an automatically generated unique ID.\u003c/p\u003e\n"],["\u003cp\u003eThe code examples provided show how to add data to the "cities" collection, including the name and country information.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication to Firestore is required, and the process involves setting up Application Default Credentials as detailed in the provided link.\u003c/p\u003e\n"],["\u003cp\u003eCode samples are shown for various programming languages, including C#, Go, Java, Node.js, PHP, Python, and Ruby, ensuring broad applicability.\u003c/p\u003e\n"],["\u003cp\u003eThe newly added document's auto-generated ID can be retrieved and used for subsequent operations, as demonstrated in the code examples.\u003c/p\u003e\n"]]],[],null,["# Add a Firestore document using an autogenerated id\n\nExplore further\n---------------\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Add and update data](/firestore/native/docs/manage-data/add-data)\n- [Add data to Cloud Firestore](https://firebase.google.com/docs/firestore/manage-data/add-data)\n\nCode sample\n-----------\n\n### C#\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 Dictionary\u003cstring, object\u003e city = new Dictionary\u003cstring, object\u003e\n {\n { \"Name\", \"Tokyo\" },\n { \"Country\", \"Japan\" }\n };\n DocumentReference addedDocRef = await db.Collection(\"cities\").AddAsync(city);\n Console.WriteLine(\"Added document with ID: {0}.\", addedDocRef.Id);\n\n### Go\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\n import (\n \t\"context\"\n \t\"log\"\n\n \t\"cloud.google.com/go/firestore\"\n )\n\n func addDocWithoutID(ctx context.Context, client *firestore.Client) error {\n \t_, _, err := client.Collection(\"cities\").https://cloud.google.com/go/docs/reference/cloud.google.com/go/firestore/latest/index.html#cloud_google_com_go_firestore_CollectionRef_Add(ctx, map[string]interface{}{\n \t\t\"name\": \"Tokyo\",\n \t\t\"country\": \"Japan\",\n \t})\n \tif err != nil {\n \t\t// Handle any errors in an appropriate way, such as returning them.\n \t\tlog.Printf(\"An error has occurred: %s\", err)\n \t}\n\n \treturn err\n }\n\n### Java\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 // Add document data with auto-generated id.\n Map\u003cString, Object\u003e data = new HashMap\u003c\u003e();\n data.put(\"name\", \"Tokyo\");\n data.put(\"country\", \"Japan\");\n ApiFuture\u003cDocumentReference\u003e addedDocRef = db.collection(\"cities\").add(data);\n System.out.println(\"Added document with ID: \" + addedDocRef.get().getId());\n\n### Node.js\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 // Add a new document with a generated id.\n const res = await db.collection('cities').add({\n name: 'Tokyo',\n country: 'Japan'\n });\n\n console.log('Added document with ID: ', res.id);\n\n### PHP\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 $data = [\n 'name' =\u003e 'Tokyo',\n 'country' =\u003e 'Japan'\n ];\n $addedDocRef = $db-\u003ecollection('samples/php/cities')-\u003eadd($data);\n printf('Added document with ID: %s' . PHP_EOL, $addedDocRef-\u003eid());\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 city = {\"name\": \"Tokyo\", \"country\": \"Japan\"}\n update_time, city_ref = db.collection(\"cities\").add(city)\n print(f\"Added document with id {city_ref.id}\")\n\n### Ruby\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 data = {\n name: \"Tokyo\",\n country: \"Japan\"\n }\n\n cities_ref = firestore.col collection_path\n\n added_doc_ref = cities_ref.add data\n puts \"Added document with ID: #{added_doc_ref.document_id}.\"\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)."]]