افزودن Firebase به برنامه Google AI Studio

حالت ساخت در Google AI Studio می‌تواند به‌طور خودکار سرویس‌های Firebase را در برنامه‌های Android و وب شما راه‌اندازی و ادغام کند:

• Cloud Firestore و Firebase Authentication (برای برنامه‌های Android و وب) برای ساختن برنامه‌هایی با فضای ذخیره‌سازی داده‌های پایدار و جریان‌های ورود به سیستم ایمن.

• Firebase AI Logic و Firebase App Check (برای برنامه‌های Android) برای فراخوانی ایمن مدل‌های Gemini مستقیماً از برنامه تلفن همراه بدون افشا کردن کلیدهای API.

فقط با یک پیام‌واره و چند کلیک، به عامل Google AI Studio امکان می‌دهید تا پروژه Firebase راه‌اندازی کند، برنامه‌تان را به آن پروژه متصل کند، و کد Firebase و فایل‌های پیکربندی لازم را مستقیماً در برنامه‌تان تولید کند.

درباره ساختن برنامه‌های وب فول‌استک و برنامه‌های Android در اسناد Google AI Studio بیشتر بدانید.

نمای کلی: افزودن پس‌زمینه به برنامه Google AI Studio

1. ایده‌تان را شرح دهید: برنامه جدیدی در 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.

2. فعال کردن ادغام Firebase: در کارتی که ظاهر می‌شود، راه‌اندازی‌تان را پیکربندی کنید:

   1. سفارشی‌سازی پروژه یا مکان (اختیاری): روی نماد تنظیمات settings کلیک کنید، سپس مکان یا پروژه 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 است

3. استقرار یا انتشار: وقتی آماده شد، می‌توانید برنامه‌تان را مستقر یا منتشر کنید:

   • برنامه‌های وب: از گزینه هم‌رسانی > انتشار برای استقرار برنامه وب خود در Cloud Run استفاده کنید. برنامه‌تان به‌طور خودکار در همان پروژه‌ای که درطول راه‌اندازی انتخاب کردید مستقر خواهد شد.
   • برنامه‌های Android: برنامه را ازطریق USB در دستگاه فیزیکی نصب کنید تا آزمایش داخلی انجام دهید یا آن را برای آزمایش‌کنندگان خاصی در Google Play منتشر کنید تا آزمایش داخلی انجام دهند.

   قبل‌از هم‌رسانی، استقرار، یا انتشار برنامه‌تان، حتماً Firebase Security Rules تولیدشده با هوش مصنوعی را مرور کنید.

افزودن Firebase به برنامه درطول توسعه

اگر می‌خواهید ادغام Firebase را به برنامه‌ای که درحال کار روی آن در Google AI Studio هستید اضافه کنید، می‌توانید این کار را در هر زمانی درطول فاز تکرار بااستفاده از یکی از گزینه‌های زیر انجام دهید:

• با نماینده صحبت کنید: به نماینده دستور دهید تا ویژگی‌ای را اضافه کند که به پایگاه داده، اصالت‌سنجی، یا هوش مصنوعی زایا برای Android نیاز دارد (برای مثال، Add a Firestore database to this app یا Add Firebase AI Logic to summarize notes).
• استفاده از منو تنظیمات: به تنظیمات > ادغام‌ها بروید و روی کاشی Firebase Firestore و Auth کلیک کنید.

هر دو گزینه جریان راه‌اندازی ادغام Firebase را راه‌اندازی می‌کنند و به شما امکان می‌دهند پروژه‌ای را انتخاب کنید، مکان پس‌بک خود را پیکربندی کنید، و ادغام را برای برنامه‌تان فعال کنید، همان‌طور که در نمای کلی توضیح داده شده است.

پس‌از فعال شدن ادغام، می‌توانید پیکربندی آن را (ازجمله پروژه، مکان، ایمیل پشتیبانی برنامه، و شناسه پایگاه داده) هرزمان بخواهید با رفتن به تنظیمات > ادغام‌ها و کلیک کردن روی کاشی Firebase Firestore و Auth بازبینی کنید.

