Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

Google AI Studio ऐप्लिकेशन में Firebase जोड़ना

Google AI Studio में मौजूद बिल्ड मोड, Firebase की सेवाओं को आपके वेब और Android ऐप्लिकेशन में अपने-आप सेट अप और इंटिग्रेट कर सकता है:

Cloud Firestore और Firebase Authentication (वेब और Android ऐप्लिकेशन के लिए) का इस्तेमाल करके, ऐसे ऐप्लिकेशन बनाए जा सकते हैं जिनमें डेटा को लंबे समय तक सेव किया जा सकता है. साथ ही, सुरक्षित तरीके से लॉगिन किया जा सकता है.
Firebase AI Logic और Firebase App Check (Android ऐप्लिकेशन के लिए) का इस्तेमाल करके, Gemini के मॉडल को सीधे अपने मोबाइल ऐप्लिकेशन से सुरक्षित तरीके से कॉल करें. इसके लिए, एपीआई कुंजियां ज़ाहिर करने की ज़रूरत नहीं है.

सिर्फ़ एक प्रॉम्प्ट और कुछ क्लिक की मदद से, Google AI Studio एजेंट को Firebase प्रोजेक्ट सेट अप करने, अपने ऐप्लिकेशन को उस प्रोजेक्ट से कनेक्ट करने, और ज़रूरी Firebase कोड और कॉन्फ़िगरेशन फ़ाइलें सीधे आपके ऐप्लिकेशन में जनरेट करने की अनुमति दी जा सकती है.

Google AI Studio के दस्तावेज़ में, फ़ुल-स्टैक वेब ऐप्लिकेशन और Android ऐप्लिकेशन बनाने के बारे में ज़्यादा जानें.

खास जानकारी: अपने Google AI Studio ऐप्लिकेशन में बैकएंड जोड़ना

अपने आइडिया के बारे में बताएं: Google AI Studio में एक नया ऐप्लिकेशन बनाएं और ऐसी सुविधा के बारे में बताएं जिसके लिए डेटाबेस, पुष्टि करने की सुविधा या जनरेटिव एआई (Android ऐप्लिकेशन के लिए) की ज़रूरत हो. उदाहरण के लिए, इस तरह का प्रॉम्प्ट डाला जा सकता है:
- Build a shared to-do list app using Firebase as a backend.
- Build an Android recipe app that uses Firebase AI Logic to suggest meals from ingredients.
सलाह: बेहतर नतीजे पाने के लिए, एजेंट से साफ़ तौर पर कहें कि वह आपके ऐप्लिकेशन के लिए, Firebase (या Firebase AI Logic) का इस्तेमाल करे.
Firebase इंटिग्रेशन चालू करें: दिखने वाले कार्ड में, अपना सेटअप कॉन्फ़िगर करें:
1. प्रोजेक्ट या जगह की जानकारी को पसंद के मुताबिक बनाना (ज़रूरी नहीं): सेटिंग आइकॉन पर क्लिक करें. इसके बाद, कोई जगह या Google Cloud प्रोजेक्ट चुनें जिसे आपको इस्तेमाल करना है.
2. चुने गए विकल्प की पुष्टि करना: आगे बढ़ने के लिए, Firebase चालू करें बटन पर क्लिक करें.
इसके बाद, एजेंट आपके Firebase प्रोजेक्ट में लागू होने वाली Firebase सेवाओं को अपने-आप सेट अप कर देता है. साथ ही, आपके ऐप्लिकेशन को आपके Firebase प्रोजेक्ट से कनेक्ट कर देता है. इसके अलावा, यह लागू होने वाला Firebase कोड और कॉन्फ़िगरेशन फ़ाइलें जनरेट करता है:
- वेब ऐप्लिकेशन:
  - ये सेवाएं उपलब्ध हो सकती हैं: Cloud Firestore, Authentication, और Firebase Security Rules
  - फ़ाइलों में /src/lib/firebase.ts और firestore.rules शामिल हैं
- Android ऐप्लिकेशन:
  - संभावित सेवाएं: Cloud Firestore, Authentication, और Firebase Security Rules; अगर आपका ऐप्लिकेशन एआई की सुविधाओं का इस्तेमाल करता है, तो: Firebase AI Logic और Firebase App Check
  - फ़ाइलों में google-services.json, firestore.rules, और firebase_applet_config.xml शामिल हैं
अहम जानकारी: इंटिग्रेट की गई पहली सुविधा (जैसे, Cloud Firestore और Authentication) के लिए चुना गया प्रोजेक्ट और जगह की जानकारी, Firebase और Google Cloud की उन सभी सेवाओं (जैसे, Cloud Run) पर अपने-आप लागू हो जाएगी जिन्हें बाद में आपके ऐप्लिकेशन में जोड़ा जाएगा. एक बार सेट हो जाने के बाद, Google AI Studio का इस्तेमाल करके सेट अप किए गए इन संसाधनों की जगह की जानकारी नहीं बदली जा सकती.
डिप्लॉय या पब्लिश करें: तैयार हो जाने के बाद, अपने ऐप्लिकेशन को डिप्लॉय या पब्लिश किया जा सकता है:
- वेब ऐप्लिकेशन: अपने वेब ऐप्लिकेशन को Cloud Run पर डिप्लॉय करने के लिए, शेयर करें > पब्लिश करें विकल्प का इस्तेमाल करें. आपका ऐप्लिकेशन, सेटअप के दौरान चुने गए प्रोजेक्ट में अपने-आप डिप्लॉय हो जाएगा.
- Android ऐप्लिकेशन: लोकल टेस्टिंग के लिए, यूएसबी की मदद से ऐप्लिकेशन को किसी फ़िज़िकल डिवाइस पर इंस्टॉल करें. इसके अलावा, इंटरनल टेस्टिंग के लिए, Google Play में जाकर ऐप्लिकेशन को चुनिंदा टेस्टर के लिए पब्लिश करें.
अपने ऐप्लिकेशन को शेयर, डिप्लॉय या पब्लिश करने से पहले, एआई से जनरेट किए गए Firebase Security Rules की समीक्षा ज़रूर करें.

