الأسئلة الشائعة حول 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 Value enabled ).

أضاف 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
• في الرد من تشغيل أمر Firebase CLI firebase projects:list

جرّب خطوات استكشاف الأخطاء وإصلاحها هذه:

1. أولاً، حاول الوصول إلى مشروعك عن طريق زيارة عنوان URL الخاص بالمشروع مباشرةً. استخدم التنسيق التالي:
   https://console.firebase.google.com/project/ PROJECT-ID /overview
2. إذا لم تتمكن من الوصول إلى المشروع أو تلقيت أخطاء في الأذونات، فتحقق مما يلي:
   • تأكد من تسجيل الدخول إلى Firebase باستخدام نفس حساب Google الذي لديه حق الوصول إلى المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.
   • تحقق مما إذا كان بإمكانك عرض المشروع في Google Cloud Console .
   • تأكد من أن مشروعك يحتوي على التصنيف firebase:enabled في صفحة التصنيفات لمشروعك في Google Cloud Console. يستخدم Firebase وGoogle Cloud هذا التصنيف لإدراج مشاريع Firebase الخاصة بك. إذا كنت لا ترى هذه التسمية ولكن تم تمكين Firebase Management API لمشروعك، فقم بإضافة التسمية يدويًا (على وجه التحديد، Key firebase Value enabled ).
   • تأكد من تعيين أحد أدوار IAM الأساسية (المالك، المحرر، العارض) أو دور يحتوي على أذونات متعلقة بـ Firebase، على سبيل المثال دور Firebase المحدد مسبقًا . يمكنك عرض دورك (أدوارك) في صفحة IAM الخاصة بـ Google Cloud Console.
   • إذا كان مشروعك ينتمي إلى مؤسسة Google Cloud، فقد تحتاج إلى أذونات إضافية لرؤية المشروع مدرجًا في وحدة تحكم Firebase. اتصل بالشخص الذي يدير مؤسسة Google Cloud الخاصة بك ليمنحك الدور المناسب لعرض المشروع، على سبيل المثال دور المتصفح.

إذا لم تمكنك أي من خطوات استكشاف الأخطاء وإصلاحها المذكورة أعلاه من رؤية مشروعك في قائمة مشاريع Firebase، فاتصل بدعم Firebase .

كم عدد المشاريع التي يمكنني الحصول عليها لكل حساب؟

• خطة تسعير Spark - تقتصر حصة مشروعك على عدد صغير من المشاريع (عادةً حوالي 5-10).
• خطة تسعير Blaze - تزداد حصة مشروعك لكل حساب Cloud Billing بشكل كبير طالما أن حساب Cloud Billing الخاص بك في وضع جيد.

نادرًا ما يشكل الحد الأقصى لحصة المشروع مصدر قلق لمعظم المطورين، ولكن إذا لزم الأمر، يمكنك طلب زيادة في حصة مشروعك .

لاحظ أن الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصتك حتى يتم حذفه بالكامل.

ما عدد تطبيقات Firebase التي يمكنني الحصول عليها في مشروع Firebase؟

مشروع Firebase عبارة عن حاوية لتطبيقات Firebase عبر Apple وAndroid والويب. يقيد Firebase العدد الإجمالي لتطبيقات Firebase ضمن مشروع Firebase إلى 30.

بعد هذا الرقم، يبدأ الأداء في التدهور (خاصة بالنسبة لبرنامج Google Analytics)، وفي النهاية، عند عدد أكبر من التطبيقات، تتوقف بعض وظائف المنتج عن العمل. بالإضافة إلى ذلك، إذا كنت تستخدم تسجيل الدخول بحساب Google كموفر مصادقة، فسيتم إنشاء معرف عميل 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 إعدادات المشروع > عام ، ثم في بطاقة مشروعك ضمن البيئة ، انقر فوق 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 / BigQuery بمشروعي أو تطبيقي على Firebase؟

• لربط حسابك في Google Play ، تحتاج إلى ما يلي:
  • أي من أدوار Firebase التالية: المالك أو مسؤول Firebase
    و
  • أي من مستويات الوصول إلى Google Play التالية: مالك الحساب أو المشرف