آشنایی با سهمیه مشترک برای Cloud Firestore

بسته به زمان ایجاد برنامه، واجدشرایط بودن حساب، و پلاتفرم شما (Starter Tier برای برنامه‌های Android دردسترس نیست)، پایگاه‌های داده شما ممکن است در پروژه Google Cloud Starter Tier یا پروژه استاندارد میزبانی شود. بااین‌حال، در هر دو مورد، همه پایگاه‌های داده Cloud Firestore که توسط عامل Google AI Studio تأمین شده‌اند در همان گروه پایگاه‌های داده «سهمیه مشترک هوش مصنوعی» در پروژه شما قرار می‌گیرند. همه آن‌ها این ویژگی‌ها را دارند:

• سهمیه مشترک: همه پایگاه‌های داده در گروه سهمیه استفاده مشترک دارند (جزئیات را در زیر ببینید).
• به حساب Cloud Billing نیاز نیست: می‌توانید برنامه‌تان را بدون افزودن صورت‌حساب بسازید و آزمایش کنید. جزئیات مربوط به افزودن اختیاری صورت‌حساب را در زیر ببینید.
• بازنشانی‌های روزانه: اگر به حد سهمیه روزانه برسید (برای مثال، ۵۰ هزار خواندن در روز)، سرویس برای همه پایگاه‌های داده درون گروه موقتاً متوقف می‌شود و روز بعد حدود نیمه‌شب به‌وقت اقیانوس آرام ازسر گرفته می‌شود.

Cloud Firestore پایگاه داده در گروه سهمیه هم‌رسانی‌شده محدودیت‌های زیر را هم‌رسانی می‌کنند:

(اختیاری) برای دریافت سهمیه Cloud Firestore بیشتر، صورت‌حساب اضافه کنید

اگر برنامه‌تان مورد استقبال قرار گرفت و لازم بود از محدودیت‌های بدون هزینه برای Cloud Firestore فراتر بروید، می‌توانید صورت‌حساب اضافه کنید که پروژه Firebase شما را به طرح قیمت‌گذاری Blaze با پرداخت به اندازه استفاده ارتقا می‌دهد.

ممکن است قبلاً به دلایل مختلفی، مثلاً برای استفاده از Nano Banana، صورت‌حساب را به پروژه‌تان اضافه کرده باشید. اگر این‌طور باشد، پروژه‌تان ازقبل در طرح قیمت‌گذاری Blaze است و می‌توانید مستقیماً به مرحله ارتقا دادن پایگاه داده بروید.

مرحله ۱. افزودن صورت‌حساب (اگر قبلاً این کار را نکرده‌اید)

می‌توانید صدور صورت‌حساب را مستقیماً در Google AI Studio راه‌اندازی کنید.

1. در Google AI Studio، به صفحه پروژه‌ها بروید.
2. روی راه‌اندازی صورت‌حساب در کنار پروژه‌ای که می‌خواهید ارتقا دهید کلیک کنید.
3. پیام‌واره‌های روی صفحه را دنبال کنید تا کشورتان را انتخاب کنید، با شرایط موافقت کنید، و روش پرداختی اضافه کنید یا حساب صورت‌حساب موجودی را انتخاب کنید. همچنین ممکن است از شما خواسته شود پیش‌پرداخت انجام دهید (که برای استفاده از Firebase و سرویس‌های Google Cloud اعمال نمی‌شود).

مرحله ۲: ارتقا دادن پایگاه داده

حتی پس‌از افزودن صورت‌حساب، پایگاه‌های داده Cloud Firestore ایجادشده توسط عامل Google AI Studio در گروه سهمیه مشترک باقی می‌مانند. برای فعال کردن مقیاس‌بندی کامل پولی برای پایگاه داده‌ای خاص، باید آن را به‌صورت دستی ارتقا دهید.