डेवलपमेंट के दौरान किसी ऐप्लिकेशन में Firebase जोड़ना

अगर आपको Google AI Studio में बनाए जा रहे किसी ऐप्लिकेशन में Firebase इंटिग्रेशन जोड़ना है, तो इसे दोहराने के चरण के दौरान किसी भी समय जोड़ा जा सकता है. इसके लिए, इनमें से कोई एक विकल्प चुनें:

एजेंट से बात करें: एजेंट को ऐसी सुविधा जोड़ने का निर्देश दें जिसके लिए डेटाबेस, पुष्टि करने की प्रोसेस या Android के लिए जनरेटिव एआई की ज़रूरत हो. उदाहरण के लिए, Add a Firestore database to this app या Add Firebase AI Logic to summarize notes.
सेटिंग मेन्यू का इस्तेमाल करें: सेटिंग > इंटिग्रेशन पर जाएं और Firebase Firestore और Auth टाइल पर क्लिक करें.

दोनों विकल्पों से, Firebase इंटिग्रेशन सेटअप करने का फ़्लो शुरू हो जाएगा. इससे आपको कोई प्रोजेक्ट चुनने, बैकएंड की जगह कॉन्फ़िगर करने, और अपने ऐप्लिकेशन के लिए इंटिग्रेशन चालू करने का विकल्प मिलेगा. इसके बारे में खास जानकारी में बताया गया है.

इंटिग्रेशन चालू होने के बाद, इसके कॉन्फ़िगरेशन की समीक्षा कभी भी की जा सकती है. इसमें प्रोजेक्ट, जगह, ऐप्लिकेशन से जुड़ी सहायता के लिए ईमेल पता, और डेटाबेस आईडी शामिल है. इसके लिए, सेटिंग > इंटिग्रेशन पर जाएं. इसके बाद, Firebase Firestore और Auth टाइल पर क्लिक करें.

Cloud Firestore के लिए शेयर किए गए कोटे के बारे में जानकारी

आपने ऐप्लिकेशन कब बनाया, आपका खाता ज़रूरी शर्तें पूरी करता है या नहीं, और आपका प्लैटफ़ॉर्म क्या है, इस आधार पर आपकी डेटाबेस को Google Cloud के स्टार्टर टियर प्रोजेक्ट या स्टैंडर्ड प्रोजेक्ट में होस्ट किया जा सकता है. स्टार्टर टियर, Android ऐप्लिकेशन के लिए उपलब्ध नहीं है. हालांकि, दोनों ही मामलों में, Google AI Studio एजेंट से उपलब्ध कराए गए सभी Cloud Firestore डेटाबेस, आपके प्रोजेक्ट में मौजूद डेटाबेस के "एआई के साथ शेयर किए गए कोटे" वाले ग्रुप में रखे जाते हैं. इन सभी में ये विशेषताएं होती हैं:

शेयर किया गया कोटा: ग्रुप में मौजूद सभी डेटाबेस, इस्तेमाल करने का कोटा शेयर करते हैं (नीचे दी गई जानकारी देखें).
खाते की ज़रूरत नहीं है Cloud Billing: बिलिंग की सुविधा जोड़े बिना, अपने ऐप्लिकेशन को बनाया और टेस्ट किया जा सकता है. बिलिंग की जानकारी जोड़ने के बारे में यहां ज़्यादा जानें.
हर दिन रीसेट होने वाला कोटा: अगर आपने हर दिन के कोटे की सीमा (उदाहरण के लिए, हर दिन 50 हज़ार बार पढ़ने की सीमा) पूरी कर ली है, तो ग्रुप में मौजूद सभी डेटाबेस के लिए सेवा रोक दी जाएगी. यह सेवा अगले दिन, पैसिफ़िक टाइम के हिसाब से आधी रात को फिर से शुरू होगी.

Cloud Firestore शेयर किए गए कोटा ग्रुप में मौजूद डेटाबेस, ये सीमाएं शेयर करते हैं:

मेट्रिक	कोटा
संग्रहित डेटा	कुल 1 GiB
नेटवर्क इग्रेस डेटा ट्रैफ़िक	हर महीने 10 जीबी
यूनिट लिखें	हर दिन 40,000 राइट
इकाइयां पढ़ें	हर दिन 50,000 रीड
रीयल-टाइम अपडेट यूनिट	हर दिन 50,000 अपडेट

(ज़रूरी नहीं) Cloud Firestore का ज़्यादा कोटा पाने के लिए, बिलिंग की जानकारी जोड़ें

अगर आपका ऐप्लिकेशन लोकप्रिय हो जाता है और आपको Cloud Firestore के लिए बिना किसी शुल्क के उपलब्ध सीमा से ज़्यादा इस्तेमाल करना है, तो बिलिंग की जानकारी जोड़ें. इससे आपका Firebase प्रोजेक्ट, इस्तेमाल के हिसाब से शुल्क चुकाने वाले ब्लेज़ प्लान में अपग्रेड हो जाएगा.