• لربط تطبيق AdMob ، يجب أن تكون مالكًا لمشروع Firebase ومشرفًا في AdMob.
• لربط حسابك في AdWords ، يجب أن تكون مالكًا لمشروع Firebase ومسؤولًا في AdWords.
• لربط مشروع BigQuery الخاص بك، يجب أن تكون مالك مشروع Firebase.

ما هي الإشعارات مفتوحة المصدر التي يجب أن أدرجها في تطبيقي؟

على منصات Apple، تحتوي حجرة Firebase على ملف إشعارات يتضمن الإدخالات ذات الصلة. يحتوي Firebase Android SDK على Activity مساعد لعرض معلومات الترخيص.

كيف أقوم بتعيين دور لأحد أعضاء المشروع، مثل دور المالك؟

لإدارة الدور (الأدوار) المعين لكل عضو في المشروع، يجب أن تكون مالكًا لمشروع 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 تلبية الطلبات الإدارية فقط من مالكي المشروع الموضحين.

بعد إعداد المالك (المالكين) لمشروع Firebase، من المهم الحفاظ على تحديث هذه المهام.

لاحظ أنه إذا كان مشروع Firebase جزءًا من مؤسسة Google Cloud، فيمكن للشخص الذي يدير مؤسسة Google Cloud الخاصة بك تنفيذ العديد من المهام التي يمكن للمالك القيام بها. ومع ذلك، بالنسبة للعديد من المهام الخاصة بالمالك (مثل تعيين الأدوار أو إدارة خصائص Google Analytics)، قد يحتاج المسؤول إلى تعيين دور المالك الفعلي لنفسه لتنفيذ هذه المهام.

لا أعتقد أن لدي مشروع Firebase، لكني تلقيت بريدًا إلكترونيًا حول أحد المشروعات. كيف يمكنني الوصول إلى هذا المشروع؟

يجب أن يحتوي البريد الإلكتروني الذي تلقيته على رابط لفتح مشروع Firebase الخاص بك. يجب أن يؤدي النقر على الرابط الموجود في البريد الإلكتروني إلى فتح المشروع في وحدة تحكم Firebase.

إذا لم تتمكن من فتح المشروع في الرابط، فتأكد من تسجيل الدخول إلى Firebase باستخدام حساب Google نفسه الذي تلقى البريد الإلكتروني حول المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.

لاحظ أنه إذا كنت مشرفًا لمؤسسة Google Cloud، فقد يتم إعلامك بالتغييرات التي تطرأ على مشاريع Firebase داخل مؤسستك. ومع ذلك، قد لا يكون لديك الأذونات الكافية لفتح مشروع Firebase. في هذه الحالات، يكون الحل الأبسط هو تعيين دور المالك الفعلي لنفسك لفتح المشروع وتنفيذ الإجراءات المطلوبة. تعرف على المزيد حول سبب ووقت تعيين دور المالك .

ما هي المتصفحات المدعومة للوصول إلى وحدة تحكم Firebase؟

يمكن الوصول إلى وحدة تحكم Firebase من الإصدارات الحديثة من متصفحات سطح المكتب الشائعة مثل Chrome وFirefox وSafari وEdge. متصفحات الجوال غير مدعومة بشكل كامل حاليًا.

يمكنني تحميل وحدة تحكم Firebase، ولكن لماذا لا يمكنني العثور على مشروع Firebase الخاص بي أو الوصول إليه؟

تنطبق هذه الأسئلة الشائعة إذا كنت تواجه أيًا من المشكلات التالية:

• تعرض وحدة تحكم Firebase صفحة خطأ تفيد بأن مشروعك قد لا يكون موجودًا أو أنه لا يمكنك الوصول إلى المشروع.
• لا تعرض وحدة تحكم Firebase مشروعك حتى عند إدخال معرف المشروع أو اسم المشروع في حقل البحث بوحدة التحكم.

جرّب خطوات استكشاف الأخطاء وإصلاحها هذه:

1. أولاً، حاول الوصول إلى مشروعك عن طريق زيارة عنوان URL الخاص بالمشروع مباشرةً. استخدم التنسيق التالي:
   https://console.firebase.google.com/project/ PROJECT-ID /overview
