Google AI Studio ऐप्लिकेशन में Cloud Firestore और Authentication जोड़ना

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

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

1. अपने आइडिया के बारे में बताएं: Google AI Studio में एक नया ऐप्लिकेशन बनाएं. इसके बाद, ऐसी सुविधा के बारे में बताएं जिसके लिए डेटाबेस या पुष्टि करने की सुविधा की ज़रूरत हो. उदाहरण के लिए, यह प्रॉम्प्ट डाला जा सकता है: Build a shared to-do list app using Firebase as a backend.

2. Firebase इंटिग्रेशन चालू करें: एजेंट के अनुरोध करने पर, Firebase इंटिग्रेशन चालू करें. इसके बाद, अपने प्रोजेक्ट के लिए कोई जगह चुनें और Firebase की शर्तों को स्वीकार करें. इसके बाद, एजेंट आपके ऐप्लिकेशन को आपके Firebase प्रोजेक्ट से अपने-आप कनेक्ट कर देता है. साथ ही, आपके ऐप्लिकेशन के लिए ज़रूरी Cloud Firestore और Authentication कोड जनरेट करता है. इसमें /src/lib/firebase.ts फ़ाइल और firestore.rules फ़ाइल भी शामिल होती है.

3. डिप्लॉय करें: तैयार हो जाने के बाद, शेयर करें > पब्लिश करें विकल्प का इस्तेमाल करके, अपने वेब ऐप्लिकेशन को Cloud Run पर डिप्लॉय करें.

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

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

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

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

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

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

1. बिलिंग की जानकारी जोड़ें (अगर आपने पहले से नहीं जोड़ी है): Firebase कंसोल पर जाएं और अपने प्रोजेक्ट से बिलिंग खाता लिंक करें.

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

   • PROJECT_ID : Firebase प्रोजेक्ट आईडी; यह आईडी Firebase कंसोल की प्रोजेक्ट सेटिंग में जाकर ढूंढें.

   • DATABASE_ID : Cloud Firestore डेटाबेस आईडी, जो आपके ऐप्लेट आईडी से मेल खाएगा; यह डेटाबेस आईडी, Firebase कंसोल में Cloud Firestore डेटाबेस पेज पर नाम कॉलम में मिलेगा.

   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": false}'
   

Security Rules जनरेट की गई

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

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

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

Google AI Studio एजेंट से, Google Cloud प्रोजेक्ट में Google AI Studio उपलब्ध कराने के लिए भी कहा जा सकता है.Cloud Firestore एजेंट को अपने मौजूदा प्रोजेक्ट का इस्तेमाल करने का निर्देश दें. इसके लिए, इस तरह का प्रॉम्प्ट इस्तेमाल करें:

Add Firestore to this app using project PROJECT_ID.

• शेयर किए गए कोटे का इस्तेमाल करके, उस प्रोजेक्ट में एक नया Cloud Firestore डेटाबेस उपलब्ध कराया जाएगा.
• Firebase Authentication के साथ Google साइन-इन की सुविधा कॉन्फ़िगर की जाएगी.
• सेवा खाते को आपके 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 से जुड़े अपने प्रोजेक्ट ऐक्सेस करने के लिए, यह तरीका अपनाएं:

1. Firebase कंसोल पर जाएं और AI Studio के तौर पर लेबल किया गया प्रोजेक्ट चुनें.

2. बाईं ओर मौजूद नेविगेशन पैनल में, बनाएं > Cloud Firestore डेटाबेस पर क्लिक करके, Cloud Firestore में अपना डेटा देखें और उसमें बदलाव करें. इसके अलावा, Authentication की सेटिंग और डेटा को कॉन्फ़िगर करने के लिए, बनाएं > Authentication पर क्लिक करें.

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

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

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

Firebase बैकएंड जोड़ें सुविधा का इस्तेमाल करने पर, Google AI Studio एजेंट आपके ऐप्लिकेशन की बैकएंड सेवाओं (Cloud Firestore और Firebase Authentication) के लिए, Firebase प्रोजेक्ट को अपने-आप चुन लेता है.

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

Use project PROJECT_ID for the Firebase backend.

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

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

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

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

फ़िलहाल, Google AI Studio एजेंट सिर्फ़ वेब ऐप्लिकेशन बना सकता है. Google AI Studio एजेंट के दस्तावेज़ में जाकर, इस बारे में ज़्यादा जानें कि कौनसी सुविधाएं काम करती हैं.

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

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

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

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

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

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

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

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

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 कंसोल में Cloud Firestore डेटाबेस पेज पर जाएं.

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

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

1. Firebase प्रोजेक्ट को पहले से ही मैन्युअल तरीके से बना लें.

2. Google AI Studio में Firebase बैकएंड सेट अप करते समय, एजेंट को अपने मौजूदा प्रोजेक्ट का इस्तेमाल करने के लिए कहें:

   Add Firestore to this app using project PROJECT_ID.
   

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

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

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

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

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

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

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