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

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

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

  1. अपने आइडिया के बारे में बताएं: Google AI Studio में एक नया ऐप्लिकेशन बनाएं और ऐसी सुविधा के बारे में बताएं जिसके लिए डेटाबेस या पुष्टि करने की ज़रूरत हो. उदाहरण के लिए, "एक शेयर की जाने वाली टास्क लिस्ट बनाएं".

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

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

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

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

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

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

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

(ज़रूरी नहीं) ज़्यादा 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=limited_free_tier" \
    -d '{"limited_free_tier": false}'
    

Security Rules जनरेट करने की सुविधा

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

ध्यान दें कि अगर आपने Security Rules को सीधे तौर पर Firebase कंसोल में जाकर मैन्युअल तरीके से अडजस्ट किया है, तो 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 की सेटिंग और डेटा कॉन्फ़िगर करें.

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

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

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

Firebase बैकएंड जोड़ें सुविधा का इस्तेमाल करने पर, Google AI Studio एजेंट Google से साइन इन करने की सुविधा सेट अप करता है. अन्य तरीकों को सेट अप करने के लिए, उन्हें Firebase कंसोल में चालू करें. इसके बाद, 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 इससे आपके ऐप्लिकेशन के चलने पर कोई असर नहीं पड़ता. हालांकि, अक्सर एआई स्टूडियो एजेंट को समस्या के बारे में बताया जा सकता है, ताकि वह माता-पिता के छूटे हुए दस्तावेज़ बना सके.

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

मेरे Cloud Firestore डेटाबेस के लिए जगह की जानकारी कैसे चुनी जाती है?

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

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

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