2. إذا كنت لا تزال غير قادر على الوصول إلى المشروع أو تلقي أخطاء الأذونات، فتحقق مما يلي:
   • تأكد من تسجيل الدخول إلى Firebase باستخدام نفس حساب Google الذي لديه حق الوصول إلى المشروع. يمكنك تسجيل الدخول والخروج من وحدة تحكم Firebase عبر الصورة الرمزية لحسابك في الزاوية العلوية اليمنى من وحدة التحكم.
   • تأكد من تمكين Firebase Management API للمشروع.
   • تأكد من تعيين أحد أدوار IAM الأساسية (المالك، المحرر، العارض) أو دور يحتوي على أذونات متعلقة بـ Firebase، على سبيل المثال دور Firebase المحدد مسبقًا . يمكنك عرض دورك (أدوارك) في صفحة IAM الخاصة بـ Google Cloud Console.
   • إذا كان مشروعك ينتمي إلى مؤسسة Google Cloud، فقد تحتاج إلى أذونات إضافية لرؤية المشروع مدرجًا في وحدة تحكم Firebase. اتصل بالشخص الذي يدير مؤسسة Google Cloud الخاصة بك ليمنحك الدور المناسب لعرض المشروع، على سبيل المثال دور المتصفح.

إذا لم تمكنك أي من خطوات استكشاف الأخطاء وإصلاحها المذكورة أعلاه من العثور على مشروعك أو الوصول إليه، فاتصل بدعم Firebase .

لماذا لا يتم تحميل وحدة تحكم Firebase بالنسبة لي؟

تنطبق هذه الأسئلة الشائعة إذا كنت تواجه أيًا من المشكلات التالية:

• لا تنتهي الصفحة في وحدة تحكم Firebase مطلقًا من التحميل.
• لا يتم تحميل البيانات الموجودة داخل الصفحة كما هو متوقع.
• تتلقى رسائل خطأ في المتصفح عند تحميل وحدة تحكم Firebase.

جرّب خطوات استكشاف الأخطاء وإصلاحها هذه:

1. تحقق من صف وحدة التحكم في لوحة معلومات حالة Firebase بحثًا عن أي انقطاع محتمل للخدمة.
2. تأكد من أنك تستخدم متصفحًا مدعومًا .
3. حاول تحميل وحدة تحكم Firebase في نافذة خاصة أو متخفية.
4. تعطيل كافة ملحقات المتصفح.
5. تأكد من عدم حظر اتصال الشبكة بواسطة أداة حظر الإعلانات أو برامج مكافحة الفيروسات أو الوكيل أو جدار الحماية أو أي برامج أخرى.
6. حاول تحميل وحدة تحكم Firebase باستخدام شبكة أو جهاز مختلف.
7. إذا كنت تستخدم Chrome، فتحقق من وحدة تحكم أدوات المطور بحثًا عن أي أخطاء .

إذا لم تنجح أي من خطوات استكشاف الأخطاء وإصلاحها المذكورة أعلاه في حل المشكلة، فاتصل بدعم Firebase .

كيف يتم تحديد لغة وحدة تحكم Firebase الخاصة بي؟

يعتمد إعداد اللغة لوحدة تحكم Firebase على اللغة المحددة في إعدادات حساب Google الخاص بك.

لتغيير تفضيلات اللغة، راجع تغيير اللغة .

تدعم وحدة تحكم Firebase اللغات التالية:

• إنجليزي
• البرتغالية البرازيلية
• فرنسي
• ألمانية
• الاندونيسية
• اليابانية
• الكورية
• الروسية
• الصينية المبسطة
• الأسبانية
• الصينية التقليدية

ما الأدوار والأذونات التي تدعمها وحدة تحكم Firebase؟

تستخدم وحدة تحكم Firebase وGoogle Cloud Console نفس الأدوار والأذونات الأساسية. تعرف على المزيد حول الأدوار والأذونات في وثائق Firebase IAM .

يدعم Firebase الأدوار الأساسية (الأساسية) للمالك والمحرر والعارض:

• يمكن لمالك المشروع إضافة أعضاء آخرين إلى المشروع، وإعداد عمليات التكامل (ربط المشروع بخدمات مثل BigQuery أو Slack)، كما يتمتع بحق الوصول الكامل لتحرير المشروع.
• يتمتع محرر المشروع بحق الوصول الكامل لتحرير المشروع.
• يمتلك عارض المشروع حق الوصول للقراءة فقط للمشروع. لاحظ أن وحدة تحكم Firebase لا تقوم حاليًا بإخفاء/تعطيل عناصر تحكم واجهة المستخدم الخاصة بالتحرير من عارضي المشروع، ولكن ستفشل هذه العمليات بالنسبة لأعضاء المشروع الذين تم تعيين دور العارض لهم.