1. به کنسول Firebase بروید و پروژه حاوی پایگاه داده‌ای را که می‌خواهید ارتقا دهید انتخاب کنید.
2. از قاب پیمایش سمت راست، به پایگاه‌های داده و فضای ذخیره‌سازی > Firestore بروید.
3. اگر پروژه‌تان حاوی چند نمونه پایگاه داده Cloud Firestore است، نمونه‌ای را که می‌خواهید ارتقا دهید انتخاب کنید.
4. به‌دنبال برنمایی در نزدیکی بالای صفحه بگردید که نشان می‌دهد پایگاه داده مشمول محدودیت‌های سهمیه هم‌رسانی‌شده هوش مصنوعی است. برای ارتقا دادن آن، روی ارتقا دادن پایگاه داده > ارتقا دادن به پرداخت به اندازه استفاده کلیک کنید.اگر این برنما را نمی‌بینید، پایگاه داده یا توسط نماینده Google AI Studio ایجاد نشده است و بخشی از گروه سهمیه مشترک نیست، یا قبلاً ارتقا داده شده است.

تغییر غیرفعال کردن سهمیه مشترک و فعال کردن صورت‌حساب پرداخت به اندازه استفاده برای پایگاه داده شما باید ظرف چند دقیقه اعمال شود.

‫Security Rules تولید

عامل Google AI Studio به‌طور خودکار Firebase Security Rules را براساس منطق برنامه‌تان تولید می‌کند. این Security Rules به‌صورت «رد کردن پیش‌فرض» طراحی شده‌اند، یعنی کاربران نهایی برنامه‌تان فقط می‌توانند به داده‌هایی که مالک آن‌ها هستند دسترسی داشته باشند.

توجه داشته باشید که اگر Security Rules را مستقیماً در کنسول Firebase به‌صورت دستی اصلاح کنید، نماینده Google AI Studio از تغییرات مطلع نخواهد شد و این تغییرات در تکرارهای بعدی برنامه رونویسی خواهند شد. توصیه می‌کنیم از عامل Google AI Studio برای اصلاح Firebase Security Rules استفاده کنید تا مطمئن شوید تغییراتتان حفظ می‌شود و با منطق برنامه‌تان هم‌راستا است.

Firebase AI Logic و App Check برای برنامه‌های Android

وقتی برنامه Android می‌سازید که شامل ویژگی‌های هوش مصنوعی زایا در Google AI Studio است، نماینده به‌طور خودکار Firebase AI Logic را ادغام می‌کند و Firebase App Check را اعمال می‌کند.

برخلاف برنامه‌های وب در Google AI Studio—که فراخوانی‌های Gemini API را از زمان اجرای سمت سرور در Cloud Run اجرا می‌کنند—برنامه‌های Android به‌عنوان باینری‌های سمت کارخواه (APK) توزیع می‌شوند. جاسازی کردن کلید میانای برنامه‌سازی کاربردی Gemini خام مستقیماً در APK کلید را درمعرض استخراج و سوءاستفاده احتمالی از صورت‌حساب قرار می‌دهد. استفاده از Firebase AI Logic با App Check با تأیید اینکه درخواست‌های ارسال‌شده به Gemini API از نمونه معتبری از برنامه‌تان منشأ می‌گیرد، از پروژه‌تان محافظت می‌کند.

نحوه عملکرد App Check در آزمایش و تولید

Google AI Studio App Check را پیکربندی می‌کند تا برنامه‌تان به‌طور ایمن بدون راه‌اندازی دستی کار کند، چه درحال آزمایش نمونه اولیه باشید چه درحال انتشار در Google Play.

• آزمایش و هم‌رسانی (ساخت‌های اشکال‌زدایی): وقتی پیش‌نمایش برنامه‌تان را در شبیه‌ساز Google AI Studio می‌بینید، آن را ازطریق USB در تلفنتان نصب می‌کنید، یا آن را با آزمایش‌کنندگان مورداعتماد در Google AI Studio هم‌رسانی می‌کنید، برنامه از App Check کد اشکال‌زدایی استفاده می‌کند که Google AI Studio به‌طور خودکار در پشت صحنه آن را مدیریت می‌کند. مشارکت‌کنندگان می‌توانند ویژگی‌های هوش مصنوعی را فوراً بدون دیدن کلیدهای میانای برنامه‌سازی کاربردی یا رمزهای شما آزمایش کنند.
• انتشار در Google Play (ساخت‌های نسخه پخش): وقتی نسخه پخش را برای Google Play می‌سازید، برنامه‌تان به‌طور خودکار به reCAPTCHA Enterprise تغییر می‌کند تا بااستفاده از کلید سایت ازپیش پیکربندی‌شده، گواهی تولید را دریافت کند. نیازی نیست پیش‌از انتشار، Google Play را به‌صورت دستی پیوند دهید یا ارائه‌دهندگان App Check را پیکربندی کنید.

