هل لديك تحديات أخرى أو لا ترى مشكلتك موضحة أدناه؟ يرجى الإبلاغ عن خطأ أو طلب ميزة والانضمام إلى مناقشات Stack Overflow .
مشاريع Firebase وتطبيقات Firebase
ما هو مشروع Firebase؟
مشروع Firebase هو كيان المستوى الأعلى لـ Firebase. في المشروع ، يمكنك تسجيل تطبيقات Apple أو Android أو الويب. بعد تسجيل تطبيقاتك في Firebase ، يمكنك إضافة حزم Firebase SDK الخاصة بالمنتج إلى تطبيقك ، مثل Analytics أو Cloud Firestore أو Crashlytics أو Remote Config.
يجب عليك تسجيل متغيرات تطبيقات Apple و Android والويب في مشروع Firebase واحد. يمكنك استخدام العديد من مشاريع Firebase لدعم بيئات متعددة ، مثل التطوير والتشغيل المرحلي والإنتاج.
فيما يلي بعض الموارد لمعرفة المزيد حول مشاريع Firebase:
- فهم مشاريع Firebase - يوفر لمحات عامة موجزة عن العديد من المفاهيم المهمة حول مشاريع Firebase ، بما في ذلك علاقتها مع Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.
- أفضل الممارسات العامة لإعداد مشاريع Firebase - يوفر أفضل الممارسات العامة عالية المستوى لإعداد مشاريع Firebase وتسجيل تطبيقاتك في مشروع بحيث يكون لديك سير عمل تطوير واضح يستخدم بيئات متميزة.
لاحظ أنه بالنسبة لجميع مشاريع Firebase ، يضيف Firebase تلقائيًا تسمية firebase:enabled
في صفحة التصنيفات لمشروعك في Google Cloud Console. تعرف على المزيد حول هذه التسمية في الأسئلة الشائعة الخاصة بنا.
ما هي مؤسسة جوجل كلاود؟
مؤسسة Google Cloud هي حاوية لمشاريع Google Cloud (بما في ذلك مشاريع Firebase). يتيح هذا التسلسل الهرمي تنظيمًا أفضل وإدارة الوصول والتدقيق لمشاريع Google Cloud و Firebase. لمزيد من المعلومات ، راجع إنشاء وإدارة المنظمات .
كيف أضيف Firebase إلى مشروع Google Cloud موجود؟
قد يكون لديك مشاريع حالية تتم إدارتها من خلال Google Cloud Console أو وحدة تحكم Google APIs . بشكل افتراضي ، تكون هذه المشاريع مرئية في وحدة تحكم Firebase ، ولكنها لا تعتبر مشروعات Firebase.
لإضافة Firebase إلى مشروع Google Cloud الحالي ، انقر على "إضافة مشروع" في الصفحة المقصودة لوحدة تحكم Firebase ، ثم حدد مشروعك في قائمة اسم المشروع .
لماذا يحتوي مشروعي على Google Cloud على تصنيف firebase:enabled
؟
في صفحة التصنيفات لمشروعك في Google Cloud Console ، قد ترى تسمية firebase:enabled
(على وجه التحديد ، Key
firebase
مع enabled
Value
).
أضاف Firebase هذه التسمية تلقائيًا لأن مشروعك هو مشروع Firebase ، مما يعني أن مشروعك به تكوينات وخدمات خاصة بـ Firebase مُمكَّنة له. تعرف على المزيد حول العلاقة بين مشاريع Firebase و Google Cloud .
نوصي بشدة بعدم تعديل أو حذف هذه التسمية. يتم استخدام هذا التصنيف بواسطة Firebase و Google Cloud لسرد مشروعات Firebase (على سبيل المثال ، عبر قائمة REST API projects.list
أو في القوائم داخل وحدة تحكم Firebase).
اعلم أن إضافة هذا التصنيف يدويًا إلى قائمة تسميات المشروع لا يؤدي إلى تمكين التكوينات والخدمات الخاصة بـ Firebase لمشروع Google Cloud الخاص بك. للقيام بذلك ، تحتاج إلى إضافة Firebase عبر وحدة تحكم Firebase (أو ، لحالات الاستخدام المتقدمة ، عبر Firebase Management REST API أو Firebase CLI ).
لماذا لا يظهر مشروعي في Firebase في قائمة مشاريع Firebase؟
هذه الأسئلة الشائعة قابلة للتطبيق إذا لم تشاهد مشروع Firebase الخاص بك في الأماكن التالية:
- في قائمة المشاريع التي تشاهدها داخل وحدة تحكم Firebase
- ردًا على استدعاء REST API
projects.list
endpoint - في الاستجابة من تشغيل
firebase projects:list
جرب هذه الخطوات لتحري الخلل وإصلاحه:
- أولاً ، حاول الوصول إلى مشروعك من خلال زيارة عنوان URL الخاص بالمشروع مباشرةً. استخدم التنسيق التالي:
https://console.firebase.google.com/project/ PROJECT-ID /overview
- إذا لم تتمكن من الوصول إلى المشروع أو تلقيت أخطاء الأذونات ، فتحقق مما يلي:
- تأكد من تسجيل الدخول إلى Firebase باستخدام نفس حساب Google الذي يمكنه الوصول إلى المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.
- تحقق مما إذا كان يمكنك عرض المشروع في Google Cloud Console .
- تأكد من أن مشروعك يحمل التصنيف
firebase:enabled
في صفحة التصنيفات لمشروعك في Google Cloud Console. يستخدم Firebase و Google Cloud هذا التصنيف لسرد مشاريع Firebase. إذا كنت لا ترى هذا التصنيف ولكن تم تمكين Firebase Management API لمشروعك ، فقم بإضافة التسمية يدويًا (على وجه التحديد ،Key
firebase
معenabled
Value
). - تأكد من تعيين أحد أدوار IAM الأساسية (مالك ، محرر ، عارض) أو دور له أذونات متعلقة بـ Firebase ، على سبيل المثال دور Firebase محدد مسبقًا . يمكنك عرض الدور (الأدوار) الخاص بك في صفحة IAM في Google Cloud Console.
- إذا كان مشروعك ينتمي إلى مؤسسة Google Cloud ، فقد تحتاج إلى أذونات إضافية لرؤية المشروع مدرجًا في وحدة تحكم Firebase. اتصل بالشخص الذي يدير مؤسسة Google Cloud الخاصة بك لمنحك الدور المناسب لعرض المشروع ، على سبيل المثال دور المستعرض.
إذا لم تمكّنك أي خطوة من خطوات تحرّي الخلل وإصلاحه أعلاه من رؤية مشروعك في قائمة مشاريع Firebase ، فاتصل بدعم Firebase .
كم عدد المشاريع التي يمكنني الحصول عليها لكل حساب؟
- خطة تسعير شرارة - تقتصر حصة مشروعك على عدد صغير من المشاريع (عادة حوالي 5-10).
- خطة تسعير Blaze - تزداد حصة مشروعك لكل حساب Cloud Billing بشكل كبير طالما أن حساب Cloud Billing الخاص بك في وضع جيد.
نادرًا ما يكون الحد الأقصى لحصة المشروع مصدر قلق لمعظم المطورين ، ولكن إذا لزم الأمر ، يمكنك طلب زيادة في حصة المشروع الخاصة بك .
لاحظ أن الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصتك حتى يتم حذفه بالكامل.
كم عدد تطبيقات Firebase التي يمكنني الحصول عليها في مشروع Firebase؟
مشروع Firebase عبارة عن حاوية لتطبيقات Firebase عبر Apple و Android والويب. يقيد Firebase إجمالي عدد تطبيقات Firebase ضمن مشروع Firebase بـ 30.
بعد هذا الرقم ، يبدأ الأداء في التدهور (خاصةً بالنسبة إلى Google Analytics) ، وفي النهاية ، في عدد أكبر من التطبيقات ، تتوقف بعض وظائف المنتج عن العمل. بالإضافة إلى ذلك ، تؤدي إضافة تطبيق Firebase إلى مشروع إلى إنشاء معرف عميل OAuth 2.0 أساسي واحد أو أكثر. يوجد حد يبلغ حوالي 30 معرّفًا للعميل يمكن إنشاؤها في مشروع واحد.
يجب عليك التأكد من أن جميع تطبيقات Firebase ضمن مشروع Firebase واحد هي متغيرات النظام الأساسي للتطبيق نفسه من منظور المستخدم النهائي. على سبيل المثال ، إذا قمت بتطوير تطبيق تسمية أولية ، فيجب أن يكون لكل تطبيق مصنف بشكل مستقل مشروع Firebase الخاص به ، ولكن يمكن أن تكون إصدارات Apple و Android من هذا التصنيف في نفس المشروع. اقرأ المزيد من الإرشادات التفصيلية في أفضل ممارساتنا العامة لإعداد مشاريع Firebase .
في حالة نادرة يتطلب مشروعك أكثر من 30 تطبيقًا ، يمكنك طلب زيادة حد التطبيق. يجب أن يكون مشروعك على خطة تسعير Blaze لتقديم هذا الطلب. قم بزيارة Google Cloud Console لتقديم طلبك وتقييمه. تعرف على المزيد حول إدارة الحصص في وثائق Google Cloud.
ماذا يحدث إذا وضعت علامة على مشروعي على أنه بيئة "إنتاج"؟
في وحدة تحكم Firebase ، يمكنك تمييز مشاريعك في Firebase بنوع بيئتها ، إما كبيئات إنتاج أو بيئات غير محددة (غير إنتاجية).
لا يؤثر وضع علامة على مشروعك كنوع بيئة على كيفية عمل مشروع Firebase أو ميزاته. ومع ذلك ، يمكن أن تساعدك العلامات أنت وفريقك في إدارة مشاريع Firebase المتنوعة لدورة حياة التطبيق.
إذا قمت بوضع علامة على مشروعك كبيئة إنتاج ، فإننا نضيف علامة Prod ذات الألوان الزاهية إلى المشروع في وحدة تحكم Firebase ، لتذكيرك بأن أي تغييرات قد تؤثر على تطبيقات الإنتاج المرتبطة. في المستقبل ، قد نضيف المزيد من الميزات والضمانات لمشاريع Firebase التي تم وضع علامة عليها كبيئات إنتاج.
لتغيير نوع البيئة لمشروع Firebase الخاص بك ، انتقل إلى settings Project settings > General ، ثم في بطاقة مشروعك ضمن البيئة ، انقر فوق edit لتغيير نوع البيئة.
أين يمكنني العثور على معرف التطبيق لتطبيق Firebase الخاص بي؟
في وحدة تحكم Firebase ، انتقل إلى settings المشروع الخاصة بك. قم بالتمرير لأسفل إلى بطاقة التطبيقات الخاصة بك ، ثم انقر فوق تطبيق Firebase المطلوب لعرض معلومات التطبيق ، بما في ذلك معرف التطبيق الخاص به.
فيما يلي بعض الأمثلة على قيم معرّف التطبيق:
- تطبيقات Firebase iOS:
1:1234567890:ios:321abc456def7890
- تطبيقات Firebase Android:
1:1234567890:android:321abc456def7890
- تطبيقات الويب Firebase:
1:1234567890:web:321abc456def7890
ما هي المتطلبات الأساسية لربط Google Play / AdMob / Google Ads / BigQuery بمشروع أو تطبيقي على Firebase؟
- لربط حساب Google Play الخاص بك ، تحتاج إلى ما يلي:
- أي من أدوار Firebase التالية: المالك أو مشرف Firebase
و - أي من مستويات الوصول التالية إلى Google Play: مالك الحساب أو المسؤول
- أي من أدوار Firebase التالية: المالك أو مشرف Firebase
- لربط تطبيق AdMob ، يجب أن تكون مالك مشروع Firebase ومسؤول AdMob.
- لربط حسابك في AdWords ، يجب أن تكون مالكًا لمشروع Firebase ومسؤولًا في AdWords.
- لربط مشروع BigQuery ، يجب أن تكون مالك مشروع Firebase.
ما هي إشعارات المصدر المفتوح التي يجب أن أدرجها في تطبيقي؟
على أنظمة Apple الأساسية ، تحتوي حافظة Firebase على ملف NOTICES الذي يتضمن الإدخالات ذات الصلة. تحتوي حزمة Firebase Android SDK على Activity
مساعد لعرض معلومات الترخيص.
الأذونات والوصول إلى مشاريع Firebase
كيف يمكنني تعيين دور لعضو في المشروع ، مثل دور المالك؟
لإدارة الدور (الأدوار) المعينة لكل عضو في المشروع ، يجب أن تكون مالكًا لمشروع Firebase (أو أن يتم تعيين دور مع الإذن resourcemanager.projects.setIamPolicy
).
إليك الأماكن حيث يمكنك تعيين الأدوار وإدارتها:
- توفر وحدة تحكم Firebase طريقة مبسطة لتعيين الأدوار لأعضاء المشروع في علامة التبويب المستخدمون والأذونات في settings > إعدادات المشروع . في وحدة تحكم Firebase ، يمكنك تعيين أي من الأدوار الأساسية (مالك ، محرر ، عارض) ، أو أدوار مشرف / عارض Firebase ، أو أي من أدوار فئة المنتج المحددة مسبقًا في Firebase .
- تقدم Google Cloud Console مجموعة موسعة من الأدوات لتعيين الأدوار لأعضاء المشروع في صفحة IAM . في Cloud Console ، يمكنك أيضًا إنشاء أدوار مخصصة وإدارتها ، بالإضافة إلى منح حسابات الخدمة حق الوصول إلى مشروعك.
لاحظ أنه في Google Cloud Console ، يُطلق على أعضاء المشروع اسم المدير .
إذا لم يعد بإمكان مالك مشروعك أداء مهام المالك (على سبيل المثال ، ترك الشخص شركتك) ولم تتم إدارة مشروعك عبر مؤسسة Google Cloud (انظر الفقرة التالية) ، يمكنك الاتصال بدعم Firebase للحصول على تم تعيين مالك مؤقت.
لاحظ أنه إذا كان مشروع Firebase جزءًا من مؤسسة Google Cloud ، فقد لا يكون له مالك. إذا لم تتمكن من العثور على مالك لمشروع Firebase ، فاتصل بالشخص الذي يدير مؤسسة Google Cloud لتعيين مالك للمشروع.
كيف أعثر على مالك مشروع Firebase؟
يمكنك مشاهدة أعضاء المشروع وأدوارهم في الأماكن التالية:
- إذا كان لديك حق الوصول إلى المشروع في وحدة تحكم Firebase ، فيمكنك عرض قائمة أعضاء المشروع ، بما في ذلك المالكون ، في صفحة المستخدمون والأذونات بوحدة تحكم Firebase.
- إذا لم يكن لديك حق الوصول إلى المشروع في وحدة تحكم Firebase ، فتحقق مما إذا كان لديك حق الوصول إلى المشروع في Google Cloud Console. يمكنك عرض قائمة أعضاء المشروع ، بما في ذلك المالكون ، في صفحة IAM في Google Cloud Console.
إذا لم يعد بإمكان مالك مشروعك أداء مهام المالك (على سبيل المثال ، ترك الشخص شركتك) ولم تتم إدارة مشروعك عبر مؤسسة Google Cloud (انظر الفقرة التالية) ، يمكنك الاتصال بدعم Firebase للحصول على تم تعيين مالك مؤقت.
لاحظ أنه إذا كان مشروع Firebase جزءًا من مؤسسة Google Cloud ، فقد لا يكون له مالك. بدلاً من ذلك ، يمكن للشخص الذي يدير مؤسستك في Google Cloud تنفيذ العديد من المهام التي يمكن للمالك القيام بها. ومع ذلك ، لأداء العديد من المهام الخاصة بالمالك (مثل تعيين الأدوار أو إدارة خصائص Google Analytics) ، قد يحتاج المسؤول إلى تعيين دور المالك الفعلي لأداء تلك المهام. إذا لم تتمكن من العثور على مالك لمشروع Firebase ، فاتصل بالشخص الذي يدير مؤسسة Google Cloud لتعيين مالك للمشروع.
لماذا أو متى يجب أن أسند لعضو في المشروع دور المالك؟
لضمان الإدارة السليمة لمشروع Firebase ، يجب أن يكون له مالك . مالك المشروع هو الشخص الذي يمكنه تنفيذ العديد من الإجراءات الإدارية المهمة (مثل تعيين الأدوار وإدارة خصائص Google Analytics) ، ويمكن لـ Firebase Support تلبية الطلبات الإدارية فقط من مالكي المشروع المحددين.
بعد إعداد المالك (المالكين) لمشروع Firebase ، من المهم الحفاظ على تحديث هذه التعيينات.
لاحظ أنه إذا كان مشروع Firebase جزءًا من مؤسسة Google Cloud ، فيمكن للشخص الذي يدير مؤسستك في Google Cloud تنفيذ العديد من المهام التي يمكن للمالك القيام بها. ومع ذلك ، بالنسبة للعديد من المهام الخاصة بالمالك (مثل تعيين الأدوار أو إدارة خصائص Google Analytics) ، قد يحتاج المسؤول إلى تعيين دور المالك الفعلي لأداء تلك المهام.
لا أعتقد أن لديّ مشروع Firebase ، لكنني تلقيت بريدًا إلكترونيًا حوله. كيف يمكنني الوصول إلى هذا المشروع؟
يجب أن يحتوي البريد الإلكتروني الذي تلقيته على رابط لفتح مشروع Firebase. يجب أن يؤدي النقر فوق الارتباط الموجود في البريد الإلكتروني إلى فتح المشروع في وحدة تحكم Firebase.
إذا لم تتمكن من فتح المشروع في الرابط ، فتأكد من تسجيل الدخول إلى Firebase باستخدام نفس حساب Google الذي تلقى البريد الإلكتروني حول المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.
لاحظ أنه إذا كنت المسؤول عن مؤسسة Google Cloud ، فقد يتم إخطارك بالتغييرات التي تطرأ على مشاريع Firebase داخل مؤسستك. ومع ذلك ، قد لا يكون لديك أذونات كافية لفتح مشروع Firebase. في هذه الحالات ، يتمثل الحل الأبسط في تعيين دور المالك الفعلي لنفسك لفتح المشروع وتنفيذ الإجراءات المطلوبة. تعرف على المزيد حول لماذا ومتى يتم تعيين دور المالك .
المنصات والأطر
قم بزيارة صفحات استكشاف الأخطاء وإصلاحها والأسئلة الشائعة الخاصة بالمنصة للحصول على نصائح وإجابات مفيدة لمزيد من الأسئلة الشائعة.
وحدة تحكم Firebase
ما المتصفحات المدعومة للوصول إلى وحدة تحكم Firebase؟
يمكن الوصول إلى وحدة تحكم Firebase من الإصدارات الحديثة من متصفحات سطح المكتب الشائعة مثل Chrome و Firefox و Safari و Edge. متصفحات الهاتف المحمول ليست مدعومة بالكامل حاليًا.
يمكنني تحميل وحدة تحكم Firebase ، ولكن لماذا لا يمكنني العثور على مشروع Firebase الخاص بي أو الوصول إليه؟
هذه الأسئلة الشائعة قابلة للتطبيق إذا كنت تواجه أيًا من المشكلات التالية:
- تعرض وحدة تحكم Firebase صفحة خطأ تفيد بأن مشروعك قد لا يكون موجودًا أو أنه ليس لديك حق الوصول إلى المشروع.
- لا تعرض وحدة تحكم Firebase مشروعك حتى عند إدخال معرف المشروع أو اسم المشروع في حقل البحث الخاص بوحدة التحكم.
جرب هذه الخطوات لتحري الخلل وإصلاحه:
- أولاً ، حاول الوصول إلى مشروعك من خلال زيارة عنوان URL الخاص بالمشروع مباشرةً. استخدم التنسيق التالي:
https://console.firebase.google.com/project/ PROJECT-ID /overview
- إذا كنت لا تزال غير قادر على الوصول إلى المشروع أو تلقيت أخطاء الأذونات ، فتحقق مما يلي:
- تأكد من تسجيل الدخول إلى Firebase باستخدام نفس حساب Google الذي يمكنه الوصول إلى المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.
- تأكد من تمكين Firebase Management API للمشروع.
- تأكد من تعيين أحد أدوار IAM الأساسية (مالك ، محرر ، عارض) أو دور له أذونات متعلقة بـ Firebase ، على سبيل المثال دور Firebase محدد مسبقًا . يمكنك عرض الدور (الأدوار) الخاص بك في صفحة IAM في Google Cloud Console.
- إذا كان مشروعك ينتمي إلى مؤسسة Google Cloud ، فقد تحتاج إلى أذونات إضافية لرؤية المشروع مدرجًا في وحدة تحكم Firebase. اتصل بالشخص الذي يدير مؤسسة Google Cloud الخاصة بك لمنحك الدور المناسب لعرض المشروع ، على سبيل المثال دور المستعرض.
إذا لم تمكّنك أي خطوة من خطوات تحرّي الخلل وإصلاحه أعلاه من العثور على مشروعك أو الوصول إليه ، فاتصل بدعم Firebase .
لماذا لا يتم تحميل وحدة تحكم Firebase بالنسبة لي؟
هذه الأسئلة الشائعة قابلة للتطبيق إذا كنت تواجه أيًا من المشكلات التالية:
- لا تنتهي صفحة في وحدة تحكم Firebase من التحميل مطلقًا.
- لا يتم تحميل البيانات داخل الصفحة بالشكل المتوقع.
- تتلقى رسائل خطأ في المتصفح عند تحميل وحدة تحكم Firebase.
جرب هذه الخطوات لتحري الخلل وإصلاحه:
- تحقق من صف وحدة التحكم في Firebase Status Dashboard بحثًا عن أي انقطاعات محتملة في الخدمة.
- تأكد من أنك تستخدم متصفحًا مدعومًا .
- حاول تحميل وحدة تحكم Firebase في نافذة التصفح المتخفي أو الخاصة.
- تعطيل كافة ملحقات المتصفح.
- تحقق من عدم حظر اتصال الشبكة بواسطة أداة حظر الإعلانات أو مكافحة الفيروسات أو الوكيل أو جدار الحماية أو أي برنامج آخر.
- حاول تحميل وحدة تحكم Firebase باستخدام شبكة أو جهاز مختلف.
- إذا كنت تستخدم Chrome ، فتحقق من Developer Tools Console بحثًا عن أي أخطاء .
إذا لم تنجح أي خطوة من خطوات تحرّي الخلل وإصلاحه أعلاه في حل المشكلة ، فاتصل بدعم Firebase .
كيف يتم تحديد لغة وحدة تحكم Firebase الخاصة بي؟
يعتمد إعداد اللغة لوحدة تحكم Firebase على اللغة المحددة في إعدادات حساب Google الخاص بك.
لتغيير تفضيلات اللغة الخاصة بك ، راجع تغيير اللغة .
تدعم وحدة تحكم Firebase اللغات التالية:
- إنجليزي
- البرتغالية البرازيلية
- فرنسي
- ألمانية
- الأندونيسية
- اليابانية
- الكورية
- الروسية
- الصينية المبسطة
- الأسبانية
- الصينية التقليدية
ما الأدوار والأذونات التي تدعمها وحدة تحكم Firebase؟
تستخدم وحدة تحكم Firebase و Google Cloud Console نفس الأدوار والأذونات الأساسية. تعرف على المزيد حول الأدوار والأذونات في وثائق Firebase IAM .
يدعم Firebase الأدوار الأساسية (الأساسية) للمالك والمحرر والعارض:
- يمكن لمالك المشروع إضافة أعضاء آخرين إلى المشروع ، وإعداد عمليات التكامل (ربط المشروع بخدمات مثل BigQuery أو Slack) ، ولديه حق الوصول الكامل للتعديل للمشروع.
- محرر المشروع لديه حق الوصول الكامل لتحرير المشروع.
- يمتلك عارض المشروع حق الوصول للقراءة فقط للمشروع. لاحظ أن وحدة تحكم Firebase حاليًا لا تخفي / تعطل عناصر تحكم تعديل واجهة المستخدم من عارضين المشروع ، لكن هذه العمليات ستفشل لأعضاء المشروع الذين تم تعيين دور العارض لهم.
يدعم Firebase أيضًا:
- أدوار Firebase المحددة مسبقًا - أدوار محددة خاصة بـ Firebase تمكِّن من التحكم في الوصول الدقيق أكثر من الأدوار الأساسية للمالك والمحرر والعارض.
- أدوار مخصصة - أدوار IAM المخصصة بالكامل التي تقوم بإنشائها لتخصيص مجموعة من الأذونات التي تلبي المتطلبات المحددة لمؤسستك.
التسعير
ما هي المنتجات المدفوعة؟ ما هي بدون تكلفة؟
منتجات البنية التحتية المدفوعة من Firebase هي Realtime Database و Cloud Storage for Firebase والوظائف السحابية والاستضافة ومختبر الاختبار ومصادقة الهاتف. نحن نقدم طبقة مجانية لجميع هذه الميزات.
يحتوي Firebase أيضًا على العديد من المنتجات المجانية: التحليلات والمراسلة السحابية وملحن الإشعارات والتكوين عن بُعد وفهرسة التطبيقات والارتباطات الديناميكية وتقارير الأعطال. يمكنك استخدام كمية غير محدودة من أي من هذه المنتجات في جميع الخطط ، بما في ذلك خطة Spark المجانية الخاصة بنا. بالإضافة إلى ذلك ، فإن جميع ميزات المصادقة بخلاف مصادقة الهاتف مجانية.
هل يقدم Firebase أرصدة تجريبية بدون تكلفة للمنتجات المدفوعة؟
يمكن استخدام خدمات Firebase المدفوعة ضمن الإصدار التجريبي المجاني من Google Cloud . يمكن لمستخدمي Google Cloud و Firebase الجدد الاستفادة من فترة تجريبية مدتها 90 يومًا تتضمن 300 دولارًا أمريكيًا في أرصدة الفوترة السحابية المجانية لاستكشاف وتقييم منتجات وخدمات Google Cloud و Firebase.
خلال فترة الإصدار التجريبي المجاني من Google Cloud ، سيتم تزويدك بحساب Free Trial Cloud Billing. سيكون أي مشروع Firebase يستخدم حساب الفوترة هذا مدرجًا في خطة تسعير Blaze خلال الفترة التجريبية المجانية.
لا تقلق ، إعداد حساب Free Trial Cloud Billing هذا لا يمكننا من تحصيل الرسوم منك. لا يتم محاسبتك إلا إذا قمت بتمكين الفوترة صراحةً عن طريق ترقية حساب Free Trial Cloud Billing الخاص بك إلى حساب مدفوع. يمكنك الترقية إلى حساب مدفوع في أي وقت أثناء الفترة التجريبية. بعد الترقية ، لا يزال بإمكانك استخدام أي أرصدة متبقية (خلال فترة 90 يومًا).
بمجرد انتهاء صلاحية الإصدار التجريبي المجاني ، ستحتاج إما إلى إرجاع مشروعك إلى خطة تسعير Spark أو إعداد خطة تسعير Blaze في وحدة تحكم Firebase لمواصلة استخدام مشروع Firebase الخاص بك.
تعرف على المزيد حول الإصدار التجريبي المجاني من Google Cloud .
كيف أعرف خطة التسعير المناسبة لي؟
خطة تسعير شرارة
تعتبر خطة Spark الخاصة بنا مكانًا رائعًا لتطوير تطبيقك بدون تكلفة. ستحصل على جميع ميزات Firebase المجانية (التحليلات ومؤلف الإشعارات و Crashlytics وما إلى ذلك) وكميات سخية من ميزات البنية التحتية المدفوعة. ومع ذلك ، إذا تجاوزت موارد خطة Spark الخاصة بك في شهر تقويمي ، فسيتم إيقاف تشغيل تطبيقك لبقية ذلك الشهر. بالإضافة إلى ذلك ، لا تتوفر ميزات Google Cloud عند استخدام خطة Spark.
خطة تسعير Blaze
تم تصميم خطة Blaze الخاصة بنا لتطبيقات الإنتاج. تسمح لك خطة Blaze أيضًا بتوسيع تطبيقك بميزات Google Cloud المدفوعة. أنت تدفع فقط مقابل الموارد التي تستهلكها ، مما يسمح لك بالتوسع حسب الطلب. نحن نسعى جاهدين لجعل أسعار خطة Blaze الخاصة بنا تنافسية مع مزودي الخدمات السحابية الرائدين في الصناعة.
كيف يمكنني مراقبة استخدامي والفواتير الخاصة بي؟
يمكنك تتبع استخدامك لموارد المشروع في وحدة تحكم Firebase على أي من لوحات المعلومات التالية:
ماذا حدث لخطة تسعير Flame؟
في كانون الثاني (يناير) 2020 ، تمت إزالة خطة تسعير Flame (25 دولارًا شهريًا للحصة الإضافية) كخيار لعمليات الاشتراك الجديدة. تم منح مستخدمي الخطة الحاليين فترة سماح لترحيل مشاريعهم خارج خطة Flame. في فبراير 2022 ، تم تخفيض تصنيف المشاريع المتبقية في خطة تسعير Flame إلى خطة تسعير Spark.
وفقاً لذلك،
- لم يعد بإمكان مشاريع خطة Spark و Blaze الحالية وأي مشاريع جديدة التبديل إلى خطة Flame أو الاشتراك فيها.
- إذا قمت بنقل مشروع خطة Flame الحالي إلى خطة تسعير مختلفة ، فلن يتمكن المشروع من العودة إلى خطة Flame.
- يمكن ترقية المشاريع التي تم تخفيض تصنيفها إلى خطة Spark إلى خطة Blaze لاستئناف الخدمات الإضافية المدفوعة.
- تمت إزالة الإشارات إلى خطة Flame من الوثائق.
هل لديك المزيد من الأسئلة حول خطة تقاعد Flame؟ اقرأ بعض الأسئلة الشائعة الإضافية أدناه.
هل تريد التعرف على خطط الأسعار الأخرى التي تقدمها Firebase؟ قم بزيارة صفحة تسعير Firebase الخاصة بنا! إذا كنت ترغب في بدء نقل أي مشاريع حالية إلى خطة تسعير أخرى ، فيمكنك القيام بذلك في وحدة تحكم Firebase لمشروعك.
أسئلة وأجوبة إضافية حول تقاعد خطة Flame
لديّ مشروع أو عملية أو نموذج عمل يعتمد على تكلفة Firebase ثابتة. ماذا علي أن أفعل؟
اشترك في خطة تسعير Blaze ، وتأكد من تعيين تنبيهات الميزانية .
هل يمكنني الحصول على وصول خاص لإنشاء مشاريع خطة Flame الجديدة؟
لا ، لا يوفر Firebase وصولاً خاصًا للمشاريع للتبديل إلى خطة Flame أو الاشتراك فيها.
لقد غيرت مشروع خطة Flame الخاص بي إلى خطة أسعار مختلفة. كيف يمكنني تغييره مرة أخرى؟
لم يعد التبديل إلى خطة Flame ممكنًا. للوصول إلى الخدمات التي توفرها خطة Flame ، تأكد من أنك تستخدم خطة تسعير Blaze ، وفكر في إعداد تنبيهات الميزانية لمشروعك.
تم تحويل مشروعي تلقائيًا إلى خطة تسعير مختلفة كجزء من تقاعد خطة Flame. ماذا علي أن أفعل؟
إذا كان مشروعك يتطلب حصة إضافية تتجاوز ما تم توفيره في خطة Spark ، فستحتاج إلى ترقية مشروعك إلى خطة تسعير Blaze.
لماذا تم إيقاف خطة Flame؟
على مر السنين ، شهدنا انخفاضًا في استخدام خطة Flame ، ومعظم المشاريع التي تستخدم الخطة لا تستهلك قيمتها الكاملة. عادةً ما يكون الحفاظ على خطة التسعير هذه غير فعال من حيث التكلفة ، ونشعر أنه يمكننا خدمة الجميع بشكل أفضل إذا ذهبت الموارد إلى مبادرات Firebase الأخرى.
كيف يختلف الاستخدام المجاني في خطة Blaze عن الاستخدام المجاني في خطة Spark؟
يتم حساب الاستخدام بدون تكلفة في خطة Blaze يوميًا. تختلف حدود الاستخدام أيضًا عن خطة Spark للوظائف السحابية ومصادقة الهاتف ومختبر الاختبار.
بالنسبة إلى وظائف السحابة ، يتم حساب الاستخدام بدون تكلفة في خطة Blaze على مستوى حساب Cloud Billing ، وليس على مستوى المشروع وله الحدود التالية:
- 2 مليون دعاء / شهر
- 400 كيلو بايت / ثانية / شهر
- 200 ألف وحدة معالجة مركزية ثانية / شهر
- 5 جيجابايت من شبكات الخروج / الشهر
لمصادقة الهاتف ، يتم حساب الاستخدام بدون تكلفة في خطة Blaze شهريًا.
بالنسبة إلى Test Lab ، فإن الاستخدام بدون تكلفة في خطة Blaze له الحدود التالية:
- 30 دقيقة على الجهاز الفعلي / اليوم
- 60 دقيقة على الجهاز الافتراضي / اليوم
هل يتم إعادة تعيين حصة الاستخدام بدون تكلفة عند التغيير من Spark إلى خطة Blaze؟
يتم تضمين الاستخدام بدون تكلفة من خطة Spark في خطة Blaze. لا يتم إعادة تعيين الاستخدام بدون تكلفة عند الانتقال إلى خطة Blaze.
ما هو "اتصال قاعدة البيانات المتزامن"؟
الاتصال المتزامن يعادل جهاز محمول أو علامة تبويب متصفح أو تطبيق خادم متصل بقاعدة البيانات. يفرض Firebase قيودًا صارمة على عدد الاتصالات المتزامنة بقاعدة بيانات تطبيقك. تم وضع هذه الحدود لحماية كل من Firebase ومستخدمينا من إساءة الاستخدام.
حد خطة Spark هو 100 ولا يمكن رفعه. تمتلك خطط Flame and Blaze حدًا يبلغ 200000 اتصال متزامن لكل قاعدة بيانات.
هذا الحد لا يماثل العدد الإجمالي لمستخدمي تطبيقك ، لأن المستخدمين لديك لا يتصلون جميعًا في وقت واحد. إذا كنت بحاجة إلى أكثر من 200000 اتصال متزامن ، فيرجى قراءة مقياس مع قواعد بيانات متعددة .
ماذا يحدث إذا تجاوزت حدود تخزين خطة Spark أو التنزيل لقاعدة بيانات Realtime؟
لتزويدك بسعر يمكن التنبؤ به ، يتم تحديد الموارد المتاحة لك في خطط Spark. هذا يعني أنه عند تجاوز أي حد للخطة في أي شهر ، سيتم إيقاف تشغيل التطبيق الخاص بك لمنع أي استخدام إضافي للموارد والرسوم الإضافية.
ماذا يحدث إذا تجاوزت حدود الاتصال المتزامن لخطة Spark لقاعدة بيانات Realtime؟
عندما يصل تطبيقك إلى حد التزامن الخاص به في خطة Spark ، سيتم رفض أي اتصالات لاحقة حتى يتم إغلاق بعض الاتصالات الحالية. سيستمر التطبيق في العمل للمستخدمين المتصلين.
ماذا يحدث إذا تجاوزت حدود تحميل أو تنزيل أو تخزين خطة Spark لـ Cloud Storage؟
عندما تتجاوز حدود التخزين السحابي في مشروع على خطة Spark ، تعتمد النتيجة على نوع الحد الذي تتجاوزه:
- إذا تجاوزت الحد المخزن بالجيجابايت ، فلن تتمكن من تخزين أي بيانات أخرى في هذا المشروع ما لم تقم بإزالة بعض البيانات المخزنة أو الترقية إلى خطة توفر مساحة تخزين أكبر أو مساحة تخزين غير محدودة.
- إذا تجاوزت حد التنزيل بالجيجابايت ، فلن يتمكن تطبيقك من تنزيل المزيد من البيانات حتى اليوم التالي (بدءًا من منتصف الليل ، بتوقيت المحيط الهادئ في الولايات المتحدة) ، ما لم تقم بالترقية إلى خطة ذات حدود أقل تقييدًا ، أو بلا حدود.
- إذا تجاوزت حد عمليات التحميل أو التنزيل ، فلن يتمكن تطبيقك من تحميل أو تنزيل المزيد من البيانات حتى اليوم التالي (بدءًا من منتصف الليل ، بتوقيت المحيط الهادئ في الولايات المتحدة) ، ما لم تقم بالترقية إلى خطة ذات حدود أقل تقييدًا ، أو بدون حدود.
كيف يعمل تكامل Firebase مع Google Cloud؟
تم دمج Firebase بعمق مع Google Cloud . تتم مشاركة المشاريع بين Firebase و Google Cloud ، لذا يمكن تمكين خدمات Firebase وخدمات Google Cloud للمشاريع. يمكنك الوصول إلى نفس المشروع من Firebase console أو Google Cloud Console. خاصة:
- يتم دعم بعض منتجات Firebase مباشرةً بواسطة Google Cloud ، مثل Cloud Storage for Firebase. ستستمر قائمة المنتجات المدعومة من Google Cloud في النمو بمرور الوقت.
- تتم مشاركة العديد من إعداداتك ، بما في ذلك المتعاونون ومعلومات الفوترة ، بواسطة Firebase و Google Cloud. يظهر استخدامك لكل من Firebase و Google Cloud في نفس الفاتورة.
بالإضافة إلى ذلك ، عند الترقية إلى خطة Blaze ، يمكنك استخدام أي من البنية التحتية كخدمة وواجهات برمجة تطبيقات Google Cloud ذات المستوى العالمي مباشرة داخل مشروع Firebase ، بسعر Google Cloud القياسي. يمكنك أيضًا تصدير البيانات من Google Cloud مباشرةً إلى BigQuery لتحليلها. لمعرفة المزيد ، راجع ربط BigQuery بـ Firebase.
هناك العديد من مزايا تعزيز الأمان وتحسين زمن الوصول وتوفير الوقت لاستخدام Google Cloud مع Firebase (مقابل الخدمات السحابية الأخرى غير الموجودة في نفس الموقع). تحقق من موقع Google Cloud للحصول على مزيد من التفاصيل.
ماذا يحدث لمشروع Firebase الخاص بي إذا أضفت أو أزلت حسابات الفوترة لهذا المشروع في Google Cloud Console؟
إذا تمت إضافة حساب Cloud Billing إلى مشروع في Google Cloud Console ، فسيتم تلقائيًا ترقية المشروع نفسه إلى خطة Firebase Blaze إذا كان هذا المشروع في خطة Spark حاليًا.
في المقابل ، إذا تمت إزالة حساب Cloud Billing نشط حالي من مشروع في Google Cloud Console ، فسيتم إرجاع هذا المشروع إلى خطة Firebase Spark.
هل يمكنني الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت؟
نعم ، يمكنك الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت. لاحظ أننا لا نقدم المبالغ المستردة بالتناسب للتخفيضات أو الإلغاء. هذا يعني أنك إذا رجعت إلى إصدار سابق أو ألغيت قبل نهاية المدة الزمنية للفوترة ، فستظل تدفع مقابل الفترة المتبقية من الشهر.
ما نوع الدعم الذي سأحصل عليه؟
تأتي جميع تطبيقات Firebase ، بما في ذلك تلك التي تستخدم خططًا بدون تكلفة ، مع دعم عبر البريد الإلكتروني من موظفي Firebase خلال ساعات العمل في المحيط الهادئ بالولايات المتحدة. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.
Can I cap usage on the Blaze plan?
No, you cannot currently cap your Blaze plan usage. We are evaluating options for supporting caps on Blaze plan usage.
Blaze users can define a budget for their project or account, and receive alerts as their spending approaches those limits. Learn how to set up budget alerts .
What are automated backups? Do you offer hourly backups?
Automated backups are an advanced feature for customers on our Blaze pricing plan that backs up your Firebase Realtime Database data once a day and uploads it to Google Cloud Storage .
We do not offer hourly backups.
Do you offer open-source, nonprofit, or educational discounts?
Our Spark plan can be used by any type of individual or organization, including nonprofits, schools, and open-source projects. Since these plans already include generous quotas, we don't offer any special discounts or plans for open-source, nonprofit, or educational projects.
Do you offer enterprise contracts, pricing, support, or dedicated infrastructure hosting?
Our Blaze plan is suitable for enterprises of all sizes, and our SLA meets or exceeds the industry standard for cloud infrastructure. However, we do not currently offer enterprise contracts, pricing, or support, nor do we offer dedicated infrastructure hosting (that is, on-premises installations) for services like our Realtime Database. We are hard at work adding some of these features.
Do you offer ad-hoc pricing? I only want pay-as-you-go for one or two features.
We offer ad-hoc pricing in the Blaze plan, where you pay only for the features you use.
How do the paid Firebase plans work with Ads? Are there no-cost advertising credits with paid plans?
The Firebase pricing plans are separate from Ads, so there are no advertising credits without cost. As a Firebase developer, you are able to "link" your Ads account to Firebase to support conversion tracking.
All ads campaigns are managed directly in Ads, and Ads billing is managed from the Ads console.
Cloud Functions pricing
Why do I need a billing account to use Cloud Functions for Firebase?
Cloud Functions for Firebase relies on some paid Google services. New function deployments with Firebase CLI 11.2.0 and higher rely on Cloud Build and Artifact Registry . Deployments to older versions use Cloud Build in the same way, but rely on Container Registry and Cloud Storage for storage instead of Artifact Registry. Usage of these services will be billed in addition to existing pricing.
Storage space for Firebase CLI 11.2.0 and newer versions
Artifact Registry provides the containers in which functions run. Artifact Registry provides the first 500MB at no cost, so your first function deployments may not incur any fees. Above that threshold, each additional GB of storage is billed at $0.10 per month.
Storage space for Firebase CLI 11.1.x and prior versions
For functions deployed to older versions, Container Registry , provides the containers in which functions run. You'll be billed for each container required to deploy a function. You may notice small charges for each container stored—for example, 1GB of storage is billed at $0.026 per month .
To understand more about how your bill might change, please review the following
- Cloud Functions pricing : existing no-cost tier is unchanged.
- Cloud Build pricing: Cloud Build provides for a no-cost tier.
- Artifact Registry pricing .
- Container Registry pricing .
Does Cloud Functions for Firebase still have no-cost usage?
Yes. On the Blaze plan, Cloud Functions provides a no-cost tier for invocations, compute time, and internet traffic. The first 2,000,000 invocations, 400,000 GB-sec, 200,000 CPU-sec, and 5 GB of Internet egress traffic is provided at no cost each month. You'll be charged only for usage above those thresholds.
After the first 500MB of no-cost storage, each deployment operation will incur small-scale charges for the storage space used for the function's container. If your development process depends on deploying functions for testing, you can further minimize costs by using the Firebase Local Emulator Suite during development.
See Firebase Pricing plans and the Cloud Functions Pricing example scenarios.
Is Firebase planning to raise the quotas and limits for Cloud Functions for Firebase?
No. There are no plans to change the quotas except for the removal of a maximum build time limit; instead of receiving errors or warnings when the daily build quota of 120 minutes is reached, you'll be billed under the terms of the Blaze pricing plan. See Quotas and limits .
Can I get the Google Cloud $300 credit?
Yes, you can create a Cloud Billing account in the Google Cloud Console to get the $300 credit, then link that Cloud Billing account to a Firebase project.
More about the Google Cloud credit here .
Note that if you do this, you have to then set up the Blaze pricing plan in the Firebase console in order for your project to continue working after the $300 credit is exhausted.
I want to follow a codelab to learn about Firebase. Can you give me a temporary billing account?
No, sorry. You can use the Firebase emulator for development without having a Cloud Billing account. Alternatively, try applying for a Google Cloud free trial . If you're still having trouble paying your bill because of this change, contact Firebase Support.
I'm worried I'm going to rack up a huge bill.
You can set up budget alerts in the Google Cloud Console to help control costs. Also, you can set limits on the number of billed instances created for each of your functions. To get an idea of costing for typical scenarios, see the Cloud Functions Pricing examples.
How can I check my current billing charges?
View the Usage and billing dashboard in the Firebase console.
I use Firebase Extensions. Do I need a billing account?
Yes. Since extensions use Cloud Functions , extensions will be subject to the same charges as other functions.
To use extensions, you will need to upgrade to the Blaze pricing plan. You will be charged a small amount (typically around $0.01 per month for the Firebase resources required by each extension you install (even if they are not used), in addition to any charges associated with your use of Firebase services.
Privacy
Where can I find information about privacy and security in Firebase?
Check out the page Privacy and Security in Firebase .
Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?
Yes. This is currently iOS-only, but may change in the future. The Firebase Apple platforms SDK includes the FirebaseCoreDiagnostics
framework by default. This framework is used by Firebase to collect SDK usage and diagnostics information to help prioritize future product enhancements. FirebaseCoreDiagnostics
is optional, so if you would like to opt out of sending Firebase diagnostic logs, you can do so by unlinking the library from your application. You can browse the full source, including logged values, on GitHub
A/B Testing
A/B Testing: How many experiments can I create and run?
You are allowed up to 300 experiments per project, which could consist of up to 24 running experiments, with the rest as draft or completed.
A/B Testing: Why can't I view my experiments after unlinking and re-linking my project to Google Analytics?
Linking to a different Google Analytics property will cause you to lose access to experiments created beforehand. To regain access to a previous experiment, re-link your project to the Google Analytics property that was linked when the experiment was created.
AdMob
AdMob: Can I link my Windows apps to Firebase?
No, Windows apps are not currently supported.
AdMob: Why can't I link my app to AdMob from the Firebase console?
You can link an AdMob app to a Firebase app via the AdMob console. Learn how.
AdMob: What permissions or access do I need to link a Firebase app to an AdMob app?
In order to do this linking, you need the following access:
- AdMob : You need to be an AdMob admin.
- Firebase : You must have the
firebase.links.create
permission, which is included in the Owner role and the Firebase Admin role . - Google Analytics : You must have the Edit role or Manage Users role for the property associated with the Firebase project. Learn more.
AdMob: Can multiple users in the same AdMob account link AdMob apps and Firebase apps?
For multi-user AdMob accounts , the user who created the first Firebase link and accepted the Firebase Terms of Service is the only user who can create new links between AdMob apps and Firebase apps.
AdMob: To use AdMob, should I use the Firebase SDK for AdMob or the Google Mobile Ads SDK?
- For iOS projects , use the Google Mobile Ads SDK:
pod 'Google-Mobile-Ads-SDK'
- For Android projects , use the Google Mobile Ads SDK:
implementation 'com.google.android.gms:play-services-ads:21.5.0'
Note that the Firebase Android SDKs for AdMob transitively include the Firebase SDK for Google Analytics. So, if your app calls any Google Analytics APIs and you switch to using the Google Mobile Ads SDK, make sure that you explicitly add the dependency for the Firebase SDK for Google Analytics (
) to your app'scom.google.firebase:firebase-analytics build.gradle
file. - For C++ projects and Unity projects , follow the instructions in the respective documentation.
Analytics
Analytics: Why is Google Analytics a recommended part of using Firebase products?
Google Analytics is a free and unlimited analytics solution that works with Firebase features to deliver powerful insights. It enables you to view event logs in Crashlytics, notification effectiveness in FCM, deep link performance for Dynamic Links, and in-app purchase data from Google Play. It powers advanced audience targeting in Remote Config, Remote Config personalization, and more.
Google Analytics acts as a layer of intelligence in the Firebase console to provide you with more actionable insights about how to develop a high quality app, grow your user base, and earn more money.
To get started, read the documentation .
Analytics: How do I control how my Analytics data is shared with the rest of Firebase?
By default, your Google Analytics data is used to enhance other Firebase and Google features. You can control how your Google Analytics data is shared in your project settings anytime. Learn more about Data sharing settings .
Analytics in my iOS app: Can I install Analytics without ad attribution and IDFA collection features?
Yes. See the Configure Data Collection and Usage page for more details.
Analytics: Why don't I see any data after unlinking my app from Google Analytics?
Your analytics data resides within the Google Analytics property - not within the Firebase project. If you delete or unlink the property, then your data is unlinked from your project as well. The data still resides in that property, however, and you can always relink it to your project.
Creating a new Google Analytics account (and new property) will result in having a blank analytics dashboard in the Firebase console.
Analytics: How do I segment users who have not met some criterion?
You can reframe the problem by "negatively targeting" these users. For example, reframe the problem as "Don't show ads to people who have bought something", and form an audience of those users to target.
Analytics: Are audiences and/or events defined in the Google Analytics interface also available in the Firebase console?
Your audiences and user properties will be synced. For some features, you'll need to use the Google Analytics interface, such as segmentation and closed funnels. You can access the Google Analytics interface directly via deep-links from the Firebase console.
Any changes you make from the Firebase console can also be performed in Google Analytics, and those changes will be reflected in Firebase.
Analytics: What changed in the Google Analytics section with the October 2021 update?
You can find a summary of these changes in the Firebase Help Center article New Google Analytics 4 functionality in Google Analytics for Firebase .
Upgrading your Analytics property
Analytics: What is the new fully upgraded Google Analytics account?
You can read more about the new Google Analytics upgrade in our blog post .
Analytics: How do I know if I'm using Google Analytics for Firebase or a fully upgraded Google Analytics account?
If you see a link to "View your data in Google Analytics" from the analytics dashboard in the Firebase console, then your project is using a fully upgraded Google Analytics account.
You can also check by viewing the Google Analytics card in the Firebase console (you can access this from settings > Project Settings > Integrations , then click Manage ). If you see a Linked Google Analytics account listed in the Your Google Analytics property section, your project is using the full Google Analytics experience in Firebase. If you do not see a Linked Google Analytics account , your project is using Google Analytics for Firebase.
Analytics: When must I upgrade my Google Analytics for Firebase property to retain service?
Any Firebase project created before July 31, 2019 must be upgraded to the full Google Analytics 4 experience if it hasn't already. (Banners display in the Analytics dashboard if an upgrade is required.) The associated Terms of Service must be accepted by February 15, 2022 to ensure data collection continues and by March 15, 2022 to prevent the deletion of the Analytics property and its data. If you no longer want to use Google Analytics and the associated data, no action is required and the property will be deleted on March 15, 2022.
Failure to accept the new Google Analytics Terms of Service will disrupt Firebase features, including Crash-Free Users (Crashlytics), targeted Configurations and Remote Config personalization, A/B Testing features, Targeting and Campaign Metrics (Cloud Messaging). It will also disrupt Google Analytics for Firebase Integrations , including Exporting project data to BigQuery , Google Ads Integrations , and AdMob Integrations .
If you have questions about accessing your Firebase project, including finding or assigning an Owner, review the Permissions and access to Firebase projects FAQs .
Analytics: What will happen to my data when I upgrade to the new Google Analytics for Firebase?
This will not affect your existing Firebase project analytics data in the Firebase console.
You will be able to continue using the same dashboard and workflows you are using today, and you will also have access to some advanced features in Google Analytics.
Note that if you decide to enable cross-device reporting after making the upgrade, your data will be de-duplicated using the UserID. This may decrease some user counts in the Firebase console.
Analytics: Why do I get an error when trying to upgrade my project to the new Google Analytics experience?
If you are experiencing an error when upgrading, such as:
The operation has failed (Reason: Requested entity already exists)
or
The operation has failed (Reason: Precondition check failed)
This means that there is an association between your project and an already existing Google Analytics property. You can unlink the property, delete it, or upgrade through the Google Analytics interface.
If this is still an issue, you can use the REST API to unlink by using the removeAnalytics
method , then use the addGoogleAnalytics
method to link a new property.
You can then move the data from one property to another .
المصادقة
Firebase Authentication: Which countries are supported for phone authentication?
Firebase Authentication supports phone number verification across the the world, but not all networks reliably deliver our verification messages. The following countries have good rates of delivery, and should be expected to work well for phone number sign in.
Country | Code |
---|---|
AD | Andorra |
AE | United Arab Emirates |
AF | Afghanistan |
AG | Antigua and Barbuda |
AL | Albania |
AM | Armenia |
AO | Angola |
AR | Argentina |
AS | American Samoa |
AT | Austria |
AU | Australia |
AW | Aruba |
AZ | Azerbaijan |
BA | Bosnia and Herzegovina |
BB | Barbados |
BD | Bangladesh |
BE | Belgium |
BF | Burkina Faso |
BG | Bulgaria |
BJ | Benin |
BM | Bermuda |
BN | Brunei Darussalam |
BO | Bolivia |
BR | Brazil |
BS | Bahamas |
BT | Bhutan |
BW | Botswana |
BY | Belarus |
BZ | Belize |
CA | Canada |
CD | Congo, (Kinshasa) |
CF | Central African Republic |
CG | Congo (Brazzaville) |
CH | Switzerland |
CI | Côte d'Ivoire |
CK | Cook Islands |
CL | Chile |
CM | Cameroon |
CO | Colombia |
CR | Costa Rica |
CV | Cape Verde |
CW | Curaçao |
CY | Cyprus |
CZ | Czech Republic |
DE | Germany |
DJ | Djibouti |
DK | Denmark |
DM | Dominica |
DO | Dominican Republic |
DZ | Algeria |
EC | Ecuador |
EG | Egypt |
ES | Spain |
ET | Ethiopia |
FI | Finland |
FJ | Fiji |
FK | Falkland Islands (Malvinas) |
FM | Micronesia, Federated States of |
FO | Faroe Islands |
FR | France |
GA | Gabon |
GB | United Kingdom |
GD | Grenada |
GE | Georgia |
GF | French Guiana |
GG | Guernsey |
GH | Ghana |
GI | Gibraltar |
GL | Greenland |
GM | Gambia |
GP | Guadeloupe |
GQ | Equatorial Guinea |
GR | Greece |
GT | Guatemala |
GY | Guyana |
HK | Hong Kong, SAR China |
HN | Honduras |
HR | Croatia |
HT | Haiti |
HU | Hungary |
ID | Indonesia |
IE | Ireland |
IL | Israel |
IM | Isle of Man |
IN | India |
IQ | Iraq |
IT | Italy |
JE | Jersey |
JM | Jamaica |
JO | Jordan |
JP | Japan |
KE | Kenya |
KG | Kyrgyzstan |
KH | Cambodia |
KM | Comoros |
KN | Saint Kitts and Nevis |
KR | Korea (South) |
KW | Kuwait |
KY | Cayman Islands |
KZ | Kazakhstan |
LA | Lao PDR |
LB | Lebanon |
LC | Saint Lucia |
LI | Liechtenstein |
LK | Sri Lanka |
LS | Lesotho |
LT | Lithuania |
LU | Luxembourg |
LV | Latvia |
LY | Libya |
MA | Morocco |
MD | Moldova |
ME | Montenegro |
MF | Saint-Martin (French part) |
MG | Madagascar |
MK | Macedonia, Republic of |
MM | Myanmar |
MN | Mongolia |
MO | Macao, SAR China |
MS | Montserrat |
MT | Malta |
MU | Mauritius |
MW | Malawi |
MX | Mexico |
MY | Malaysia |
MZ | Mozambique |
NA | Namibia |
NC | New Caledonia |
NE | Niger |
NF | Norfolk Island |
NG | Nigeria |
NI | Nicaragua |
NL | Netherlands |
NO | Norway |
NP | Nepal |
NZ | New Zealand |
OM | Oman |
PA | Panama |
PE | Peru |
PG | Papua New Guinea |
PH | Philippines |
PK | Pakistan |
PL | Poland |
PM | Saint Pierre and Miquelon |
PR | Puerto Rico |
PS | Palestinian Territory |
PT | Portugal |
PY | Paraguay |
QA | Qatar |
RE | Réunion |
RO | Romania |
RS | Serbia |
RU | Russian Federation |
RW | Rwanda |
SA | Saudi Arabia |
SC | Seychelles |
SE | Sweden |
SG | Singapore |
SH | Saint Helena |
SI | Slovenia |
SK | Slovakia |
SL | Sierra Leone |
SN | Senegal |
SR | Suriname |
ST | Sao Tome and Principe |
SV | El Salvador |
SZ | Swaziland |
TC | Turks and Caicos Islands |
TG | Togo |
TH | Thailand |
TL | Timor-Leste |
TM | Turkmenistan |
TO | Tonga |
TR | Turkey |
TT | Trinidad and Tobago |
TW | Taiwan, Republic of China |
TZ | Tanzania, United Republic of |
UA | Ukraine |
UG | Uganda |
US | United States of America |
UY | Uruguay |
UZ | Uzbekistan |
VC | Saint Vincent and Grenadines |
VE | Venezuela (Bolivarian Republic) |
VG | British Virgin Islands |
VI | Virgin Islands, US |
VN | Viet Nam |
WS | Samoa |
YE | Yemen |
YT | Mayotte |
ZA | South Africa |
ZM | Zambia |
ZW | Zimbabwe |
Cloud Functions
Cloud Functions runtime support
How do I upgrade to the latest supported version of Node.js?
- Make sure you're on the Blaze pricing plan .
- Make sure you are using the latest version of the Firebase CLI.
- Update the
engines
field in your functions'package.json
. - Optionally, test your changes using the Firebase Local Emulator Suite .
- Redeploy all functions.
How can I make sure I deployed my functions to a specific Node.js runtime?
In the Firebase console, go to the functions dashboard , select a function, and check the function's language under Additional details .
I use Firebase Extensions. Will I be affected by Cloud Functions runtime updates?
Yes. Since extensions use Cloud Functions , the runtime of your extensions will need to be updated on the same timeline as Cloud Functions.
We recommend that you periodically update to the latest version of each extension installed in your project. You can upgrade your projects' extensions via the Firebase console or Firebase CLI .
Cloud Messaging
Cloud Messaging: What's the difference between the Notifications composer and Cloud Messaging?
Firebase Cloud Messaging provides a complete set of messaging capabilities through its client SDKs and HTTP and XMPP server protocols. For deployments with more complex messaging requirements, FCM is the right choice.
The Notifications composer is a lightweight, serverless messaging solution built on Firebase Cloud Messaging. With a user-friendly graphical console and reduced coding requirements, the Notifications composer lets users easily send messages to reengage and retain users, foster app growth, and support marketing campaigns.
Capabilities | Notifications composer | Cloud Messaging | |
---|---|---|---|
Target | Single device | ||
Clients subscribed to topics (ie weather) | |||
Clients in predefined user segment (app, version, language) | |||
Clients in specified analytics audiences | |||
Clients in device groups | |||
Upstream from client to server | |||
Message Type | Notifications up to 2kb | ||
Data messages up to 4kb | |||
Delivery | Immediate | ||
Future client device local time | |||
Analytics | Built-in Notifications analytics collection and funnel analytics |
Cloud Messaging: Apple announced they're deprecating the legacy binary protocol for APNs. Do I need to do anything?
No. Firebase Cloud Messaging switched to the HTTP/2-based APNs protocol in 2017. If you are using FCM to send notifications to iOS devices, there should be no action required on your part.
Cloud Messaging: Do I need to use other Firebase services in order to use FCM?
You can use Firebase Cloud Messaging as a standalone component, in the same manner as you did with GCM, without using other Firebase services.
Cloud Messaging: I am an existing Google Cloud Messaging (GCM) developer. Should I move to Firebase Cloud Messaging?
FCM is the new version of GCM under the Firebase brand. It inherits GCM's core infrastructure, with new SDKs to make Cloud Messaging development easier.
Benefits of upgrading to FCM SDK include:
- Simpler client development. You no longer have to write your own registration or subscription retry logic.
- An out-of-the-box notification solution. You can use the Notifications composer, a serverless notifications solution with a web console that lets anyone send notifications to target specific audiences based on insights from Google Analytics for Firebase.
To upgrade from GCM SDKs to FCM SDKs, see the guides for migrating Android and iOS apps.
Cloud Messaging: Why do my targeted devices apparently fail to receive messages?
When it looks like devices haven't successfully received messages, check first for these two potential causes:
Foreground message handling for notification messages . Client apps need to add message handling logic to handle notification messages when the app is in the foreground on the device. See the details for iOS and Android .
Network firewall restrictions . If your organization has a firewall that restricts the traffic to or from the Internet, you need to configure it to allow connectivity with FCM in order for your Firebase Cloud Messaging client apps to receive messages. The ports to open are:
- 5228
- 5229
- 5230
FCM usually uses 5228, but it sometimes uses 5229 and 5230. FCM does not provide specific IPs, so you should allow your firewall to accept outgoing connections to all IP addresses contained in the IP blocks listed in Google's ASN of 15169 .
Cloud Messaging: I have implemented onMessageReceived
in my Android app, but it is not being called.
When your app is in the background, notification messages are displayed in the system tray, and onMessageReceived
is not called. For notification messages with a data payload, the notification message is displayed in the system tray, and the data that was included with the notification message can be retrieved from the intent launched when the user taps on the notification.
For more information, see Receive and handle messages .
Notifications composer: What's the difference between the Notifications composer and Cloud Messaging?
The Notifications composer is a lightweight, serverless messaging solution built on Firebase Cloud Messaging. With a user-friendly graphical console and reduced coding requirements, the Notifications composer lets users easily send messages to reengage and retain users, foster app growth, and support marketing campaigns.
Firebase Cloud Messaging provides a complete set of messaging capabilities through its client SDKs and HTTP and XMPP server protocols. For deployments with more complex messaging requirements, FCM is the right choice.
Here's a comparison of the messaging capabilities provided by Firebase Cloud Messaging and the Notifications composer:
Capabilities | Notifications composer | Cloud Messaging | |
---|---|---|---|
Target | Single device | ||
Clients subscribed to topics (ie weather) | |||
Clients in predefined user segment (app, version, language) | |||
Clients in specified analytics audiences | |||
Clients in device groups | |||
Upstream from client to server | |||
Message Type | Notifications up to 2kb | ||
Data messages up to 4kb | |||
Delivery | Immediate | ||
Future client device local time | |||
Analytics | Built-in Notifications analytics collection and funnel analytics |
Notifications composer: I am an existing Google Cloud Messaging (GCM) developer, and I want to use the Notifications composer. What should I do?
The Notifications composer is an out-of-the-box solution that lets anyone send notifications to target specific audiences based on insights from Google Analytics for Firebase. Also, the Notifications composer provides funnel analysis for every message, allowing easy evaluation of notification effectiveness.
If you are an existing GCM developer, to use the Notifications composer you have to upgrade from GCM SDKs to FCM SDKs. See the guides for migrating Android and iOS apps.
Cloud Storage for Firebase
Cloud Storage for Firebase: Why can't I use Cloud Storage for Firebase?
Cloud Storage for Firebase creates a default bucket in the App Engine no-cost tier. This allows you to quickly get up and running with Firebase and Cloud Storage for Firebase, without having to put in a credit card or enable a Cloud Billing account. It also allows you to easily share data between Firebase and a Google Cloud project.
There are, however, two known cases where this bucket cannot be created and you will be unable to use Cloud Storage for Firebase:
- A project imported from Google Cloud which had a App Engine Master/Slave Datastore application.
- A project imported from Google Cloud which has domain prefixed projects. For example:
domain.com:project-1234
.
There are currently no workarounds to these issues, and we recommend that you create a new project in the Firebase console and enable Cloud Storage for Firebase in that project.
Cloud Storage for Firebase: Why do I get error code 412 responses about service account permissions and failed service account operations when using the Cloud Storage for Firebase API?
It's likely you're getting 412 error codes either because the Cloud Storage for Firebase API is not enabled for your project or a necessary service account is missing the required permissions.
See the related FAQ .
Cloud Storage for Firebase: Why do I see new service account IDs associated with my Firebase projects that use Cloud Storage for Firebase?
Firebase uses service accounts to operate and manage services without sharing user credentials. When you create a Firebase project, you might notice that a number of service accounts are already available in your project.
The service account that Cloud Storage for Firebase uses is scoped to your project and is named
service- PROJECT_NUMBER @gcp-sa-firebasestorage.iam.gserviceaccount.com
.
If you used Cloud Storage for Firebase before September 19, 2022, you may see an additional service account on previously-linked Cloud Storage buckets named firebase-storage@system.gserviceaccount.com
. As of September 19, 2022, this service account is no longer supported.
You can view all service accounts associated with your project in the Firebase console, on the Service accounts tab .
Adding the new service account
If you removed the service account previously or the service account is not present in your project, you may do one of the following to add the account.
- (Recommended) Automated: Use the AddFirebase REST endpoint to re-import your bucket into Firebase. You will only need to call this endpoint once, not once for each linked bucket.
- Manual: Follow the steps in Creating and managing service accounts . Following that guide, add a service account with the IAM role
Cloud Storage for Firebase Service Agent
, and service account name
service- PROJECT_NUMBER @gcp-sa-firebasestorage.iam.gserviceaccount.com
.
Removing the new service account
We strongly discourage you from removing the service account because this may block access to your Cloud Storage buckets from your apps. To remove the service account from your project, follow the instructions in Disabling a service account .
Crashlytics
Visit the Crashlytics troubleshooting & FAQ page for helpful tips and answers to more FAQs.
Dynamic Links
Dynamic Links: Why does my Android app access each Dynamic Link twice?
The getInvitation
API clears the saved Dynamic Link to prevent it from being accessed twice. Be sure to call this API with the autoLaunchDeepLink
parameter set to false
in each of the deep link activities to clear it for the case when the activity is triggered outside the main activity.
Firebase Local Emulator Suite
Why do Emulator Suite logs show an error starting with "Multiple projectIds are not recommended in single project mode"?
This message means the Emulator Suite has detected it may be running a particular product emulator using different project IDs. This may indicate a misconfiguration, and can cause issues when emulators try to communicate with one another, and when you try to interact with emulators from your code. If project IDs don't match, it often appears that data is missing, since data stored in emulators is keyed to projectID, and interoperability depends on matching project IDs.
This has been a common source of confusion among developers, so by default the Local Emulator Suite will now only allow running with a single project ID, unless you specify otherwise in the firebase.json
configuration file. If an emulator detects more than one project ID, it will log a warning and potentially throw a fatal error.
Check your project ID declaration(s) for mismatches in:
- The default project set at the command line. By default, the project ID will be taken on startup from the project selected with
firebase init
orfirebase use
. To view the list of projects (and see which one is selected) usefirebase projects:list
. - Unit tests. The project ID is often specified in calls to the Rules Unit Testing library methods
initializeTestEnvironment
orinitializeTestApp
. Other testing code may initialize withinitializeApp(config)
. - The command line
--project
flag. Passing the Firebase CLI--project
flag overrides the default project. You'll need to ensure the value of the flag matches the project ID in unit tests and app initialization.
Platform-specific places to check:
Web | The projectId property in your JavaScript firebaseConfig object, used in initializeApp . |
Android | The project_id property inside the google-services.json configuration file. |
Apple platforms | The PROJECT_ID property in the GoogleService-Info.plist configuration file. |
To disable single project mode, update firebase.json
with the singleProjectMode
key:
{ "firestore": { ... }, "functions": { ... }, "hosting": { ... }, "emulators": { "singleProjectMode": false, "auth": { "port": 9099 }, "functions": { "port": 5001 }, ... } }
Hosting
Hosting: Why does my Hosting release history table in the Firebase console show file counts that are more than what my local project actually has?
Firebase automatically adds extra files containing metadata about the Hosting site, and these files are included in the total file count for the release.
Hosting: What's the largest file size that I can deploy to Firebase Hosting?
Hosting has a maximum size limit of 2 GB for individual files.
We recommend storing larger files using Cloud Storage , which offers a maximum size limit in the terabyte range for individual objects.
Hosting: How many Hosting sites can I have per Firebase project?
The Firebase Hosting multisite feature supports a maximum of 36 sites per project.
Performance Monitoring
Visit the Performance Monitoring troubleshooting & FAQ page for helpful tips and answers to more FAQs.
Performance Monitoring: How many custom URL patterns can I create?
You can create up to 400 total custom URL patterns per app and up to 100 custom URL patterns per domain for that app.
Performance Monitoring: Why am I not seeing real time display of performance data?
To view real time performance data, make sure that your app uses a Performance Monitoring SDK version that's compatible with real time data processing.
- iOS — v7.3.0 or later
- tvOS — v8.9.0 or later
- Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
- Web — v7.14.0 or later
Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.
قاعدة بيانات الوقت الفعلي
Realtime Database: Why was my Realtime Database reported bandwidth lower than average between September 2016 and March 2017?
For our bandwidth calculations, we normally include SSL encryption overhead (based on layer 5 of the OSI model). However, in September 2016, we introduced a bug that caused our bandwidth reporting to ignore encryption overhead. This might have resulted in artificially low reported bandwidth and bills on your account for a few months.
We released a fix for the bug in late March 2017, returning bandwidth reporting and billing to their normal levels.
Realtime Database: What are the scaling limitations of the Realtime Database?
Each Realtime Database instance has limits on the number of write operations per second. For small writes, this limit is approximately 1000 write operations per second. If you are approaching this limit, batching operations using multi-path updates can help you achieve higher throughput.
In addition, each database instance has a cap on the number of simultaneous database connections . Our default limits are large enough for most applications. If you are building an app that requires additional scale, you may need to shard your application across multiple database instances for added scale. You may also consider Cloud Firestore as an alternative database.
Realtime Database: What can I do if I'm over my Realtime Database usage limits?
If you've received an email alert or notification in the Firebase console that you've exceeded your Realtime Database usage limits, you can address it based on the usage limit you've exceeded. To see your Realtime Database usage, go to the Realtime Database Usage dashboard in the Firebase console.
If you're over your download limit, you can upgrade your Firebase pricing plan or wait until your download limit resets at the start of your next billing cycle. To decrease your downloads, try the following steps:
- Add queries to limit the data that your listen operations return.
- Check for unindexed queries.
- Use listeners that only download updates to data — for example,
on()
instead ofonce()
. - Use security rules to block unauthorized downloads.
If you're over your storage limit, upgrade your pricing plan to avoid service disruptions. To reduce the amount of data in your database, try the following steps:
- Run periodic cleanup jobs.
- Reduce any duplicate data in your database.
Note that it may take some time to see any data deletions reflected in your storage allotment.
If you're over your simultaneous database connections limit, upgrade your plan to avoid any service disruptions. To manage simultaneous connections to your database, try connecting via users via the REST API if they don't require a realtime connection.
Remote Config
Remote Config: Why don't fetched values change the behavior and appearance of my app?
Unless you fetch values with fetchAndActivate()
, values are stored locally but not activated. To activate fetched values so that they can take effect, call activate
. This design lets you control when the behavior and appearance of your app changes, because you can choose when to call activate
. After you call activate
, your app source code determines when updated parameter values are used.
For example, you could fetch values and then activate them the next time a user starts your app, which removes the need to delay app startup while your app waits for fetched values from the service. Changes to your app's behavior and appearance then occur when your app uses the updated parameter values.
To learn more about the Remote Config API and usage model, see Remote Config API Overview .
Remote Config: I am making a lot of fetch requests while developing my app. Why doesn't my app always get the latest values from the service when it sends fetch requests?
During app development, you might want to fetch and activate configs very frequently (many times per hour) to let you rapidly iterate as you develop and test your app. To accommodate rapid iteration on a project with up to 10 developers, you can temporarily set a FirebaseRemoteConfigSettings
object with a low minimum fetch interval ( setMinimumFetchIntervalInSeconds
) in your app.
Remote Config: How quickly does the Remote Config service return fetched values after my app sends a fetch request?
Devices usually receive fetched values in less than a second, and often receive fetched values in milliseconds. The Remote Config service handles fetch requests within milliseconds, but the time required to complete a fetch request will depend on the network speed of the device and the latency of the network connection used by the device.
If your goal is to make fetched values take effect in your app as soon as possible, but without creating a jarring user experience, consider adding calls to fetchAndActivate
each time that your app does a full screen refresh.
Test Lab
Visit the Test Lab troubleshooting page for helpful tips and answers to FAQs.
Firebase User Segmentation Storage
What is Firebase User Segmentation Storage?
Firebase User Segmentation Storage stores Firebase installation IDs and related attributes and segments as well as audience lists you've created to provide targeting information to other Firebase services that use them, such as Crashlytics, FCM, Remote Config personalization, and more.