ऐसा हो सकता है कि आपने अपने प्रोजेक्ट के लिए बिलिंग की जानकारी पहले ही जोड़ दी हो. ऐसा अलग-अलग वजहों से किया जा सकता है. जैसे, Nano Banana का इस्तेमाल करने के लिए. अगर ऐसा है, तो इसका मतलब है कि आपका प्रोजेक्ट पहले से ही ब्लेज़ प्लान पर है. ऐसे में, सीधे डेटाबेस को अपग्रेड करने के चरण पर जाएं.

पहला चरण. बिलिंग की जानकारी जोड़ना (अगर आपने पहले से ऐसा नहीं किया है)

Google AI Studio में जाकर, सीधे तौर पर बिलिंग सेट अप की जा सकती है.

Google AI Studio में, प्रोजेक्ट पेज पर जाएं.
आपको जिस प्रोजेक्ट को अपग्रेड करना है उसके बगल में मौजूद, बिलिंग सेट अप करें पर क्लिक करें.
स्क्रीन पर दिए गए निर्देशों का पालन करके, अपना देश चुनें और शर्तों को स्वीकार करें. इसके बाद, पेमेंट का कोई तरीका जोड़ें या कोई मौजूदा बिलिंग खाता चुनें. आपको पहले से पेमेंट करने के लिए भी कहा जा सकता है. यह पेमेंट, Firebase और Google Cloud सेवाओं के इस्तेमाल पर लागू नहीं होता.

अहम जानकारी: Google AI Studio में बिलिंग सेट अप करने से, लिंक किए गए बिलिंग खाते को अपने-आप पेड बिलिंग खाते में अपग्रेड कर दिया जाता है या नया पेड बिलिंग खाता बन जाता है. इसका मतलब है कि सेवा के सभी इस्तेमाल पर, इस्तेमाल के हिसाब से पैसे चुकाने की स्टैंडर्ड दरें लागू होंगी. इनमें Firebase और अन्य Google Cloud सेवाओं का इस्तेमाल भी शामिल है. हालांकि, शेयर किए गए कोटा ग्रुप में मौजूद Cloud Firestore इंस्टेंस पर ये दरें लागू नहीं होंगी.

अगर आपने नया बिलिंग खाता बनाया है, तो हो सकता है कि आपको Firebase और Google Cloud की अन्य सेवाओं के लिए, बिना किसी शुल्क के आज़माने की सुविधा के तहत मिलने वाले वेलकम क्रेडिट का दावा करने का विकल्प मिले.
अगर आपने मौजूदा बिलिंग खाते को लिंक किया है, तो आपके पास Firebase और Google Cloud की अन्य सेवाओं के लिए, बिना शुल्क के आज़माने की सुविधा के तहत मिले बचे हुए वेलकम क्रेडिट इस्तेमाल करने का विकल्प होता है. ध्यान रखें कि अगर आपके पास इस बिलिंग खाते से जुड़े अन्य प्रोजेक्ट हैं, तो उन प्रोजेक्ट में किसी भी तरह के इस्तेमाल के लिए, अब इस्तेमाल के हिसाब से पैसे चुकाने होंगे.

ध्यान दें कि Google AI Studio में सीधे तौर पर बिलिंग सेट अप करने की सुविधा, Public Preview में है.

दूसरा चरण: डेटाबेस को अपग्रेड करना

बिलिंग की जानकारी जोड़ने के बाद भी, Google AI Studio एजेंट से बनाए गए Cloud Firestore डेटाबेस, शेयर किए गए कोटा ग्रुप में बने रहते हैं. किसी खास डेटाबेस के लिए, पैसे चुकाकर मिलने वाली स्केलिंग की सुविधा चालू करने के लिए, आपको उसे मैन्युअल तरीके से अपग्रेड करना होगा.

Firebase कंसोल पर जाएं और वह प्रोजेक्ट चुनें जिसमें मौजूद डेटाबेस को आपको अपग्रेड करना है.
बाईं ओर मौजूद नेविगेशन पैनल में, Databases & Storage > Firestore पर जाएं.
अगर आपके प्रोजेक्ट में एक से ज़्यादा Cloud Firestore डेटाबेस इंस्टेंस हैं, तो वह इंस्टेंस चुनें जिसे आपको अपग्रेड करना है.
पेज पर सबसे ऊपर मौजूद बैनर देखें. इससे पता चलता है कि डेटाबेस, एआई के शेयर किए गए कोटे की सीमाओं के दायरे में आता है. इसे अपग्रेड करने के लिए, डेटाबेस अपग्रेड करें > इस्तेमाल के हिसाब से पैसे चुकाने वाले प्लान पर अपग्रेड करें पर क्लिक करें.अगर आपको यह बैनर नहीं दिखता है, तो इसका मतलब है कि डेटाबेस को Google AI Studio एजेंट ने नहीं बनाया है और यह शेयर किए गए कोटा ग्रुप का हिस्सा नहीं है या इसे पहले ही अपग्रेड कर दिया गया है.

शेयर किए गए कोटे को बंद करने और अपने डेटाबेस के लिए इस्तेमाल के हिसाब से पैसे चुकाने की सुविधा चालू करने का बदलाव, कुछ ही मिनट में लागू हो जाएगा.

अहम जानकारी: Cloud Billing खाते को लिंक करने से, शेयर किए गए कोटे की सीमाएं अपने-आप नहीं हटती हैं. इसे एआई के लिए शेयर किए गए कोटे की सीमा से बाहर ले जाने के लिए, आपको Firebase कंसोल में मौजूद डेटाबेस अपग्रेड करें बटन पर क्लिक करना होगा.