يدعم Firebase أيضًا:

• أدوار Firebase المحددة مسبقًا - أدوار منسقة خاصة بـ Firebase تتيح التحكم في الوصول بشكل أكثر دقة من الأدوار الأساسية للمالك والمحرر والعارض.
• الأدوار المخصصة — أدوار IAM مخصصة بالكامل تقوم بإنشائها لتخصيص مجموعة من الأذونات التي تلبي المتطلبات المحددة لمؤسستك.

ما هي المنتجات التي يتم دفعها؟ والتي هي بلا تكلفة؟

منتجات البنية التحتية المدفوعة لـ Firebase هي قاعدة بيانات Realtime، والتخزين السحابي لـ Firebase، والوظائف السحابية، والاستضافة، ومختبر الاختبار، ومصادقة الهاتف. نحن نقدم طبقة مجانية لجميع هذه الميزات.

يحتوي Firebase أيضًا على العديد من المنتجات المجانية: التحليلات، والمراسلة السحابية، وملحن الإشعارات، والتكوين عن بعد، وفهرسة التطبيقات، والارتباطات الديناميكية، وإعداد تقارير الأعطال. يمكنك استخدام كمية غير محدودة من أي من هذه المنتجات في جميع الخطط، بما في ذلك خطة Spark المجانية. بالإضافة إلى ذلك، فإن جميع ميزات المصادقة بخلاف مصادقة الهاتف مجانية.

كيف أعرف خطة التسعير المناسبة لي؟

خطة تسعير سبارك

تعد خطة Spark الخاصة بنا مكانًا رائعًا لتطوير تطبيقك دون أي تكلفة. يمكنك الحصول على جميع ميزات Firebase المجانية (Analytics، ومؤلف الإشعارات، وCrashlytics، وما إلى ذلك) وكميات كبيرة من ميزات البنية التحتية المدفوعة لدينا. ومع ذلك، إذا تجاوزت موارد خطة Spark الخاصة بك في شهر تقويمي واحد، فسيتم إيقاف تطبيقك لبقية ذلك الشهر. بالإضافة إلى ذلك، لا تتوفر ميزات Google Cloud عند استخدام خطة Spark.

خطة التسعير الحريق

تم تصميم خطة Blaze الخاصة بنا لتطبيقات الإنتاج. تسمح لك خطة Blaze أيضًا بتوسيع تطبيقك بميزات Google Cloud المدفوعة. أنت تدفع فقط مقابل الموارد التي تستهلكها، مما يسمح لك بالتوسع حسب الطلب. نحن نسعى جاهدين لجعل أسعار خطة Blaze الخاصة بنا تنافسية مع موفري الخدمات السحابية الرائدين في الصناعة.

كيف يمكنني مراقبة استخدامي وفواتيرتي؟

يمكنك تتبع استخدامك لموارد المشروع في وحدة تحكم Firebase على أي من لوحات المعلومات التالية:

• لوحة تحكم الاستخدام والفوترة الشاملة على مستوى المشروع
• لوحة معلومات استخدام المصادقة (خاصة لمثيلات مصادقة الهاتف)
• لوحة تحكم استخدام Cloud Firestore
• لوحة تحكم استخدام الوظائف السحابية
• لوحة معلومات استخدام التخزين السحابي
• لوحة تحكم استخدام الاستضافة
• لوحة تحكم استخدام قاعدة البيانات في الوقت الفعلي

ماذا حدث لخطة تسعير Flame؟

في يناير 2020، تمت إزالة خطة تسعير Flame (25 دولارًا شهريًا من الحصة الإضافية) كخيار لعمليات الاشتراك الجديدة. تم منح مستخدمي الخطة الحاليين فترة سماح لترحيل مشاريعهم من خطة Flame. في فبراير 2022، تم تخفيض المشاريع المتبقية في خطة تسعير Flame إلى خطة تسعير Spark.
وفقاً لذلك،

