इस क्विकस्टार्ट में, Cloud Firestore सेट अप करने, डेटा जोड़ने, और उसे देखने का तरीका बताया गया है वह डेटा जिसे आपने अभी-अभी Firebase कंसोल में जोड़ा है.
Cloud Firestore का डेटाबेस बनाएं
अगर आपने पहले से Firebase प्रोजेक्ट नहीं बनाया है, तो इसे बनाएं: Firebase कंसोल में जाकर, प्रोजेक्ट जोड़ें पर क्लिक करें. फिर, Firebase प्रोजेक्ट बनाने के लिए या स्क्रीन पर दिए गए निर्देशों का पालन करके मौजूदा GCP प्रोजेक्ट में Firebase सेवाएं जोड़ना.
इसके Cloud Firestore सेक्शन पर जाएं: Firebase कंसोल. आपसे कोई मौजूदा Firebase प्रोजेक्ट चुनने के लिए कहा जाएगा. डेटाबेस बनाने के वर्कफ़्लो को फ़ॉलो करें.
अपने Cloud Firestore Security Rules के लिए कोई शुरुआती मोड चुनें:
- टेस्ट मोड
यह मोबाइल और वेब क्लाइंट लाइब्रेरी का इस्तेमाल शुरू करने के लिए सही है, हालांकि, इसकी मदद से कोई भी व्यक्ति आपके डेटा को पढ़ सकता है और उसमें बदलाव कर सकता है. परीक्षण के बाद, अपने अपना डेटा सुरक्षित करें सेक्शन को ज़रूर देखें.
वेब, Apple प्लैटफ़ॉर्म या Android SDK का इस्तेमाल शुरू करने के लिए, टेस्ट मोड चुनें.
- लॉक मोड
मोबाइल और वेब क्लाइंट के किसी भी तरह के पढ़े और लिखे गए कॉन्टेंट को अस्वीकार करता है. आपके पुष्टि किए गए ऐप्लिकेशन सर्वर (C#, Go, Java, Node.js, PHP, Python या Ruby) अब भी आपके डेटाबेस को ऐक्सेस कर सकता है.
C#, Go, Java, Node.js, PHP, Python या Ruby के साथ शुरुआत करने के लिए सर्वर क्लाइंट लाइब्रेरी में, लॉक मोड चुनें.
Cloud Firestore Security Rules का शुरुआती सेट, आपके डिफ़ॉल्ट स्टोरेज पर लागू होगा Cloud Firestore डेटाबेस. अगर आपने अपने प्रोजेक्ट के लिए एक से ज़्यादा डेटाबेस बनाए हैं, हर डेटाबेस के लिए, Cloud Firestore Security Rules को डिप्लॉय किया जा सकता है.
अपने डेटाबेस के लिए कोई जगह चुनें.
जगह की यह सेटिंग आपके प्रोजेक्ट की है Google Cloud Platform (GCP) के संसाधन की डिफ़ॉल्ट जगह. ध्यान दें कि इस जगह का इस्तेमाल आपके प्रोजेक्ट में GCP की सेवाओं के लिए किया जाएगा जिसे स्थान सेटिंग की आवश्यकता होती है, विशेष रूप से, आपका डिफ़ॉल्ट Cloud Storage बकेट और App Engine ऐप्लिकेशन (जो Cloud शेड्यूलर का इस्तेमाल करने के लिए ज़रूरी है).
अगर जगह चुनने में समस्या आ रही है, तो हो सकता है कि आपने पहले से ही अपना प्रोजेक्ट यह डिफ़ॉल्ट GCP संसाधन की जगह पर होता है. इसे प्रोजेक्ट के दौरान सेट किया गया था या ऐसी कोई अन्य सेवा सेट अप करते समय जिसके लिए जगह की जानकारी की ज़रूरत हो सेटिंग.
हो गया पर क्लिक करें.
Cloud Firestore को चालू करने पर, एपीआई को इसमें भी चालू कर दिया जाता है Cloud API मैनेजर.
अपना डेवलपमेंट एनवायरमेंट सेट अप करें
अपने ऐप्लिकेशन में ज़रूरी डिपेंडेंसी और क्लाइंट लाइब्रेरी जोड़ें.
Web
- दिए गए निर्देशों का पालन करके अपने वेब ऐप्लिकेशन में Firebase जोड़ें.
- अपने ऐप्लिकेशन में Firebase और Cloud Firestore लाइब्रेरी जोड़ें:
Cloud Firestore SDK टूल, एनपीएम पैकेज के तौर पर भी उपलब्ध है.<script src="https://www.gstatic.com/firebasejs/10.13.1/firebase-app-compat.js"></script> <script src="https://www.gstatic.com/firebasejs/10.13.1/firebase-firestore-compat.js"></script>
आपको Firebase और Cloud Firestore, दोनों को मैन्युअल तरीके से इस्तेमाल करना होगा.npm install firebase@10.13.1 --save
import firebase from "firebase/compat/app"; // Required for side-effects import "firebase/firestore";
Web
- दिए गए निर्देशों का पालन करके अपने वेब ऐप्लिकेशन में Firebase जोड़ें.
-
Cloud Firestore SDK टूल, एनपीएम पैकेज के तौर पर उपलब्ध है.
आपको Firebase और Cloud Firestore, दोनों को इंपोर्ट करना होगा.npm install firebase@10.13.1 --save
import { initializeApp } from "firebase/app"; import { getFirestore } from "firebase/firestore";
iOS और उसके बाद के वर्शन
दिए गए निर्देशों का पालन करके अपने Apple ऐप्लिकेशन में Firebase जोड़ें.
Firebase डिपेंडेंसी इंस्टॉल और मैनेज करने के लिए, Swift पैकेज मैनेजर का इस्तेमाल करें.
- Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलने के लिए, फ़ाइल > Swift पैकेज > पैकेज डिपेंडेंसी जोड़ें.
- जब कहा जाए, तब Firebase Apple प्लैटफ़ॉर्म SDK टूल का रिपॉज़िटरी जोड़ें:
- Firestore लाइब्रेरी चुनें.
- यह काम पूरा होने पर, Xcode अपने-आप रिज़ॉल्व और डाउनलोड होना शुरू कर देगा पर निर्भर करता है.
https://github.com/firebase/firebase-ios-sdk
Android
- दिए गए निर्देशों का पालन करके अपने Android ऐप्लिकेशन में Firebase जोड़ें.
- इसका उपयोग करके
Firebase Android BoM,
इसमें Android के लिए Cloud Firestore लाइब्रेरी के लिए डिपेंडेंसी का एलान करें
आपकी मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल
(आम तौर पर
app/build.gradle.kts
याapp/build.gradle
).dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.0")) // Declare the dependency for the Cloud Firestore library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-firestore") }
इसका इस्तेमाल करके Firebase Android BoM, आपका ऐप्लिकेशन, Firebase Android के साथ काम करने वाले वर्शन का हमेशा इस्तेमाल करेगा लाइब्रेरी.
(वैकल्पिक) Firebase लाइब्रेरी डिपेंडेंसी का एलान बिना BoM
अगर आपको Firebase BoM का इस्तेमाल नहीं करना है, तो आपको हर Firebase लाइब्रेरी का वर्शन, इसकी डिपेंडेंसी लाइन में है.
ध्यान दें कि यदि आप कई Firebase लाइब्रेरी का उपयोग हमारा सुझाव है कि लाइब्रेरी को मैनेज करने के लिए, BoM का इस्तेमाल करें. वर्शन चुनें, जिससे यह पक्का होता है कि सभी वर्शन साथ काम करते हैं.
dependencies { // Declare the dependency for the Cloud Firestore library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-firestore:25.1.0") }
Kotlin की मदद से खास लाइब्रेरी मॉड्यूल की तलाश कर रहे हैं? शुरुआत अक्टूबर 2023 में रिलीज़, Kotlin और Java डेवलपर, दोनों मुख्य लाइब्रेरी मॉड्यूल पर निर्भर हो सकते हैं (जानकारी के लिए, इस पहल के बारे में अक्सर पूछे जाने वाले सवाल).
Dart
- अगर आपने पहले से ऐसा नहीं किया है, तो कॉन्फ़िगर करें और अपने Flutter ऐप्लिकेशन में Firebase शुरू करना होगा.
- अपने Flutter प्रोजेक्ट के रूट से, नीचे दी गई कमांड को चलाकर देखें
प्लगिन इंस्टॉल करें:
flutter pub add cloud_firestore
- यह प्रोसेस पूरी होने के बाद, अपना Flutter ऐप्लिकेशन फिर से बनाएं:
flutter run
- ज़रूरी नहीं: iOS और macOS पर, बिल्ड इंपोर्ट होने में लगने वाला समय
का इस्तेमाल किया जा सकता है.
फ़िलहाल, iOS के लिए Firestore SDK टूल ऐसे कोड पर निर्भर करता है जो में बनाने के लिए 5 मिनट से ज़्यादा समय का है. बिल्ड में लगने वाले समय को कम करने के लिए काफ़ी अहम है, तो आप आपकी Podfile में
target 'Runner' do
ब्लॉक:target 'Runner' do use_frameworks! use_modular_headers! pod 'FirebaseFirestore', :git => 'https://github.com/invertase/firestore-ios-sdk-frameworks.git', :tag => 'IOS_SDK_VERSION' flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__)) target 'RunnerTests' do inherit! :search_paths end end
IOS_SDK_VERSION को Firebase iOS के वर्शन से बदलें
firebase_core
में तय SDK टूलfirebase_sdk_version.rb
फ़ाइल से लिए जाते हैं. यदि आपfirebase_core
, अपने स्थानीय Pub पैकेज में यह फ़ाइल खोजें कैश मेमोरी (आम तौर पर~/.pub-cache
).इसके अलावा, पक्का करें कि आपने CocoaPods को 1.9.1 पर अपग्रेड कर लिया है या ज़्यादा:
gem install cocoapods
ज़्यादा जानकारी के लिए, देखें समस्या GitHub पर.
Java
- अपने ऐप्लिकेशन में Firebase एडमिन SDK टूल जोड़ें:
-
Gredle का इस्तेमाल करना:
compile 'com.google.firebase:firebase-admin:1.32.0'
-
Maven का इस्तेमाल करना:
<dependency> <groupId>com.google.firebase</groupId> <artifactId>firebase-admin</artifactId> <version>1.32.0</version> </dependency>
-
Gredle का इस्तेमाल करना:
- Cloud Firestore शुरू करने के लिए, नीचे दिए गए निर्देशों का पालन करें सही क्रेडेंशियल का इस्तेमाल करें.
Python
- अपने Python ऐप्लिकेशन में Firebase एडमिन SDK टूल जोड़ें:
pip install --upgrade firebase-admin
- Cloud Firestore शुरू करने के लिए, नीचे दिए गए निर्देशों का पालन करें सही क्रेडेंशियल का इस्तेमाल करें.
C++
- दिए गए निर्देशों का पालन करके अपने C++ प्रोजेक्ट में Firebase जोड़ें.
- Android के लिए C++ इंटरफ़ेस.
- Gradle डिपेंडेंसी. अपने मॉड्यूल में इन्हें जोड़ें
(ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर
app/build.gradle
):android.defaultConfig.externalNativeBuild.cmake { arguments "-DFIREBASE_CPP_SDK_DIR=$gradle.firebase_cpp_sdk_dir" } apply from: "$gradle.firebase_cpp_sdk_dir/Android/firebase_dependencies.gradle" firebaseCpp.dependencies { // earlier entries auth firestore }
- बाइनरी डिपेंडेंसी. इसी तरह, यह सुविधा पाने के लिए
CMakeLists.txt
में बाइनरी डिपेंडेंसी का इस्तेमाल करना फ़ाइल:add_subdirectory(${FIREBASE_CPP_SDK_DIR} bin/ EXCLUDE_FROM_ALL) set(firebase_libs firebase_auth firebase_firestore firebase_app) # Replace the target name below with the actual name of your target, # for example, "native-lib". target_link_libraries(${YOUR_TARGET_NAME_HERE} "${firebase_libs}")
- डेस्कटॉप इंटिग्रेशन सेट अप करने के लिए, Firebase को अपने C++ प्रोजेक्ट में जोड़ना लेख देखें.
Unity
- दिए गए निर्देशों का पालन करके अपनी Unity में Firebase जोड़ना प्रोजेक्ट.
- Android बिल्ड को छोटा करने के लिए, अपना प्रोजेक्ट कॉन्फ़िगर करने के लिए Unity इंटरफ़ेस का इस्तेमाल करें.
- यह विकल्प प्लेयर सेटिंग > Android > पब्लिश किया जा रहा है सेटिंग > छोटा करें.
- Unity के अलग-अलग वर्शन में विकल्प अलग-अलग हो सकते हैं. इसलिए, Unity के लिए आधिकारिक दस्तावेज़ और Firebase यूनिटी बिल्ड डीबग गाइड.
-
अगर छोटा करने की सुविधा चालू करने के बाद भी, बताए गए तरीकों की संख्या कम नहीं होती
सीमा से ज़्यादा हो जाता है, तो दूसरा विकल्प
multidex
को चालू करना होता है:-
प्लेयर सेटिंग में कस्टम ग्रेडल टेंप्लेट चालू होने पर,
mainTemplate.gradle
-
या, अगर एक्सपोर्ट किए गए प्रोजेक्ट को बनाने के लिए Android Studio का इस्तेमाल किया जाता है, तो मॉड्यूल-लेवल की
build.gradle
फ़ाइल का इस्तेमाल करें.
-
प्लेयर सेटिंग में कस्टम ग्रेडल टेंप्लेट चालू होने पर,
Error while merging dex archives
मैसेज से बचने के लिए, आपको बिल्ड को छोटा करना होगा.
Node.js
-
अपने ऐप्लिकेशन में Firebase एडमिन SDK टूल जोड़ें:
npm install firebase-admin --save
- Cloud Firestore शुरू करने के लिए, नीचे दिए गए निर्देशों का पालन करें सही क्रेडेंशियल का इस्तेमाल करें.
शुरू करें
- अपने Go ऐप्लिकेशन में Firebase एडमिन SDK टूल जोड़ें:
go get firebase.google.com/go
- Cloud Firestore शुरू करने के लिए, नीचे दिए गए निर्देशों का पालन करें सही क्रेडेंशियल का इस्तेमाल करें.
PHP
-
Cloud Firestore सर्वर क्लाइंट लाइब्रेरी (Java, Node.js, Python, Go, PHP, C#, और Ruby) इन लाइब्रेरी का इस्तेमाल करती है
Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल
पुष्टि करने के लिए.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
GOOGLE_APPLICATION_CREDENTIALS
सेट करें एनवायरमेंट वैरिएबल का इस्तेमाल करके, JSON सेवा खाते की कुंजी फ़ाइल पर ले जाया जा सकता है. आपके पास एक कुंजी फ़ाइल बनाने का विकल्प है API Console के क्रेडेंशियल वाले पेज पर.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- अगर ऐप्लिकेशन को चलाया जाता है, तो आपको अपने प्रोडक्शन एनवायरमेंट में पुष्टि करने की ज़रूरत नहीं है Cloud Firestore के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का इस्तेमाल करके, App Engine या Compute Engine पर इंस्टॉल किया जा सकता है. या फिर, सेवा खाता सेट अप करना.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
- gRPC एक्सटेंशन इंस्टॉल और चालू करें के लिए, आपको क्लाइंट लाइब्रेरी का इस्तेमाल करना होगा.
-
अपने ऐप्लिकेशन में Cloud Firestore PHP लाइब्रेरी जोड़ें:
composer require google/cloud-firestore
C#
-
Cloud Firestore सर्वर क्लाइंट लाइब्रेरी (Java, Node.js, Python, Go, PHP, C#, और Ruby) इन लाइब्रेरी का इस्तेमाल करती है
Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल
पुष्टि करने के लिए.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
GOOGLE_APPLICATION_CREDENTIALS
सेट करें एनवायरमेंट वैरिएबल का इस्तेमाल करके, JSON सेवा खाते की कुंजी फ़ाइल पर ले जाया जा सकता है. आपके पास एक कुंजी फ़ाइल बनाने का विकल्प है API Console के क्रेडेंशियल वाले पेज पर.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- अगर ऐप्लिकेशन को चलाया जाता है, तो आपको अपने प्रोडक्शन एनवायरमेंट में पुष्टि करने की ज़रूरत नहीं है Cloud Firestore के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का इस्तेमाल करके, App Engine या Compute Engine पर इंस्टॉल किया जा सकता है. या फिर, सेवा खाता सेट अप करना.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
-
अपनी
.csproj
फ़ाइल में, अपने ऐप्लिकेशन में Cloud Firestore C# लाइब्रेरी जोड़ें:<ItemGroup> <PackageReference Include="Google.Cloud.Firestore" Version="1.1.0-beta01" /> </ItemGroup>
-
अपनी
Program.cs
फ़ाइल में यह जोड़ें:using Google.Cloud.Firestore;
Ruby
-
Cloud Firestore सर्वर क्लाइंट लाइब्रेरी (Java, Node.js, Python, Go, PHP, C#, और Ruby) इन लाइब्रेरी का इस्तेमाल करती है
Google ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल
पुष्टि करने के लिए.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
GOOGLE_APPLICATION_CREDENTIALS
सेट करें एनवायरमेंट वैरिएबल का इस्तेमाल करके, JSON सेवा खाते की कुंजी फ़ाइल पर ले जाया जा सकता है. आपके पास एक कुंजी फ़ाइल बनाने का विकल्प है API Console के क्रेडेंशियल वाले पेज पर.export GOOGLE_APPLICATION_CREDENTIALS="path/to/your/keyfile.json"
- अगर ऐप्लिकेशन को चलाया जाता है, तो आपको अपने प्रोडक्शन एनवायरमेंट में पुष्टि करने की ज़रूरत नहीं है Cloud Firestore के लिए इस्तेमाल किए जाने वाले प्रोजेक्ट का इस्तेमाल करके, App Engine या Compute Engine पर इंस्टॉल किया जा सकता है. या फिर, सेवा खाता सेट अप करना.
-
अपने डेवलपमेंट एनवायरमेंट से पुष्टि करने के लिए,
-
अपने
Gemfile
में, अपने ऐप्लिकेशन में Cloud Firestore Ruby लाइब्रेरी जोड़ें:gem "google-cloud-firestore"
-
इसका इस्तेमाल करके अपने
Gemfile
से डिपेंडेंसी इंस्टॉल करें:bundle install
(ज़रूरी नहीं) प्रोटोटाइप बनाना और Firebase Local Emulator Suite की मदद से टेस्ट करना
मोबाइल डेवलपर के लिए: आपका ऐप्लिकेशन किस तरह से कॉन्टेंट लिखता है और पढ़ता है, इस बारे में बात करने से पहले आइए, Cloud Firestore से लेकर अब तक ऐसे टूल के सेट के बारे में जानते हैं जिनका इस्तेमाल करके, Cloud Firestore के काम करने के तरीके को प्रोटोटाइप बनाएं और उसकी जांच करें: Firebase Local Emulator Suite. अगर अलग-अलग डेटा मॉडल को आज़माया जा रहा है, तो आपके सुरक्षा नियमों को ऑप्टिमाइज़ करना या सबसे किफ़ायती रास्ता ढूंढना डिप्लॉयमेंट के बिना स्थानीय तौर पर काम करने में, बैक-एंड से इंटरैक्ट करने की सुविधा एक अच्छा आइडिया हो सकता है.
एक Cloud Firestore एम्युलेटर, Local Emulator Suite का हिस्सा है, जो इससे आपका ऐप्लिकेशन, आपके डेटाबेस के एम्युलेट किए गए कॉन्टेंट और कॉन्फ़िगरेशन से इंटरैक्ट कर सकता है. जैसे: विकल्प के तौर पर, आपके एम्युलेट किए गए प्रोजेक्ट रिसोर्स (फ़ंक्शन, अन्य डेटाबेस, और सुरक्षा के नियम शामिल हैं).
Cloud Firestore एम्युलेटर को इस्तेमाल करने के लिए, आपको कुछ ही चरण पूरे करने होंगे:
- एम्युलेटर से कनेक्ट करने के लिए, अपने ऐप्लिकेशन के टेस्ट कॉन्फ़िगरेशन में कोड की एक लाइन जोड़ना.
- आपकी लोकल प्रोजेक्ट डायरेक्ट्री के रूट से,
firebase emulators:start
पर चल रहा है. - Cloud Firestore प्लैटफ़ॉर्म का इस्तेमाल करके, अपने ऐप्लिकेशन के प्रोटोटाइप कोड से कॉल करना हमेशा की तरह SDK टूल.
Cloud Firestore और Cloud Functions से जुड़े सिलसिलेवार निर्देश उपलब्ध हैं. आपको Local Emulator Suite के बारे में जानकारी भी देखनी चाहिए.
Cloud Firestore शुरू करें
Cloud Firestore का इंस्टेंस शुरू करना:
Web
import { initializeApp } from "firebase/app"; import { getFirestore } from "firebase/firestore"; // TODO: Replace the following with your app's Firebase project configuration // See: https://support.google.com/firebase/answer/7015592 const firebaseConfig = { FIREBASE_CONFIGURATION }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Cloud Firestore and get a reference to the service const db = getFirestore(app);
FIREBASE_CONFIGURATION को अपने वेब ऐप्लिकेशन के साथ बदलें
firebaseConfig
.
डिवाइस का कनेक्शन बंद होने पर डेटा सेव रखने के लिए, ऑफ़लाइन डेटा चालू करें का दस्तावेज़ देखें.
Web
import firebase from "firebase/app"; import "firebase/firestore"; // TODO: Replace the following with your app's Firebase project configuration // See: https://support.google.com/firebase/answer/7015592 const firebaseConfig = { FIREBASE_CONFIGURATION }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Cloud Firestore and get a reference to the service const db = firebase.firestore();
FIREBASE_CONFIGURATION को अपने वेब ऐप्लिकेशन के साथ बदलें
firebaseConfig
.
डिवाइस का कनेक्शन बंद होने पर डेटा सेव रखने के लिए, ऑफ़लाइन डेटा चालू करें का दस्तावेज़ देखें.
Swift
import FirebaseCore import FirebaseFirestore
FirebaseApp.configure() let db = Firestore.firestore()
Objective-C
@import FirebaseCore; @import FirebaseFirestore; // Use Firebase library to configure APIs [FIRApp configure];
FIRFirestore *defaultFirestore = [FIRFirestore firestore];
Kotlin+KTX
// Access a Cloud Firestore instance from your Activity
val db = Firebase.firestore
Java
// Access a Cloud Firestore instance from your Activity
FirebaseFirestore db = FirebaseFirestore.getInstance();
Dart
db = FirebaseFirestore.instance;
Java
Cloud Firestore SDK टूल को अलग-अलग तरीकों से शुरू किया जाता है. यह इन पर निर्भर करता है आपके आस-पास का माहौल शामिल है. यहां सबसे आम तरीके दिए गए हैं. पूरी जानकारी के लिए, देखें शुरू करें एडमिन SDK.import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use the application default credentials GoogleCredentials credentials = GoogleCredentials.getApplicationDefault(); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .setProjectId(projectId) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
अपने सर्वर पर Firebase एडमिन SDK का इस्तेमाल करने के लिए, सेवा खाता शामिल नहीं है.
इस पर जाएं आईएएम और एडमिन > सेवा खाते खोलें. नया निजी पासकोड जनरेट करें और JSON को सेव करें फ़ाइल से लिए जाते हैं. इसके बाद, SDK टूल शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import com.google.auth.oauth2.GoogleCredentials; import com.google.cloud.firestore.Firestore; import com.google.firebase.FirebaseApp; import com.google.firebase.FirebaseOptions; // Use a service account InputStream serviceAccount = new FileInputStream("path/to/serviceAccount.json"); GoogleCredentials credentials = GoogleCredentials.fromStream(serviceAccount); FirebaseOptions options = new FirebaseOptions.Builder() .setCredentials(credentials) .build(); FirebaseApp.initializeApp(options); Firestore db = FirestoreClient.getFirestore();
Python
Cloud Firestore SDK टूल को अलग-अलग तरीकों से शुरू किया जाता है. यह इन पर निर्भर करता है आपके आस-पास का माहौल शामिल है. यहां सबसे आम तरीके दिए गए हैं. पूरी जानकारी के लिए, देखें शुरू करें एडमिन SDK.import firebase_admin from firebase_admin import firestore # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore.client()
SDK टूल शुरू करने के लिए, किसी मौजूदा ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का भी इस्तेमाल किया जा सकता है.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore.client()
अपने सर्वर पर Firebase एडमिन SDK का इस्तेमाल करने के लिए, सेवा खाता शामिल नहीं है.
इस पर जाएं आईएएम और एडमिन > सेवा खाते खोलें. नया निजी पासकोड जनरेट करें और JSON को सेव करें फ़ाइल से लिए जाते हैं. इसके बाद, SDK टूल शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore.client()
Python
Cloud Firestore SDK टूल को अलग-अलग तरीकों से शुरू किया जाता है. यह इन पर निर्भर करता है आपके आस-पास का माहौल शामिल है. यहां सबसे आम तरीके दिए गए हैं. पूरी जानकारी के लिए, देखें शुरू करें एडमिन SDK.import firebase_admin from firebase_admin import firestore_async # Application Default credentials are automatically created. app = firebase_admin.initialize_app() db = firestore_async.client()
SDK टूल शुरू करने के लिए, किसी मौजूदा ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल का भी इस्तेमाल किया जा सकता है.
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use the application default credentials. cred = credentials.ApplicationDefault() firebase_admin.initialize_app(cred) db = firestore_async.client()
अपने सर्वर पर Firebase एडमिन SDK का इस्तेमाल करने के लिए, सेवा खाता शामिल नहीं है.
इस पर जाएं आईएएम और एडमिन > सेवा खाते खोलें. नया निजी पासकोड जनरेट करें और JSON को सेव करें फ़ाइल से लिए जाते हैं. इसके बाद, SDK टूल शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import firebase_admin from firebase_admin import credentials from firebase_admin import firestore_async # Use a service account. cred = credentials.Certificate('path/to/serviceAccount.json') app = firebase_admin.initialize_app(cred) db = firestore_async.client()
C++
// Make sure the call to `Create()` happens some time before you call Firestore::GetInstance(). App::Create(); Firestore* db = Firestore::GetInstance();
Node.js
Cloud Firestore SDK टूल को अलग-अलग तरीकों से शुरू किया जाता है. यह इन पर निर्भर करता है आपके आस-पास का माहौल शामिल है. यहां सबसे आम तरीके दिए गए हैं. पूरी जानकारी के लिए, देखें शुरू करें एडमिन SDK.-
Cloud Functions को शुरू करें
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp(); const db = getFirestore();
-
Google Cloud को शुरू करें
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
initializeApp({ credential: applicationDefault() }); const db = getFirestore();
-
अपने सर्वर पर शुरू करना
अपने सर्वर (या किसी दूसरे Node.js एनवायरमेंट) पर Firebase एडमिन SDK टूल का इस्तेमाल करने के लिए, सेवा खाते का इस्तेमाल करें. IAM और एडमिन > Google Cloud Console में सेवा खाते. नई निजी कुंजी जनरेट करें और JSON फ़ाइल सेव करें. इसके बाद, SDK टूल शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
const { initializeApp, applicationDefault, cert } = require('firebase-admin/app'); const { getFirestore, Timestamp, FieldValue, Filter } = require('firebase-admin/firestore');
const serviceAccount = require('./path/to/serviceAccountKey.json'); initializeApp({ credential: cert(serviceAccount) }); const db = getFirestore();
शुरू करें
Cloud Firestore SDK टूल को अलग-अलग तरीकों से शुरू किया जाता है. यह इन पर निर्भर करता है आपके आस-पास का माहौल शामिल है. यहां सबसे आम तरीके दिए गए हैं. पूरी जानकारी के लिए, देखें शुरू करें एडमिन SDK.import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use the application default credentials ctx := context.Background() conf := &firebase.Config{ProjectID: projectID} app, err := firebase.NewApp(ctx, conf) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
अपने सर्वर पर Firebase एडमिन SDK का इस्तेमाल करने के लिए, सेवा खाता शामिल नहीं है.
इस पर जाएं आईएएम और एडमिन > सेवा खाते खोलें. नया निजी पासकोड जनरेट करें और JSON को सेव करें फ़ाइल से लिए जाते हैं. इसके बाद, SDK टूल शुरू करने के लिए फ़ाइल का इस्तेमाल करें:
import ( "log" firebase "firebase.google.com/go" "google.golang.org/api/option" ) // Use a service account ctx := context.Background() sa := option.WithCredentialsFile("path/to/serviceAccount.json") app, err := firebase.NewApp(ctx, nil, sa) if err != nil { log.Fatalln(err) } client, err := app.Firestore(ctx) if err != nil { log.Fatalln(err) } defer client.Close()
PHP
PHP
Cloud Firestore क्लाइंट बनाने और इंस्टॉल करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Cloud Firestore क्लाइंट लाइब्रेरी.
Unity
using Firebase.Firestore; using Firebase.Extensions;
FirebaseFirestore db = FirebaseFirestore.DefaultInstance;
C#
C#
Cloud Firestore क्लाइंट बनाने और इंस्टॉल करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Cloud Firestore क्लाइंट लाइब्रेरी.
Ruby
डेटा जोड़ें
Cloud Firestore, कलेक्शन में सेव किए गए दस्तावेज़ों में डेटा सेव करता है. Cloud Firestore, सीधे तौर पर कलेक्शन और दस्तावेज़ बनाता है पहली बार दस्तावेज़ में डेटा जोड़ते समय. आपको साफ़ तौर पर ऐसा करने की ज़रूरत नहीं है संग्रह या दस्तावेज़ बनाने के लिए.
नीचे दिए गए उदाहरण कोड का इस्तेमाल करके, नया कलेक्शन और दस्तावेज़ बनाएं.
Web
import { collection, addDoc } from "firebase/firestore"; try { const docRef = await addDoc(collection(db, "users"), { first: "Ada", last: "Lovelace", born: 1815 }); console.log("Document written with ID: ", docRef.id); } catch (e) { console.error("Error adding document: ", e); }
Web
db.collection("users").add({ first: "Ada", last: "Lovelace", born: 1815 }) .then((docRef) => { console.log("Document written with ID: ", docRef.id); }) .catch((error) => { console.error("Error adding document: ", error); });
Swift
// Add a new document with a generated ID do { let ref = try await db.collection("users").addDocument(data: [ "first": "Ada", "last": "Lovelace", "born": 1815 ]) print("Document added with ID: \(ref.documentID)") } catch { print("Error adding document: \(error)") }
Objective-C
// Add a new document with a generated ID __block FIRDocumentReference *ref = [[self.db collectionWithPath:@"users"] addDocumentWithData:@{ @"first": @"Ada", @"last": @"Lovelace", @"born": @1815 } completion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error adding document: %@", error); } else { NSLog(@"Document added with ID: %@", ref.documentID); } }];
Kotlin+KTX
// Create a new user with a first and last name val user = hashMapOf( "first" to "Ada", "last" to "Lovelace", "born" to 1815, ) // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener { documentReference -> Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}") } .addOnFailureListener { e -> Log.w(TAG, "Error adding document", e) }
Java
// Create a new user with a first and last name Map<String, Object> user = new HashMap<>(); user.put("first", "Ada"); user.put("last", "Lovelace"); user.put("born", 1815); // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener(new OnSuccessListener<DocumentReference>() { @Override public void onSuccess(DocumentReference documentReference) { Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId()); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "Error adding document", e); } });
Dart
// Create a new user with a first and last name final user = <String, dynamic>{ "first": "Ada", "last": "Lovelace", "born": 1815 }; // Add a new document with a generated ID db.collection("users").add(user).then((DocumentReference doc) => print('DocumentSnapshot added with ID: ${doc.id}'));
Java
Python
Python
C++
// Add a new document with a generated ID Future<DocumentReference> user_ref = db->Collection("users").Add({{"first", FieldValue::String("Ada")}, {"last", FieldValue::String("Lovelace")}, {"born", FieldValue::Integer(1815)}}); user_ref.OnCompletion([](const Future<DocumentReference>& future) { if (future.error() == Error::kErrorOk) { std::cout << "DocumentSnapshot added with ID: " << future.result()->id() << std::endl; } else { std::cout << "Error adding document: " << future.error_message() << std::endl; } });
Node.js
शुरू करें
PHP
PHP
Cloud Firestore क्लाइंट बनाने और इंस्टॉल करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Cloud Firestore क्लाइंट लाइब्रेरी.
Unity
DocumentReference docRef = db.Collection("users").Document("alovelace"); Dictionary<string, object> user = new Dictionary<string, object> { { "First", "Ada" }, { "Last", "Lovelace" }, { "Born", 1815 }, }; docRef.SetAsync(user).ContinueWithOnMainThread(task => { Debug.Log("Added data to the alovelace document in the users collection."); });
C#
Ruby
अब users
संग्रह में एक और दस्तावेज़ जोड़ें. ध्यान दें कि इस दस्तावेज़
में ऐसा की-वैल्यू पेयर (बीच का नाम) शामिल है जो पहले
दस्तावेज़. कलेक्शन के दस्तावेज़ों में जानकारी के अलग-अलग सेट हो सकते हैं.
Web
// Add a second document with a generated ID. import { addDoc, collection } from "firebase/firestore"; try { const docRef = await addDoc(collection(db, "users"), { first: "Alan", middle: "Mathison", last: "Turing", born: 1912 }); console.log("Document written with ID: ", docRef.id); } catch (e) { console.error("Error adding document: ", e); }
Web
// Add a second document with a generated ID. db.collection("users").add({ first: "Alan", middle: "Mathison", last: "Turing", born: 1912 }) .then((docRef) => { console.log("Document written with ID: ", docRef.id); }) .catch((error) => { console.error("Error adding document: ", error); });
Swift
// Add a second document with a generated ID. do { let ref = try await db.collection("users").addDocument(data: [ "first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912 ]) print("Document added with ID: \(ref.documentID)") } catch { print("Error adding document: \(error)") }
Objective-C
// Add a second document with a generated ID. __block FIRDocumentReference *ref = [[self.db collectionWithPath:@"users"] addDocumentWithData:@{ @"first": @"Alan", @"middle": @"Mathison", @"last": @"Turing", @"born": @1912 } completion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error adding document: %@", error); } else { NSLog(@"Document added with ID: %@", ref.documentID); } }];
Kotlin+KTX
// Create a new user with a first, middle, and last name val user = hashMapOf( "first" to "Alan", "middle" to "Mathison", "last" to "Turing", "born" to 1912, ) // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener { documentReference -> Log.d(TAG, "DocumentSnapshot added with ID: ${documentReference.id}") } .addOnFailureListener { e -> Log.w(TAG, "Error adding document", e) }
Java
// Create a new user with a first, middle, and last name Map<String, Object> user = new HashMap<>(); user.put("first", "Alan"); user.put("middle", "Mathison"); user.put("last", "Turing"); user.put("born", 1912); // Add a new document with a generated ID db.collection("users") .add(user) .addOnSuccessListener(new OnSuccessListener<DocumentReference>() { @Override public void onSuccess(DocumentReference documentReference) { Log.d(TAG, "DocumentSnapshot added with ID: " + documentReference.getId()); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "Error adding document", e); } });
Dart
// Create a new user with a first and last name final user = <String, dynamic>{ "first": "Alan", "middle": "Mathison", "last": "Turing", "born": 1912 }; // Add a new document with a generated ID db.collection("users").add(user).then((DocumentReference doc) => print('DocumentSnapshot added with ID: ${doc.id}'));
Java
Python
Python
C++
db->Collection("users") .Add({{"first", FieldValue::String("Alan")}, {"middle", FieldValue::String("Mathison")}, {"last", FieldValue::String("Turing")}, {"born", FieldValue::Integer(1912)}}) .OnCompletion([](const Future<DocumentReference>& future) { if (future.error() == Error::kErrorOk) { std::cout << "DocumentSnapshot added with ID: " << future.result()->id() << std::endl; } else { std::cout << "Error adding document: " << future.error_message() << std::endl; } });
Node.js
शुरू करें
PHP
PHP
Cloud Firestore क्लाइंट बनाने और इंस्टॉल करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Cloud Firestore क्लाइंट लाइब्रेरी.
Unity
DocumentReference docRef = db.Collection("users").Document("aturing"); Dictionary<string, object> user = new Dictionary<string, object> { { "First", "Alan" }, { "Middle", "Mathison" }, { "Last", "Turing" }, { "Born", 1912 } }; docRef.SetAsync(user).ContinueWithOnMainThread(task => { Debug.Log("Added data to the aturing document in the users collection."); });
C#
Ruby
डेटा पढ़ें
डेटा का इस्तेमाल करना में दर्शक के तौर पर Firebase कंसोल का इस्तेमाल करके, फटाफट इस बात की पुष्टि की जा सकती है कि आपने Cloud Firestore में डेटा जोड़ा है या नहीं.
आप "get" शब्द का भी इस्तेमाल कर सकते हैं का इस्तेमाल करके, पूरे कलेक्शन को वापस पाया जा सकता है.
Web
import { collection, getDocs } from "firebase/firestore"; const querySnapshot = await getDocs(collection(db, "users")); querySnapshot.forEach((doc) => { console.log(`${doc.id} => ${doc.data()}`); });
Web
db.collection("users").get().then((querySnapshot) => { querySnapshot.forEach((doc) => { console.log(`${doc.id} => ${doc.data()}`); }); });
Swift
do { let snapshot = try await db.collection("users").getDocuments() for document in snapshot.documents { print("\(document.documentID) => \(document.data())") } } catch { print("Error getting documents: \(error)") }
Objective-C
[[self.db collectionWithPath:@"users"] getDocumentsWithCompletion:^(FIRQuerySnapshot * _Nullable snapshot, NSError * _Nullable error) { if (error != nil) { NSLog(@"Error getting documents: %@", error); } else { for (FIRDocumentSnapshot *document in snapshot.documents) { NSLog(@"%@ => %@", document.documentID, document.data); } } }];
Kotlin+KTX
db.collection("users") .get() .addOnSuccessListener { result -> for (document in result) { Log.d(TAG, "${document.id} => ${document.data}") } } .addOnFailureListener { exception -> Log.w(TAG, "Error getting documents.", exception) }
Java
db.collection("users") .get() .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() { @Override public void onComplete(@NonNull Task<QuerySnapshot> task) { if (task.isSuccessful()) { for (QueryDocumentSnapshot document : task.getResult()) { Log.d(TAG, document.getId() + " => " + document.getData()); } } else { Log.w(TAG, "Error getting documents.", task.getException()); } } });
Dart
await db.collection("users").get().then((event) { for (var doc in event.docs) { print("${doc.id} => ${doc.data()}"); } });
Java
Python
users_ref = db.collection("users") docs = users_ref.stream() for doc in docs: print(f"{doc.id} => {doc.to_dict()}")
Python
C++
Future<QuerySnapshot> users = db->Collection("users").Get(); users.OnCompletion([](const Future<QuerySnapshot>& future) { if (future.error() == Error::kErrorOk) { for (const DocumentSnapshot& document : future.result()->documents()) { std::cout << document << std::endl; } } else { std::cout << "Error getting documents: " << future.error_message() << std::endl; } });
Node.js
शुरू करें
PHP
PHP
Cloud Firestore क्लाइंट बनाने और इंस्टॉल करने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें Cloud Firestore क्लाइंट लाइब्रेरी.
Unity
CollectionReference usersRef = db.Collection("users"); usersRef.GetSnapshotAsync().ContinueWithOnMainThread(task => { QuerySnapshot snapshot = task.Result; foreach (DocumentSnapshot document in snapshot.Documents) { Debug.Log(String.Format("User: {0}", document.Id)); Dictionary<string, object> documentDictionary = document.ToDictionary(); Debug.Log(String.Format("First: {0}", documentDictionary["First"])); if (documentDictionary.ContainsKey("Middle")) { Debug.Log(String.Format("Middle: {0}", documentDictionary["Middle"])); } Debug.Log(String.Format("Last: {0}", documentDictionary["Last"])); Debug.Log(String.Format("Born: {0}", documentDictionary["Born"])); } Debug.Log("Read all data from the users collection."); });
C#
Ruby
अपना डेटा सुरक्षित रखें
अगर आपने वेब, Android या Apple प्लैटफ़ॉर्म SDK टूल का इस्तेमाल किया है, तो Firebase का इस्तेमाल करें पुष्टि करना और Cloud Firestore Security Rules में अपने डेटा को सुरक्षित रखें Cloud Firestore.
यहां कुछ बुनियादी नियम सेट दिए गए हैं, जिनका इस्तेमाल करके शुरुआत की जा सकती है. आप नियमों के सुरक्षा नियमों टैब में से कंसोल.
अनुमति देना ज़रूरी है
// Allow read/write access to a document keyed by the user's UID
service cloud.firestore {
match /databases/{database}/documents {
match /users/{uid} {
allow read, write: if request.auth != null && request.auth.uid == uid;
}
}
}
लॉक मोड
// Deny read/write access to all users under any conditions
service cloud.firestore {
match /databases/{database}/documents {
match /{document=**} {
allow read, write: if false;
}
}
}
अपने वेब, Android या iOS ऐप्लिकेशन को प्रोडक्शन में डिप्लॉय करने से पहले, यह भी ध्यान रखें कि ताकि यह पक्का किया जा सके कि सिर्फ़ आपके ऐप्लिकेशन क्लाइंट ही आपके Cloud Firestore का डेटा ऐक्सेस कर सकें. ऐप्लिकेशन जांच दस्तावेज़ देखें.
अगर किसी सर्वर SDK टूल का इस्तेमाल किया जा रहा है, तो पहचान और ऐक्सेस मैनेजमेंट की सुविधा का इस्तेमाल करें (IAM): अपना डेटा सुरक्षित रखें Cloud Firestore में.
वीडियो ट्यूटोरियल देखें
Cloud Firestore का इस्तेमाल शुरू करने के बारे में ज़्यादा जानकारी के लिए मोबाइल क्लाइंट लाइब्रेरी में उपलब्ध है, तो निम्न में से कोई एक वीडियो ट्यूटोरियल देखें:
वेब
iOS और उसके बाद के वर्शन
Android
Firebase में जाकर और भी वीडियो देखे जा सकते हैं YouTube चैनल.
अगले चरण
इन विषयों के बारे में बेहतर जानकारी पाएं:
- Codelabs — Cloud Firestore को असल ऐप्लिकेशन में इस्तेमाल करने का तरीका जानें Android, iOS के लिए कोडलैब का इस्तेमाल करके या वेब.
- डेटा मॉडल — डेटा कैसे काम करता है, इसके बारे में ज़्यादा जानें Cloud Firestore में स्ट्रक्चर्ड डेटा. इसमें हैरारकी के हिसाब से डेटा और सब-कलेक्शन भी शामिल हैं.
- डेटा जोड़ें — Cloud Firestore में डेटा बनाने और उसे अपडेट करने के बारे में ज़्यादा जानें.
- डेटा पाएं — डेटा वापस पाने के तरीके के बारे में ज़्यादा जानें डेटा शामिल है.
- आसान और कंपाउंड क्वेरी करना — आसान और कंपाउंड क्वेरी चलाने का तरीका जानें.
- ऑर्डर और क्वेरी को सीमित करना ऑर्डर करने का तरीका जानें और अपनी क्वेरी से मिलने वाले डेटा को सीमित करें.