शेयर किया गया कोटा खत्म होने पर: अगर शेयर किया गया कोटा खत्म हो जाता है, तो ग्रुप में मौजूद सभी डेटाबेस में गड़बड़ियां दिखेंगी. उनके पास लिंक किए गए बिलिंग खाते का ऐक्सेस नहीं है.
ज़्यादा इस्तेमाल: किसी डेटाबेस के लिए ज़्यादा इस्तेमाल की सुविधा चालू करने के लिए, आपको उस डेटाबेस को शेयर किए गए कोटा ग्रुप से बाहर निकालना होगा. इसके लिए, डेटाबेस अपग्रेड करें बटन का इस्तेमाल करें. इससे वह इंस्टेंस, पैसे चुकाकर इस्तेमाल किए जाने वाले सामान्य डेटाबेस में बदल जाता है. इसमें सभी इस्तेमाल के लिए, Cloud Firestore दरें लागू होती हैं.

Security Rules जनरेशन

Google AI Studio एजेंट, आपके ऐप्लिकेशन के लॉजिक के आधार पर Firebase Security Rules अपने-आप जनरेट करता है. इन Security Rules को "डिफ़ॉल्ट रूप से अनुमति नहीं है" के तौर पर डिज़ाइन किया गया है. इसका मतलब है कि आपके ऐप्लिकेशन के असली उपयोगकर्ता सिर्फ़ उस डेटा को ऐक्सेस कर सकते हैं जो उनका है.

अहम जानकारी: अपने ऐप्लिकेशन में जनरेटिव एआई का इस्तेमाल करते समय, इन बातों का ध्यान रखें:

जनरेटिव एआई से गलतियां हो सकती हैं. इसे प्रोडक्शन में डिप्लॉय करने से पहले, इसके बदलावों या आउटपुट की हमेशा जांच करें.
अपने कोड के स्नैपशॉट को बार-बार कमिट करें. खास तौर पर, अपने ऐप्लिकेशन में बड़े बदलाव करने से पहले ऐसा करें.
एआई की मदद से काम करने वाले इस तरीके का इस्तेमाल अपने जोखिम पर करें. एआई से जनरेट किए गए Security Rules में सुरक्षा से जुड़ी किसी भी तरह की गड़बड़ी के लिए, Google और Firebase ज़िम्मेदार नहीं हैं. जनरेट किए गए Security Rules को प्रोडक्शन में डिप्लॉय करने से पहले, उनकी समीक्षा और जांच करना आपकी ज़िम्मेदारी है.

ध्यान दें कि अगर Firebase कंसोल में जाकर, Security Rules को मैन्युअल तरीके से अडजस्ट किया जाता है, तो Google AI Studio एजेंट को इन बदलावों के बारे में पता नहीं चलेगा. साथ ही, ऐप्लिकेशन के अगले इटरेशन के दौरान, इन बदलावों को ओवरराइट कर दिया जाएगा. हमारा सुझाव है कि आप Google AI Studio एजेंट का इस्तेमाल करके, Firebase Security Rules में बदलाव करें. इससे यह पक्का किया जा सकेगा कि आपके बदलाव सेव रहें और आपके ऐप्लिकेशन के लॉजिक के मुताबिक हों.

Android ऐप्लिकेशन के लिए Firebase AI Logic और App Check

Google AI Studio में जनरेटिव एआई की सुविधाएँ शामिल करने वाला Android ऐप्लिकेशन बनाने पर, एजेंट अपने-आप Firebase AI Logic को इंटिग्रेट कर देता है और Firebase App Check को लागू कर देता है.

Google AI Studio में मौजूद वेब ऐप्लिकेशन के उलट, Android ऐप्लिकेशन को क्लाइंट-साइड बाइनरी (APK) के तौर पर डिस्ट्रिब्यूट किया जाता है. वेब ऐप्लिकेशन, Cloud Run पर सर्वर-साइड रनटाइम से Gemini API कॉल को एक्ज़ीक्यूट करते हैं. Gemini API के रॉ पासकोड को सीधे तौर पर APK में एम्बेड करने से, पासकोड को निकाला जा सकता है. साथ ही, बिलिंग का गलत इस्तेमाल किया जा सकता है. Firebase AI Logic को App Check के साथ इस्तेमाल करने पर, आपके प्रोजेक्ट को सुरक्षित रखने में मदद मिलती है. इससे यह पुष्टि की जाती है कि Gemini API को किए गए अनुरोध, आपके ऐप्लिकेशन के किसी असली इंस्टेंस से किए गए हैं.

टेस्टिंग और प्रोडक्शन के दौरान App Check कैसे काम करता है

Google AI Studio, App Check को कॉन्फ़िगर करता है, ताकि आपका ऐप्लिकेशन मैन्युअल सेटअप के बिना सुरक्षित तरीके से काम करे. इससे कोई फ़र्क़ नहीं पड़ता कि प्रोटोटाइप की जांच की जा रही है या Google Play पर पब्लिश किया जा रहा है.

टेस्टिंग और शेयर करना (डीबग के लिए बिल्ड): Google AI Studio एम्युलेटर में अपने ऐप्लिकेशन की झलक देखने, उसे यूएसबी के ज़रिए अपने फ़ोन पर इंस्टॉल करने या Google AI Studio में भरोसेमंद टेस्टर के साथ शेयर करने पर, ऐप्लिकेशन App Check डीबग टोकन का इस्तेमाल करता है. इसे Google AI Studio पर्दे के पीछे अपने-आप मैनेज करता है. सहयोगी, एआई की सुविधाओं को तुरंत आज़मा सकते हैं. उन्हें आपके एपीआई पासकोड या गोपनीय जानकारी नहीं दिखेगी.
Google Play पर पब्लिश करना (रिलीज़ के लिए तैयार बिल्ड): Google Play के लिए रिलीज़ के लिए तैयार वर्शन बनाने पर, आपका ऐप्लिकेशन पहले से कॉन्फ़िगर की गई साइट कुंजी का इस्तेमाल करके, प्रोडक्शन अटेस्टेशन के लिए reCAPTCHA Enterprise पर अपने-आप स्विच हो जाता है. आपको पब्लिश करने से पहले, Google Play को मैन्युअल तरीके से लिंक करने या App Check की सेवा देने वाली कंपनियों को कॉन्फ़िगर करने की ज़रूरत नहीं है.