• لم يعد بإمكان مشاريع خطة Spark and Blaze الحالية وأي مشاريع جديدة التبديل إلى خطة Flame أو الاشتراك فيها.
• إذا قمت بنقل مشروع خطة Flame موجود إلى خطة تسعير مختلفة، فلن يتمكن المشروع من العودة إلى خطة Flame.
• يمكن ترقية المشاريع التي تم تخفيض رتبتها إلى خطة Spark إلى خطة Blaze لاستئناف الخدمات الإضافية المدفوعة.
• تمت إزالة الإشارات إلى خطة Flame من الوثائق.

هل لديك المزيد من الأسئلة حول التقاعد في خطة Flame؟ اقرأ بعض الأسئلة الشائعة الإضافية أدناه.

هل تريد التعرف على خطط التسعير الأخرى التي تقدمها Firebase؟ تفضل بزيارة صفحة تسعير Firebase الخاصة بنا! إذا كنت ترغب في بدء نقل أي مشاريع حالية إلى خطة تسعير أخرى، فيمكنك القيام بذلك في وحدة تحكم Firebase لمشروعك.

أسئلة متكررة إضافية حول التقاعد في خطة Flame

كيف يختلف الاستخدام بدون تكلفة في خطة Blaze عن الاستخدام بدون تكلفة في خطة Spark؟

يتم حساب الاستخدام بدون تكلفة في خطة Blaze يوميًا. تختلف حدود الاستخدام أيضًا عن خطة Spark للوظائف السحابية ومصادقة الهاتف ومعمل الاختبار.

بالنسبة لوظائف السحابة، يتم حساب الاستخدام بدون تكلفة في خطة Blaze على مستوى حساب الفوترة السحابية، وليس على مستوى المشروع وله الحدود التالية:

• 2 مليون دعوة / شهر
• 400 كيلو جيجا بايت في الثانية/الشهر
• 200 ألف وحدة المعالجة المركزية في الثانية/الشهر
• 5 جيجا بايت من خروج الشبكات / الشهر

بالنسبة لمصادقة الهاتف، يتم حساب الاستخدام المجاني لخطة Blaze شهريًا.

بالنسبة إلى Test Lab، فإن الاستخدام بدون تكلفة في خطة Blaze له الحدود التالية:

• 30 دقيقة على الأجهزة الفعلية/اليوم
• 60 دقيقة على الأجهزة الافتراضية/اليوم

هل تتم إعادة تعيين حصة الاستخدام بدون تكلفة عندما أقوم بالتغيير من خطة Spark إلى خطة Blaze؟

يتم تضمين الاستخدام بدون تكلفة من خطة Spark في خطة Blaze. لا تتم إعادة ضبط الاستخدام بدون تكلفة عند الانتقال إلى خطة Blaze.

ما هو "الاتصال المتزامن بقاعدة البيانات"؟

يعادل الاتصال المتزامن جهازًا محمولاً واحدًا أو علامة تبويب متصفح أو تطبيق خادم متصل بقاعدة البيانات. يفرض Firebase حدودًا صارمة على عدد الاتصالات المتزامنة بقاعدة بيانات تطبيقك. تم وضع هذه الحدود لحماية كل من Firebase ومستخدمينا من إساءة الاستخدام.

الحد الأقصى لخطة Spark هو 100 ولا يمكن رفعه. تتضمن خطط Flame وBlaze حدًا يبلغ 200000 اتصال متزامن لكل قاعدة بيانات.

هذا الحد لا يماثل إجمالي عدد مستخدمي تطبيقك، لأن المستخدمين لا يتصلون جميعًا في وقت واحد. إذا كنت بحاجة إلى أكثر من 200000 اتصال متزامن، فيرجى قراءة مقياس مع قواعد بيانات متعددة .

ماذا يحدث إذا تجاوزت حدود تخزين خطة Spark أو حدود التنزيل لقاعدة بيانات Realtime؟

لتزويدك بسعر يمكن التنبؤ به، تم وضع حد أقصى للموارد المتاحة لك في خطط Spark. وهذا يعني أنه عند تجاوز أي حد للخطة في أي شهر، سيتم إيقاف تشغيل تطبيقك لمنع أي استخدام إضافي للموارد ورسوم إضافية.

ماذا يحدث إذا تجاوزت حدود الاتصال المتزامن لخطة Spark لقاعدة بيانات Realtime؟

