إضافة Firebase إلى تطبيق Google AI Studio

يمكن أن يعمل وضع الإنشاء في Google AI Studio على إعداد خدمات Firebase ودمجها تلقائيًا في تطبيقات الويب وتطبيقات Android:

• Cloud Firestore وFirebase Authentication (لتطبيقات الويب وAndroid) لإنشاء تطبيقات تتضمّن مساحة تخزين بيانات دائمة ومسارات تسجيل دخول آمنة
• Firebase AI Logic وFirebase App Check (لتطبيقات Android) لطلب نماذج Gemini مباشرةً من تطبيقك على الأجهزة الجوّالة بشكل آمن وبدون الكشف عن مفاتيح واجهة برمجة التطبيقات

باستخدام طلب واحد وبضع نقرات، يمكنك السماح لوكيل 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: يمكنك إنشاء تطبيقك واختباره بدون إضافة معلومات الفوترة. يمكنك الاطّلاع على التفاصيل أدناه حول إمكانية إضافة معلومات الفوترة.
• إعادة الضبط اليومية: في حال بلوغ الحدّ الأقصى للحصة اليومية (على سبيل المثال، 50 ألف عملية قراءة في اليوم)، ستتوقف الخدمة مؤقتًا لجميع قواعد البيانات ضمن المجموعة وتُستأنف في اليوم التالي في منتصف الليل تقريبًا بتوقيت المحيط الهادئ.

تتشارك قواعد بيانات Cloud Firestore في مجموعة الحصص المشتركة الحدود التالية:

(اختياري) إضافة معلومات الفوترة للحصول على حصة أكبر من Cloud Firestore

إذا حقّق تطبيقك رواجًا واحتجت إلى تجاوز حدود الاستخدام المجاني Cloud Firestore، يمكنك إضافة معلومات الفوترة التي تؤدي إلى ترقية مشروعك على Firebase إلى خطة أسعار "الفئة المَرِنة" بنظام الدفع حسب الاستخدام.

ربما سبق لك إضافة معلومات الفوترة إلى مشروعك لأسباب مختلفة، مثل استخدام Nano Banana. إذا كان الأمر كذلك، يعني هذا أنّ مشروعك يستخدم حاليًا خطة أسعار Blaze المَرِنة، ويمكنك الانتقال مباشرةً إلى خطوة ترقية قاعدة البيانات.

الخطوة 1: إضافة معلومات الفوترة (إذا لم يسبق لك ذلك)

يمكنك إعداد الفوترة مباشرةً في Google AI Studio.

1. في Google AI Studio، انتقِل إلى صفحة المشاريع.
2. انقر على إعداد الفوترة بجانب المشروع الذي تريد ترقيته.
3. اتّبِع التعليمات الظاهرة على الشاشة لاختيار بلدك والموافقة على البنود وإضافة طريقة دفع أو اختيار حساب فوترة حالي. قد يُطلب منك أيضًا دفع مبلغ مسبق (وهو لا ينطبق على استخدام خدمات Firebase وGoogle Cloud).

الخطوة 2: ترقية قاعدة البيانات

حتى بعد إضافة الفوترة، تظل قواعد بيانات Cloud Firestore التي أنشأها عامل Google AI Studio في مجموعة الحصة المشتركة. لتفعيل التوسيع الكامل المدفوع لقاعدة بيانات معيّنة، عليك ترقيتها يدويًا.

1. انتقِل إلى Firebase وحدة التحكّم واختَر المشروع الذي يحتوي على قاعدة البيانات التي تريد ترقيتها.
2. من مساحة الروابط على يمين الصفحة، انتقِل إلى قواعد البيانات ومساحة التخزين (Databases & Storage) > قاعدة بيانات 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 API الأولي مباشرةً في حزمة 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 لتطبيق، يمكنك اختياريًا تحديد موقع ومشروع في البطاقة التي تظهر:

• تخصيص المشروع أو الموقع الجغرافي (اختياري): انقر على رمز الإعدادات settings، واختَر موقعًا جغرافيًا أو مشروع Google Cloud تريد استخدامه، ثم انقر على تفعيل Firebase.

يرجى الإحاطة علمًا بالتالي:

• موقع قاعدة البيانات دائم: بعد اختيار موقع لقاعدة بياناتك، لا يمكنك تغييره لهذا المشروع. سيتم استخدام هذا الخيار كإعداد تلقائي لخدمات الخلفية الأخرى.
• اتّساق المشروع: لضمان تكامل سلس، تستخدم Google AI Studio تلقائيًا المشروع نفسه لكل من الخلفية وعملية النشر. لا يمكنك استخدام مشاريع مختلفة لخدمات مختلفة ضمن التطبيق نفسه.

ما هي طرق المصادقة المتوافقة؟