किसी मौजूदा प्रोजेक्ट का इस्तेमाल करना

Firebase इंटिग्रेशन को पहली बार चालू करते समय, आपके पास Google Cloud के मालिकाना हक वाले किसी मौजूदा प्रोजेक्ट को चुनने का विकल्प होता है:

पॉप-अप होने वाले कार्ड में, सेटिंग आइकॉन पर क्लिक करें.
अपना प्रोजेक्ट चुनें. इसके बाद, Firebase चालू करें पर क्लिक करें.

अपने ऐप्लिकेशन को बेहतर बनाने के लिए, एजेंट को किसी दूसरे प्रोजेक्ट का इस्तेमाल करने के लिए भी कहा जा सकता है. इसके लिए, इस तरह का प्रॉम्प्ट इस्तेमाल करें:

Add Firestore to this app using project PROJECT_ID.

कोई प्रोजेक्ट चुनने पर, ये कार्रवाइयां होती हैं:

शेयर किए गए कोटे का इस्तेमाल करके, उस प्रोजेक्ट में एक नया Cloud Firestore डेटाबेस उपलब्ध कराया जाएगा.
'Google साइन इन' की मदद से, Firebase Authentication को कॉन्फ़िगर किया जाएगा.
जनरेटिव एआई का इस्तेमाल करने वाले Android ऐप्लिकेशन के लिए, Firebase AI Logic, Firebase App Check, और reCAPTCHA Enterprise को सेट अप किया जाएगा. Firebase AI Logic के लिए, App Check अपने-आप लागू हो जाता है, ताकि आपके एपीआई कोटा को सुरक्षित रखा जा सके.
किसी सेवा खाते को आपके Cloud Firestore डेटाबेस का ऐक्सेस दिया जाएगा. Google AI Studio से एडमिन ऐक्सेस की अनुमति देने के लिए, ais-sandbox@PROJECT_ID.iam.gservice.com नाम के नए सेवा खाते को आपके Cloud Firestore डेटाबेस को ऐक्सेस करने की अनुमति दी जाएगी. यह खाता सिर्फ़ आपके Google AI Studio ऐप्लिकेशन से जुड़ा है.
सीमाएं: अगर Firebase प्रोजेक्ट में पहले से ही Cloud Firestoreडेटाबेस मौजूद है, तो एजेंट कोई दूसरा डेटाबेस नहीं जोड़ पाएगा. आपको कोई दूसरा प्रोजेक्ट चुनना होगा या इस्तेमाल करने के लिए, एक नया और खाली प्रोजेक्ट बनाना होगा.

Firebase कंसोल का इस्तेमाल करना

Firebase कंसोल में जाकर, अपने ऐप्लिकेशन का डेटा और सेटिंग देखी जा सकती हैं. Google AI Studio से जुड़े Firebase प्रोजेक्ट को ऐक्सेस करने का तरीका यहां दिया गया है:

Firebase कंसोल पर जाएं और AI Studio लेबल वाला प्रोजेक्ट चुनें.
बाईं ओर मौजूद नेविगेशन पैनल में, अपने प्रोजेक्ट में चालू की गई सेवाओं को एक्सप्लोर करें:
- सेव किए गए Cloud Firestore डेटा को देखने और उसमें बदलाव करने के लिए, डेटाबेस और स्टोरेज > Firestore पर जाएं.
- Authentication की सेटिंग और डेटा देखने या कॉन्फ़िगर करने के लिए, सुरक्षा > पुष्टि करना पर जाएं.
- Firebase AI Logic के इस्तेमाल को मॉनिटर करने, कोटा देखने या सेटिंग कॉन्फ़िगर करने के लिए, एआई > एआई लॉजिक पर जाएं.
- App Check को लागू करने की सुविधा को मैनेज करने, पुष्टि करने के अनुरोधों पर नज़र रखने या डीबग टोकन रद्द करने के लिए, सुरक्षा > App Check पर जाएं.

समस्या हल करना और अक्सर पूछे जाने वाले सवाल

Firebase को अपने Google AI Studio ऐप्लिकेशन के साथ इंटिग्रेट करने के दौरान होने वाली समस्याओं को हल करने का तरीका जानें. साथ ही, अक्सर पूछे जाने वाले सवालों के जवाब पाएं.

मेरा Google Cloud / Firebase प्रोजेक्ट और जगह कैसे चुनी जाती है?

किसी ऐप्लिकेशन के लिए Firebase बैकएंड का अनुरोध करते समय, आपके पास कार्ड में दिखने वाली जगह और प्रोजेक्ट को चुनने का विकल्प होता है:

प्रोजेक्ट या जगह को पसंद के मुताबिक बनाएं (ज़रूरी नहीं): सेटिंग आइकॉन पर क्लिक करें. इसके बाद, वह जगह या Google Cloud प्रोजेक्ट चुनें जिसका आपको इस्तेमाल करना है. इसके बाद, Firebase चालू करें पर क्लिक करें.

निम्नलिखित का ध्यान रखें:

