افزودن 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 و فایل‌های پیکربندی لازم را مستقیماً در برنامه‌تان تولید کند.

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

نمای کلی: افزودن زیرینه به برنامه 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» را از زمان اجرای سمت سرور در 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 به‌طور خودکار در پشت صحنه آن را مدیریت می‌کند. مشارکت‌کنندگان می‌توانند ویژگی‌های هوش مصنوعی را بدون دیدن رمزها یا رمزهای API شما بلافاصله آزمایش کنند.
• انتشار در 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 آشنا شوید.

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

وقتی برای برنامه‌ای درخواست 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» را از زمان اجرای سمت سرور ایمن (میزبانی‌شده در 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 console بروید و پروژه را حذف کنید یا منابع جداگانه (مثل 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 پیدا کنم؟

وقتی کارگزار «استودیو هوش مصنوعی» داده‌ها را در مسیر تودرتو (مثل /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 پیدا کنید