इस पेज पर, Firebase प्रोजेक्ट से जुड़े कई अहम कॉन्सेप्ट के बारे में खास जानकारी दी गई है. सुविधाओं, सेवाओं, टूल, और सबसे सही तरीकों के बारे में ज़्यादा जानकारी पाने के लिए, उपलब्ध होने पर लिंक पर जाएं.
Firebase प्रोजेक्ट, ऐप्लिकेशन, और प्रॉडक्ट के बीच संबंध
Firebase प्रोजेक्ट, Firebase के लिए टॉप-लेवल की इकाई है. किसी प्रोजेक्ट में, Apple, Android या वेब ऐप्लिकेशन रजिस्टर किए जा सकते हैं. Firebase में अपने ऐप्लिकेशन रजिस्टर करने के बाद, Firebase के किसी भी प्रॉडक्ट के लिए Firebase SDK टूल जोड़े जा सकते हैं. जैसे, Analytics, Cloud Firestore, Performance Monitoring या Remote Config.
इस प्रोसेस के बारे में ज़्यादा जानकारी पाने के लिए, अपने प्लैटफ़ॉर्म के लिए शुरुआती निर्देश वाली गाइड देखें:
iOS+ | Android |
वेब | Unity | C++ |
Flutter.
Firebase प्रोजेक्ट की हैरारकी को समझना
इस डायग्राम में, Firebase प्रोजेक्ट की बुनियादी हैरारकी दिखाई गई है. यहां मुख्य संबंधों के बारे में बताया गया है:
Firebase प्रोजेक्ट, आपके सभी ऐप्लिकेशन और प्रोजेक्ट के लिए उपलब्ध कराए गए किसी भी संसाधन और सेवा के लिए, एक कंटेनर की तरह होता है.
किसी Firebase प्रोजेक्ट में एक या उससे ज़्यादा Firebase ऐप्लिकेशन रजिस्टर किए जा सकते हैं. उदाहरण के लिए, किसी ऐप्लिकेशन के iOS और Android, दोनों वर्शन या किसी ऐप्लिकेशन के मुफ़्त और पैसे चुकाकर लिए जाने वाले, दोनों वर्शन.
एक ही Firebase प्रोजेक्ट में रजिस्टर किए गए सभी Firebase ऐप्लिकेशन, प्रोजेक्ट के लिए उपलब्ध कराए गए सभी संसाधनों और सेवाओं को शेयर करते हैं और उन्हें ऐक्सेस कर सकते हैं. यहां कुछ उदाहरण दिए गए हैं:
एक ही Firebase प्रोजेक्ट में रजिस्टर किए गए सभी Firebase ऐप्लिकेशन, एक ही बैकएंड शेयर करते हैं. जैसे, Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage, और Cloud Functions.
एक ही Firebase प्रोजेक्ट में रजिस्टर किए गए सभी Firebase ऐप्लिकेशन, एक ही Google Analytics प्रॉपर्टी से जुड़े होते हैं. इस प्रॉपर्टी में, हर Firebase ऐप्लिकेशन एक अलग डेटा स्ट्रीम होता है.
Firebase प्रोजेक्ट और Google Cloud के बीच संबंध
नया Firebase प्रोजेक्ट बनाने का मतलब है कि आपने पर्दे के पीछे एक Google Cloud प्रोजेक्ट बनाया है. पहले Google Cloud प्रोजेक्ट बनाकर, बाद में उसमें Firebase को जोड़ा जा सकता है. Google Cloud प्रोजेक्ट को डेटा, कोड, कॉन्फ़िगरेशन, और सेवाओं के लिए एक वर्चुअल कंटेनर माना जा सकता है.
ध्यान दें कि Firebase के सभी प्रोजेक्ट के लिए, Firebase आपके प्रोजेक्ट में firebase:enabled का लेबल अपने-आप जोड़ देता है. यह लेबल, Google Cloud कंसोल के IAM और एडमिन > लेबल पेज पर दिखता है. इस लेबल के बारे में ज़्यादा जानने के लिए, अक्सर पूछे जाने वाले सवाल देखें.
Firebase प्रोजेक्ट, Google Cloud प्रोजेक्ट होता है:
प्रोजेक्ट को Firebase कंसोल के साथ-साथ, Google Cloud कंसोल और Google APIs कंसोल में ऐक्सेस और इस्तेमाल किया जा सकता है.
Firebase सीएलआई, gcloud CLI, और Google के किसी भी Terraform रिसॉर्स का इस्तेमाल करके, प्रोजेक्ट के साथ इंटरैक्ट किया जा सकता है.
प्रोजेक्ट में, Firebase और Google Cloud, दोनों के प्रॉडक्ट और एपीआई इस्तेमाल किए जा सकते हैं.
प्रोजेक्ट के लिए IAM अनुमतियां और भूमिकाएं, Firebase और Google Cloud के बीच शेयर की जाती हैं. प्रोजेक्ट के किसी सदस्य (यानी कि प्रिंसिपल) के पास आपके Google Cloud प्रोजेक्ट का जो भी ऐक्सेस होगा वह आपके Firebase प्रोजेक्ट पर भी लागू होगा. इसके उलट, Firebase प्रोजेक्ट का ऐक्सेस भी प्रोजेक्ट पर लागू होगा.
प्रोजेक्ट की बिलिंग, Firebase और Google Cloud के बीच शेयर की जाती है. अगर आपके Google Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू है, तो आपका Firebase प्रोजेक्ट, Firebase के इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर होगा.
प्रोजेक्ट के यूनीक आइडेंटिफ़ायर (जैसे, प्रोजेक्ट नंबर और प्रोजेक्ट आईडी), Firebase और Google Cloud के बीच शेयर किए जाते हैं.
आपके Google Cloud प्रोजेक्ट पर लागू की गई कोई भी संसाधन की हैरारकी (उदाहरण के लिए, संगठन, फ़ोल्डर वगैरह) आपके Firebase प्रोजेक्ट पर भी लागू होगी.
प्रोजेक्ट को मिटाने पर, वह Firebase और Google Cloud, दोनों से मिट जाता है.
प्रोजेक्ट में मौजूद किसी संसाधन या डेटा को मिटाने या उसमें बदलाव करने पर, वह बदलाव Firebase और Google Cloud, दोनों पर लागू होता है.
Firebase प्रोजेक्ट सेट अप करना और ऐप्लिकेशन रजिस्टर करना
Firebase कंसोल में जाकर, Firebase प्रोजेक्ट सेट अप किया जा सकता है और ऐप्लिकेशन रजिस्टर किए जा सकते हैं. इसके अलावा, बेहतर इस्तेमाल के उदाहरणों के लिए, Firebase Management REST API या Firebase सीएलआई का इस्तेमाल किया जा सकता है. प्रोजेक्ट सेट अप करने और ऐप्लिकेशन रजिस्टर करने के बाद, आपको संगठन से जुड़े कुछ फ़ैसले लेने होंगे. साथ ही, अपने लोकल प्रोजेक्ट में Firebase के हिसाब से कॉन्फ़िगरेशन की जानकारी जोड़नी होगी.
प्रोडक्शन ऐप्लिकेशन के लिए, आपको एक साफ़ डेवलपमेंट वर्कफ़्लो सेट अप करना होगा. इसमें आम तौर पर, कई एनवायरमेंट का इस्तेमाल करना शामिल होता है. डेवलपमेंट वर्कफ़्लो बनाने के लिए, Firebase प्रोजेक्ट सेट अप करने और ऐप्लिकेशन रजिस्टर करने के बारे में जानकारी देने वाला हमारा दस्तावेज़ देखें. इसमें डेवलपर वर्कफ़्लो, सबसे सही तरीके, और सुरक्षा से जुड़े दिशा-निर्देश शामिल हैं.
Firebase प्रोजेक्ट के साथ इंटरैक्ट करना
प्रॉडक्ट के एसडीके के अलावा, कई अलग-अलग टूल और इंटरफ़ेस का इस्तेमाल करके, सीधे तौर पर Firebase प्रोजेक्ट के साथ इंटरैक्ट किया जा सकता है.
Firebase console
Firebase कंसोल, Firebase के प्रॉडक्ट, ऐप्लिकेशन, और प्रोजेक्ट-लेवल की सेटिंग को मैनेज करने के लिए सबसे बेहतर प्लैटफ़ॉर्म है.
कंसोल के बाईं ओर मौजूद पैनल में, Firebase के प्रॉडक्ट की सूची होती है. इन्हें टॉप-लेवल की कैटगरी के हिसाब से व्यवस्थित किया जाता है. किसी प्रोजेक्ट की सेटिंग ऐक्सेस करने के लिए, बाईं ओर मौजूद पैनल में सबसे ऊपर,
कंसोल के बीच में, अलग-अलग तरह के ऐप्लिकेशन रजिस्टर करने के लिए, सेटअप वर्कफ़्लो लॉन्च करने वाले बटन दिखते हैं. Firebase का इस्तेमाल शुरू करने के बाद, कंसोल का मुख्य हिस्सा एक डैशबोर्ड में बदल जाता है. इसमें, आपके इस्तेमाल किए जाने वाले प्रॉडक्ट के आंकड़े दिखते हैं.
ध्यान दें कि Firebase प्रोजेक्ट भी एक Google Cloud प्रोजेक्ट होता है. इसलिए, आपको कई टास्क या प्रॉडक्ट के लिए, Firebase कंसोल के बजाय Google Cloud कंसोल का इस्तेमाल करना पड़ सकता है.
Firebase सीएलआई (एक कमांड लाइन टूल)
Firebase, Firebase सीएलआई भी उपलब्ध कराता है. इसकी मदद से, Firebase के कुछ प्रॉडक्ट को कॉन्फ़िगर और मैनेज किया जा सकता है. जैसे, Firebase Hosting, Cloud Functions for Firebase, और Firebase Extensions.
Firebase सीएलआई इंस्टॉल करने के बाद, आपके पास global firebase कमांड का ऐक्सेस होता है. Firebase सीएलआई का इस्तेमाल करके, अपनी लोकल ऐप्लिकेशन डायरेक्ट्री को किसी Firebase प्रोजेक्ट से लिंक करें. इसके बाद, Firebase पर होस्ट किए गए कॉन्टेंट के नए वर्शन या फ़ंक्शन के अपडेट डिप्लॉय करें.
Firebase Management REST API
Firebase Management REST API का इस्तेमाल करके, Firebase प्रोजेक्ट को प्रोग्राम के हिसाब से मैनेज किया जा सकता है. उदाहरण के लिए, प्रोग्राम के हिसाब से किसी ऐप्लिकेशन को प्रोजेक्ट के साथ रजिस्टर किया जा सकता है या पहले से रजिस्टर किए गए ऐप्लिकेशन की सूची बनाई जा सकती है (iOS+ | Android | वेब).
Firebase प्रोजेक्ट आइडेंटिफ़ायर
Firebase प्रोजेक्ट की पहचान, Firebase बैकएंड और अलग-अलग डेवलपर इंटरफ़ेस में की जा सकती है. इसके लिए, अलग-अलग आइडेंटिफ़ायर का इस्तेमाल किया जाता है. इनमें प्रोजेक्ट का नाम, प्रोजेक्ट नंबर, और प्रोजेक्ट आईडी शामिल हैं.
प्रोजेक्ट का नाम
कोई प्रोजेक्ट बनाते समय, आपको प्रोजेक्ट का नाम देना होता है. यह आइडेंटिफ़ायर, Firebase कंसोल, Google Cloud कंसोल, और Firebase सीएलआई में मौजूद किसी प्रोजेक्ट का सिर्फ़ इंटरनल नाम होता है. प्रोजेक्ट का नाम, सार्वजनिक तौर पर दिखने वाले किसी भी Firebase या Google Cloud प्रॉडक्ट, सेवा या संसाधन में नहीं दिखता. इससे आपको कई प्रोजेक्ट के बीच आसानी से अंतर करने में मदद मिलती है.
Firebase कंसोल के
प्रोजेक्ट नंबर
किसी Firebase प्रोजेक्ट (और उससे जुड़े Google Cloud प्रोजेक्ट) का एक प्रोजेक्ट नंबर होता है. यह प्रोजेक्ट के लिए, Google की ओर से असाइन किया गया दुनिया भर में इस्तेमाल होने वाला यूनीक कैननिकल आइडेंटिफ़ायर है. Firebase, Google या तीसरे पक्ष की सेवाओं के साथ इंटिग्रेशन कॉन्फ़िगर करते समय और/या उन्हें एपीआई कॉल करते समय, इस आइडेंटिफ़ायर का इस्तेमाल करें.
प्रोजेक्ट नंबर में बदलाव नहीं किया जा सकता. किसी प्रोजेक्ट को मिटाने पर, उसका नंबर भी मिट जाता है. इसके बाद, उस नंबर का इस्तेमाल किसी दूसरे प्रोजेक्ट के लिए नहीं किया जा सकता.
प्रोजेक्ट आईडी
किसी Firebase प्रोजेक्ट (और उससे जुड़े Google Cloud प्रोजेक्ट) का एक प्रोजेक्ट आईडी होता है. यह प्रोजेक्ट के लिए, उपयोगकर्ता का तय किया गया यूनीक आइडेंटिफ़ायर है. इसका इस्तेमाल, Firebase और Google Cloud के सभी प्लैटफ़ॉर्म पर किया जाता है. जब कोई Firebase प्रोजेक्ट बनाया जाता है, तो Firebase उस प्रोजेक्ट को अपने-आप एक यूनीक आईडी असाइन कर देता है. हालांकि, प्रोजेक्ट सेटअप के दौरान उसमें बदलाव किया जा सकता है. आम तौर पर, इस आइडेंटिफ़ायर को प्रोजेक्ट के रेफ़रंस के तौर पर इस्तेमाल किया जाना चाहिए.
Firebase की कॉन्फ़िगरेशन फ़ाइलें और ऑब्जेक्ट
किसी ऐप्लिकेशन को Firebase प्रोजेक्ट के साथ रजिस्टर करने पर, Firebase कंसोल, Firebase कॉन्फ़िगरेशन फ़ाइल (Apple/Android ऐप्लिकेशन) या कॉन्फ़िगरेशन ऑब्जेक्ट (वेब ऐप्लिकेशन) उपलब्ध कराता है. इसे सीधे तौर पर अपनी लोकल ऐप्लिकेशन डायरेक्ट्री में जोड़ा जा सकता है.
- Apple ऐप्लिकेशन के लिए, आपको
GoogleService-Info.plistकॉन्फ़िगरेशन फ़ाइल जोड़नी होगी. - Android ऐप्लिकेशन के लिए,
google-services.jsonकॉन्फ़िगरेशन फ़ाइल जोड़ी जाती है. - वेब ऐप्लिकेशन के लिए, Firebase कॉन्फ़िगरेशन ऑब्जेक्ट जोड़ा जाता है.
किसी भी समय, ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट को हासिल किया जा सकता है.
Firebase की कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट, किसी ऐप्लिकेशन को किसी खास Firebase प्रोजेक्ट और उसके संसाधनों (डेटाबेस, स्टोरेज बकेट वगैरह) से जोड़ता है. कॉन्फ़िगरेशन में "Firebase के विकल्प" शामिल होते हैं. ये ऐसे पैरामीटर होते हैं जिनकी ज़रूरत Firebase और Google की सेवाओं को होती है. इनकी मदद से, Firebase सर्वर एपीआई के साथ कम्यूनिकेट किया जाता है. साथ ही, क्लाइंट डेटा को Firebase प्रोजेक्ट और Firebase ऐप्लिकेशन से जोड़ा जाता है.
यहां "Firebase के विकल्प" दिए गए हैं, जो ज़रूरी हैं:
Firebase एपीआई पासकोड: यह एक यूनीक स्ट्रिंग होती है. इसका इस्तेमाल, आपके Firebase प्रोजेक्ट पर अनुरोधों को रूट करने के लिए किया जाता है. इस एपीआई पासकोड का इस्तेमाल, सिर्फ़ Firebase से जुड़े एपीआई के लिए किया जाना चाहिए. (उदाहरण के लिए:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)Firebase प्रोजेक्ट आईडी: यह Firebase और Google Cloud के सभी प्रोजेक्ट के लिए, उपयोगकर्ता का तय किया गया यूनीक आइडेंटिफ़ायर होता है. यह आइडेंटिफ़ायर, Firebase के कुछ संसाधनों के यूआरएल या नामों में दिख सकता है. हालांकि, आम तौर पर इसे प्रोजेक्ट के रेफ़रंस के तौर पर इस्तेमाल किया जाना चाहिए. (उदाहरण के लिए:
myapp-project-123)Firebase ऐप्लिकेशन आईडी ("ऐप्लिकेशन आईडी"): यह Firebase ऐप्लिकेशन के लिए, दुनिया भर में इस्तेमाल होने वाला यूनीक आइडेंटिफ़ायर है. यह Firebase के सभी प्लैटफ़ॉर्म पर काम करता है. साथ ही, Google Cloud के लिए, प्लैटफ़ॉर्म के हिसाब से फ़ॉर्मैट में उपलब्ध होता है:
- Firebase Apple ऐप्लिकेशन:
GOOGLE_APP_ID(उदाहरण के लिए:1:1234567890:ios:321abc456def7890)
यह Apple बंडल आईडी नहीं है. - Firebase Android ऐप्लिकेशन:
mobilesdk_app_id(उदाहरण के लिए:1:1234567890:android:321abc456def7890)
यह Android पैकेज का नाम या Android ऐप्लिकेशन आईडी नहीं है. - Firebase वेब ऐप्लिकेशन:
appId(उदाहरण के लिए वैल्यू:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)
- Firebase Apple ऐप्लिकेशन:
Firebase कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट के कॉन्टेंट को सार्वजनिक माना जाता है. इसमें ऐप्लिकेशन का प्लैटफ़ॉर्म के हिसाब से आईडी (Apple बंडल आईडी या Android पैकेज का नाम) और Firebase प्रोजेक्ट के हिसाब से वैल्यू शामिल होती हैं. जैसे, एपीआई पासकोड, प्रोजेक्ट आईडी, Realtime Database यूआरएल, और Cloud Storage बकेट का नाम. इसलिए, Realtime Database, Cloud Firestore, और Cloud Storage में अपने डेटा और फ़ाइलों को सुरक्षित रखने के लिए, Firebase Security Rules का इस्तेमाल करें.
ओपन सोर्स प्रोजेक्ट के लिए, हम आम तौर पर सोर्स कंट्रोल में ऐप्लिकेशन की Firebase कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट को शामिल करने का सुझाव नहीं देते. ऐसा इसलिए, क्योंकि ज़्यादातर मामलों में उपयोगकर्ताओं को अपने Firebase प्रोजेक्ट बनाने चाहिए और अपने ऐप्लिकेशन को अपने Firebase संसाधनों पर ले जाना चाहिए. इसके लिए, उन्हें अपनी Firebase कॉन्फ़िगरेशन फ़ाइल या ऑब्जेक्ट का इस्तेमाल करना चाहिए.
Firebase प्रोजेक्ट, ऐप्लिकेशन, और साइटों के लिए सामान्य सीमाएं
Firebase प्रोजेक्ट, ऐप्लिकेशन, और साइटों के लिए कुछ सामान्य सीमाएं यहां दी गई हैं:
हर Google खाते (ईमेल पते) के लिए प्रोजेक्ट की संख्या
- स्पार्क प्लान: इस प्लान में प्रोजेक्ट बनाने का कोटा सीमित होता है. आम तौर पर, इसमें सिर्फ़ 5 से 10 प्रोजेक्ट बनाए जा सकते हैं.
- ब्लेज़ प्लान की बिलिंग की जानकारी: प्रोजेक्ट बनाने का कोटा अब भी सीमित है. हालांकि, अच्छी स्थिति वाले Cloud Billing खाते को लिंक करने पर, यह कोटा बढ़ सकता है.
प्रोजेक्ट बनाने के कोटे की सीमा के बारे में इन बातों का ध्यान रखें:
- यह सीमा सिर्फ़ Firebase के लिए नहीं है. प्रोजेक्ट कोटा पर Firebase की सीमाएं, Google Cloud की सीमाओं के जैसी ही हैं.
- अगर आपको कभी इसकी ज़रूरत पड़े, तो प्रोजेक्ट का कोटा बढ़ाने का अनुरोध किया जा सकता है.
- किसी प्रोजेक्ट को पूरी तरह से मिटाने में 30 दिन लगते हैं. जब तक प्रोजेक्ट पूरी तरह से मिट नहीं जाता, तब तक उसे प्रोजेक्ट कोटा में गिना जाता है.
Firebase के सुझाए गए Firebase प्रोजेक्ट सेट अप करने के सबसे सही तरीकों के बारे में जानें.
हर प्रोजेक्ट में ऐप्लिकेशन की संख्या
Firebase, किसी Firebase प्रोजेक्ट में Firebase ऐप्लिकेशन की कुल संख्या को 30 तक सीमित रखता है.
आपको यह पक्का करना चाहिए कि एक ही Firebase प्रोजेक्ट में मौजूद सभी Firebase ऐप्लिकेशन, असली उपयोगकर्ता के नज़रिए से एक ही ऐप्लिकेशन के प्लैटफ़ॉर्म वैरिएंट हों. सबसे सही तरीकों के बारे में बताने वाले हमारे दस्तावेज़ों में, मल्टी-टेनेंसी के बारे में ज़्यादा पढ़ें.
अक्सर पूछे जाने वाले सवालों में, हर प्रोजेक्ट के लिए ऐप्लिकेशन की सीमा के बारे में ज़्यादा जानें.
हर प्रोजेक्ट के लिए Hosting साइटों की संख्या
Firebase Hosting की मल्टीसाइट सुविधा का इस्तेमाल करके, हर प्रोजेक्ट में ज़्यादा से ज़्यादा 36 साइटें जोड़ी जा सकती हैं.
अपना ऐप्लिकेशन लॉन्च करना
- Google Cloud कंसोल में अपने प्रोजेक्ट के लिए, बजट से जुड़ी सूचनाएं सेट अप करें.
- Firebase कंसोल में इस्तेमाल और बिलिंग डैशबोर्ड पर नज़र रखें. इससे आपको Firebase की कई सेवाओं में, अपने प्रोजेक्ट के इस्तेमाल की पूरी जानकारी मिलेगी.
- Firebase लॉन्च चेकलिस्ट देखें.