استفاده از پروژه موجود

وقتی برای اولین‌بار ادغام Firebase را فعال می‌کنید، می‌توانید به‌طور اختیاری یک پروژه Google Cloud موجود را که مالک آن هستید انتخاب کنید:

1. در کارتی که بالا می‌آید، روی نماد تنظیمات settings کلیک کنید.
2. پروژه‌تان را انتخاب کنید و سپس روی فعال کردن Firebase کلیک کنید.

همان‌طور که برنامه‌تان را تکرار می‌کنید، می‌توانید به نماینده دستور دهید که از پروژه دیگری استفاده کند، مثلاً با پیام‌واره‌ای مانند:

Add Firestore to this app using project PROJECT_ID.

وقتی پروژه‌ای را انتخاب می‌کنید، کنش‌های زیر انجام می‌شود:

• پایگاه داده Cloud Firestore جدیدی در آن پروژه بااستفاده از سهمیه مشترک تأمین خواهد شد.
• Firebase Authentication با «ورود به سیستم با Google» پیکربندی خواهد شد.
• برای برنامه‌های Android که از هوش مصنوعی زایا استفاده می‌کنند، Firebase AI Logic، Firebase App Check، و reCAPTCHA Enterprise راه‌اندازی خواهد شد. App Check به‌طور خودکار برای Firebase AI Logic اعمال می‌شود تا از سهمیه میانای برنامه‌سازی کاربردی شما محافظت شود.
• به حساب سرویس اجازه داده خواهد شد به پایگاه داده Cloud Firestore شما دسترسی داشته باشد. برای مجاز کردن دسترسی سرپرست از Google AI Studio، حساب سرویس جدیدی به‌نام ais-sandbox@PROJECT_ID.iam.gservice.com اجازه دسترسی به پایگاه داده Cloud Firestore شما را دریافت خواهد کرد. این حساب فقط با برنامه‌های Google AI Studio شما مرتبط است.
• محدودیت‌ها: اگر پروژه Firebase ازقبل پایگاه داده Cloud Firestore داشته باشد، نماینده نمی‌تواند پایگاه داده دیگری اضافه کند. باید پروژه دیگری را انتخاب کنید یا پروژه خالی جدیدی برای استفاده ایجاد کنید.

استفاده از کنسول Firebase

می‌توانید داده‌ها و تنظیمات برنامه‌تان را در کنسول Firebase مشاهده کنید. در اینجا نحوه دسترسی به پروژه Firebase مرتبط با Google AI Studio آمده است:

1. به کنسول Firebase بروید و پروژه دارای برچسب AI Studio را انتخاب کنید.

2. از قاب پیمایش سمت راست، سرویس‌های فعال‌شده در پروژه‌تان را کاوش کنید:

   • برای مشاهده و ویرایش داده‌های ذخیره‌شده Cloud Firestore، به پایگاه‌های داده و فضای ذخیره‌سازی > Firestore بروید.
   • برای مشاهده یا پیکربندی تنظیمات و داده‌های Authentication، به امنیت > اصالت‌سنجی بروید.
   • برای نظارت بر استفاده، مشاهده سهمیه‌ها، یا پیکربندی تنظیمات Firebase AI Logic، به هوش مصنوعی > منطق هوش مصنوعی بروید.
   • برای مدیریت اجرای App Check، نظارت بر درخواست‌های گواهی، یا لغو کردن کدهای اشکال‌زدایی، به امنیت > بررسی برنامه بروید.

عیب‌یابی و پرسشگان