عندما يصل تطبيقك إلى حد التزامن الخاص به في خطة Spark، سيتم رفض أي اتصالات لاحقة حتى يتم إغلاق بعض الاتصالات الحالية. سيستمر التطبيق في العمل للمستخدمين المتصلين.

كيف يعمل تكامل Firebase مع Google Cloud؟

تم دمج Firebase بعمق مع Google Cloud . تتم مشاركة المشاريع بين Firebase وGoogle Cloud، بحيث يمكن للمشاريع تمكين خدمات Firebase وخدمات Google Cloud. يمكنك الوصول إلى نفس المشروع من وحدة تحكم Firebase أو 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 نشط حالي من مشروع في Google Cloud Console، فسيتم إرجاع هذا المشروع إلى خطة Firebase Spark.

هل يمكنني الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت؟

نعم، يمكنك الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت. لاحظ أننا لا نقدم مبالغ مستردة بشكل تناسبي لتخفيضات التصنيف أو الإلغاءات. وهذا يعني أنه إذا قمت بالرجوع إلى إصدار سابق أو الإلغاء قبل نهاية فترة الفاتورة الخاصة بك، فستظل تدفع ثمن بقية الشهر.

ما نوع الدعم الذي سأتلقاه؟

تأتي جميع تطبيقات Firebase، بما في ذلك تلك التي تستخدم خططًا مجانية، مع دعم عبر البريد الإلكتروني من موظفي Firebase خلال ساعات العمل في الولايات المتحدة والمحيط الهادئ. تتمتع جميع الحسابات بدعم غير محدود للمشكلات المتعلقة بالفواتير، والمشكلات المتعلقة بالحساب، والأسئلة الفنية (استكشاف الأخطاء وإصلاحها)، وتقارير الحوادث.

هل يمكنني تحديد الاستخدام في خطة Blaze؟

لا، لا يمكنك حاليًا تحديد استخدام خطة Blaze الخاصة بك. نحن نقوم بتقييم الخيارات لدعم الحدود القصوى لاستخدام خطة Blaze.

يمكن لمستخدمي Blaze تحديد ميزانية لمشروعهم أو حسابهم، وتلقي تنبيهات عندما يقترب إنفاقهم من تلك الحدود. تعرف على كيفية إعداد تنبيهات الميزانية .

ما هي النسخ الاحتياطية الآلية؟ هل تقدمون نسخًا احتياطية كل ساعة؟

تعد النسخ الاحتياطية التلقائية ميزة متقدمة للعملاء في خطة تسعير Blaze الخاصة بنا والتي تقوم بعمل نسخة احتياطية لبيانات Firebase Realtime Database الخاصة بك مرة واحدة يوميًا وتحميلها إلى Google Cloud Storage .

نحن لا نقدم النسخ الاحتياطية كل ساعة.

هل تقدمون خصومات مفتوحة المصدر أو غير ربحية أو تعليمية؟

يمكن استخدام خطة Spark الخاصة بنا من قبل أي نوع من الأفراد أو المؤسسات، بما في ذلك المنظمات غير الربحية والمدارس والمشاريع مفتوحة المصدر. وبما أن هذه الخطط تتضمن بالفعل حصصًا سخية، فإننا لا نقدم أي خصومات أو خطط خاصة للمشاريع مفتوحة المصدر أو غير الربحية أو التعليمية.

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.

How do I predict how much I will be billed for upload and download operations?

Visit the Firebase Pricing page and use the Blaze plan calculator . The calculator lists all the usage types for Cloud Storage for Firebase.

Use the sliders to input the expected usage of your Storage bucket. The calculator will estimate your monthly bill.

What happens if I exceed Spark plan upload, download or storage limits for Cloud Storage for Firebase?

When you exceed limits for Cloud Storage in a project on the Spark plan, the result depends on the type of limit that you exceed:

• If you exceed the GB stored limit, you will not be able to store any more data in that project unless you remove some of the data stored or upgrade to a plan that provides more storage space, or unlimited storage space.
• If you exceed the GB downloaded limit, your app will not be able to download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.
• If you exceed the upload or download operations limit, your app will not be able to upload or download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.

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: 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.