डेटाबेस की जगह हमेशा के लिए तय हो जाती है: डेटाबेस के लिए कोई जगह चुनने के बाद, उस प्रोजेक्ट के लिए उसे बदला नहीं जा सकता. इस विकल्प को अन्य बैकएंड सेवाओं के लिए, डिफ़ॉल्ट के तौर पर इस्तेमाल किया जाएगा.
प्रोजेक्ट की एक जैसी सेटिंग: आसान इंटिग्रेशन के लिए, Google AI Studio आपके बैकएंड और डिप्लॉयमेंट, दोनों के लिए एक ही प्रोजेक्ट का इस्तेमाल अपने-आप करता है. एक ही ऐप्लिकेशन में अलग-अलग सेवाओं के लिए, अलग-अलग प्रोजेक्ट का इस्तेमाल नहीं किया जा सकता.

पुष्टि करने के कौन-कौनसे तरीके इस्तेमाल किए जा सकते हैं?

जब Authentication या साइन-इन स्क्रीन सेट अप करने के लिए कहा जाता है, तब Google AI Studio एजेंट, Google साइन-इन की सुविधा सेट अप करता है. अपने ऐप्लिकेशन में साइन इन करने के अन्य तरीके जोड़ने के लिए, यह तरीका अपनाएं:

Firebase कंसोल में, सुरक्षा > पुष्टि > साइन-इन का तरीका पेज पर जाएं. इसके बाद, साइन-इन करने के लिए अपनी पसंद के तरीके कॉन्फ़िगर करें.
Google AI Studio में वापस जाकर, Google AI Studio एजेंट से साइन-इन के नए तरीके के साथ अपने कोडबेस को अपडेट करने में मदद मांगें.

क्या Google AI Studio की मदद से, Android या iOS जैसा कोई मोबाइल ऐप्लिकेशन बनाया जा सकता है?

Google AI Studio एजेंट, वेब ऐप्लिकेशन और Android ऐप्लिकेशन, दोनों बना सकता है. Firebase इंटिग्रेशन की मदद से, वेब और Android ऐप्लिकेशन, दोनों में Cloud Firestore और Authentication को जोड़ा जा सकता है. साथ ही, Android ऐप्लिकेशन के लिए Firebase AI Logic और Firebase App Check को भी जोड़ा जा सकता है.

Google AI Studio में iOS ऐप्लिकेशन बनाने की सुविधा उपलब्ध नहीं है. हालांकि, सभी वेब ऐप्लिकेशन की तरह, Google AI Studio से बनाए गए वेब ऐप्लिकेशन को भी मोबाइल पर वेब ऐप्लिकेशन के तौर पर ऐक्सेस किया जा सकता है. इसके लिए, मोबाइल डिवाइसों (iOS के साथ-साथ) पर इंस्टॉल किए गए ब्राउज़र का इस्तेमाल किया जा सकता है.

Android ऐप्लिकेशन बनाने के बारे में ज़्यादा जानने के लिए, Google AI Studio दस्तावेज़ पढ़ें.

Firebase AI Logic और App Check इंटिग्रेशन का इस्तेमाल सिर्फ़ Android ऐप्लिकेशन के लिए क्यों किया जाता है, वेब ऐप्लिकेशन के लिए क्यों नहीं?

Android ऐप्लिकेशन, क्लाइंट-साइड बाइनरी (APK) के तौर पर डिस्ट्रिब्यूट किए जाते हैं. अगर कोई Android ऐप्लिकेशन, स्टैंडर्ड एपीआई पासकोड का इस्तेमाल करके Gemini API को सीधे कॉल करता है, तो कोई भी व्यक्ति APK को डीकंपाइल कर सकता है, पासकोड निकाल सकता है, और बिना अनुमति के अनुरोध कर सकता है. इसे रोकने के लिए, Google AI Studio में बनाए गए Android ऐप्लिकेशन, Firebase AI Logic और Firebase App Check का एक साथ इस्तेमाल करते हैं. इससे यह पुष्टि की जाती है कि अनुरोध आपके ऐप्लिकेशन के किसी असली इंस्टेंस से आए हैं.

दूसरी ओर, Google AI Studio में बनाए गए वेब ऐप्लिकेशन, Google Gen AI SDK का इस्तेमाल करके, सुरक्षित सर्वर-साइड रनटाइम (डिप्लॉय किए जाने पर Cloud Run पर होस्ट किए गए) से Gemini API के अनुरोधों को पूरा करते हैं. एपीआई पासकोड सर्वर पर रहता है और क्लाइंट ब्राउज़र को कभी नहीं दिखता. इसलिए, इस तरह से बनाए गए वेब ऐप्लिकेशन के लिए, क्लाइंट-साइड Firebase AI Logic और App Check की ज़रूरत नहीं होती.

`firebase-blueprint.json` फ़ाइल क्या है?

यह एक इंटरमीडिएट फ़ाइल है. इसका इस्तेमाल Google AI Studio एजेंट, आपके ऐप्लिकेशन के कोडबेस को समझने के लिए करता है. इस फ़ाइल में मैन्युअल तरीके से बदलाव न करें. ऐसा करने से, एजेंट गलत कोड या असुरक्षित Security Rules जनरेट कर सकता है.

"तय सीमा पार हो गई" गड़बड़ी का मैसेज मिलने पर मुझे क्या करना चाहिए?

Cloud Firestore कोटे की सीमा पूरी होने का मतलब है कि आपके ऐप्लिकेशन ने Cloud Firestore डेटाबेस के शेयर किए गए कोटे वाले ग्रुप के लिए, हर दिन के इस्तेमाल की सीमा पूरी कर ली है. इस समस्या को हल करने के दो तरीके हैं:

पहला विकल्प: इंतज़ार करें: कोटा, हर दिन पैसिफ़िक टाइम के हिसाब से आधी रात को रीसेट होता है.
दूसरा विकल्प: अपग्रेड करना: इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर अपग्रेड करें.
- अगर Google AI Studio एजेंट ने आपके लिए Cloud Firestore सेट अप किया है, तो आपको अपने डेटाबेस को पैसे चुकाकर इस्तेमाल किए जाने वाले सामान्य डेटाबेस में बदलने के लिए, डेटाबेस अपग्रेड करें बटन का इस्तेमाल करना होगा. इसके बारे में ज़्यादा Cloud Firestore कोटा पाने के लिए बिलिंग जोड़ें में बताया गया है. अगर आपने Cloud Firestore को मैन्युअल तरीके से सेट अप किया है, तो डेटाबेस अपग्रेड करें बटन का इस्तेमाल करना ज़रूरी नहीं है.

अगर मुझे "अनुमतियां मौजूद नहीं हैं या पूरी नहीं हैं" गड़बड़ी का मैसेज मिलता है, तो मुझे क्या करना चाहिए?

यह गड़बड़ी तब होती है, जब आपका ऐप्लिकेशन आपके Cloud Firestore डेटाबेस में डेटा को पढ़ने या लिखने की कोशिश करता है, लेकिन Security Rules उस अनुरोध को अस्वीकार कर देता है. इससे पता चलता है कि Security Rules, पुष्टि की मौजूदा स्थिति या डेटा पाथ के आधार पर, की गई कार्रवाई की अनुमति नहीं दे रहे हैं. गड़बड़ी ठीक करें बटन पर क्लिक करें, ताकि Google AI Studio एजेंट को Security Rules को ठीक करने के लिए कहा जा सके.

Google AI Studio ऐप्लिकेशन को मिटाने पर, मेरे Firebase बैकएंड का क्या होगा?

Google AI Studio में अपना ऐप्लिकेशन मिटाने से, कनेक्ट किया गया Firebase प्रोजेक्ट, Cloud Firestore डेटाबेस या Firebase Authentication कॉन्फ़िगरेशन अपने-आप नहीं मिटता.

अगर आपने Firebase बैकएंड जोड़ा है, तो आपको मैन्युअल तरीके से Firebase कंसोल पर जाना होगा. इसके बाद, प्रोजेक्ट को मिटाना होगा या अलग-अलग संसाधनों को हटाना होगा. जैसे, Cloud Firestore डेटाबेस इंस्टेंस और Authentication प्रोवाइडर. इससे यह पक्का किया जा सकेगा कि सारा डेटा और कॉन्फ़िगरेशन हटा दिए गए हैं.

क्या Google AI Studio एजेंट, मेरे Cloud Firestore डेटाबेस में मौजूद डेटा को मिटा सकता है या उसमें बदलाव कर सकता है?

Google AI Studio एजेंट को ज़रूरी बैकएंड रिसॉर्स उपलब्ध कराने और कोड और Security Rules जनरेट करने में मदद करने के लिए डिज़ाइन किया गया है. एजेंट सीधे तौर पर आपके Cloud Firestore डेटाबेस में मौजूद डेटा एंट्री को मिटा, बदल, या उनमें हेर-फेर नहीं कर सकता. हालांकि, यह आपके ऐप्लिकेशन में ऐसा कोड लिख सकता है जिसे इन कार्रवाइयों को करने के लिए डिज़ाइन किया गया हो. डेटा मैनेज करने से जुड़े टास्क पूरे करने के लिए, Firebase कंसोल में डेटाबेस और स्टोरेज > Firestore पेज पर जाएं. जैसे, एंट्री मिटाना.

मैं एक ऐसे संगठन से जुड़ा हूं जो Google Cloud का इस्तेमाल करता है. क्या मैं अपने Google AI Studio ऐप्लिकेशन को अपने संगठन के Google Cloud एनवायरमेंट में मौजूद किसी प्रोजेक्ट से कनेक्ट कर सकता हूं?

हां. पक्का करें कि आपका Firebase प्रोजेक्ट, आपके Google Cloud संगठन के फ़ोल्डर में मौजूद हो. इसके बाद, इनमें से किसी एक तरीके का इस्तेमाल करके अपने प्रोजेक्ट को कनेक्ट करें:

इंटिग्रेशन चालू करते समय: Google AI Studio में Firebase इंटिग्रेशन को पहली बार चालू करते समय, दिखने वाले कार्ड में अपना मौजूदा प्रोजेक्ट चुनें. सेटिंग आइकॉन पर क्लिक करें और अपना प्रोजेक्ट चुनें.
इटरेशन के दौरान: अगर आपने पहले से ही Firebase चालू किया है या आपको बाद में प्रोजेक्ट स्विच करने हैं, तो एजेंट को अपने मौजूदा प्रोजेक्ट का इस्तेमाल करने के लिए कहा जा सकता है. इसके लिए, इस तरह का प्रॉम्प्ट इस्तेमाल करें:
```
  Add Firestore to this app using project PROJECT_ID.
```

मुझे Firebase कंसोल में कुछ दस्तावेज़ क्यों नहीं दिख रहे हैं?

जब AI Studio एजेंट, पैरंट दस्तावेज़ (user1) बनाए बिना, नेस्ट किए गए पाथ (जैसे, /users/user1/messages/msg1) में डेटा सेव करता है, तो वह मौजूद नहीं होने वाला पैरंट दस्तावेज़ बनाता है. ये दस्तावेज़, Firebase कंसोल में नहीं दिखते. इसलिए, Cloud Firestore डेटाबेस ब्राउज़ करते समय, इन्हें ढूंढना मुश्किल हो सकता है. हालांकि, इससे आपके ऐप्लिकेशन के चलने पर कोई असर नहीं पड़ता, लेकिन अक्सर AI Studio एजेंट को समस्या के बारे में बताया जा सकता है, ताकि वह छूटे हुए पैरंट दस्तावेज़ बना सके.