پاسخ پرسش‌های رایج را پیدا کنید و با نحوه حل کردن مشکلات هنگام ادغام Firebase با برنامه Google AI Studio آشنا شوید.

پروژه Google Cloud / Firebase و مکان من چگونه انتخاب می‌شود؟

وقتی برای برنامه‌ای درخواست Firebase backend می‌کنید، می‌توانید به‌طور اختیاری مکان و پروژه‌ای را در کارتی که ظاهر می‌شود انتخاب کنید:

• سفارشی‌سازی پروژه یا مکان (اختیاری): روی نماد تنظیمات settings کلیک کنید، مکان یا پروژه Google Cloud را که می‌خواهید استفاده کنید انتخاب کنید، و سپس روی فعال کردن Firebase کلیک کنید.

موارد زیر را به یاد داشته باشید:

• مکان پایگاه داده دائمی است: وقتی مکانی را برای پایگاه داده‌تان انتخاب می‌کنید، نمی‌توانید آن را برای آن پروژه تغییر دهید. این انتخاب به‌عنوان پیش‌فرض برای دیگر سرویس‌های پس‌زمینه استفاده خواهد شد.
• سازگاری پروژه: برای اطمینان از ادغام یکپارچه، Google AI Studio به‌طور خودکار از همان پروژه برای هر دو بخش باطنی و استقرار شما استفاده می‌کند. نمی‌توانید از پروژه‌های مختلف برای سرویس‌های مختلف در یک برنامه استفاده کنید.

از چه روش‌های اصالت‌سنجی پشتیبانی می‌شود؟

وقتی درخواست راه‌اندازی Authentication یا صفحه ورود به سیستم را می‌دهید، نماینده Google AI Studio «ورود به سیستم با Google» را راه‌اندازی می‌کند. در اینجا نحوه افزودن روش‌های ورود به سیستم اضافی به برنامه‌تان آورده شده است:

1. در کنسول Firebase، به صفحه امنیت > اصالت‌سنجی > روش ورود به سیستم بروید، و روش‌های ورود به سیستم دلخواه را پیکربندی کنید.

2. به Google AI Studio برگردید و از نماینده Google AI Studio بخواهید برای به‌روزرسانی پایگاه کدتان با روش جدید ورود به سیستم به شما کمک کند.

آیا می‌توانم با Google AI Studio برنامه تلفن همراه (مثل Android یا iOS) ایجاد کنم؟

عامل Google AI Studio از ایجاد برنامه‌های وب و برنامه‌های Android پشتیبانی می‌کند. ادغام Firebase از افزودن Cloud Firestore و Authentication به برنامه‌های وب و Android پشتیبانی می‌کند و علاوه‌براین، از Firebase AI Logic و Firebase App Check برای برنامه‌های Android پشتیبانی می‌کند.

ساختن برنامه‌های iOS در Google AI Studio پشتیبانی نمی‌شود. بااین‌حال، درست مانند همه برنامه‌های وب، برنامه‌های وبی که Google AI Studio ایجاد می‌کند می‌توانند به‌عنوان برنامه‌های وب تلفن همراه از مرورگرهایی که در دستگاه‌های همراه نصب شده‌اند (ازجمله iOS) قابل دسترسی باشند.

در سند Google AI Studio درباره ساختن برنامه‌های Android بیشتر بدانید.

چرا ادغام Firebase AI Logic و App Check فقط برای برنامه‌های Android استفاده می‌شود و نه برنامه‌های وب؟

برنامه‌های Android به‌عنوان فایل‌های دودویی سمت کارخواه (APK) توزیع می‌شوند. اگر یک برنامه Android مستقیماً بااستفاده از کلید میانای برنامه‌سازی کاربردی استاندارد، Gemini API را فراخوانی کند، هرکسی می‌تواند APK را تبدیل کد کند، کلید را استخراج کند، و درخواست‌های غیرمجاز ارسال کند. برای جلوگیری از این اتفاق، برنامه‌های Android ساخته‌شده در Google AI Studio از Firebase AI Logic به‌همراه Firebase App Check استفاده می‌کنند تا تأیید کنند درخواست‌ها از نمونه معتبر برنامه شما ارسال شده است.

