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

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

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

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

ध्यान दें: Android ऐप्लिकेशन में Firebase AI Logic और Firebase App Check को इंटिग्रेट करने की सुविधा, आने वाले दिनों में लॉन्च की जाएगी. अगर आपको Google AI Studio में यह सुविधा अब तक नहीं मिली है, तो कुछ समय बाद फिर से देखें!

सिर्फ़ एक प्रॉम्प्ट और कुछ क्लिक की मदद से, 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 में मौजूद वेब ऐप्लिकेशन, Cloud Run पर सर्वर-साइड रनटाइम से Gemini API कॉल को एक्ज़ीक्यूट करते हैं. हालांकि, Android ऐप्लिकेशन को क्लाइंट-साइड बाइनरी (APK) के तौर पर डिस्ट्रिब्यूट किया जाता है. किसी एपीके में Gemini API पासकोड को सीधे एम्बेड करने से, पासकोड को एक्सट्रैक्ट किया जा सकता है. साथ ही, बिलिंग का गलत इस्तेमाल किया जा सकता है. 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 पर जाएं.

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

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

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

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

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

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

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

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

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

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 डेटाबेस के लिए जगह चुनी जा सकती है.

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

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 तक सीमित रखा जाएगा.