ज़्यादा जानकारी के लिए, ऐसे पैरंट दस्तावेज़ जो मौजूद नहीं हैं लेख पढ़ें.

क्या मेरे पास अपने Cloud Firestore डेटाबेस के लिए जगह चुनने का विकल्प है?

हां. Google AI Studio में Firebase इंटिग्रेशन को पहली बार चालू करने पर, Cloud Firestore डेटाबेस के लिए जगह चुनी जा सकती है.

ध्यान रखें कि चुनी गई जगह, सभी Cloud Firestoreडेटाबेस पर लागू होती है. ये डेटाबेस, Google AI Studio एजेंट उस Firebase प्रोजेक्ट में बनाता है. एक बार सेट हो जाने के बाद, इन डेटाबेस के लिए इस जगह को बदला नहीं जा सकता.

Cloud Firestore डेटाबेस को अपग्रेड करने के बाद, क्या उसे शेयर किए गए कोटा ग्रुप में वापस लाया जा सकता है?

डेटाबेस को शेयर किए गए कोटे के ग्रुप से हटाने और पैसे चुकाकर लिए जाने वाले सामान्य इंस्टेंस में बदलने के बाद, curl कमांड का इस्तेमाल करके उसे शेयर किए गए कोटे के ग्रुप में वापस लाया जा सकता है. ध्यान दें कि शेयर किए गए कोटे वाले ग्रुप में मौजूद सभी डेटाबेस एक ही वर्शन के होने चाहिए. साथ ही, वे एक ही क्षेत्र में होने चाहिए.

PROJECT_ID : Firebase प्रोजेक्ट आईडी. यह आईडी, Firebase कंसोल के सेटिंग > सामान्य पेज पर मिलेगा.
DATABASE_ID : Cloud Firestore डेटाबेस आईडी, जो आपके ऐप्लेट आईडी से मैच करेगा. इस डेटाबेस आईडी को Google AI Studio में ढूंढने के लिए, सेटिंग > इंटिग्रेशन पर जाएं. इसके बाद, Firebase Firestore और Auth टाइल पर क्लिक करें.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
-d '{"free_tier_limited": true}'

Google, Google AI Studio में मेरे डेटा (जैसे, कोड और प्रॉम्प्ट) का इस्तेमाल कैसे करता है?

आपके डेटा का इस्तेमाल कैसे किया जाता है, इस बारे में जानने के लिए Gemini API की सेवा की अतिरिक्त शर्तें पढ़ें.

मुझे Google Cloud से एक ईमेल मिला है. इसमें "आपके Google Cloud प्रोजेक्ट के लिए, सार्वजनिक तौर पर ऐक्सेस किए जा सकने वाले Google API पासकोड" के बारे में बताया गया है. मुझे क्या करना होगा?

अगर आपको Google Cloud से "आपके Google Cloud प्रोजेक्ट के लिए, सार्वजनिक तौर पर ऐक्सेस किए जा सकने वाले Google API पासकोड" के बारे में कोई ईमेल मिला है और ईमेल में दिया गया एपीआई पासकोड आपका Firebase एपीआई पासकोड है, तो पक्का करें कि एपीआई पासकोड यहां दी गई ज़रूरी शर्तें पूरी करता हो. इससे, एपीआई पासकोड को आपके कोड या कॉन्फ़िगरेशन फ़ाइलों में सुरक्षित तरीके से शामिल किया जा सकेगा. Google Cloud कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पेज पर जाकर, इनकी पुष्टि की जा सकती है.

यह वह एपीआई पासकोड होता है जिसका इस्तेमाल Firebase ऐप्लिकेशन और सिर्फ़ Firebase सेवाओं के लिए किया जाता है. आम तौर पर, इन बटन को Browser key (auto created by Firebase) या Android key (auto created by Firebase) या iOS key (auto created by Firebase) कहा जाता है.
इसमें Firebase से जुड़े सभी ज़रूरी एपीआई शामिल हों. ये एपीआई, कुंजी की "एपीआई से जुड़ी पाबंदियों" की अनुमति वाली सूची में शामिल होने चाहिए.
इसकी "एपीआई से जुड़ी पाबंदियों" की अनुमति वाली सूची में कोई दूसरा एपीआई नहीं है. खास तौर पर, सूची में नहीं होना चाहिए Generative Language API.

साथ ही, पक्का करें कि इस्तेमाल किए जा रहे Firebase प्रॉडक्ट के लिए, Firebase Security Rules और App Check का इस्तेमाल, सुझाए गए तरीके से किया जा रहा हो.

Firebase के लिए एपीआई कुंजियों के बारे में ज़्यादा जानकारी पाएं. साथ ही, अक्सर पूछे जाने वाले सवालों की सूची देखें. इसके लिए, Firebase के लिए एपीआई कुंजियों का इस्तेमाल करने और उन्हें मैनेज करने के बारे में जानें पर जाएं

अहम जानकारी: अपने ऐप्लिकेशन में Gemini Developer API को कॉल करने के लिए इस्तेमाल किया जाने वाला एपीआई पासकोड, आपके कोड या कॉन्फ़िगरेशन फ़ाइलों में कभी नहीं शामिल किया जाना चाहिए. इसे सार्वजनिक तौर पर दिखने से बचाना चाहिए. Google Cloud कंसोल में, इसे Gemini API Key या Gemini Developer API key (auto created by Firebase) कहा जाएगा. साथ ही, इसे Generative Language API तक सीमित रखा जाएगा.