ازسوی‌دیگر، برنامه‌های وب ساخته‌شده در Google AI Studio درخواست‌های Gemini API را از یک زمان اجرای امن سمت سرور (که هنگام استقرار در Cloud Run میزبانی می‌شود) بااستفاده از «کیت توسعه نرم‌افزار هوش مصنوعی زایای Google» اجرا می‌کنند. چون کلید میانای API در سرور باقی می‌ماند و هرگز برای مرورگر کارخواه آشکار نمی‌شود، Firebase AI Logic و App Check سمت کارخواه برای برنامه‌های وب با این ساختار لازم نیست.

فایل firebase-blueprint.json چیست؟

این فایل واسطی است که عامل Google AI Studio از آن برای درک پایگاه کد برنامه‌تان استفاده می‌کند. این فایل را به‌صورت دستی اصلاح نکنید، زیرا ممکن است باعث شود که نماینده کد نادرست یا Security Rules ناامن تولید کند.

اگر خطای «سهمیه تمام شده است» دریافت کردم چه باید بکنم؟

رسیدن به حد سهمیه Cloud Firestore یعنی برنامه‌تان به سقف استفاده روزانه خود برای گروه سهمیه مشترک پایگاه داده Cloud Firestore رسیده است. دو روش برای حل‌وفصل این مشکل وجود دارد:

• گزینه ۱: صبر کنید: سهمیه‌ها هر روز حدود نیمه‌شب به وقت اقیانوس آرام بازنشانی می‌شوند.
• گزینه ۲: ارتقا دادن: به طرح قیمت‌گذاری Blaze با پرداخت به اندازه استفاده ارتقا دهید.
  • اگر نماینده Google AI Studio Cloud Firestore را برای شما راه‌اندازی کرده است، باید از دکمه ارتقا دادن پایگاه داده که در افزودن صورت‌حساب برای دریافت سهمیه Cloud Firestore بیشتر شرح داده شده است استفاده کنید تا پایگاه داده‌تان را به حالت پولی معمولی منتقل کنید. اگر Cloud Firestore را به‌صورت دستی راه‌اندازی کرده‌اید، استفاده از دکمه ارتقا دادن پایگاه داده لازم نیست.

اگر خطای «اجازه‌ها وجود ندارد یا کافی نیست» دریافت کردم، چه کاری باید انجام دهم؟

این خطا زمانی رخ می‌دهد که برنامه شما تلاش می‌کند داده‌ها را در پایگاه داده Cloud Firestore بخواند یا بنویسد، اما درخواست توسط Security Rules رد می‌شود. این نشان می‌دهد که Security Rules براساس وضعیت اصالت‌سنجی فعلی یا مسیر داده، اجازه انجام عملیات موردنظر را نمی‌دهد. روی دکمه رفع خطا کلیک کنید تا از نماینده Google AI Studio خواسته شود Security Rules را اصلاح کند.

وقتی برنامه Google AI Studio را حذف می‌کنم، چه اتفاقی برای Firebase backend من می‌افتد؟

حذف کردن برنامه در 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 شما حذف، ویرایش، یا دستکاری کند، می‌تواند کدی را در برنامه شما بنویسد که برای انجام این اقدامات طراحی شده است. برای انجام دادن کارهای مدیریت داده، مثل حذف کردن ورودی‌ها، به صفحه پایگاه‌های داده و فضای ذخیره‌سازی > Firestore در کنسول Firebase بروید.

من عضو سازمانی هستم که از Google Cloud استفاده می‌کند؛ آیا می‌توانم برنامه Google AI Studio خود را به پروژه‌ای موجود در محیط Google Cloud سازمانم متصل کنم؟

بله. مطمئن شوید پروژه Firebase شما در پوشه سازمان Google Cloud قرار دارد، سپس پروژه‌تان را بااستفاده از یکی از روش‌های زیر متصل کنید:

• درطول فعال‌سازی: وقتی برای اولین‌بار ادغام Firebase را در Google AI Studio فعال می‌کنید، پروژه موجودتان را در کارتی که ظاهر می‌شود انتخاب کنید. روی نماد تنظیمات settings کلیک کنید و پروژه‌تان را انتخاب کنید.

• درطول تکرار: اگر قبلاً Firebase را فعال کرده‌اید یا می‌خواهید بعداً پروژه‌ها را عوض کنید، می‌توانید با پیام‌واره‌ای مثل پیام‌واره زیر به نماینده دستور دهید از پروژه موجود شما استفاده کند:

    Add Firestore to this app using project PROJECT_ID.
  

چرا نمی‌توانم برخی‌از اسناد را در کنسول Firebase پیدا کنم؟

وقتی که نماینده AI Studio داده‌ها را در یک مسیر تودرتو (مانند /users/user1/messages/msg1) ذخیره می‌کند، بدون اینکه ابتدا سند والد (user1) را ایجاد کند، چیزی را ایجاد می‌کند که به‌عنوان سند والد غیرموجود شناخته می‌شود. این اسناد در کنسول Firebase نمایش داده نمی‌شوند، که می‌تواند پیدا کردن آن‌ها را هنگام مرور پایگاه داده Cloud Firestore دشوار کند. اگرچه این موضوع بر نحوه اجرای برنامه‌تان تأثیر نمی‌گذارد، اغلب می‌توانید مشکل را برای نماینده AI Studio شرح دهید تا آن را به ایجاد اسناد والد مفقودشده ترغیب کنید.

برای جزئیات بیشتر، اسناد اصلی غیرموجود را ببینید.

آیا می‌توانم مکان پایگاه داده Cloud Firestore را انتخاب کنم؟

بله. وقتی برای اولین‌بار ادغام Firebase را در Google AI Studio فعال می‌کنید، می‌توانید مکان پایگاه داده Cloud Firestore را انتخاب کنید.

به‌خاطر داشته باشید که مکان انتخابی شما برای همه پایگاه‌های داده Cloud Firestore که نماینده Google AI Studio در آن پروژه Firebase ایجاد می‌کند اعمال می‌شود. پس‌از تنظیم، این مکان را نمی‌توان برای آن پایگاه‌های داده تغییر داد.

پس‌از ارتقا دادن پایگاه داده Cloud Firestore، می‌توانم آن را به گروه سهمیه مشترک برگردانم؟

وقتی پایگاه داده از گروه سهمیه هم‌رسانی‌شده خارج شد و به نمونه پولی معمولی تبدیل شد، می‌توانید از فرمان curl برای برگرداندن آن به گروه سهمیه هم‌رسانی‌شده استفاده کنید. توجه داشته باشید که همه پایگاه‌های داده در گروه سهمیه مشترک باید از یک نسخه باشند و در یک منطقه قرار داشته باشند.

• PROJECT_ID : شناسه پروژه Firebase. این شناسه را در صفحه settings تنظیمات > عمومی کنسول 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 API با دسترسی عمومی برای پروژه Google Cloud» دریافت کردم. چه کاری باید انجام دهم؟

اگر ایمیلی از Google Cloud درباره «کلید Google API با دسترسی عمومی برای پروژه Google Cloud» دریافت کرده‌اید و کلید API فهرست‌شده در ایمیل کلید Firebase API شما است، مطمئن شوید که کلید API شرایط زیر را برآورده می‌کند تا بتوانید آن را به‌طور ایمن در کد یا فایل‌های پیکربندی خود قرار دهید. می‌توانید موارد زیر را در صفحه APIs & Services (میاناهای برنامه‌سازی کاربردی و سرویس‌ها) > Credentials (اطلاعات کاربری) در کنسول 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 Security Rules و App Check طبق توصیه برای محصولات Firebase که استفاده می‌کنید بهره می‌برید.

می‌توانید جزئیات مربوط به کلیدهای میانای برنامه‌سازی کاربردی برای Firebase را یاد بگیرید و فهرستی از پرسشگان را در آشنایی با استفاده و مدیریت کلیدهای میانای برنامه‌سازی کاربردی برای Firebase پیدا کنید