يُعدّ وكيل Google AI Studio ميزة "تسجيل الدخول باستخدام حساب Google" عندما تطلب إعداد Authentication أو شاشة تسجيل الدخول. في ما يلي كيفية إضافة طرق تسجيل دخول أخرى إلى تطبيقك:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة الأمان > المصادقة > طريقة تسجيل الدخول، واضبط أي طرق تسجيل دخول مطلوبة.

2. بعد ذلك، ارجع إلى Google AI Studio واطلب من وكيل Google AI Studio المساعدة في تعديل قاعدة الرموز البرمجية باستخدام طريقة تسجيل الدخول الجديدة.

هل يمكنني إنشاء تطبيق متوافق مع الأجهزة الجوّالة (مثل Android أو iOS) باستخدام Google AI Studio؟

يتيح وكيل Google AI Studio إنشاء كل من تطبيقات الويب وتطبيقات Android. يتيح دمج Firebase إضافة السمتَين Cloud Firestore وAuthentication إلى تطبيقات الويب وتطبيقات Android، كما يتيح إضافة السمتَين Firebase AI Logic وFirebase App Check إلى تطبيقات Android.

لا يمكن إنشاء تطبيقات iOS في "Google AI Studio". ومع ذلك، مثل جميع تطبيقات الويب، يمكن الوصول إلى تطبيقات الويب التي ينشئها Google AI Studio كتطبيقات ويب للأجهزة الجوّالة من المتصفحات المثبتة على الأجهزة الجوّالة (بما في ذلك iOS).

يمكنك الاطّلاع على مزيد من المعلومات حول إنشاء تطبيقات Android في مستندات Google AI Studio.

لماذا يتم استخدام دمج 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 عند نشرها) باستخدام حزمة تطوير البرامج (SDK) لـ Google الذكاء الاصطناعي التوليدي. بما أنّ مفتاح واجهة برمجة التطبيقات يظل على الخادم ولا يتم عرضه مطلقًا لمتصفّح العميل، لا تكون هناك حاجة إلى Firebase AI Logic وApp Check من جهة العميل لتطبيقات الويب التي تم تصميمها على هذا النحو.

ما هو ملف firebase-blueprint.json؟

هذا ملف وسيط يستخدمه الوكيل Google AI Studio لفهم قاعدة الرموز البرمجية لتطبيقك. لا تعدِّل هذا الملف يدويًا، لأنّ ذلك قد يؤدي إلى أن ينشئ الوكيل رمزًا برمجيًا غير صحيح أو Security Rules غير آمن.

ماذا أفعل إذا ظهرت لي رسالة الخطأ "تم تجاوز الحصة"؟

يعني الوصول إلى الحد الأقصى لحصة Cloud Firestore أنّ تطبيقك قد وصل إلى الحد الأقصى للاستخدام اليومي لمجموعة الحصص المشتركة في قاعدة بيانات Cloud Firestore. هناك طريقتان لحلّ هذه المشكلة:

• الخيار 1: الانتظار: تتم إعادة ضبط الحصص يوميًا في منتصف الليل بتوقيت المحيط الهادئ.
• الخيار 2: الترقية: يمكنك الترقية إلى خطة Blaze المَرِنة التي تتيح لك الدفع حسب الاستخدام.
  • إذا أعدّ موظف دعم Google AI Studio قاعدة بيانات Cloud Firestore لك، عليك بعد ذلك استخدام الزر ترقية قاعدة البيانات الموضَّح في إضافة الفوترة للحصول على حصة أكبر في Cloud Firestore لنقل قاعدة بياناتك إلى حالة مدفوعة عادية. إذا أعددت Cloud Firestore يدويًا، لن تحتاج إلى استخدام الزر ترقية قاعدة البيانات.

ماذا أفعل إذا ظهرت لي رسالة الخطأ "الأذونات غير متوفّرة أو غير كافية"؟

يحدث هذا الخطأ عندما يحاول تطبيقك قراءة البيانات أو كتابتها في قاعدة بيانات Cloud Firestore، ولكن يتم رفض الطلب من قِبل Security Rules. يشير ذلك إلى أنّ Security Rules لا تسمح بتنفيذ العملية المطلوبة استنادًا إلى حالة المصادقة الحالية أو مسار البيانات. انقر على الزر إصلاح الخطأ لطلب أن يحاول وكيل Google AI Studio تصحيح Security Rules.

ماذا يحدث لخادم Firebase الخلفي عند حذف تطبيق Google AI Studio؟

لا يؤدي حذف تطبيقك في "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 يستوفي المتطلبات التالية ليكون من الآمن تضمينه في الرموز البرمجية أو ملفات الإعداد. يمكنك التحقّق من ما يلي في صفحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة تحكّم 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.