A/B Testing: Why do I receive a "Project not linked to Google Analytics" message when creating a Remote Config experiment?

If you've already linked Firebase and Google Analytics , but still see a message that Google Analytics is not linked, make sure that an Analytics stream exists for all apps in your project. Currently, all apps in a project must be connected to a Google Analytics stream to use A/B Testing.

You can find the list of all active streams on the Google Analytics integration details page within the Firebase console, accessed from settings Project Settings chevron_right Integrations chevron_right Google Analytics chevron_right Manage .

Creating a Google Analytics stream for any app that does not have one should resolve the issue. There are a few ways to create streams for missing apps:

• If you only have one or two apps missing an associated Google Analytics stream, you can choose one of the following methods to add a Google Analytics stream:
  • Delete and re-add any app without an active stream in the Firebase console.
  • From the Google Analytics console , select Admin , click Data Streams , then click Add stream , add the missing app's details, and click Register app .
• If you have more than a few missing app streams, unlinking and relinking your Google Analytics property is the fastest and most efficient way to create the missing app streams:
  1. From settings Project Settings , select Integrations .
  2. Within the Google Analytics card, click Manage to access Firebase and Google Analytics settings.
  3. Make a note of the Google Analytics Property ID and the Linked Google Analytics account .
  4. Click more_vert More and select Unlink Analytics from this project .
  5. Review the warning that appears (don't worry here; you will relink the same property in the next step), then click Unlink Google Analytics .
     
     When unlinking is complete, you'll be redirected to the Integrations page.
  6. Within the Google Analytics card, click Enable to begin the relinking process.
  7. Select your Analytics account from the Select account list.
  8. Next to Automatically create a new property in this account , click edit Edit and, from the Analytics property list that appears, select your property ID.
     
     A list of all apps in your project appears. Existing stream mappings for each app are listed, and apps that do not have a stream will have one created for them.
  9. Click Enable Google Analytics to relink the property.
  10. Click Finish .

If you still receive an error creating A/B Tests with Remote Config after performing these steps, contact Firebase Support .

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:22.4.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 ( com.google.firebase:firebase-analytics ) to your app's build.gradle file.

• For C++ projects and Unity projects , follow the instructions in the respective documentation.

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: How do I update my Analytics property settings?

From the Admin page in your Google Analytics property, you can update your property settings, such as:

• Data sharing settings
• Data retention settings
• Time zone and currency settings

To update your property settings, follow these steps:

1. In the Firebase console, go to your settings > Project settings .
2. Go to the Integrations tab, and then in the Google Analytics card, click Manage or View link .
3. Click the link for your Google Analytics account to open the account and property 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: 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 .

Analytics: Why don't I see any Analytics data in the Firebase console after unlinking Firebase from Google Analytics?

Analytics data resides within the Google Analytics property — not within the Firebase project. If you delete or unlink the property, then the Analytics data will not be accessible to Firebase and you'll see an empty Analytics dashboard in the Firebase console. Note that since the data still resides in the previously linked property, you can always relink the property to Firebase and see the Analytics data in the Firebase console.

Linking a brand new Google Analytics account (and thus a new Google Analytics property) to your Firebase project will result in an empty Analytics dashboard in the Firebase console. However, if your previously linked property still exists, then you can move the existing data from the old property to the new property.

Analytics: If my Analytics property and its data were deleted, is there any way to get them back?

No. If your property has been deleted, it isn't possible to undelete the property or retrieve the previously collected Analytics data stored in that property.

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Analytics: If my Analytics property was deleted, can I link a new Google Analytics property to my Firebase project and start using Analytics again?

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Note that since all Analytics data is stored in the property (not the Firebase project), the previously collected Analytics data cannot be retrieved.

Analytics: How will Firebase products or integrated Google products be affected by the deletion of my Analytics property?

Several Firebase products rely on the Google Analytics integration. If your Analytics property and its data are deleted, the following will happen if you use the following products:

• Crashlytics — You can no longer see crash-free users, breadcrumb logs, and/or velocity alerts.
• Cloud Messaging and In-App Messaging — You can no longer use targeting, campaign metrics, audience segmentation, and analytics labels.
• Remote Config — You can no longer use targeted configurations or Personalization.
• A/B Testing — You can no longer use A/B Testing since the experiment measurement is supplied by Google Analytics.
• Dynamic Links — Any feature that relies on data from Google Analytics will be disrupted.

In addition, the following integrations will be affected:

• You can no longer export Analytics data to BigQuery .
• You can no longer take advantage of Google Ads integrations or Google AdMob integrations .

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.

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.

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.

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.

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:

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. 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.

Which FCM APIs were deprecated on June 20, 2023, and what should I do if I am using those APIs?

The following APIs/SDKs will be affected by the deprecation:

Server APIs

Firebase Admin SDK APIs

Client SDKs

Will I see a service downgrade before June 2024?

No. You have 12 months (06/20/2023 - 06/21/2024) to migrate from the old APIs to new APIs without any service downgrade. We strongly recommend you to plan the migration as early as possible so you won't be impacted by the decommissioning of the APIs in June 2024.

After June 2024, you may see increased errors or lack of functionality when using the APIs/SDKs listed above.

What's the difference between OAuth 2.0 tokens and server keys?

An OAuth 2.0 token is a short-lived token derived from a service account . It's Google's standard auth model and it's more secure than static server keys.

See Use credentials to mint access tokens for guidance on using the Google Auth Library to obtain tokens.

Note that the request headers differ when you use OAuth 2.0 tokens for requests to different endpoints.

• HTTP v1 API : Authorization: Bearer $oauth_token
• Instance ID server API and Device group management API : Authorization: Bearer $oauth_token
access_token_auth: true

Can I migrate my requests to the new API all at once?

We recommend that you slowly ramp up your traffic to the new API. If you expect to send more than 600,000 messages/min on a regular basis, contact Firebase support for instructions on how to increase quota or get recommendations on how to spread out traffic.

What's the difference between the HTTP v1 API and the legacy APIs when I send messages to topics/device groups?

Topics: you don't need to add the "/topics/" prefix to your topic target when you use the v1 API.

Device groups: You can use a group token as a token target in the HTTP v1 API. However, the HTTP v1 API doesn't return the success/failure counts in the response. We recommend that you use FCM topics or manage your device groups by yourself.

Does the HTTP v1 API support sending messages to multiple tokens in one request?

No. This feature, called "multicast" in legacy HTTP APIs, is not supported by the HTTP v1 API, which is better designed for scalability.

For use cases where end-to-end latency is critical, or where total fanout size is small (fewer than 1 million), Google recommends sending multiple separate requests using the HTTP v1 API. The HTTP v1 API over HTTP/2 performs similarly for 99.9% of multicast requests (sending < 100 tokens). For outlier use cases (sending 1000 tokens), it achieves up to a third of the throughput rate, so additional concurrency is needed to optimize for this atypical use case. Users can experience more reliability and availability with the HTTP v1 API than with legacy multicast.

For use cases where throughput and egress bandwidth are prioritized or where total fanout size is large (greater than 1 million), Google recommends topic messaging. While topic messaging requires a one-time action to subscribe recipients to a topic, it offers up to a 10,000 QPS per project fanout rate without a maximum limit on topic size.

What versions of the Firebase Admin SDK have the new APIs?

What's the difference between the batch send API and the HTTP v1 API?

The FCM batch send API uses the same message format and authentication mechanism as the HTTP v1 API. However, it uses a different endpoint. If you want to improve efficiency, you should consider using HTTP/2 to send multiple requests over the same HTTP connection to the HTTP v1 API.

What should I do if I can't access my project?

Please reach out to the Google Cloud support team for help.

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 an unexpected increase in upload and download operations?

Previously, download and upload requests to the Cloud Storage for Firebase API were not being counted properly. We have taken steps to fix this issue, starting from September 15, 2023.

For Blaze users, upload and download operations will start counting towards your monthly bill. For Spark users, they will start counting towards your monthly free limit.

We recommend monitoring your Usage page for any increases that may count towards your limits.

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 .

Dynamic Links: What are Firebase's future plans for Dynamic Links?

See Dynamic Links FAQ .

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.

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 or firebase use . To view the list of projects (and see which one is selected) use firebase projects:list .
• Unit tests. The project ID is often specified in calls to the Rules Unit Testing library methods initializeTestEnvironment or initializeTestApp . Other testing code may initialize with initializeApp(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:

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: 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: 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 of once() .
• 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: 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.

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.