هل لديك تحديات أخرى أو لم تظهر مشكلتك الموضّحة أدناه؟ يُرجى الإبلاغ عن خطأ أو طلب ميزة والانضمام إلى مناقشات تجاوز تكديس هذه الميزة.
مشاريع Firebase وتطبيقات Firebase
ما هو مشروع Firebase؟
مشروع Firebase هو الكيان ذو المستوى الأعلى في Firebase. في أي مشروع، يمكنك تسجيل تطبيقات الويب أو تطبيقات Android أو Apple. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حِزم تطوير البرامج (SDK) الخاصة بالمنتجات في Firebase إلى تطبيقك، مثل "إحصاءات Google" أو Cloud Firestore أو Crashlytics أو "الإعداد عن بُعد".
يجب تسجيل صيغ Apple وAndroid وتطبيق الويب في مشروع واحد على Firebase. يمكنك استخدام عدة مشاريع في Firebase لدعم بيئات متعددة، مثل التطوير والمراحل والإنتاج.
إليك بعض الموارد لمعرفة المزيد عن مشاريع Firebase:
- فهم مشاريع Firebase: يقدّم هذا القسم نظرات عامة مختصرة حول عدّة مفاهيم مهمّة عن مشاريع Firebase، بما في ذلك علاقتها بخدمة Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.
- أفضل الممارسات العامة لإعداد مشاريع Firebase: يقدّم هذا التقرير أفضل الممارسات العامة وعالية المستوى لإعداد مشاريع Firebase وتسجيل تطبيقاتك باستخدام مشروع حتى يكون لديك سير عمل واضح للتطوير يستخدم بيئات مختلفة.
يُرجى العلم أنّه بالنسبة إلى جميع مشاريع Firebase، يضيف Firebase تلقائيًا تصنيفًا firebase:enabled
ضمن صفحة التصنيفات لمشروعك في Google Cloud Console. يمكنك الاطّلاع على مزيد من المعلومات حول هذا التصنيف في صفحة
الأسئلة الشائعة.
ما هي مؤسسة Google Cloud؟
مؤسسة Google Cloud هي حاوية لمشاريع Google Cloud (بما في ذلك مشاريع Firebase). ويتيح هذا التسلسل الهرمي تنظيم مشاريع Google Cloud وFirebase وإدارة أذونات الوصول بشكل أفضل والتدقيق. لمزيد من المعلومات، راجِع المقالة إنشاء المؤسسات وإدارتها.
كيف يمكنني إضافة منصة Firebase إلى مشروع حالي على Google Cloud؟
قد يكون لديك مشاريع حالية على Google Cloud مُدارة من خلال وحدة التحكّم في Google Cloud أو وحدة تحكّم Google APIs.
يمكنك إضافة Firebase إلى هذه المشاريع الحالية باستخدام أيّ من الخيارات التالية:
- باستخدام "وحدة تحكُّم Firebase":
في الصفحة المقصودة لوحدة تحكُّم Firebase، انقر على إضافة مشروع، ثم اختَر مشروعك الحالي من قائمة اسم المشروع. - باستخدام خيار آلي:
- اطلب نقطة نهاية Firebase Management REST API
addFirebase
. - شغِّل أمر Firebase CLI
firebase projects:addfirebase
. - استخدِم Terraform.
- اطلب نقطة نهاية Firebase Management REST API
لماذا يحمل مشروعي على Google Cloud تصنيفًا firebase:enabled
؟
في
صفحة التصنيفات
الخاصة بمشروعك في وحدة التحكّم في Google Cloud، قد يظهر لك تصنيف
firebase:enabled
(على وجه التحديد، تصنيف Key
من
firebase
مع Value
من enabled
).
أضافت منصة Firebase هذا التصنيف تلقائيًا لأنّ مشروعك هو مشروع في Firebase، ما يعني أنّه قد تم تفعيل إعدادات وخدمات خاصة بمنصة Firebase في مشروعك. يمكنك الاطّلاع على مزيد من المعلومات حول العلاقة بين مشاريع Firebase وGoogle Cloud.
ننصحك بشدة بعدم تعديل هذا التصنيف أو حذفه. يستخدِم Firebase وGoogle Cloud هذا التصنيف لإدراج
مشاريعك في Firebase (على سبيل المثال، باستخدام
نقطة نهاية
projects.list
واجهة برمجة التطبيقات REST
أو في القوائم ضمن "وحدة تحكُّم Firebase").
يُرجى العلم أنّ إضافة هذا التصنيف يدويًا إلى قائمة تصنيفات المشاريع لا يؤدي إلى تفعيل عمليات الضبط والخدمات الخاصة بمنصة Firebase لمشروعك على Google Cloud. لتنفيذ ذلك، يجب إضافة Firebase من خلال وحدة تحكُّم Firebase (أو في حالات الاستخدام المتقدّمة، من خلال Firebase Management REST API أو واجهة سطر الأوامر في Firebase).
لماذا لا يظهر مشروعي في Firebase في قائمة مشاريع Firebase؟
ينطبق هذا السؤال الشائع إذا لم يظهر لك مشروع Firebase في الأماكن التالية:
- في قائمة المشاريع التي تشاهدها ضمن وحدة تحكُّم Firebase
- في الردّ من استدعاء
نقطة نهاية
projects.list
لواجهة برمجة التطبيقات REST - في الاستجابة من تشغيل أمر Firebase CLI
firebase projects:list
جرِّب الخطوات التالية لتحديد المشاكل وحلّها:
- أولاً، حاوِل الوصول إلى مشروعك من خلال الانتقال إلى عنوان URL الخاص به
مباشرةً. استخدِم الصيغة التالية:
https://console.firebase.google.com/project/PROJECT-ID/overview
- إذا لم تتمكّن من الوصول إلى المشروع أو ظهرت لك أخطاء في الأذونات، تحقَّق مما يلي:
- تأكّد من تسجيل الدخول إلى Firebase باستخدام حساب Google نفسه الذي لديه إذن الوصول إلى المشروع. يمكنك تسجيل الدخول والخروج من "وحدة تحكُّم Firebase" من خلال الأفاتار الخاص بحسابك في أعلى يسار "وحدة التحكّم".
- تحقَّق من إمكانية عرض المشروع في وحدة تحكُّم Google Cloud.
- تأكَّد من أنّ مشروعك يحمل التصنيف
firebase:enabled
في صفحة التصنيفات لمشروعك في Google Cloud Console. يستخدم كل من Firebase وGoogle Cloud هذا التصنيف لإدراج مشاريعك في Firebase. إذا لم يظهر هذا التصنيف، ولكن تم تفعيل Firebase Management API لمشروعك، عليك إضافة التصنيف يدويًا (على وجه التحديد، سمةKey
منfirebase
معValue
منenabled
). - تأكَّد من أنّه قد تم إسناد أحد الأدوار الأساسية لإدارة الهوية وإمكانية الوصول (المالك أو المحرِّر أو المُشاهد) أو دور يتضمّن أذونات مرتبطة بمنصة Firebase، على سبيل المثال دور محدَّد مسبقًا في Firebase. يمكنك الاطّلاع على أدوارك في صفحة إدارة الهوية وإمكانية الوصول على Google Cloud Console.
- إذا كان مشروعك ينتمي إلى مؤسسة على Google Cloud، قد تطلب أذونات إضافية للاطّلاع على المشروع المُدرَج في وحدة تحكُّم Firebase. تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لمنحك الدور المناسب لعرض المشروع، مثل دور المتصفّح.
إذا لم تتيح لك أيّ من خطوات تحديد المشاكل وحلّها المذكورة أعلاه عرض مشروعك في قائمة مشاريع Firebase، يُرجى التواصل مع فريق دعم Firebase.
كم عدد المشاريع التي يمكنني امتلاكها لكل حساب؟
- خطة تسعير Spark: تقتصر حصة المشاريع على عدد صغير من المشاريع (تتراوح عادةً من 5 إلى 10 مشاريع).
- خطة الأسعار الأساسية: تزداد حصة مشروعك لكل حساب فوترة في Cloud بشكل كبير طالما أن حساب فوترة Cloud الخاص بك في وضع جيد.
نادرًا ما يكون الحدّ الأقصى لحصة المشاريع مصدر قلق لمعظم المطوّرين، ولكن يمكنك طلب زيادة حصة مشروعك إذا لزم الأمر.
يُرجى ملاحظة أنّ الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصتك حتى يتم حذفه بالكامل.
كم عدد تطبيقات Firebase التي يمكنني امتلاكها في مشروع Firebase؟
مشروع Firebase هو حاوية لتطبيقات Firebase على أجهزة Apple وAndroid والويب. يقصر Firebase إجمالي عدد تطبيقات Firebase في مشروع Firebase على 30 تطبيقًا.
وبعد هذا الرقم، يبدأ الأداء في الانخفاض (خاصةً بالنسبة إلى "إحصاءات Google")، وفي نهاية المطاف، تتوقف بعض وظائف المنتج عن العمل عند عدد أكبر من التطبيقات. بالإضافة إلى ذلك، إذا كنت تستخدم تسجيل الدخول بحساب Google كموفِّر مصادقة، يتم إنشاء معرِّف عميل OAuth 2.0 أساسي لكل تطبيق في مشروعك. هناك حد أقصى يبلغ 30 رقم تعريف عميل يمكن إنشاؤه في مشروع واحد تقريبًا.
يجب التأكد من أنّ جميع تطبيقات Firebase ضمن مشروع واحد على Firebase هي صيغ مختلفة للنظام الأساسي للتطبيق نفسه من منظور المستخدم النهائي. على سبيل المثال، إذا طورت تطبيق تسمية أولية، يجب أن يكون لكل تطبيق يحمل تصنيفًا مستقل مشروع Firebase الخاص به، ولكن قد تكون إصدارات Apple وAndroid من ذلك التصنيف ضمن المشروع نفسه. يمكنك الاطّلاع على إرشادات أكثر تفصيلاً في أفضل الممارسات العامة المتعلقة بإعداد مشاريع Firebase.
في الحالات النادرة التي يتطلب فيها مشروعك أكثر من 30 تطبيقًا، يمكنك طلب زيادة الحد الأقصى لمدة استخدام التطبيقات. يجب أن يكون مشروعك ضمن خطة أسعار Blaze لإرسال هذا الطلب. يُرجى الانتقال إلى وحدة التحكّم في Google Cloud لتقديم طلبك وتقييمه. يمكنك الاطّلاع على مزيد من المعلومات حول إدارة الحصص في مستندات 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: صاحب الحساب أو المشرف
- أيٌّ من الدورَين التاليين في Firebase: المالك أو مشرف Firebase
- لربط تطبيق AdMob، يجب أن تكون مالكًا لمشروع على Firebase ومشرفًا في AdMob في الوقت نفسه.
- لربط حسابك على "إعلانات Google"، يجب أن تكون مالك مشروع Firebase ومشرفًا في AdWords في الوقت نفسه.
- لربط مشروع BigQuery، يجب أن تكون مالك مشروع Firebase.
ما هي الإشعارات المفتوحة المصدر التي يجب تضمينها في تطبيقي؟
على منصات Apple، تحتوي لوحة Firebase على ملف Notifications (الإشعارات) يتضمّن الإدخالات ذات الصلة. تحتوي حزمة تطوير البرامج (SDK) لنظام التشغيل Android على Firebase على مساعد Activity
لعرض معلومات الترخيص.
الأذونات والوصول إلى مشاريع Firebase
كيف يمكنني تعيين دور لأحد أعضاء المشروع، مثل دور المالك؟
لإدارة الأدوار التي تم إسنادها إلى كل عضو في المشروع، يجب أن تكون مالكًا لمشروع Firebase
(أو أن يتم إسناد دور له بالإذن
resourcemanager.projects.setIamPolicy
).
في ما يلي الأماكن التي يمكنك إسناد الأدوار فيها وإدارتها:
- توفّر "وحدة تحكُّم Firebase" طريقة مبسّطة لإسناد الأدوار إلى أعضاء المشروع في علامة التبويب المستخدمون والأذونات ضمن settings > إعدادات المشروع. في "وحدة تحكُّم Firebase"، يمكنك تعيين أي من الأدوار الأساسية (المالك أو المحرِّر أو المُشاهد) أو أدوار المشرف/المُشاهد في Firebase أو أي من الأدوار المحدَّدة مسبقًا في فئات المنتجات في Firebase.
- تقدّم Google Cloud Console مجموعة واسعة من الأدوات لإسناد الأدوار إلى أعضاء المشاريع
في
صفحة إدارة الهوية وإمكانية الوصول. في Cloud Console، يمكنك أيضًا إنشاء
أدوار مخصّصة وإدارتها،
فضلاً عن منح حسابات الخدمة
إذن الوصول إلى مشروعك.
يُرجى العلم أنّه في Google Cloud Console، يُطلق على أعضاء المشروع اسم مديرو المشاريع.
إذا لم يعد بإمكان مالك مشروعك أداء مهام المالك (على سبيل المثال، غادر الشخص شركتك) ولم تتم إدارة مشروعك عبر مؤسسة Google Cloud (راجِع الفقرة التالية)، يمكنك التواصل مع فريق دعم Firebase لتعيين مالك مؤقت.
تجدر الإشارة إلى أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، قد لا يكون له مالك. إذا لم تتمكن من العثور على مالك لمشروعك في Firebase، تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لتعيين مالك للمشروع.
كيف يمكنني العثور على مالك مشروع Firebase؟
يمكنك عرض أعضاء المشروع وأدوارهم في الأماكن التالية:
- إذا كان لديك إذن بالوصول إلى المشروع في "وحدة تحكُّم Firebase"، يمكنك عرض قائمة بأعضاء المشروع، بما في ذلك المالكون، في صفحة "المستخدمون والأذونات" ضمن "وحدة تحكُّم Firebase".
- إذا لم يكن لديك إذن الوصول إلى المشروع في وحدة تحكُّم Firebase، تحقّق مما إذا كان بإمكانك الوصول إلى المشروع في وحدة تحكّم Google Cloud. يمكنك الاطّلاع على قائمة بأعضاء المشروع، بما في ذلك المالكون، في صفحة إدارة الهوية وإمكانية الوصول على Google Cloud Console.
إذا لم يعد بإمكان مالك مشروعك أداء مهام المالك (على سبيل المثال، غادر الشخص شركتك) ولم تتم إدارة مشروعك من خلال مؤسسة Google Cloud (راجِع الفقرة التالية)، يمكنك التواصل مع فريق دعم Firebase لتعيين مالك مؤقت.
يُرجى العِلم أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، قد لا يكون له مالك. وبدلاً من ذلك، يمكن للشخص الذي يدير مؤسستك في Google Cloud أداء العديد من المهام التي يمكن أن يُجريها المالك. ومع ذلك، لتنفيذ العديد من المهام الخاصة بالمالك (مثل إسناد الأدوار أو إدارة المواقع على "إحصاءات Google")، قد يحتاج المشرف إلى إسناد دور المالك الفعلي إلى نفسه لأداء هذه المهام. إذا لم تتمكن من العثور على مالك لمشروعك في Firebase، تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لتحديد مالك للمشروع.
لماذا أو متى يجب عليّ تعيين دور المالك لأحد أعضاء المشروع؟
لضمان الإدارة السليمة لمشروع Firebase، يجب أن يكون هناك مالك. مالك المشروع هو الشخص الذي يمكنه تنفيذ العديد من الإجراءات الإدارية المهمة (مثل إسناد الأدوار وإدارة المواقع على "إحصاءات Google")، ولا يمكن لفريق دعم Firebase تنفيذ الطلبات الإدارية إلا من مالكي المشاريع الظاهرين.
بعد إعداد المالك(المالكين) لمشروع Firebase، من المهم تحديث هذه المهام بشكل دوري.
تجدر الإشارة إلى أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، يمكن للشخص الذي يدير مؤسستك على Google Cloud تنفيذ العديد من المهام التي يمكن لأي مالك تنفيذها. ومع ذلك، بالنسبة إلى العديد من المهام المحدّدة للمالك (مثل إسناد الأدوار أو إدارة المواقع على "إحصاءات Google")، قد يحتاج المشرف إلى إسناد دور المالك الفعلي إلى نفسه لأداء هذه المهام.
لا أعتقد أنّ لديّ مشروع على 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 للمشروع.
- تأكَّد من أنّه قد تم إسناد أحد الأدوار الأساسية لإدارة الهوية وإمكانية الوصول (المالك أو المحرِّر أو المُشاهد) أو دور يتضمّن أذونات مرتبطة بمنصة Firebase، على سبيل المثال، دور محدَّد مسبقًا في Firebase. يمكنك الاطّلاع على أدوارك في صفحة إدارة الهوية وإمكانية الوصول على Google Cloud Console.
- إذا كان مشروعك ينتمي إلى مؤسسة على Google Cloud، قد تحتاج إلى الحصول على أذونات إضافية للاطّلاع على المشروع المُدرَج في "وحدة تحكُّم Firebase". تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لمنحك الدور المناسب لعرض المشروع، مثل دور المتصفّح.
إذا لم تساعدك أي من خطوات تحديد المشاكل وحلّها المذكورة أعلاه في العثور على مشروعك أو الوصول إليه، يُرجى التواصل مع فريق دعم Firebase.
لماذا لا يتم تحميل وحدة تحكُّم Firebase نيابةً عني؟
ينطبق هذا السؤال الشائع إذا كنت تواجه أيًا من المشاكل التالية:
- لا تنتهي أبدًا صفحة في "وحدة تحكُّم Firebase" من التحميل.
- لا يتم تحميل البيانات داخل إحدى الصفحات على النحو المتوقّع.
- تتلقّى رسائل خطأ في المتصفّح عند تحميل "وحدة تحكُّم Firebase".
جرِّب الخطوات التالية لتحديد المشاكل وحلّها:
- تحقَّق من صف وحدة التحكّم في لوحة البيانات الخاصة بحالة Firebase بحثًا عن أي انقطاعات محتملة في الخدمة.
- تأكَّد من استخدام متصفّح متوافق.
- حاوِل تحميل وحدة تحكُّم Firebase في نافذة تصفّح متخفٍ أو نافذة خاصة.
- أوقِف جميع إضافات المتصفّح.
- تحقق من عدم حظر الاتصال بالشبكة من خلال أداة حظر الإعلانات أو برامج مكافحة الفيروسات أو الخادم الوكيل أو جدار الحماية أو أي برامج أخرى.
- جرِّب تحميل "وحدة تحكُّم Firebase" باستخدام شبكة أو جهاز مختلفَين.
- في حال استخدام Chrome، راجِع وحدة التحكم في أدوات المطوّرين بحثًا عن أي أخطاء.
إذا لم يتم حلّ المشكلة من خلال خطوات تحديد المشاكل وحلّها المذكورة أعلاه، يُرجى التواصل مع فريق دعم Firebase.
كيف يتم تحديد لغة وحدة تحكُّم Firebase؟
تستند إعدادات اللغة في "وحدة تحكُّم Firebase" إلى اللغة التي اخترتها في إعدادات حسابك على Google.
لتغيير إعدادات اللغة المفضّلة، يُرجى الاطّلاع على القسم تغيير اللغة.
اللغات التالية متاحة في "وحدة تحكُّم Firebase":
- الإنجليزية
- البرتغالية البرازيلية
- مأكولات فرنسية
- الألمانية
- الإندونيسية
- مأكولات يابانية
- الكورية
- الروسية
- الصينية المبسطة
- مأكولات إسبانية
- الصينية التقليدية
ما هي الأدوار والأذونات التي توفِّرها وحدة تحكُّم Firebase؟
تستخدم وحدة تحكُّم Firebase وGoogle Cloud Console الأدوار والأذونات الأساسية نفسها. يمكنك الاطّلاع على مزيد من المعلومات حول الأدوار والأذونات في مستندات "إدارة الهوية وإمكانية الوصول من Firebase".
يتيح Firebase الأدوار الأساسية (الأساسية) لكل من "المالك" و"المحرِّر" و"المُشاهد":
- يمكن لمالك المشروع إضافة أعضاء آخرين إلى المشروع وإعداد عمليات الدمج (ربط المشروع بخدمات مثل BigQuery أو Slack)، ويحصل على إذن بتعديل المحتوى في المشروع بالكامل.
- يملك محرِّر المشروع الإذن بتعديل المحتوى بالكامل.
- يكون لدى مُشاهد المشروع إذن بالاطّلاع على المشروع فقط. تجدر الإشارة إلى أنّ "وحدة تحكُّم Firebase" لا تخفي حاليًا أو تُوقف عناصر التحكّم في تعديل واجهة المستخدم من "مشاهدي المشروع"، ولكن ستتعذّر هذه العمليات لأعضاء المشروع الذين تم منح دور "المُشاهد" لهم.
يتوافق Firebase أيضًا مع:
- الأدوار المحدَّدة مسبقًا في Firebase - الأدوار المنظّمة الخاصة بمنصّة Firebase والتي تتيح التحكُّم في الوصول بدقة أكبر من الأدوار الأساسية لكل من "المالك" و"المحرِّر" و"المُشاهد".
- الأدوار المخصّصة - أدوار "إدارة الهوية وإمكانية الوصول" المخصّصة بالكامل التي تنشئها لتخصيص مجموعة من الأذونات التي تستوفي المتطلبات المحدّدة لمؤسستك.
الأسعار
ما هي المنتجات المدفوعة؟ أي منها متوفّر بدون تكلفة؟
منتجات البنية الأساسية المدفوعة في Firebase هي: "قاعدة البيانات في الوقت الفعلي" وCloud Storage for Firebase وCloud Functions وHosting وTest Lab ومصادقة الهاتف. ونقدّم فئة بدون تكلفة لجميع هذه الميزات.
هناك أيضًا العديد من المنتجات المجانية التي يمكن الاستفادة منها في Firebase، وهي: "إحصاءات Google" و"المراسلة عبر السحابة الإلكترونية" و"مؤلف الإشعارات" و"الإعداد عن بُعد" و"فهرسة التطبيقات" و"الروابط الديناميكية" و"تقارير الأعطال". لا يخضع استخدام هذه المنتجات إلا لسياسات مراقبة الزيارات الخاصة بالمنتج (مثل الحصص وأذونات الوصول العادل وغيرها من إجراءات الحماية المتعلّقة بالخدمة) في جميع الخطط، بما في ذلك خطة Spark بدون تكلفة. بالإضافة إلى ذلك، لا يتم فرض تكلفة على جميع ميزات المصادقة، غير مصادقة الهاتف.
هل يقدّم Firebase أرصدة تجريبية بدون تكلفة للمنتجات المدفوعة؟
يمكن استخدام خدمات Firebase المدفوعة بموجب الفترة التجريبية المجانية من Google Cloud. يمكن لمستخدمي Google Cloud وFirebase الجدد الاستفادة من فترة تجريبية مدتها 90 يومًا تتضمن 300 دولار أمريكي في أرصدة فوترة Cloud المجانية لاستكشاف منتجات Google Cloud وFirebase وتقييمها.
خلال الفترة التجريبية المجانية من Google Cloud، سيتم منحك حساب فوترة Cloud تجريبيًا مجانيًا. سيكون أي مشروع في Firebase يستخدم حساب الفوترة هذا ضمن خطة تسعير Blaze خلال الفترة التجريبية المجانية.
لا داعي للقلق، لا يتيح لنا إعداد حساب فوترة الفترة التجريبية المجانية هذا تحصيل رسوم منك. ولن يتم تحصيل رسوم منك ما لم يتم تفعيل الفوترة صراحةً من خلال ترقية حساب فوترة الفترة التجريبية المجانية في Cloud إلى حساب مدفوع. يمكنك الترقية إلى حساب مدفوع في أي وقت أثناء الفترة التجريبية. بعد الترقية، لا يزال بإمكانك استخدام أي أرصدة متبقية (خلال فترة 90 يومًا).
بعد انتهاء الفترة التجريبية المجانية، عليك إمّا الرجوع إلى إصدار سابق من مشروعك إلى خطة أسعار Spark أو إعداد خطة أسعار Blaze في وحدة تحكُّم Firebase لمواصلة استخدام مشروعك في Firebase.
تعرَّف على المزيد من المعلومات عن الفترة التجريبية المجانية من Google Cloud.
كيف يمكنني معرفة خطة الأسعار المناسبة لي؟
خطة أسعار Spark
تقدّم خطة Spark نموذجًا رائعًا لتطوير تطبيقك بدون أي تكلفة. يمكنك الحصول على جميع ميزات Firebase المتاحة بدون تكلفة ("إحصاءات Google" ومؤلف "الإشعارات" و"Crashlytics" وما إلى ذلك) بالإضافة إلى كميات كبيرة من ميزات البنية الأساسية المدفوعة. وفي حال تجاوز الحدّ الأقصى لموارد خطة Spark خلال شهر تقويمي، سيتم إيقاف التطبيق للفترة المتبقية من ذلك الشهر. بالإضافة إلى ذلك، لا تتوفّر ميزات Google Cloud عند استخدام خطة Spark.
خطة أسعار Blaze
تم تصميم خطة Blaze لتطبيقات الإنتاج. تسمح لك خطة Blaze أيضًا بتوسيع نطاق تطبيقك باستخدام ميزات Google Cloud المدفوعة. ولن تدفع سوى مقابل الموارد التي تستهلكها، ما يتيح لك التوسّع حسب الطلب. ونسعى جاهدين لجعل أسعار خطط Blaze تنافسية مع مقدّمي الخدمات السحابية الرواد في المجال.
كيف يمكنني مراقبة الاستخدام والفوترة؟
يمكنك تتبُّع استخدامك لموارد المشاريع في "وحدة تحكُّم Firebase" على أي من لوحات البيانات التالية:
- لوحة البيانات العامة للاستخدام والفوترة على مستوى المشروع
- لوحة بيانات استخدام المصادقة (خاصةً لمثيلات مصادقة الهاتف)
- لوحة بيانات الاستخدام في Cloud Firestore
- لوحة بيانات استخدام Cloud Functions
- لوحة بيانات استخدام Cloud Storage
- استضافة لوحة بيانات الاستخدام
- لوحة بيانات استخدام قاعدة البيانات في الوقت الفعلي
ماذا حدث لخطة أسعار Flame؟
في كانون الثاني (يناير) 2020، تمت إزالة خطة أسعار Flame (أي 25 دولار أمريكي في الشهر من الحصة الإضافية) كخيار للاشتراكات الجديدة. تم منح مستخدمي الخطة الحاليين
فترة سماح لنقل مشاريعهم خارج خطة Flame.
في شباط (فبراير) 2022، تم خفض ترتيب المشاريع المتبقية ضمن خطة أسعار Flame إلى خطة أسعار Spark.
وبناءً عليه،
- لم يعُد بإمكان مشاريع خطط Spark and 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 لدوال السحابة ومصادقة الهاتف وTest Lab.
بالنسبة إلى Cloud Functions، يتم احتساب الاستخدام بدون تكلفة لخطة Blaze على مستوى حساب فوترة Cloud، وليس على مستوى المشروع، وفقًا للحدود التالية:
- مليونا استدعاء شهريًا
- 400 ألف غيغابايت في الثانية في الشهر
- 200 ألف وحدة معالجة مركزية في الثانية/الشهر
- 5 غيغابايت من بيانات معدّل استخدام الشبكة شهريًا
بالنسبة إلى مصادقة الهاتف، يتم احتساب الاستخدام بدون تكلفة لخطة Blaze شهريًا.
بالنسبة إلى Test Lab، يجب أن تكون هناك الحدود التالية في الاستخدام بدون تكلفة لخطة Blaze:
- 30 دقيقة على الجهاز المادي في اليوم
- 60 دقيقة على الأجهزة الافتراضية في اليوم
هل تتم إعادة ضبط حصة الاستخدام بدون تكلفة عند التغيير من Spark إلى خطة Blaze؟
تشمل خطة Blaze الاستخدام بدون تكلفة من خطة Spark. لا تتم إعادة ضبط الاستخدام بدون تكلفة عند الانتقال إلى خطة Blaze.
ما "اتصال قاعدة بيانات متزامن"؟
ويعادل الاتصال المتزامن جهاز جوّال أو علامة تبويب في المتصفح أو تطبيق خادم متصل بقاعدة البيانات. ويفرض Firebase حدودًا صارمة على عدد الاتصالات المتزامنة بقاعدة بيانات تطبيقك. وقد وضعنا هذه الحدود لحماية كل من Firebase والمستخدمين من إساءة الاستخدام.
الحد الأقصى المسموح به لخطة Spark هو 100 ولا يمكن رفعه. الحد الأقصى لعدد الاتصالات المتزامنة لكل قاعدة بيانات في خطتَي Flame وBليز هو 200,000 اتصال متزامن.
ويختلف هذا الحد الأقصى عن إجمالي عدد مستخدمي تطبيقك، لأنّ جميع المستخدمين لا يتصلون في وقت واحد. وإذا كنت بحاجة إلى أكثر من 200,000 اتصال متزامن، يُرجى الاطّلاع على القياس باستخدام قواعد البيانات المتعددة.
ماذا يحدث في حال تجاوز الحدّ الأقصى المسموح به لمساحة التخزين أو التنزيل لخطة Spark في قاعدة البيانات في الوقت الفعلي؟
لتزويدك بسعر يمكن توقُّعه، يتم وضع حدّ أقصى للموارد المتاحة لك في خطط Spark. وهذا يعني أنّه عند تجاوز أي حدّ للخطة في أي شهر، سيتم إيقاف تطبيقك لمنع أي استخدام إضافي للموارد وتحصيل رسوم إضافية.
ماذا يحدث إذا تجاوزتُ حدود الاتصال المتزامنة في "خطة Spark" في قاعدة بيانات "الوقت الفعلي"؟
عندما يصل تطبيقك إلى حدّ التزامن في خطة Spark، سيتم رفض أي عمليات ربط لاحقة إلى أن يتم إغلاق بعض عمليات الربط الحالية. سيستمر التطبيق في العمل لدى المستخدمين المرتبطين به.
كيف يتم دمج Firebase مع Google Cloud؟
تم دمج Firebase بشكل كبير مع Google Cloud. تتم مشاركة المشاريع بين Firebase وGoogle Cloud، بحيث يمكن تفعيل خدمات Firebase وخدمات Google Cloud للمشروعات. يمكنك الوصول إلى المشروع نفسه من "وحدة تحكُّم Firebase" أو "وحدة تحكُّم Google Cloud". وعلى وجه التحديد:
- يتم دعم بعض منتجات 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 إلى مشروع في وحدة تحكّم Google Cloud، ستتم ترقية المشروع نفسه تلقائيًا إلى خطة Firebase Blaze إذا كان هذا المشروع ضمن خطة Spark حاليًا.
في المقابل، إذا تمت إزالة حساب فوترة نشط حالي على Cloud من مشروع في Google Cloud Console، سيتم الرجوع إلى إصدار سابق من هذا المشروع إلى خطة Firebase Spark.
هل يمكنني الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت؟
نعم، يمكنك الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت. يُرجى العِلم أنّنا لا نتيح عمليات ردّ الأموال بشكل نسبي في حال الاشتراك في خطة أقلّ كلفة أو إلغاء الاشتراكات. وهذا يعني أنّه في حال الرجوع إلى إصدار سابق أو إلغاء الاشتراك قبل نهاية المدة الزمنية للفوترة، ستظل ملزمًا بالدفع لبقية الشهر.
ما نوع الدعم الذي سأحصل عليه؟
يتوفّر في جميع تطبيقات Firebase، بما في ذلك التطبيقات التي تستخدم خططًا بدون تكلفة، الدعم عبر البريد الإلكتروني من موظفي Firebase خلال ساعات العمل في الولايات المتحدة الأمريكية. تقدّم جميع الحسابات دعمًا غير محدود بشأن المشاكل المتعلقة بالفوترة، والمشاكل المتعلقة بالحساب، والأسئلة الفنية (تحديد المشاكل وحلّها)، وتقارير الحوادث.
هل يمكنني الحد من استخدام خطة Blaze؟
لا، لا يمكنك حاليًا وضع حدّ أقصى لاستخدام خطة Blaze. ونحن نقيّم خيارات لإتاحة حدود قصوى لاستخدام خطة Blaze.
يمكن لمستخدمي Blaze تحديد ميزانية لمشروعهم أو حسابهم، وتلقّي تنبيهات عند اقتراب إنفاقهم من هذه الحدود. تعرَّف على كيفية إعداد تنبيهات الميزانية.
ما هي النسخ الاحتياطية التلقائية؟ هل توفر نسخ احتياطية كل ساعة؟
النُسخ الاحتياطية المبرمَجة هي ميزة متقدّمة للعملاء المشتركين في خطة أسعار Blaze وهي توفّر نسخة احتياطية من بيانات "قاعدة بيانات Firebase في الوقت الفعلي" مرة واحدة في اليوم وتحميلها إلى Google Cloud Storage.
نحن لا نوفر نسخًا احتياطية كل ساعة.
هل تقدّم خصومات مفتوحة المصدر أو غير ربحية أو تعليمية؟
يمكن لأي فرد أو مؤسسة استخدام خطة Spark، بما في ذلك المؤسسات غير الربحية والمؤسسات التعليمية والمشاريع مفتوحة المصدر. بما أنّ هذه الخطط تتضمّن حصصًا كبيرة، نحن لا نقدّم أي خصومات أو خطط خاصة للمشاريع المفتوحة المصدر أو غير الربحية أو التعليمية.
هل تقدّم عقودًا للمؤسسات أو أسعارًا أو خدمات دعم أو خدمات استضافة بنية أساسية مخصّصة؟
تناسب خطة Blaze المؤسسات بمختلف أحجامها، وتستوفي اتفاقية مستوى الخدمة المعايير المتّبعة في المجال للبنية الأساسية المستندة إلى السحابة الإلكترونية أو تتجاوزها. مع ذلك، لا نقدّم حاليًا عقود المؤسسات أو الأسعار أو الدعم، ولا نقدّم خدمات استضافة بنية أساسية مخصّصة (أي عمليات التثبيت داخل مقرات المؤسسات) لخدمات مثل "قاعدة البيانات في الوقت الفعلي". نحن نعمل جاهدين على إضافة بعض هذه الميزات.
هل تقدّم أسعارًا مخصّصة؟ أريد فقط الدفع حسب الاستخدام لميزة أو ميزتين.
نقدّم أسعارًا مخصّصة في خطة Blaze، حيث تدفع فقط مقابل الميزات التي تستخدمها.
كيف تعمل خطط Firebase المدفوعة مع "إعلانات Google"؟ هل هناك أرصدة إعلانية بدون تكلفة مع الخطط المدفوعة؟
إنّ خطط أسعار Firebase منفصلة عن "إعلانات Google"، لذلك ما مِن أرصدة إعلانية بدون تكلفة. وبصفتك مطوِّرًا في Firebase، سيكون بإمكانك "ربط" حسابك على "إعلانات Google" بمنصّة Firebase لتوفير ميزة تتبُّع الإحالات الناجحة.
تتم إدارة جميع الحملات الإعلانية مباشرةً في "إعلانات Google"، وتتم إدارة فوترة "إعلانات Google" من وحدة تحكُّم "إعلانات Google".
أسعار Cloud Functions
لماذا أحتاج إلى حساب فوترة لاستخدام Cloud Functions في Firebase؟
تعتمد الوظائف السحابية لمنصّة Firebase على بعض خدمات Google المدفوعة. تعتمد عمليات نشر الدوال الجديدة باستخدام الإصدار 11.2.0 من Firebase CLI والإصدارات الأحدث على Cloud Build وArtifact Registry. تستخدم عمليات النشر على الإصدارات الأقدم Cloud Build بالطريقة نفسها، لكنّها تعتمد على Container Registry وCloud Storage لتخزينه بدلاً من Artifact Registry. ستتم فوترة استخدام هذه الخدمات بالإضافة إلى الأسعار الحالية.
مساحة تخزين للإصدار 11.2.0 من Firebase CLI والإصدارات الأحدث
توفّر artifact Registry الحاويات التي يتم تشغيل الوظائف فيها. يوفّر Artifact Registry أول 500 ميغابايت بدون أي تكلفة، وبالتالي قد لا يتم فرض أي رسوم على عمليات النشر الأولى للوظائف. عند تجاوز هذا الحد، سيتم تحصيل رسوم 0.10 دولار أمريكي شهريًا لكل غيغابايت من مساحة التخزين الإضافية.
مساحة تخزين للإصدار 11.1.x من Firebase CLI والإصدارات السابقة
بالنسبة إلى الوظائف التي تم نشرها في الإصدارات القديمة، يوفّر Container Registry الحاويات التي يتم تشغيل الوظائف فيها. سيتم تحصيل رسوم منك مقابل كل حاوية مطلوبة لنشر دالة. قد تلاحظ رسومًا صغيرة لكل حاوية مخزَّنة. على سبيل المثال، يتم تحصيل رسوم بقيمة 1 غيغابايت من مساحة التخزين بقيمة 0.026 دولار أمريكي في الشهر.
للحصول على المزيد من المعلومات حول التغييرات التي قد تطرأ على فاتورتك، يُرجى مراجعة ما يلي:
- أسعار Cloud Functions: لم يتم تغيير الفئة الحالية المتاحة بدون تكلفة.
- أسعار Cloud Build: توفّر Cloud Build فئة بدون تكلفة.
- سعر Artifact Registry:
- تسعير Container Registry
هل لا يزال استخدام وظائف السحابة الإلكترونية لبرنامج Firebase بدون تكلفة؟
نعم. في خطة Blaze، توفّر خدمة Cloud Functions فئة بدون تكلفة للاستدعاءات ووقت الحوسبة وعدد الزيارات على الإنترنت. يتم توفير أول 2,000,000 استدعاء، و400,000 غيغابايت في الثانية، و200,000 وحدة معالجة مركزية (CPU) في الثانية، و5 غيغابايت بدون أي تكلفة كل شهر. ولن يتم تحصيل رسوم منك إلا مقابل الاستخدام الذي يتجاوز هذه الحدود الدنيا.
بعد أول 500 ميغابايت من مساحة التخزين بدون تكلفة، ستتكبد كل عملية نشر رسومًا صغيرة مقابل مساحة التخزين المستخدمة في حاوية الدالة. إذا كانت عملية التطوير تعتمد على نشر الوظائف لأغراض الاختبار، يمكنك تقليل التكاليف بشكل أكبر من خلال استخدام مجموعة أدوات المحاكاة المحلية من Firebase أثناء التطوير.
يمكنك الاطّلاع على أمثلة على خطط أسعار Firebase وأسعار Cloud Functions.
هل يخطّط Firebase لزيادة الحصص والحدود للوظائف السحابية في Firebase؟
لا، لا نخطط لتغيير الحصص إلا من خلال إزالة الحدّ الأقصى لوقت الإنشاء، وبدلاً من تلقّي أخطاء أو تحذيرات عند بلوغ حصّة الإصدار اليومي التي تبلغ 120 دقيقة، سيتم تحصيل الرسوم منك بموجب بنود خطة تسعير Blaze. يُرجى الاطّلاع على الحصص والحدود.
هل يمكنني الحصول على رصيد بقيمة 300 دولار أمريكي (أو ما يعادله بالعملة المحلية) من Google Cloud؟
نعم، يمكنك إنشاء حساب فوترة على Cloud في وحدة التحكّم في Google Cloud للحصول على رصيد بقيمة 300 دولار أمريكي (أو ما يعادله بالعملة المحلية)، ثم ربط حساب فوترة Cloud هذا بمشروع على Firebase.
تعرَّف على مزيد من المعلومات حول رصيد Google Cloud هنا.
تجدر الإشارة إلى أنّه في حال إجراء ذلك، يجب إعداد خطة أسعار Blaze في وحدة تحكُّم Firebase حتى يستمر مشروعك في العمل بعد نفاد الرصيد البالغ 300 دولار أمريكي (أو ما يعادله بالعملة المحلية).
أريد متابعة درس تطبيقي حول الترميز للتعرّف على Firebase. هل يمكنك إعطائي حساب فوترة مؤقت؟
لا، عذرًا. ويمكنك استخدام محاكي Firebase لتطويره بدون الحاجة إلى حساب فوترة على Cloud. يمكنك بدلاً من ذلك التقدّم بطلب للحصول على فترة تجريبية مجانية من Google Cloud. إذا كنت لا تزال تواجه مشكلة في دفع فاتورتك بسبب هذا التغيير، فاتصل بدعم Firebase.
أخشى أن سأحمّل فاتورة ضخمة.
يمكنك إعداد تنبيهات الميزانية في وحدة التحكّم في Google Cloud للمساعدة في التحكّم في التكاليف. يمكنك أيضًا ضبط حدود على عدد المثيلات الواردة في الفاتورة التي تم إنشاؤها لكل دالة من الدوال. للحصول على فكرة عن التكلفة في السيناريوهات العادية، يمكنك الاطّلاع على أمثلة تسعير دوال Cloud.
كيف يمكنني التحقّق من رسوم الفوترة الحالية؟
يمكنك الاطّلاع على لوحة بيانات الاستخدام والفوترة في وحدة تحكُّم Firebase.
أستخدم إضافات Firebase. هل أنا بحاجة إلى حساب فوترة؟
نعم. وبما أنّ الإضافات تستخدم دوال Cloud، ستخضع الإضافات للرسوم نفسها التي يتم تحصيلها من خلال الوظائف الأخرى.
لاستخدام الإضافات، ستحتاج إلى الترقية إلى خطة أسعار Blaze. سيتم تحصيل مبلغ صغير منك (عادةً حوالي 0.01 دولار أمريكي في الشهر مقابل موارد Firebase المطلوبة من خلال كل إضافة تثبِّتها (حتى في حال عدم استخدامها)، بالإضافة إلى أي رسوم مرتبطة باستخدامك لخدمات Firebase.
أسعار Cloud Storage لبرنامج Firebase
كيف أتوقّع المبلغ الذي سيتم تحصيله مني مقابل عمليات التحميل والتنزيل؟
انتقِل إلى صفحة "أسعار Firebase" واستخدِم أداة حساب خطط الفوترة. تسرد الآلة الحاسبة جميع أنواع استخدام Cloud Storage for Firebase.
استخدِم أشرطة التمرير لإدخال بيانات الاستخدام المتوقّع لحزمة "مساحة التخزين". ستقدّر الآلة الحاسبة فاتورتك الشهرية.
ماذا يحدث في حال تجاوز حدود التحميل أو التنزيل أو التخزين في "خطة Spark" (مساحة التخزين في Cloud Storage for Firebase)؟
عند تجاوز الحدود القصوى المسموح بها للتخزين في Cloud Storage في مشروع ضمن خطة Spark، تعتمد النتيجة على نوع الحد الذي يجب تجاوزه:
- إذا تجاوزت الحدّ الأقصى المسموح به الذي يبلغ غيغابايت مخزّنة، لن تتمكّن من تخزين أي بيانات أخرى في هذا المشروع إلا إذا أزلت بعض البيانات المخزّنة أو تمت الترقية إلى خطة توفّر مساحة تخزين إضافية أو مساحة تخزين غير محدودة.
- إذا تجاوزت الحدّ الأقصى المسموح به الذي يبلغ غيغابايت التي تم تنزيلها، لن يتمكّن تطبيقك من تنزيل المزيد من البيانات حتى اليوم التالي (بدءًا من منتصف الليل بتوقيت المحيط الهادئ في الولايات المتحدة)، إلا إذا تمت الترقية إلى خطة ذات حدود أقل تقييدًا أو بلا حدود.
- إذا تجاوزت الحد الأقصى لعمليات التحميل أو التنزيل، لن يتمكّن تطبيقك من تحميل المزيد من البيانات أو تنزيلها إلى اليوم التالي (بدءًا من منتصف الليل أو بتوقيت المحيط الهادئ في الولايات المتحدة)، ما لم تتم الترقية إلى خطة ذات حدود أقل تقييدًا أو بدون حدود.
الخصوصية
أين يمكنني العثور على معلومات حول الخصوصية والأمان في Firebase؟
اطّلِع على صفحة الخصوصية والأمان في Firebase.
هل تسجِّل حِزم تطوير البرامج (SDK) لمنصة Firebase أي معلومات استخدام أو بيانات تشخيص خارج "إحصاءات Google"؟
نعم. هذه الميزة خاصة بنظام التشغيل iOS فقط في الوقت الحالي، ولكن قد تتغيّر في المستقبل. تتضمّن حزمة تطوير البرامج (SDK) لمنصات Apple
Firebase إطار عمل FirebaseCoreDiagnostics
تلقائيًا. يستخدم Firebase هذا الإطار لجمع معلومات عن استخدام حِزم SDK وبيانات التشخيص المتعلّقة بها للمساعدة في إعطاء الأولوية لتحسينات المنتجات في المستقبل. إنّ FirebaseCoreDiagnostics
اختياري، لذلك إذا أردت إيقاف إرسال سجلات بيانات التشخيص لمنصة Firebase، يمكنك إجراء ذلك من خلال إلغاء ربط المكتبة بتطبيقك. يمكنك الاطّلاع على المصدر الكامل،
بما في ذلك القيم المسجّلة، على
GitHub
اختبار A/B
اختبار A/B: كم عدد التجارب التي يمكنني إنشاؤها وتنفيذها؟
يمكنك إجراء ما يصل إلى 300 تجربة لكل مشروع، ويمكن أن يشمل ذلك ما يصل إلى 24 تجربة قيد التنفيذ، والباقي كمسودة أو مكتملة.
اختبار A/B: لماذا لا يمكنني الاطّلاع على تجاربي بعد إلغاء ربط مشروعي بحساب "إحصاءات Google" وإعادة ربطه؟
سيؤدي الربط بموقع مختلف على "إحصاءات Google" إلى فقدان إمكانية الوصول إلى التجارب التي تم إنشاؤها مسبقًا. لاستعادة إمكانية الوصول إلى تجربة سابقة، عليك إعادة ربط مشروعك بموقع "إحصاءات Google" الذي تم ربطه عند إنشاء التجربة.
اختبار A/B: لماذا تظهر لي الرسالة "مشروع غير مرتبط بخدمة "إحصاءات Google"" عند إنشاء تجربة في ميزة "الإعداد عن بُعد"؟
إذا سبق لك ربط Firebase و"إحصاءات Google"، ولكن لا تزال ترى رسالة تفيد بأنّ "إحصاءات Google" غير مرتبط، تأكَّد من توفّر مصدر بيانات على "إحصاءات Google" لجميع التطبيقات في مشروعك. في الوقت الحالي، يجب ربط جميع التطبيقات في المشروع بمصدر بيانات في "إحصاءات Google" لاستخدام اختبار A/B.
يمكنك العثور على قائمة بجميع مصادر البيانات النشطة على صفحة تفاصيل دمج "إحصاءات Google" ضمن "وحدة تحكُّم Firebase"، ويمكن الوصول إليها من خلال settingsإعدادات المشروع chevron_right عمليات الدمج chevron_right إحصاءات Google chevron_right إدارة.
من المفترض أن يؤدي إنشاء مصدر بيانات في "إحصاءات Google" لأي تطبيق لا يحتوي على تطبيق إلى حلّ المشكلة. في ما يلي بضع طُرق لإنشاء أحداث بث للتطبيقات غير المتوفّرة:
-
في حال عدم توفُّر مصدر بيانات مرتبط في "إحصاءات Google" في تطبيق واحد أو تطبيقَين، يمكنك اختيار
إحدى الطرق التالية لإضافة مصدر بيانات من "إحصاءات Google":
- يمكنك حذف أي تطبيق بدون بث نشط وإعادة إضافته في "وحدة تحكُّم Firebase".
- من وحدة تحكّم "إحصاءات Google"، اختَر المشرف، وانقر على مصادر البيانات، ثم انقر على إضافة مصدر بيانات، وأضِف تفاصيل التطبيق غير المتوفّرة، ثم انقر على تسجيل التطبيق.
-
إذا كان هناك أكثر من بعض مصادر بيانات التطبيقات غير متوفّرة، يُعدّ إلغاء ربط موقعك على "إحصاءات Google" وإعادة ربطه
الطريقة الأسرع والأكثر فعالية لإنشاء مصادر بيانات التطبيقات التي لم يتم تضمينها:
- من settings إعدادات المشروع، اختَر عمليات الدمج.
- انقر على إدارة ضمن بطاقة إحصاءات Google للوصول إلى إعدادات Firebase و"إحصاءات Google".
- دوِّن رقم تعريف الموقع في "إحصاءات Google" وحساب "إحصاءات Google" المرتبط.
- انقر على more_vert المزيد واختَر إلغاء ربط "إحصاءات Google" بهذا المشروع.
-
راجِع التحذير الذي يظهر (لا داعي للقلق هنا، لأنّه ستتم إعادة ربط الموقع نفسه في
الخطوة التالية)، ثم انقر على
إلغاء ربط "إحصاءات Google".
عند اكتمال عملية إلغاء الربط، ستتم إعادة توجيهك إلى صفحة عمليات الدمج. - ضمن بطاقة إحصاءات Google، انقر على تفعيل لبدء عملية إعادة الربط.
- اختر حسابك على "إحصاءات Google" من قائمة اختيار حساب.
-
بجانب إنشاء موقع جديد تلقائيًا في هذا الحساب، انقر على
edit تعديل، ومن
قائمة الموقع على "إحصاءات Google" التي تظهر، اختَر رقم تعريف موقعك.
ستظهر قائمة بجميع التطبيقات في مشروعك. يتم إدراج عمليات ربط ساحة المشاركات الحالية لكل تطبيق، وسيتم إنشاء رابط لها في التطبيقات التي لا تتضمّن بثًا. - انقر على تفعيل "إحصاءات Google" لإعادة ربط الموقع.
- انقر على إنهاء.
إذا استمرّت رسالة الخطأ في إنشاء اختبارات A/B باستخدام ميزة "الإعداد عن بُعد" بعد تنفيذ هذه الخطوات، يمكنك التواصل مع فريق دعم Firebase.
AdMob
AdMob: هل يمكنني ربط تطبيقات Windows بمنصّة Firebase؟
لا، تطبيقات Windows غير متاحة حاليًا.
AdMob: لماذا لا يمكنني ربط تطبيقي بخدمة AdMob من وحدة تحكُّم Firebase؟
يمكنك ربط تطبيق على AdMob بتطبيق Firebase عبر وحدة تحكُّم AdMob. التعرّف على كيفية إجراء ذلك
AdMob: ما هي الأذونات أو إمكانية الوصول التي أحتاجها لربط تطبيق Firebase بتطبيق AdMob؟
لإجراء هذا الربط، يجب أن يكون لديك إذن الوصول التالي:
- AdMob: يجب أن تكون مشرف AdMob.
- Firebase: يجب أن يكون لديك إذن
firebase.links.create
، والذي يتم تضمينه في دور المالك ودور مشرف Firebase. - إحصاءات Google: يجب أن يكون لديك دور "التعديل" أو دور "إدارة المستخدمين" للموقع المرتبط بمشروع Firebase. مزيد من المعلومات
AdMob: هل بإمكان مستخدمين متعددين في حساب AdMob نفسه ربط تطبيقات AdMob وتطبيقات Firebase؟
بالنسبة إلى حسابات AdMob متعددة المستخدمين، يكون المستخدم الذي أنشأ أول رابط لمنصة Firebase ووافق على بنود خدمة Firebase هو المستخدم الوحيد الذي يمكنه إنشاء روابط جديدة بين تطبيقات AdMob وتطبيقات Firebase.
AdMob: لاستخدام AdMob، ما هي حِزم تطوير البرامج (SDK) التي يجب أن أستخدمها؟
لاستخدام AdMob، استخدِم دائمًا حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" كما هو موضّح في هذه الأسئلة الشائعة. بالإضافة إلى ذلك، إذا كنت تريد جمع مقاييس سلوك المستخدِمين في AdMob، يمكنك تضمين حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google" في تطبيقك.
- بالنسبة إلى مشاريع iOS:
يمكنك استيراد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال اتّباع التعليمات الواردة في مستندات AdMob iOS. - بالنسبة إلى مشاريع Android:
أضِف الاعتمادية لحزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى ملفbuild.gradle
:
implementation 'com.google.android.gms:play-services-ads:23.2.0'
- بالنسبة إلى مشاريع C++ و مشاريع Unity: يجب اتّباع التعليمات الواردة في المستندات ذات الصلة.
إحصاءات Google
الإحصاءات: لماذا تُعتبر "إحصاءات Google" جزءًا مقترَحًا من استخدام منتجات Firebase؟
"إحصاءات Google" هي حل مجاني وغير محدود للإحصاءات يعمل مع ميزات Firebase لتقديم إحصاءات فعّالة. ويتيح لك هذا الوضع عرض سجلّات الأحداث في Crashlytics وفعالية الإشعارات في "المراسلة عبر السحابة الإلكترونية من Firebase" وأداء الروابط لصفحات في التطبيق في الروابط الديناميكية وبيانات الشراء داخل التطبيق من Google Play. تعزّز هذه الميزة استهداف الجمهور المتقدّم في ميزات "الإعداد عن بُعد" و"الإعداد عن بُعد" وغيرها.
وتعمل "إحصاءات Google" كطبقة من الذكاء في وحدة تحكُّم Firebase لتزويدك بمزيد من الإحصاءات القابلة للاستخدام حول كيفية تطوير تطبيق عالي الجودة وتوسيع قاعدة المستخدمين وتحقيق المزيد من الأرباح.
للبدء، يُرجى قراءة المستندات.
الإحصاءات: كيف يمكنني التحكّم في كيفية مشاركة بياناتي في "إحصاءات Google" مع باقي منصة Firebase؟
وبشكلٍ تلقائي، يتم استخدام بيانات "إحصاءات Google" لتحسين ميزات Firebase وGoogle الأخرى. يمكنك في أي وقت التحكّم في كيفية مشاركة بياناتك على "إحصاءات Google" في إعدادات مشروعك. اطّلِع على المزيد من المعلومات عن إعدادات مشاركة البيانات.
إحصاءات Google: كيف يمكنني تعديل إعدادات موقعي على "إحصاءات Google"؟
من صفحة المشرف في موقعك على "إحصاءات Google"، يمكنك تعديل إعدادات الموقع، مثل:
- إعدادات مشاركة البيانات
- إعدادات الاحتفاظ بالبيانات
- إعدادات المنطقة الزمنية والعملة
لتعديل إعدادات موقعك، اتّبِع الخطوات التالية:
- في "وحدة تحكُّم Firebase"، انتقِل إلى settings > إعدادات المشروع.
- انتقِل إلى علامة التبويب عمليات الدمج، ثم انقر على إدارة أو عرض الرابط في بطاقة "إحصاءات Google".
- انقر على الرابط المؤدي إلى حسابك على "إحصاءات Google" من أجل فتح إعدادات الحساب والموقع.
"إحصاءات Google" في تطبيق iOS: هل يمكنني تثبيت "إحصاءات Google" بدون تحديد مصدر الإعلان وميزات جمع معرّف المعلِنين (IDFA)؟
نعم. راجِع صفحة ضبط جمع البيانات واستخدامها للحصول على مزيد من التفاصيل.
الإحصاءات: ما الذي تغيّر في قسم "إحصاءات Google" عند تعديل تشرين الأول (أكتوبر) 2021؟
يمكنك العثور على ملخّص لهذه التغييرات في مقالة "مركز مساعدة Firebase" الوظيفة الجديدة في "إحصاءات Google 4" ضمن "إحصاءات Google لبرنامج Firebase".
"إحصاءات Google": لماذا لا تظهر لي أي بيانات من خدمة "إحصاءات Google" في وحدة تحكُّم Firebase بعد إلغاء ربط Firebase بخدمة "إحصاءات Google"؟
تتوفّر بيانات "إحصاءات Google" في موقع "إحصاءات Google"، وليس ضمن مشروع Firebase. في حال حذف الموقع أو إلغاء ربطه، لن يمكن لمنصة Firebase الوصول إلى بيانات "إحصاءات Google"، وستظهر لوحة بيانات إحصاءات فارغة في وحدة تحكُّم Firebase. يُرجى العلم أنّه بما أنّ البيانات لا تزال متوفّرة في الموقع الذي سبق ربطه، يمكنك في أي وقت إعادة ربط الموقع بمنصّة Firebase والاطّلاع على بيانات "إحصاءات Google" في وحدة تحكّم Firebase.
سيؤدي ربط حساب جديد تمامًا على "إحصاءات Google" (وبالتالي موقع جديد على "إحصاءات Google") بمشروعك في Firebase إلى إنشاء لوحة بيانات إحصاءات فارغة في وحدة تحكُّم Firebase. في المقابل، إذا كان موقعك الذي سبق ربطه لا يزال متوفرًا، يمكنك نقل البيانات الحالية من الموقع القديم إلى الموقع الجديد.
إحصاءات Google: إذا تم حذف موقعي على "إحصاءات Google" وبياناته، هل هناك أي طريقة لاستعادتها؟
لا، إذا تم حذف موقعك، لن تتمكّن من إلغاء حذفه أو استرداد بيانات "إحصاءات Google" التي تم جمعها في السابق والمحفوظة فيه.
إذا أردت البدء في استخدام "إحصاءات Google" مجددًا، يمكنك ربط موقع جديد أو موقع حالي بمشروعك على Firebase. ويمكنك إجراء هذا الربط في وحدة تحكُّم Firebase أو واجهة مستخدم "إحصاءات Google". اطّلِع على مزيد من المعلومات عن ربط موقع على "إحصاءات Google" بمشروعك على Firebase.
"إحصاءات Google": إذا تم حذف موقعي على "إحصاءات Google"، هل يمكنني ربط موقع جديد على "إحصاءات Google" بمشروعي في Firebase وبدء استخدام "إحصاءات Google" مرة أخرى؟
إذا أردت البدء في استخدام "إحصاءات Google" مجددًا، يمكنك ربط موقع جديد أو موقع حالي بمشروعك على Firebase. ويمكنك إجراء هذا الربط في وحدة تحكُّم Firebase أو واجهة مستخدم "إحصاءات Google". اطّلِع على مزيد من المعلومات عن ربط موقع على "إحصاءات Google" بمشروعك على Firebase.
يُرجى العلم بأنّه بما أنّ جميع بيانات "إحصاءات Google" يتم تخزينها في الموقع (وليس مشروع Firebase)، لا يمكن استرداد بيانات "إحصاءات Google" التي تم جمعها في السابق.
إحصاءات Google: كيف ستتأثر منتجات Firebase أو منتجات Google المُدمجة بحذف موقعي على "إحصاءات Google"؟
يعتمد العديد من منتجات Firebase على دمج "إحصاءات Google". في حال حذف موقعك على "إحصاءات Google" وبياناته، سيحدث ما يلي في حال استخدام المنتجات التالية:
- Crashlytics: لم يعُد بإمكانك الاطّلاع على المستخدمين الذين لم تواجههم أعطالاً و/أو سجلات شريط التنقّل و/أو تنبيهات السرعة.
- "المراسلة عبر السحابة الإلكترونية" و"المراسلة داخل التطبيق": لم يعُد بإمكانك استخدام الاستهداف ومقاييس الحملة وتصنيف الجمهور وتصنيفات الإحصاءات.
- "الإعداد عن بُعد": لم يعُد بإمكانك استخدام إعدادات الاستهداف أو "التخصيص".
- اختبار A/B: لم يعُد بإمكانك استخدام اختبار A/B لأنّ خدمة قياس التجربة مُقدَّمة من "إحصاءات Google".
- الروابط الديناميكية: ستتوقّف أي ميزة تعتمد على البيانات من "إحصاءات Google".
بالإضافة إلى ذلك، ستتأثر عمليات الدمج التالية:
- لن يعود بإمكانك تصدير بيانات "إحصاءات Google" إلى BigQuery.
- لن يعود بإمكانك الاستفادة من عمليات الدمج مع "إعلانات Google" أو عمليات الدمج مع Google AdMob.
الإحصاءات: كيف يمكنني تقسيم المستخدمين الذين لم يستوفوا معيارًا معيّنًا؟
يمكنك إعادة صياغة المشكلة من خلال "استهداف سلبي" هؤلاء المستخدمين. على سبيل المثال، يمكنك إعادة صياغة المشكلة على النحو التالي: "عدم عرض الإعلانات للأشخاص الذين اشتروا منتجًا معيّنًا"، وإنشاء جمهور لهؤلاء المستخدمين لاستهدافهم.
الإحصاءات: هل تتوفّر أيضًا شرائح الجمهور و/أو الأحداث المحدّدة في واجهة "إحصاءات Google" في وحدة تحكُّم Firebase؟
ستتمّ مزامنة شرائح الجمهور وخصائص المستخدِمين. وبالنسبة إلى بعض الميزات، ستحتاج إلى استخدام واجهة "إحصاءات Google"، مثل التصنيف إلى شرائح ومسارات الإحالات الناجحة المغلقة. يمكنك الوصول إلى واجهة "إحصاءات Google" مباشرةً من خلال روابط لصفحات في التطبيق ضمن "وحدة تحكُّم Firebase".
يمكن أيضًا تنفيذ أي تغييرات تجريها من "وحدة تحكُّم Firebase" في "إحصاءات Google"، وستظهر هذه التغييرات في Firebase.
المصادقة
مصادقة Firebase: ما هي المناطق التي تتوفّر فيها مصادقة الهاتف؟
تتيح مصادقة Firebase إمكانية إثبات ملكية رقم الهاتف على مستوى العالم، ولكن لا تستطيع جميع الشبكات إرسال رسائل التحقق بشكل موثوق. تتوفّر أسعار تسليم جيدة في المناطق التالية، ويُتوقَّع أن تعمل بشكل جيد لمصادقة الهاتف. تم الإبلاغ عن عدم توفّر بعض شركات النقل في منطقة معيّنة بسبب سوء معدّلات نجاح التسليم.
الإقليم | الرمز |
---|---|
م | أندورا |
الإمارات العربية المتحدة | الإمارات العربية المتحدة |
تركيز تلقائي | أفغانستان |
متوسط | أنتيغوا وبربودا |
ألبانيا | ألبانيا |
صباحًا | أرمينيا |
AO | أنغولا |
تنسيق بتكنولوجيا الواقع المعزّز | الأرجنتين |
خادم مصادقة | ساموا الأمريكية |
AT | النمسا |
AU | أستراليا |
AW | أروبا |
أريزونا | أذربيجان |
عدد الحمّامات: | البوسنة والهرسك |
BB | بربادوس |
BD | بنغلاديش |
بلجيكا | بلجيكا |
BF | بوركينا فاسو |
BG | بلغاريا |
BJ | بنين |
معدِّل المطابقة التقريبية | برمودا |
مليار | بروناي (دار السلام) |
بوليفيا | بوليفيا |
البرازيل | البرازيل |
شهادة البكالوريوس (BS) | جزر البهاما |
بلوتوث | بوتان |
أبيض وأسود | بتسوانا |
بواسطة | بيلاروس |
BZ | بليز |
مصدر الشهادة | كندا |
قرص مضغوط | الكونغو، (كينشاسا) |
CF | جمهورية أفريقيا الوسطى |
CG | الكونغو (برازافيل) |
سويسرا | سويسرا |
كومنولث | كوت ديفوار |
CK | جزر كوك |
تشيلي | تشيلي |
مدير الحملة | الكاميرون |
كولورادو | كولومبيا |
رد جاهز | كوستاريكا |
سيرة ذاتية | الرأس الأخضر |
CW | كوراساو |
السنة التقويمية | قبرص |
تشيكيا | جمهورية التشيك |
ألمانيا | ألمانيا |
منسّق الموسيقى | جيبوتي |
الدانمرك | الدانمرك |
رسالة مباشرة | دومينيكا |
ما يجب فعله | جمهورية الدومينيكان |
الجزائر | الجزائر |
EC | إكوادور |
مصر | مصر |
الإسبانية | إسبانيا |
وقت إضافي | إثيوبيا |
فنلندا | فنلندا |
إف جي | فيجي |
ك ف | جزر فوكلاند (مالفيناس) |
راديو FM | ولايات ميكرونيسيا المتحدة |
جُزر فارو | جزر فارو |
KSA | فرنسا |
GA | الغابون |
متوسط التأخُّر عن الصدارة | المملكة المتحدة |
GD | غرينادا |
جورجيا | جورجيا |
GF | غويانا الفرنسية |
أخضر | غيرنزي |
غا | غانا |
المؤشر الجلايسيمي (GI) | جبل طارق |
غول جبال الهملايا | غرينلاند |
مدير عام | غامبيا |
GP | غوادلوب |
خبير | غينيا الاستوائية |
GR | اليونان |
غواتيماغ | غواتيمالا |
هاواي | غيانا |
هونغ كونغ | هونغ كونغ الصينية (منطقة إدارية خاصة) |
هندوراس | هندوراس |
الموارد البشرية | كرواتيا |
استراحة | هايتي |
الوحدة الرئيسية (HU) | هنغاريا |
رقم التعريف | إندونيسيا |
أيرلندا | أيرلندا |
إلينوي | إسرائيل |
المراسلة الفورية | آيل أوف مان |
IN | الهند |
نسبة الذكاء | العراق |
تكنولوجيا المعلومات | إيطاليا |
ج | جيرسي |
JM | جامايكا |
JO | الأردن |
اليابان | اليابان |
كينيا | كينيا |
كيلوغرام | قيرغيزستان |
خ | كمبوديا |
كم | جزر القمر |
كوريا الجنوبية | سانت كيتس ونيفس |
كوريا الجنوبية | كوريا (الجنوبية) |
الكويت | الكويت |
كنتاكي | جزر كايمان |
KZ | كازاخستان |
لوس أنجلوس | جمهورية لاو الديمقراطية الشعبية |
نقاط بسبب اصطدام الكرة بجسم ضارب الكرة | لبنان |
خبير محلّي | سانت لوشيا |
ليو | ليشتنشتاين |
ليو روماني | سريلانكا |
LS | ليسوتو |
LT | ليتوانيا |
كويت | لكسمبورغ |
LV | لاتفيا |
ليلى | ليبيا |
المغرب | المغرب |
ماريلاند | مولدوفا |
أنا | الجبل الأسود |
خط متوسط | سان مارتن (الجزء الفرنسي) |
ملي غالون | مدغشقر |
مقدونيا | جمهورية مقدونيا |
الشهر | ميانمار |
مينيسوتا | منغوليا |
هدف | ماكاو، منطقة إدارية خاصة بالصين |
مايكروسوفت | مونتسيرات |
MT | مالطا |
MU | موريشيوس |
ميغاواط | ملاوي |
MX | المكسيك |
ماليزيا | ماليزيا |
ميل زون | موزمبيق |
غير متاح | ناميبيا |
كارولاينا الشمالية | كاليدونيا الجديدة |
الشمال الشرقي | النيجر |
NF | جزيرة نورفولك |
NG | نيجيريا |
أيرلندا الشمالية | نيكاراغوا |
هولندا | هولندا |
لا | النرويج |
نيجيريا | نيبال |
نيوزيلندا | نيوزيلندا |
عُمان | عُمان |
PA | بنما |
خبير منتجات | بيرو |
PG | بابوا غينيا الجديدة |
PH | الفلبين |
PK | باكستان |
بولندا | بولندا |
مساءً | سان بيير وميكلون |
PR | بورتوريكو |
ضربات الجزاء | فلسطين |
توقيت المحيط الهادئ | البرتغال |
باراغواي | باراغواي |
تأكيد الجودة | قطر |
RE | ريونيون |
رومانيا | رومانيا |
RS | صربيا |
روسيا | روسيا الاتحادية |
شمال غرب | رواندا |
SA | المملكة العربية السعودية |
كارولاينا الجنوبية | سيشيل |
السويد | السويد |
SG | سنغافورة |
ركلات الترجيح | سانت هلينا |
مع نسبة شوائب صغيرة | سلوفينيا |
سلوفاكيا | سلوفاكيا |
SL | سيراليون |
السنغال | السنغال |
SR | سورينام |
ST | سان تومي وبرينسيبي |
SV | السلفادور |
جنوب شرق | سوازيلند |
TC | جزر توركس وكايكوس |
تي جي | توغو |
تايلاند | تايلاند |
قائد فريق | تيمور - ليشتي |
TM | تركمانستان |
فقد الاستحواذ | تونغا |
ليرة تركية | تركيا |
هدف | ترينيداد وتوباغو |
تايوان | تايوان، جمهورية الصين |
TZ | حمهورية تنزانيا المتحدة |
UA | أوكرانيا |
UG | أوغندا |
الولايات المتحدة | الولايات المتحدة الأمريكية |
أوروغواي | أوروغواي |
UZ | أوزباكستان |
VC | سانت فنسنت وجزر غرينادين |
فنزويلا | فنزويلا (جمهورية بوليفاريا) |
هكذا | جزر فيرجن البريطانية |
6 | جزر فيرجن الأمريكية |
فيتنام | فيتنام |
غربًا | ساموا |
نعم | اليمن |
YouTube | مايوت |
جنوب أفريقيا | جنوب أفريقيا |
زُمَى | زامبيا |
زوو | زمبابوي |
مصادقة Firebase: كيف يمكنني منع إساءة استخدام الرسائل القصيرة عند استخدام مصادقة الهاتف؟
للمساعدة في حماية مشروعك من المضخّة الناتجة عن الرسائل القصيرة وإساءة استخدام واجهة برمجة التطبيقات، يمكنك اتّباع الخطوات التالية:
يمكنك ضبط سياسة منطقة للرسائل القصيرة.
عرض استخدام رسائل SMS الإقليمية.
ابحث عن المناطق التي يتم فيها إرسال عدد كبير جدًا من الرسائل القصيرة SMS وعدد قليل جدًا (أو صفرًا) من رسائل SMS التي يتم التحقّق منها. تمثّل نسبة عمليات إثبات الملكية/المرسَلة معدّل النجاح. تتراوح معدلات النجاح الصحية عادةً بين 70 و85% لأن الرسائل القصيرة ليست بروتوكولًا مضمونًا للتسليم، وقد تواجه بعض المناطق إساءة استخدام. وتشير معدّلات النجاح الأقل من% 50 إلى أنّ العديد من الرسائل القصيرة SMS مُرسَلة رغم قلة عدد عمليات تسجيل الدخول الناجحة، وهو مؤشر شائع للجهات المسيئة وارتفاع عدد الزيارات عبر الرسائل القصيرة.
يمكنك استخدام سياسة منطقة الرسائل القصيرة SMS إما لرفض مناطق الرسائل القصيرة SMS التي تحقق معدلات نجاح منخفضة، أو للسماح بمناطق معينة فقط إذا كان تطبيقك مخصصًا للتوزيع في أسواق معينة فقط.
تقييد نطاقات المصادقة المُصرح بها
استخدِم
لوحة بيانات إعدادات المصادقة
لإدارة النطاقات المُصرَّح بها. تتم إضافة النطاق localhost
تلقائيًا إلى نطاقات المصادقة المعتمَدة لتبسيط عملية التطوير. ننصحك بإزالة
localhost
من النطاقات المسموح بها في مشروع الإنتاج
لمنع الجهات المسيئة من تشغيل الرموز البرمجية على localhost
من أجل الوصول
إلى مشروع الإنتاج.
تفعيل فحص التطبيقات وفرضه
يمكنك تفعيل ميزة فحص التطبيقات للمساعدة في حماية مشروعك من إساءة استخدام واجهة برمجة التطبيقات من خلال الإقرار بأنّ الطلبات واردة فقط من التطبيقات المرتبطة بمشروعك.
لاستخدام ميزة "فحص التطبيق" مع "مصادقة Firebase"، يجب الترقية إلى مصادقة Firebase باستخدام النظام الأساسي للهوية.
لا تنسَ أنّك بحاجة إلى فرض ميزة "فحص التطبيق" للمصادقة في وحدة تحكُّم Firebase (يمكنك مراقبة عدد الزيارات قبل فرضها). يُرجى أيضًا التحقّق مرة أخرى من قائمة المواقع الإلكترونية المُعتمَدة من reCAPTCHA Enterprise للتأكّد من أنّها تحتوي على مواقع إلكترونية خاصة بالإنتاج فقط، وأنّ قائمة التطبيقات المسجّلة في مشروعك في App Check دقيقة.
تجدُر الإشارة إلى أنّ ميزة "فحص التطبيقات" تساعد في الحماية من الهجمات الآلية من خلال التأكيد على أنّ المكالمة واردة من أحد تطبيقاتك المسجّلة. ولا يمنع المستخدمين من استخدام تطبيقك بطرق غير مقصودة (على سبيل المثال، البدء ثم عدم إنهائه مطلقًا خطوات تسجيل الدخول لإنشاء رسائل SMS مُرسَلة).
مصادقة Firebase: هل يتم نقل أرقام الهواتف إلى مشغّل شبكة جوّال جديد متوافق مع مصادقة الهاتف؟
في الوقت الحالي، ستؤدي الأرقام المنقولة بين مشغِّلي شبكات الجوّال إلى عدم إمكانية تسليم جميع رسائل SMS إلى هؤلاء المستخدمين النهائيين. ما مِن حل بديل، ويعمل Firebase على حلّ هذه المشكلة.
مصادقة Firebase: لماذا يظهر الخطأ التالي في تطبيق Android:
Google sign in failed
؟
Google sign in failed
اتّبِع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:
GoogleFragment: Google sign in failed
com.google.android.gms.common.api.ApiException: 13: Unable to get token.
at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)
تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد مصادقة:
في وحدة تحكُّم Firebase، افتح قسم المصادقة.
ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة سابقًا):
افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.
أعِد فتح طريقة تسجيل الدخول إلى Google، وفعِّلها، ثم انقر على حفظ.
تأكَّد من أنّ تطبيقك يستخدم ملف إعداد Firebase المحدَّث (
google-services.json
).
احصل على ملف إعداد تطبيقك.تأكَّد من استمرار ظهور رسالة الخطأ. إذا كنت كذلك، فانتقل إلى الخطوة التالية من استكشاف الأخطاء وإصلاحها.
تأكَّد من توفُّر عملاء OAuth 2.0 الأساسيين المطلوبين.
في صفحة بيانات الاعتماد بوحدة تحكُّم Google Cloud، ابحث في قسم معرّفات عميل OAuth 2.0.
في حال عدم توفّر برامج OAuth 2.0 (وتم تنفيذ جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يمكنك التواصل مع فريق الدعم.
مصادقة Firebase: في تطبيق النظام الأساسي من Apple، لماذا يظهر لي
الخطأ التالي:
You must specify <clientID> in <GIDConfiguration>
؟
You must specify <clientID> in <GIDConfiguration>
اتّبِع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:
You must specify |clientID| in |GIDConfiguration|
تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد مصادقة:
في وحدة تحكُّم Firebase، افتح قسم المصادقة.
ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة سابقًا):
افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.
أعِد فتح طريقة تسجيل الدخول إلى Google، وفعِّلها، ثم انقر على حفظ.
تأكَّد من أنّ تطبيقك يستخدم ملف إعداد Firebase المحدَّث (
GoogleService-Info.plist
).
احصل على ملف إعداد تطبيقك.تأكَّد من استمرار ظهور رسالة الخطأ. إذا كنت كذلك، فانتقل إلى الخطوة التالية من استكشاف الأخطاء وإصلاحها.
تأكَّد من توفُّر عملاء OAuth 2.0 الأساسيين المطلوبين.
في صفحة بيانات الاعتماد بوحدة تحكُّم Google Cloud، ابحث في قسم معرّفات عميل OAuth 2.0.
في حال عدم توفّر برامج OAuth 2.0 (وتم تنفيذ جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يمكنك التواصل مع فريق الدعم.
مصادقة Firebase: لماذا يظهر الخطأ التالي في تطبيق الويب:
AuthErrorCode.INVALID_OAUTH_CLIENT_ID
؟
AuthErrorCode.INVALID_OAUTH_CLIENT_ID
اتّبِع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:
AuthErrorCode.INVALID_OAUTH_CLIENT_ID
تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد مصادقة:
في وحدة تحكُّم Firebase، افتح قسم المصادقة.
ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة سابقًا):
افتح طريقة تسجيل الدخول باستخدام Google وأوقِفها، ثم انقر على حفظ.
أعِد فتح طريقة تسجيل الدخول إلى Google، وفعِّلها، ثم انقر على حفظ.
بالإضافة إلى ذلك، في إعدادات موفّر تسجيل الدخول إلى Google ضمن قسم المصادقة، تأكَّد من تطابق معرّف عميل OAuth والسر مع عميل الويب المعروضَين في صفحة بيانات الاعتماد بوحدة التحكّم في Google Cloud (انظر في قسم معرّفات عميل OAuth 2.0).
مصادقة Firebase: في تطبيق الويب، لماذا يتعذّر تسجيل الدخول باستخدام عمليات إعادة التوجيه
مع ظهور الخطأ التالي:
This domain YOUR_REDIRECT_DOMAIN is not
authorized to run this operation
؟
This domain YOUR_REDIRECT_DOMAIN is not
authorized to run this operation
اتّبِع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.
يعود السبب في هذا الخطأ على الأرجح إلى أنّ نطاق إعادة التوجيه ليس مدرجًا كنطاق معتمد لمصادقة Firebase، أو أنّ مفتاح واجهة برمجة التطبيقات الذي تستخدمه مع "خدمة مصادقة Firebase" غير صالح.
تأكَّد أولاً من أنّ YOUR_REDIRECT_DOMAIN مدرَج في قائمة النطاقات المصرّح بها لمشروعك في Firebase. إذا كان نطاق إعادة التوجيه مُدرجًا فيها، واصِل تحديد المشاكل المتعلّقة بمفتاح واجهة برمجة تطبيقات غير صالح وحلّها.
إنّ حزمة SDK الخاصة بالمصادقة في Firebase بشكل تلقائي تعتمد على مفتاح واجهة برمجة التطبيقات الخاص بمشروع Firebase
الذي يحمل تصنيف Browser key
، وتستخدم هذا المفتاح للتأكّد من أنّ عنوان URL لإعادة توجيه تسجيل الدخول صالح وفقًا لقائمة النطاقات المسموح بها.
تحصل المصادقة على مفتاح واجهة برمجة التطبيقات هذا بناءً على كيفية وصولك إلى حزمة تطوير البرامج للمصادقة:
إذا كنت تستخدم أدوات مساعدة المصادقة التي تقدّمها المضيفة لتسجيل المستخدمين الدخول باستخدام حزمة تطوير البرامج (SDK) الخاصة بالمصادقة JS، سيحصل Firebase تلقائيًا على مفتاح واجهة برمجة التطبيقات مع بقية إعدادات Firebase في كل مرة يتم فيها النشر إلى "استضافة Firebase". عليك التأكّد من أنّ
authDomain
في تطبيق الويبfirebaseConfig
قد تم إعداده بشكل صحيح لاستخدام أحد النطاقات الخاصة بموقع الاستضافة الإلكتروني هذا. يمكنك التحقق من ذلك من خلال الانتقال إلىhttps://authDomain__/firebase/init.json
والتحقّق من تطابقprojectId
مع العنوان الوارد فيfirebaseConfig
.في حال إجراء استضافة ذاتية لرمز تسجيل الدخول، يمكنك عندها استخدام ملف
__/firebase/init.json
لتوفير عملية ضبط Firebase لمساعد إعادة توجيه حزمة تطوير البرامج (SDK) لمصادقة JavaScript الذي تتم استضافته ذاتيًا. يجب أن يتطابق مفتاح واجهة برمجة التطبيقات وprojectId
المُدرَجان في ملف الإعداد هذا مع تطبيق الويبfirebaseConfig
.
تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات هذا لم يتم حذفه: انتقِل إلى لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة التحكّم في Google Cloud حيث يتم إدراج جميع مفاتيح واجهة برمجة التطبيقات لمشروعك.
إذا لم يتم حذف
Browser key
، تحقق مما يلي:تأكد من أن Firebase Authentication API مدرج في قائمة واجهات برمجة التطبيقات المسموح بها للمفتاح للوصول (مزيد من المعلومات حول قيود واجهة برمجة التطبيقات لمفاتيح واجهة برمجة التطبيقات).
إذا كنت تستضيف رمز تسجيل الدخول ذاتيًا، تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المُدرَج في ملف
__/firebase/init.json
يتطابق مع مفتاح واجهة برمجة التطبيقات في Cloud Console. صحِّح المفتاح في الملف، إذا لزم الأمر، ثم أعِد نشر تطبيقك.إذا تم حذف
Browser key
، يمكنك أن تطلب من Firebase إنشاء مفتاح واجهة برمجة تطبيقات جديد لك: في وحدة تحكُّم Firebase، انتقِل إلى settings > إعدادات المشروع، ثم انقر على تطبيق الويب في قسم تطبيقاتك. يؤدي هذا الإجراء تلقائيًا إلى إنشاء مفتاح واجهة برمجة تطبيقات يمكنك الاطّلاع عليه في قسم إعداد حزمة SDK وإعدادها لتطبيق الويب.
تجدر الإشارة إلى أنّه في Cloud Console، لن تتم تسمية مفتاح واجهة برمجة التطبيقات الجديد هذا باسم
Browser key
، وسيكون هو الاسم نفسه الذي يحمله لقب تطبيق الويب Firebase. إذا قرّرت إضافة قيود واجهة برمجة التطبيقات إلى مفتاح واجهة برمجة التطبيقات الجديد هذا، تأكَّد من أنّ واجهة Firebase Authentication API مُدرَجة في قائمة واجهات برمجة التطبيقات المسموح بها.بعد إنشاء مفتاح واجهة برمجة التطبيقات الجديد، عليك إكمال الخطوات السارية أدناه:
إذا كنت تستخدم عناوين URL محجوزة للاستضافة، أعِد نشر تطبيقك إلى Firebase حتى يتمكّن تلقائيًا من الحصول على مفتاح واجهة برمجة التطبيقات الجديد مع بقية إعدادات Firebase.
في حال إجراء استضافة ذاتية لرمز تسجيل الدخول، انسخ مفتاح واجهة برمجة التطبيقات الجديد وأضفه إلى ملف
__/firebase/init.json
، ثم أعِد نشر تطبيقك.
مصادقة Firebase: كيف يمكنني إنشاء برنامج ويب OAuth يدويًا؟
افتح صفحة بيانات الاعتماد في Google Cloud Console.
في أعلى الصفحة، اختَر إنشاء بيانات الاعتماد > معرِّف عميل OAuth.
إذا طُلِب منك ضبط شاشة طلب الموافقة، اتّبِع التعليمات الظاهرة على الشاشة، ثم اتّبِع الخطوات التالية الواردة في هذه الأسئلة الشائعة.
أنشِئ عميل OAuth على الويب:
في نوع التطبيق، اختَر تطبيق الويب.
بالنسبة إلى مصادر JavaScript المعتمَدة، أضِف ما يلي:
http://localhost
http://localhost:5000
https://PROJECT_ID.firebaseapp.com
https://PROJECT_ID.web.app
بالنسبة إلى معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، أضِف ما يلي:
https://PROJECT_ID.firebaseapp.com/__/auth/handler
https://PROJECT_ID.web.app/__/auth/handler
احفظ عميل OAuth.
انسخ معرِّف عميل OAuth الجديد وسر العميل إلى الحافظة.
في وحدة تحكُّم Firebase، افتح قسم المصادقة.
ضمن علامة التبويب طريقة تسجيل الدخول، افتح موفّر خدمة تسجيل الدخول بحساب Google، ثم ألصِق معرِّف عميل خادم الويب والسر الذي أنشأته للتو ونسخته من وحدة التحكّم في Google Cloud. انقر على حفظ (Save).
مصادقة Firebase: كيف يتم تحديد %APP_NAME%
لنموذج البريد الإلكتروني لرسالة التأكيد الإلكترونية التي يمكن
إرسالها إلى مستخدم عند الاشتراك باستخدام عنوان بريد إلكتروني وكلمة مرور؟
قبل كانون الأول (ديسمبر) 2022، كانت تتم تعبئة %APP_NAME%
في نموذج الرسالة الإلكترونية
باسم العلامة التجارية OAuth التي تمت إدارتها تلقائيًا عند تسجيل تطبيق Android
في مشروع Firebase. والآن، بما أنّه لا يتم توفير المتطلبات اللازمة لعلامة OAuth التجارية إلا عند تفعيل ميزة "تسجيل الدخول باستخدام حساب Google"، يوضّح ما يلي كيفية تحديد %APP_NAME%
:
إذا كان اسم علامة OAuth التجارية متوفرًا، سيكون
%APP_NAME%
في نموذج الرسالة الإلكترونية هو اسم العلامة التجارية لـ OAuth (تمامًا كما كان الحال قبل شهر كانون الأول/ديسمبر 2022).إذا لم يتوفّر اسم علامة OAuth التجارية، إليك كيفية تحديد
%APP_NAME%
في نموذج البريد الإلكتروني:بالنسبة إلى تطبيقات الويب، سيكون
%APP_NAME%
هو اسم الموقع الإلكتروني التلقائي لاستضافة Firebase (القيمة التي تسبق.firebaseapp.com
و.web.app
والتي تكون عادةً رقم تعريف مشروع Firebase).بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة:
إذا كان اسم حزمة Android أو معرّف حزمة iOS متوفّرًا في الطلب، سيصبح
%APP_NAME%
هو اسم التطبيق المستخدَم في "متجر Play" أو App Store (على التوالي).وبخلاف ذلك، سيكون
%APP_NAME%
هو الاسم التلقائي للموقع الإلكتروني لاستضافة Firebase (القيمة التي تسبق.firebaseapp.com
و.web.app
وعادةً رقم تعريف مشروع Firebase).
تجدر الإشارة إلى أنّه إذا تعذّر البحث عن اسم الموقع الإلكتروني التلقائي لاستضافة Firebase، يكون الإجراء الاحتياطي النهائي هو استخدام رقم تعريف مشروع Firebase على أنّه
%APP_NAME%
.
وظائف السحابة الإلكترونية
دعم وقت تشغيل Cloud Functions
كيف يمكنني الترقية إلى أحدث إصدار متوافق من Node.js؟
- تأكّد من أنّك مشترك في خطة أسعار Blaze.
- تأكَّد من استخدام أحدث إصدار من واجهة سطر الأوامر في Firebase.
- عدِّل الحقل
engines
في قسمpackage.json
من الدوال. - يمكنك إن أردت اختبار التغييرات باستخدام مجموعة أدوات المحاكاة المحلية من Firebase.
- إعادة نشر جميع الدوال.
كيف يمكنني التأكّد من نشر الدوال على وقت تشغيل Node.js محدّد؟
في "وحدة تحكُّم Firebase"، انتقِل إلى لوحة بيانات الدوال، واختَر دالة، وتحقَّق من لغة الدالة ضمن تفاصيل إضافية.
أستخدم إضافات Firebase. هل سأتأثّر بتحديثات وقت تشغيل Cloud Functions؟
نعم. بما أنّ الإضافات تستخدم Cloud Functions، يجب تعديل وقت تشغيل الإضافات في المخطط الزمني نفسه الذي تستخدمه Cloud Functions.
ننصحك بالتحديث بشكل دوري إلى أحدث إصدار من كل إضافة تم تثبيتها في مشروعك. يمكنك ترقية إضافات مشاريعك من خلال وحدة تحكُّم Firebase أو واجهة سطر الأوامر في Firebase.
خدمة المراسلة عبر السحابة الإلكترونية
خدمة المراسلة عبر السحابة الإلكترونية: ما الفرق بين مؤلف "الإشعارات" و"خدمة المراسلة عبر السحابة الإلكترونية"؟
وتوفِّر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" مجموعة كاملة من إمكانات المراسلة من خلال حِزم تطوير البرامج (SDK) للعميل وبروتوكولات HTTP وXMPP لخادمه. وتُعدّ ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" الخيار الأنسب لعمليات النشر التي تتضمّن متطلبات مراسلة أكثر تعقيدًا.
أداة إنشاء الإشعارات هي حل بسيط للمراسلة بدون خادم تم إنشاؤه استنادًا إلى خدمة "المراسلة عبر السحابة الإلكترونية من Firebase". باستخدام وحدة تحكّم رسومية سهلة الاستخدام ومتطلبات ترميز مخفّضة، تتيح "أداة إنشاء الإشعارات" للمستخدمين إرسال رسائل بسهولة لإعادة جذب المستخدمين والاحتفاظ بهم وتعزيز نمو التطبيق ودعم الحملات التسويقية.
الإمكانات | مؤلف الإشعارات | المراسلة عبر السحابة الإلكترونية | |
---|---|---|---|
الهدف | جهاز واحد | ||
اشترك العملاء في المواضيع (مثل الطقس) | |||
العملاء في شريحة المستخدمين المحدَّدة مسبقًا (التطبيق والإصدار واللغة) | |||
العملاء في شرائح جمهور محدّدة على "إحصاءات Google" | |||
البرامج في مجموعات الأجهزة | |||
الانتقال من العميل إلى الخادم | |||
نوع الرسالة | إشعارات يصل حجمها إلى 2 كيلوبايت | ||
رسائل بيانات يصل حجمها إلى 4 كيلوبايت | |||
التسليم | فوري | ||
التوقيت المحلي لجهاز العميل المستقبلي | |||
إحصاءات Google | مجموعة إحصاءات الإشعارات المُدمَجة وإحصاءات مسار الإحالة الناجحة |
المراسلة عبر السحابة الإلكترونية: أعلنت شركة Apple أنّها ستوقف البروتوكول الثنائي القديم لأسماء نقاط الوصول (APN). هل عليّ اتخاذ أي إجراء؟
لا، بل تم تبديل خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" إلى بروتوكول أسماء نقاط الوصول (APNs) المستند إلى HTTP/2 في عام 2017. إذا كنت تستخدم خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" لإرسال الإشعارات إلى أجهزة iOS، ليس عليك اتّخاذ أي إجراء.
المراسلة عبر السحابة الإلكترونية: هل أحتاج إلى استخدام خدمات Firebase الأخرى لاستخدام ميزة "المراسلة عبر السحابة الإلكترونية من Firebase"؟
يمكنك استخدام "المراسلة عبر السحابة الإلكترونية من Firebase" كمكون مستقل، وبالطريقة نفسها التي استخدمتها مع خدمة GCM، بدون استخدام خدمات أخرى من Firebase.
خدمة المراسلة عبر السحابة الإلكترونية: أنا مطوّر حالي لخدمة مراسلة عبر السحابة الإلكترونية من Google. هل يجب عليّ الانتقال إلى "المراسلة عبر السحابة الإلكترونية من Firebase"؟
ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" هي الإصدار الجديد من خدمة "مراسلة عبر السحابة الإلكترونية من Firebase" تحت علامة Firebase التجارية. وتكتسِب البنية الأساسية لخدمة GCM مع حِزم تطوير البرامج (SDK) الجديدة لتسهيل تطوير خدمة "المراسلة عبر السحابة الإلكترونية".
تشمل مزايا الترقية إلى حزمة تطوير البرامج (SDK) للمراسلة عبر السحابة الإلكترونية من Firebase ما يلي:
- تطوير عملاء أكثر بساطة. ولم تعُد مضطرًا لكتابة منطقك الخاص بالتسجيل أو إعادة محاولة الاشتراك.
- حل غير تقليدي للإشعارات. يمكنك استخدام أداة إنشاء الإشعارات، وهي حل لإرسال الإشعارات بدون خادم مع وحدة تحكّم على الويب تتيح لأي مستخدم إرسال إشعارات إلى جماهير محدّدة بناءً على إحصاءات من "إحصاءات Google".
للترقية من حِزم تطوير البرامج (SDK) لخدمة "GCM" إلى حِزم تطوير البرامج (SDK) لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، يُرجى الاطّلاع على الأدلّة الخاصة بنقل بيانات تطبيقات Android وiOS.
المراسلة عبر السحابة الإلكترونية: لماذا يتعذّر على الأجهزة المستهدَفة على ما يبدو تلقّي الرسائل؟
عندما يبدو أنّ الأجهزة لم تتلقَّ الرسائل بنجاح، تحقَّق أولاً من هذين السببَين المحتملَين:
التعامل مع الرسائل التي تعمل في المقدّمة لرسائل الإشعارات يجب أن تضيف تطبيقات العميل منطق معالجة الرسائل للتعامل مع رسائل الإشعارات عندما يكون التطبيق في مقدّمة الجهاز. اطّلِع على تفاصيل iOS و Android.
قيود جدار الحماية للشبكة. وإذا كانت مؤسستك تمتلك جدار حماية يحدّ من عدد الزيارات إلى الإنترنت أو منه، يجب إعداده للسماح بالاتصال بخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" حتى تتلقّى تطبيقات برنامج "المراسلة عبر السحابة الإلكترونية من Firebase" الرسائل. في ما يلي المنافذ التي يمكن فتحها:
- 5228
- 5229
- 5230
تستخدم خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" عادةً الرقمَين 5228، ولكنّها تستخدم أحيانًا 5229 و5230. لا توفّر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" عناوين IP محدّدة، لذا يجب السماح لجدار الحماية بقبول الاتصالات الصادرة لجميع عناوين IP المضمّنة في مجموعات عناوين IP المدرَجة في ASN 15169 من Google.
المراسلة عبر السحابة الإلكترونية: لقد نفّذتُ
onMessageReceived
في تطبيق Android، ولكن
لم يتم طلبه.
عندما يعمل التطبيق في الخلفية،
يتم عرض
رسائل الإشعارات في لوحة النظام
ولا يتم استدعاء onMessageReceived
. بالنسبة إلى رسائل الإشعار التي تحتوي على
حمولة بيانات، يتم عرض رسالة الإشعار في لوحة النظام،
ويمكن استرداد البيانات التي تم تضمينها في رسالة الإشعار
من الغرض الذي تم إطلاقه عندما ينقر المستخدم على الإشعار.
لمزيد من المعلومات، راجِع تلقي الرسائل ومعالجتها.
منشئ الإشعارات: ما الفرق بين منشئ الإشعارات وخدمة "المراسلة عبر السحابة الإلكترونية"؟
أداة إنشاء الإشعارات هي حل بسيط للمراسلة بدون خادم تم إنشاؤه استنادًا إلى خدمة "المراسلة عبر السحابة الإلكترونية من Firebase". باستخدام وحدة تحكّم رسومية سهلة الاستخدام ومتطلبات ترميز مخفّضة، تتيح "أداة إنشاء الإشعارات" للمستخدمين إرسال رسائل بسهولة لإعادة جذب المستخدمين والاحتفاظ بهم وتعزيز نمو التطبيق ودعم الحملات التسويقية.
وتوفِّر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" مجموعة كاملة من إمكانات المراسلة من خلال حِزم تطوير البرامج (SDK) للعميل وبروتوكولات HTTP وXMPP لخادمه. وتُعدّ ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" الخيار الأنسب لعمليات النشر التي تتضمّن متطلبات مراسلة أكثر تعقيدًا.
في ما يلي مقارنة بين إمكانات المراسلة التي توفّرها خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" ومؤلف "الإشعارات":
الإمكانات | مؤلف الإشعارات | المراسلة عبر السحابة الإلكترونية | |
---|---|---|---|
الهدف | جهاز واحد | ||
اشترك العملاء في المواضيع (مثل الطقس) | |||
العملاء في شريحة المستخدمين المحدَّدة مسبقًا (التطبيق والإصدار واللغة) | |||
العملاء في شرائح جمهور محدّدة على "إحصاءات Google" | |||
البرامج في مجموعات الأجهزة | |||
الانتقال من العميل إلى الخادم | |||
نوع الرسالة | إشعارات يصل حجمها إلى 2 كيلوبايت | ||
رسائل بيانات يصل حجمها إلى 4 كيلوبايت | |||
التسليم | فوري | ||
التوقيت المحلي لجهاز العميل المستقبلي | |||
إحصاءات Google | مجموعة إحصاءات الإشعارات المُدمَجة وإحصاءات مسار الإحالة الناجحة |
مؤلف الإشعارات: أنا مطوّر حالي لخدمة مراسلة عبر السحابة الإلكترونية من Google وأريد استخدام منشئ الإشعارات. ماذا يجب أن أفعل؟
أداة إنشاء الإشعارات هي حلّ مبتكر يتيح لأي مستخدم إرسال إشعارات إلى جماهير محدّدة استنادًا إلى إحصاءات من "إحصاءات Google". بالإضافة إلى ذلك، يوفّر مؤلف الإشعارات تحليلاً لمسار الإحالة الناجحة لكل رسالة، ما يسمح بإجراء تقييم سهل لفعالية الإشعارات.
إذا كنت مطوِّرًا حاليًا في خدمة "GCM"، يجب الترقية من "حِزم تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" إلى حِزم تطوير البرامج (SDK) لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" لتتمكن من استخدام منشئ الإشعارات. اطّلِع على الأدلة لنقل تطبيقات Android وiOS.
ميزات "المراسلة عبر السحابة الإلكترونية من Firebase" نهائيًا في حزيران (يونيو) 2023
ما هي واجهات برمجة تطبيقات "المراسلة عبر السحابة الإلكترونية من Firebase" التي تم إيقافها نهائيًا في 20 حزيران (يونيو) 2023، وما الإجراءات التي عليّ اتّخاذها إذا كنت أستخدمها؟
ستتأثر واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) التالية بالإيقاف النهائي:
واجهات برمجة تطبيقات الخادم
اسم واجهة برمجة التطبيقات | نقطة نهاية واجهة برمجة التطبيقات | التأثير على المستخدمين | مطلوب اتخاذ إجراء. |
---|---|---|---|
بروتوكول HTTP القديم | https://fcm.googleapis.com/fcm/send | سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024. | نقل البيانات إلى واجهة برمجة تطبيقات HTTP v1 |
بروتوكول XMPP القديم | fcm-xmpp.googleapis.com:5235 | سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024. | نقل البيانات إلى واجهة برمجة تطبيقات HTTP v1 |
واجهات برمجة التطبيقات لخادم معرّف المثيل | https://iid.googleapis.com/v1/web/iid | سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024. | استخدِم Web JS SDK لإنشاء تسجيلات الويب لخدمة FCM. |
https://iid.googleapis.com/iid/* | ستستمر نقاط النهاية في العمل ولكنها لن تتيح المصادقة باستخدام مفاتيح الخادم الثابتة بعد 21 حزيران (يونيو) 2024. | استخدام رمز دخول OAuth 2.0 مشتق من حساب الخدمة. | |
واجهة برمجة التطبيقات لإدارة مجموعة الأجهزة | https://fcm.googleapis.com/fcm/notification | ستستمر نقطة النهاية في العمل ولكنها لن تتيح المصادقة باستخدام مفاتيح الخادم الثابتة بعد 21/6/2024. | استخدام رمز دخول OAuth 2.0 مشتق من حساب الخدمة. |
المراسلة الأوّلية عبر XMPP | fcm-xmpp.googleapis.com:5235 | إنّ طلبات البيانات من واجهة برمجة التطبيقات إلى FirebaseMessaging.send في التطبيق لن تؤدي إلى إرسال الرسائل المرسَلة إلى خادم التطبيق بعد 21/6/2024. | نفِّذ هذه الوظيفة وفقًا لمنطق الخادم. على سبيل المثال، يستخدم بعض المطوّرين نقطة نهاية HTTP/gRPC الخاصة بهم ويستدعون نقطة النهاية مباشرةً لإرسال الرسائل من عملائهم إلى خادم التطبيق. للاطّلاع على مثال لتنفيذ المراسلات الأولية باستخدام gRPC، يُرجى الاطّلاع على مقالة البدء السريع لاستخدام gRPC. |
واجهة برمجة تطبيقات "الإرسال المجمَّع" | https://fcm.googleapis.com/batch | سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024. | الانتقال إلى طريقة الإرسال العادية من HTTP v1 API التي تتيح HTTP/2 لمضاعفة الإرسال |
واجهات برمجة تطبيقات SDK للمشرف في Firebase
اسم واجهة برمجة التطبيقات | لغة واجهة برمجة التطبيقات | التأثير على المستخدمين | مطلوب اتخاذ إجراء. |
---|---|---|---|
sendToDevice()
|
Node.js | ستتوقّف واجهة برمجة التطبيقات عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تطلب واجهة برمجة التطبيقات القديمة لإرسال HTTP. | استخدِم الطريقة send() .
|
sendToDeviceGroup()
|
Node.js | ستتوقّف واجهة برمجة التطبيقات عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تطلب واجهة برمجة التطبيقات القديمة لإرسال HTTP. | استخدِم الطريقة send() .
|
sendAll()/sendAllAsync()/send_all()/sendMulticast()/SendMulticastAsync()/send_multicast()
|
Node.js وJava وPython وGo وC# | ستتوقف واجهات برمجة التطبيقات هذه عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تستدعي واجهة برمجة التطبيقات "الإرسال المجمّع". | يُرجى الترقية إلى أحدث حزمة تطوير برامج (SDK) لمشرف Firebase واستخدام واجهات برمجة التطبيقات الجديدة بدلاً من ذلك: sendEach()/
sendEachAsync()/send_each()/sendEachForMulticast()/sendEachForMulticastAsync()/
send_each_for_multicast() .
تجدر الإشارة إلى أنّ واجهات برمجة التطبيقات الجديدة لم تعُد تستدعي واجهة برمجة التطبيقات التي تم إيقافها نهائيًا، ولهذا السبب قد تنشئ اتصالات HTTP متزامنة أكثر من واجهات برمجة التطبيقات القديمة. |
حِزم تطوير البرامج (SDK) للعملاء
إصدارات حزمة تطوير البرامج (SDK) | التأثير على المستخدمين | مطلوب اتخاذ إجراء. |
---|---|---|
حزم تطوير البرامج (SDK) في GCM (تم إيقافها في عام 2018) | بعد 21 حزيران (يونيو) 2024، لن تتمكّن التطبيقات التي تستخدم حِزم SDK لخدمة "GCM" من تسجيل الرموز المميّزة أو تلقّي رسائل من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase". | عليك ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى أحدث حزمة تطوير برامج (SDK) لمنصّة Firebase إذا لم يسبق لك إجراء ذلك. |
الإصدار <7.0.0 من حِزم تطوير البرامج (SDK) المستندة إلى JavaScript (حدث تغيير غير مسبوق في الإصدار 7.0.0 في عام 2019) | بعد 21 حزيران (يونيو) 2024، لن تتمكّن تطبيقات الويب التي تستخدم حِزم SDK قديمة من JavaScript من تسجيل الرموز المميّزة. | عليك ترقية حزمة تطوير البرامج (SDK) على الويب لمنصة Firebase إلى أحدث إصدار. |
هل سيتم الرجوع إلى إصدار سابق من الخدمة قبل يونيو 2024؟
لا، أمامك 12 شهرًا (بين 20/06/2023 و21/06/2024) لنقل البيانات من واجهات برمجة التطبيقات القديمة إلى واجهات برمجة التطبيقات الجديدة بدون الحاجة إلى الرجوع إلى إصدار سابق من الخدمة. ننصحك بشدة بالتخطيط لعملية النقل في أقرب وقت ممكن كي لا تتأثر بإيقاف واجهات برمجة التطبيقات في يونيو 2024.
بعد يونيو 2024، قد تلاحظ ارتفاعًا في عدد الأخطاء أو نقص الوظائف عند استخدام واجهات برمجة التطبيقات أو حِزم تطوير البرامج (SDK) المذكورة أعلاه (يمكنك الاطّلاع على الأسئلة الشائعة التالية لمزيد من المعلومات).
كيف ومتى سيتم إيقاف واجهات برمجة التطبيقات المتوقّفة نهائيًا؟
ستبدأ خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" بإيقاف واجهات برمجة التطبيقات المتوقّفة نهائيًا تدريجيًا في 22 تموز (يوليو) 2024 تقريبًا. وبعد هذا التاريخ، ستخضع الخدمات المتوقّفة نهائيًا لعملية "وميض" ويؤدّي فيها تزايد عدد الطلبات إلى ظهور ردود على الأخطاء. خلال فترة الإزالة التدريجية، يمكنك توقّع ارتفاع معدّل تكرار السلوكيات والأخطاء التالية بمرور الوقت:
الفئة | ما يمكن توقعه |
---|---|
بروتوكول HTTP القديم | تم رفض الطلبات باستخدام رمز HTTP 301. |
بروتوكول XMPP القديم | يتم رفض الطلبات مع رمز الخطأ 302. |
تحميل المحتوى في "المراسلة عبر السحابة الإلكترونية من Firebase" | يتم تجاهل الرسائل تلقائيًا بواسطة الواجهة الخلفية للمراسلة عبر السحابة الإلكترونية من Firebase. |
واجهة برمجة تطبيقات "الإرسال المجمَّع" | تم رفض الطلبات مع عرض رمز الخطأ 501 ورسالة الخطأ "تم إيقاف واجهة برمجة التطبيقات نهائيًا". |
حزم تطوير البرامج (SDK) في GCM - تسجيل الرموز المميّزة | تم رفض الطلبات باستخدام رمز HTTP 301. |
GCM SDKs - إرسال الرسائل | تم رفض الطلبات مع ظهور رمز الخطأ 400 ورسالة الخطأ "تم إيقاف الرمز المميز V3". |
الإصدار < 7.0.0 من حزمة JS SDK | تم رفض الطلبات باستخدام رمز HTTP 501. |
استخدام مفتاح الخادم للوصول إلى معرّف المثيل وواجهات برمجة التطبيقات لإدارة مجموعة الأجهزة | تم رفض الطلبات برمز HTTP 401. |
يمكنك التقدّم بطلب للحصول على تمديد إذا لم يكن بإمكانك إكمال عملية نقل البيانات من خدمات "المراسلة عبر السحابة الإلكترونية من Firebase" المتوقّفة نهائيًا قبل بدء الإيقاف التدريجي. إذا تم منحك تمديدًا، لن تتأثر بالتصاعد التدريجي حتى انتهاء مدة التمديد. بعد انتهاء صلاحية التمديد، من المحتمل أن تشهد حركة المرور تدهورًا سريعًا.
ما هو الفرق بين رموز OAuth 2.0 المميزة ومفاتيح الخادم؟
رمز OAuth 2.0 المميز هو رمز مميز قصير الأجل مشتق من حساب الخدمة. إنه نموذج المصادقة العادي من Google وهو أكثر أمانًا من مفاتيح الخادم الثابتة.
راجِع المقالة استخدام بيانات الاعتماد لإنشاء رموز الدخول للحصول على إرشادات حول استخدام مكتبة مصادقة Google للحصول على الرموز المميّزة.
يُرجى العِلم أنّ عناوين الطلبات تختلف عند استخدام رموز OAuth 2.0 المميزة للطلبات إلى نقاط نهاية مختلفة.
- واجهة برمجة التطبيقات HTTP v1:
Authorization: Bearer $oauth_token
- واجهة برمجة تطبيقات خادم معرّف المثيل وواجهة برمجة تطبيقات إدارة مجموعة الأجهزة:
Authorization: Bearer $oauth_token
access_token_auth: true
هل يمكنني نقل طلباتي إلى واجهة برمجة التطبيقات الجديدة دُفعة واحدة؟
وننصحك بزيادة عدد الزيارات ببطء إلى واجهة برمجة التطبيقات الجديدة. إذا كنت تتوقع إرسال أكثر من 600,000 رسالة في الدقيقة بشكل منتظم، يمكنك التواصل مع فريق دعم Firebase للحصول على تعليمات حول كيفية زيادة الحصة أو الحصول على اقتراحات حول كيفية توزيع عدد الزيارات.
ما هو الفرق بين واجهة برمجة التطبيقات HTTP v1 API وواجهات برمجة التطبيقات القديمة عندما أرسل رسائل إلى المواضيع/مجموعات الأجهزة؟
المواضيع: لا تحتاج إلى إضافة البادئة "/topics/" إلى استهداف موضوعك عند استخدام v1 API.
مجموعات الأجهزة: يمكنك استخدام رمز مميّز للمجموعة كهدف للرمز المميّز في واجهة برمجة التطبيقات HTTP v1. مع ذلك، لا تعرض واجهة برمجة التطبيقات HTTP v1 عدد مرات النجاح/الإخفاق في الاستجابة. ننصحك باستخدام مواضيع "المراسلة عبر السحابة الإلكترونية من Firebase" أو إدارة مجموعات الأجهزة بنفسك.
هل تتيح واجهة برمجة التطبيقات HTTP v1 إرسال رسائل إلى رموز مميزة متعددة في طلب واحد؟
لا، هذه الميزة المسماة "البث المتعدد" في واجهات برمجة تطبيقات HTTP القديمة غير متوافقة مع واجهة برمجة التطبيقات HTTP v1 API التي تم تصميمها بشكل أفضل لقابلية التوسع.
بالنسبة إلى حالات الاستخدام التي يكون فيها وقت الاستجابة من البداية إلى النهاية مهمًا، أو التي يكون فيها إجمالي حجم البيانات الموزّعة صغيرًا (أقل من مليون)، تنصح Google بإرسال عدة طلبات منفصلة باستخدام HTTP v1 API. تعمل واجهة برمجة التطبيقات HTTP v1 API على HTTP/2 بالمثل في 99.9% من طلبات البث المتعدد (أي إرسال أقل من 100 رمز مميز). بالنسبة إلى حالات الاستخدام الاستثنائية (من خلال إرسال 1,000 رمز مميّز)، تحقق هذه الميزة ما يصل إلى ثلث معدّل معالجة البيانات، وبالتالي يجب توفير تزامن إضافي لتحسين حالة الاستخدام غير النموذجية هذه. يمكن للمستخدمين الحصول على مزيد من الموثوقية ومدى التوفّر باستخدام واجهة برمجة التطبيقات HTTP v1 API مقارنةً بالبث المتعدد القديم.
بالنسبة إلى حالات الاستخدام التي تُعطى فيها الأولوية لمعدل نقل البيانات ومعدّل نقل البيانات الصادرة أو التي يكون فيها إجمالي حجم التوزيع الموسَّع كبيرًا (أكبر من مليون)، تنصح Google بمراسلة المواضيع. على الرغم من أنّ رسائل المواضيع تتطلب إجراءً لمرة واحدة للاشتراك في موضوع معيّن، تقدّم هذه الميزة ما يصل إلى 10,000 طلب في الثانية لكل معدّل توزيع للمشاريع بدون حدّ أقصى لحجم الموضوع.
ما هي إصدارات حزمة تطوير البرامج (SDK) للمشرف في Firebase التي تتضمّن واجهات برمجة التطبيقات الجديدة؟
النظام الأساسي | إصدار حزمة تطوير البرامج (SDK) لمشرف Firebase |
---|---|
Node.js | >=11.7.0 |
Python | >=6.2.0 |
Java | >=9.2.0 |
Go | >=4.12.0 |
.NET | >=2.4.0 |
ما هو الفرق بين واجهة برمجة تطبيقات "الإرسال المجمّع" وواجهة برمجة التطبيقات HTTP v1؟
تستخدم واجهة برمجة تطبيقات الإرسال المجمّع لميزة "المراسلة عبر السحابة الإلكترونية من Firebase" تنسيق الرسالة وآلية المصادقة نفسيهما المستخدمتَين في واجهة برمجة التطبيقات HTTP v1. ومع ذلك، فإنه يستخدم نقطة نهاية مختلفة. إذا كنت تريد تحسين الكفاءة، يمكنك استخدام HTTP/2 لإرسال طلبات متعددة عبر اتصال HTTP نفسه إلى واجهة برمجة التطبيقات HTTP v1.
ماذا أفعل إذا لم أتمكّن من الوصول إلى مشروعي؟
يُرجى التواصل مع فريق دعم Google Cloud للحصول على المساعدة.
هل يمكن للمشاريع الجديدة تفعيل واجهة Cloud Messaging API القديمة؟
لا، اعتبارًا من 20/5/2024، لن يُسمح للمشاريع الجديدة بتفعيل واجهات برمجة التطبيقات القديمة.
حصص وحدود "المراسلة عبر السحابة الإلكترونية من Firebase"
أحتاج إلى إعلام قاعدة عملاء كبيرة خلال دقيقتين.
لا يمكن تطبيق حالة الاستخدام هذه. يجب توزيع عدد الزيارات على أكثر من 5 دقائق.
يرسل تطبيقي إشعارًا إلى المستخدمين بالأحداث. يجب تسليم الرسائل فورًا لدعم نموذج نشاطي التجاري. هل يمكنني الحصول على حصة أكبر؟
ولا يمكننا الموافقة على زيادات في الحصة لهذا السبب. يجب توزيع عدد الزيارات على أكثر من 5 دقائق.
تتناول رسائلي أحداثًا مُجدوَلة وأحتاج إلى إرسال جميع الزيارات في أعلى الساعة.
ننصحك ببدء إرسال الإشعارات قبل 5 دقائق على الأقل من انعقاد الفعالية.
كم من الوقت سيستغرق تنفيذ طلب حصتي؟
يعتمد هذا بعض الشيء على استخدامك لميزة "المراسلة عبر السحابة الإلكترونية من Firebase". على أي حال، يمكنك توقّع الحصول على إجابة خلال بضعة أيام عمل. وفي بعض الحالات، قد تحدث بعض الحالات المتناوبة في ما يتعلّق باستخدامك خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" وظروف مختلفة، ما قد يؤدي إلى إطالة العملية. في حال استيفاء جميع المتطلبات، ستتمّ معالجة معظم الطلبات في غضون أسبوعَين.
كيف يمكنني مراقبة استخدام حصتي؟
اطّلِع على إرشادات Google Cloud حول كيفية إنشاء رسومات بيانية لمقاييس الحصص ومراقبتها.
يصعب عليّ أو على نشاطي التجاري التعامل مع أخطاء 429. هل يمكنني الحصول على إعفاء أو حصة أكبر لتجنُّب الحصول على نماذج 429؟
ندرك أنّ حدود الحصص قد تمثّل تحديًا، لكنّ الحصص تشكّل ركيزة أساسية للحفاظ على موثوقية الخدمة، ولا يمكننا منح استثناءات.
هل يمكنني الحصول على حصة أكبر لفعالية مؤقتة؟
يمكنك طلب حصة إضافية لدعم فعالية تستمر لمدة تصل إلى شهر واحد. يُرجى تقديم الطلب قبل شهر واحد على الأقل من الفعالية مع تقديم تفاصيل واضحة عن موعد بدء الفعالية وانتهائها، وستبذل "المراسلة عبر السحابة الإلكترونية من Firebase" كل الجهود العملية لتلبية الطلب (لا يمكن ضمان زيادة الطلب). وسيتم التراجع عن هذه الزيادات في الحصة بعد تاريخ انتهاء الفعالية.
هل حصتي الحالية عرضة للتغيير؟
ولن تفعل Google ذلك باستخفاف، ولكن قد يتم تغيير الحصص حسب الحاجة لحماية سلامة النظام. وستُعلمك Google مسبقًا بهذه التغييرات، عند الإمكان.
التخزين في السحابة الإلكترونية لبرنامج Firebase
Cloud Storage for Firebase: لماذا لا يمكنني استخدام Cloud Storage for Firebase؟
تنشئ خدمة Cloud Storage for Firebase حزمة تلقائية في الفئة "بدون تكلفة" على App Engine. يتيح لك ذلك بدء استخدام Firebase وCloud Storage for Firebase بسرعة، بدون الحاجة إلى استخدام بطاقة ائتمان أو تفعيل حساب فوترة على السحابة الإلكترونية. ويتيح لك أيضًا مشاركة البيانات بسهولة بين Firebase ومشروع على Google Cloud.
مع ذلك، هناك حالتان معروفتان يتعذّر فيهما إنشاء هذه الحزمة ولن تتمكّن من استخدام Cloud Storage for Firebase وهما:
- مشروع تم استيراده من Google Cloud وكان له تطبيق App Engine Master/Slave Datastore.
-
مشروع تم استيراده من Google Cloud ويتضمّن مشاريع بادئة بالنطاق. مثلاً:
domain.com:project-1234
لا تتوفّر حاليًا حلول بديلة لهذه المشاكل، وننصحك بإنشاء مشروع جديد في وحدة تحكُّم Firebase وتفعيل Cloud Storage for Firebase في هذا المشروع.
Cloud Storage for Firebase: لماذا تظهر لي ردود رمز الخطأ 412 بشأن أذونات حساب الخدمة وعمليات حساب الخدمة التي تعذّر عند استخدام Cloud Storage for Firebase API؟
من المحتمل أنّك تتلقّى رموز الخطأ 412 إمّا بسبب عدم تفعيل Cloud Storage for Firebase API لمشروعك أو لأنّ حساب الخدمة اللازم لا يتضمّن الأذونات المطلوبة.
يمكنك الاطّلاع على الأسئلة الشائعة ذات الصلة.
التخزين في السحابة الإلكترونية لبرنامج Firebase: هل يمكنني تخزين الملفات القابلة للتنفيذ في مشاريع خطة Spark؟
بالنسبة إلى مشاريع خطط (Spark) المجانية، يحظر Firebase عمليات تحميل واستضافة أنواع معيّنة من الملفات القابلة للتنفيذ على Windows وAndroid وApple من خلال Cloud Storage لبرنامج Firebase وFirebase Hosting. تهدف هذه السياسة إلى منع إساءة الاستخدام على منصتنا.
تم حظر عرض الملفات غير المسموح بها واستضافتها وعمليات تحميل الملفات لجميع مشاريع Spark التي تم إنشاؤها في 28 أيلول (سبتمبر) 2023 أو بعد هذا التاريخ. بالنسبة إلى مشاريع Spark الحالية التي تتضمّن ملفات تم تحميلها قبل هذا التاريخ، يمكن تحميل هذه الملفات واستضافتها.
ينطبق هذا الشرط على مشاريع خطط Spark. ولن تتأثّر المشاريع ضمن خطة الدفع حسب الاستخدام (Blaze).
لا يمكن استضافة أنواع الملفات التالية على استضافة Firebase وCloud Storage for Firebase:
- ملفات Windows بامتدادات
.exe
و.dll
و.bat
- ملفات Android بالامتداد
.apk
- ملفات نظام Apple الأساسي بالامتداد
.ipa
ما هو الإجراء الذي عليّ اتّخاذه؟
إذا كنت لا تزال تريد استضافة أنواع الملفات التالية بعد 28 أيلول (سبتمبر) 2023:
- بالنسبة إلى الاستضافة: يجب الترقية إلى خطة Blaze قبل أن تتمكّن من نشر أنواع الملفات هذه إلى ميزة "استضافة Firebase" من خلال الأمر
firebase deploy
. - بالنسبة إلى مساحة التخزين: عليك الترقية إلى خطة Blaze لتحميل أنواع الملفات هذه إلى الحزمة التي تختارها باستخدام GCS CLI أو وحدة تحكُّم Firebase أو وحدة تحكُّم Google Cloud.
استخدِم أدوات Firebase لإدارة موارد استضافة Firebase وCloud Storage.
- ولإدارة الموارد في "استضافة Firebase"، استخدِم "وحدة تحكُّم Firebase" لحذف الإصدارات وفقًا لهذا الدليل.
- لإدارة الموارد في Cloud Storage، انتقِل إلى صفحة منتج مساحة التخزين في مشروعك.
- في علامة التبويب الملفات، حدِّد موقع الملفات غير المسموح بحذفها في التدرج الهرمي للمجلدات، ثم اختَرها باستخدام مربّع الاختيار بجانب أسماء الملفات على يمين اللوحة.
- انقر على حذف، وتأكّد من حذف الملفات.
يُرجى الرجوع إلى مستنداتنا للحصول على معلومات إضافية حول إدارة استضافة الموارد باستخدام أدوات Firebase وحِزم Cloud Storage for Firebase من خلال مكتبات العملاء.
التخزين في السحابة الإلكترونية لمنصة Firebase: لماذا أرى زيادة غير متوقعة في عمليات التحميل والتنزيل؟
في السابق، لم يكن يتم احتساب طلبات التنزيل وتحميلها بشكل صحيح إلى Cloud Storage API for Firebase API. لقد اتّخذنا خطوات لحلّ هذه المشكلة اعتبارًا من 15 أيلول (سبتمبر) 2023.
بالنسبة إلى مستخدمي Blaze، ستبدأ عمليات التحميل والتنزيل في احتساب فاتورتك الشهرية. بالنسبة إلى مستخدمي Spark، سيبدأ احتسابهم ضمن الحد الأقصى الشهري للاستخدام المجاني.
ننصحك بتتبُّع صفحة الاستخدام بحثًا عن أي زيادات قد تُحتسَب ضمن الحدّ الأقصى المسموح به.
التخزين في السحابة الإلكترونية لـ Firebase: لماذا تظهر لي أرقام تعريف حسابات خدمة جديدة مرتبطة بمشاريع Firebase التي تستخدم Cloud Storage for Firebase؟
تستخدم منصة Firebase حسابات الخدمة لتشغيل الخدمات وإدارتها بدون مشاركة بيانات اعتماد المستخدم. عند إنشاء مشروع على Firebase، قد تلاحظ توفّر عدد من حسابات الخدمة في مشروعك.
إنّ حساب الخدمة الذي تستخدمه Cloud Storage for Firebase مخصّص لمشروعك
ويُسمى service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com
.
إذا استخدمت Cloud Storage for Firebase قبل 19 أيلول (سبتمبر) 2022، قد
يظهر لك حساب خدمة إضافي على حِزم Cloud Storage التي سبق ربطها
باسم firebase-storage@system.gserviceaccount.com
. اعتبارًا من
19 أيلول (سبتمبر) 2022، سيتم إيقاف حساب الخدمة هذا.
يمكنك الاطّلاع على جميع حسابات الخدمة المرتبطة بمشروعك في "وحدة تحكُّم Firebase"، ضمن علامة التبويب "حسابات الخدمة".
جارٍ إضافة حساب الخدمة الجديد
إذا أزلت حساب الخدمة سابقًا أو لم يكن حساب الخدمة متوفّرًا في مشروعك، يمكنك تنفيذ أحد الإجراءات التالية لإضافة الحساب.
- (إجراء يُنصح به) مبرمَج: استخدِم نقطة نهاية إضافة Firebase REST لإعادة استيراد الحزمة إلى Firebase. ستحتاج إلى استدعاء نقطة النهاية هذه مرة واحدة فقط، وليس مرة واحدة لكل مجموعة بيانات مرتبطة.
-
يدويًا: اتّبِع الخطوات الواردة في إنشاء حسابات الخدمة وإدارتها.
باتّباع هذا الدليل، أضِف حساب خدمة بدور "إدارة الهوية وإمكانية الوصول"
Cloud Storage for Firebase Service Agent
واسم حساب الخدمةservice-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com
.
إزالة حساب الخدمة الجديد
ننصحك بشدة بعدم إزالة حساب الخدمة لأنّ ذلك قد يؤدي إلى حظر الوصول إلى حِزم Cloud Storage من تطبيقاتك. ولإزالة حساب الخدمة من مشروعك، يُرجى اتّباع التعليمات الواردة في إيقاف حساب الخدمة.
Crashlytics
يمكنك الانتقال إلى صفحة تحديد المشاكل وحلّها والأسئلة الشائعة حول Crashlytics للحصول على نصائح وإجابات مفيدة لمزيد من الأسئلة الشائعة.
الروابط الديناميكية
الروابط الديناميكية: ما هي خطط Firebase المستقبلية للروابط الديناميكية؟
الروابط الديناميكية: لماذا يمكن لتطبيق Android الوصول إلى كل رابط ديناميكي مرتَين؟
تمحو واجهة برمجة التطبيقات getInvitation
الرابط الديناميكي المحفوظ لمنع الوصول إليه مرتين. واحرص على طلب واجهة برمجة التطبيقات هذه مع ضبط معلَمة autoLaunchDeepLink
على false
في كل نشاط من أنشطة الروابط المؤدية إلى صفحات في التطبيق لمحوها في الحالة التي يتم فيها بدء النشاط خارج النشاط الرئيسي.
مجموعة أدوات المحاكاة المحلية لمنصة Firebase
لماذا تعرض سجلات مجموعة المحاكيات رسالة خطأ تبدأ بـ "لا يُنصح باستخدام أرقام تعريف مشروع متعددة في وضع المشروع الفردي"؟
تعني هذه الرسالة أن مجموعة Emulator Suite رصدت إمكانية تشغيل مُحاكي منتج معيّن باستخدام أرقام تعريف مختلفة للمشروع. قد يشير ذلك إلى خطأ في الإعداد وقد يتسبّب في حدوث مشاكل عندما تحاول أدوات المحاكاة الاتصال ببعضها بعضًا، وعند محاولة التفاعل مع أدوات المحاكاة من الرمز البرمجي الخاص بك. في حال عدم تطابق أرقام تعريف المشروع، غالبًا ما يبدو أنّ البيانات مفقودة، لأنّ البيانات المخزَّنة في المحاكيات تعتمد على معرّف المشروع، وتعتمد إمكانية التشغيل التفاعلي على مطابقة أرقام تعريف المشروع.
وقد كان هذا مصدرًا شائعًا للالتباس بين المطوّرين، لذا ستسمح حزمة أدوات المحاكاة المحلية بالتشغيل تلقائيًا الآن باستخدام رقم تعريف مشروع واحد فقط، ما لم تحدّد خلاف ذلك في ملف الإعداد firebase.json
. وإذا اكتشف المحاكي أكثر من رقم تعريف مشروع واحد، سيسجّل تحذيرًا وقد يعرض خطأً
خطيرًا.
يُرجى التحقّق من بيانات أرقام تعريف المشروع بحثًا عن حالات عدم التطابق في:
-
المشروع التلقائي الذي تم ضبطه في سطر الأوامر. سيتم تلقائيًا الحصول على رقم تعريف المشروع عند بدء التشغيل من المشروع الذي تم اختياره باستخدام
firebase init
أوfirebase use
. لعرض قائمة المشاريع (ومعرفة المشروع الذي تم اختياره)، استخدِمfirebase projects:list
. -
اختبارات الوحدة: غالبًا ما يتم تحديد رقم تعريف المشروع في الاستدعاءات
لطرق مكتبة اختبار الوحدات
initializeTestEnvironment
أوinitializeTestApp
. قد يتم إعداد رمز اختبار آخر باستخدامinitializeApp(config)
. -
علامة سطر الأوامر
--project
يؤدي تمرير علامة--project
في واجهة سطر الأوامر في Firebase إلى إلغاء المشروع التلقائي. عليك التأكّد من أنّ قيمة العلامة تتطابق مع رقم تعريف المشروع في اختبارات الوحدات وإعداد التطبيق.
الأماكن التي يجب التحقّق منها الخاصة بالمنصة:
الويب | السمة projectId في الكائن firebaseConfig في JavaScript، وتُستخدَم في initializeApp .
|
Android | السمة project_id داخل ملف الإعداد google-services.json .
|
أنظمة Apple الأساسية | السمة PROJECT_ID في ملف الإعداد GoogleService-Info.plist .
|
لإيقاف وضع المشروع الفردي، عليك تحديث firebase.json
باستخدام
المفتاح singleProjectMode
:
{ "firestore": { ... }, "functions": { ... }, "hosting": { ... }, "emulators": { "singleProjectMode": false, "auth": { "port": 9099 }, "functions": { "port": 5001 }, ... } }
الاستضافة
الاستضافة: هل يمكنني تخزين الملفات التنفيذية في مشاريع خطة Spark؟
بالنسبة إلى مشاريع خطط (Spark) المجانية، يحظر Firebase عمليات تحميل واستضافة أنواع معيّنة من الملفات القابلة للتنفيذ على Windows وAndroid وApple من خلال Cloud Storage لبرنامج Firebase وFirebase Hosting. تهدف هذه السياسة إلى منع إساءة الاستخدام على منصتنا.
تم حظر عرض الملفات غير المسموح بها واستضافتها وعمليات تحميل الملفات لجميع مشاريع Spark التي تم إنشاؤها في 28 أيلول (سبتمبر) 2023 أو بعد هذا التاريخ. بالنسبة إلى مشاريع Spark الحالية التي تتضمّن ملفات تم تحميلها قبل هذا التاريخ، يمكن تحميل هذه الملفات واستضافتها.
ينطبق هذا الشرط على مشاريع خطط Spark. ولن تتأثّر المشاريع ضمن خطة الدفع حسب الاستخدام (Blaze).
لا يمكن استضافة أنواع الملفات التالية على استضافة Firebase وCloud Storage for Firebase:
- ملفات Windows بامتدادات
.exe
و.dll
و.bat
- ملفات Android بالامتداد
.apk
- ملفات نظام Apple الأساسي بالامتداد
.ipa
ما هو الإجراء الذي عليّ اتّخاذه؟
إذا كنت لا تزال تريد استضافة أنواع الملفات التالية بعد 28 أيلول (سبتمبر) 2023:
- بالنسبة إلى الاستضافة: يجب الترقية إلى خطة Blaze قبل أن تتمكّن من نشر أنواع الملفات هذه إلى ميزة "استضافة Firebase" من خلال الأمر
firebase deploy
. - بالنسبة إلى مساحة التخزين: عليك الترقية إلى خطة Blaze لتحميل أنواع الملفات هذه إلى الحزمة التي تختارها باستخدام GCS CLI أو وحدة تحكُّم Firebase أو وحدة تحكُّم Google Cloud.
استخدِم أدوات Firebase لإدارة موارد استضافة Firebase وCloud Storage.
- ولإدارة الموارد في "استضافة Firebase"، استخدِم "وحدة تحكُّم Firebase" لحذف الإصدارات وفقًا لهذا الدليل.
- لإدارة الموارد في Cloud Storage، انتقِل إلى صفحة منتج مساحة التخزين في مشروعك.
- في علامة التبويب الملفات، حدِّد موقع الملفات غير المسموح بحذفها في التدرج الهرمي للمجلدات، ثم اختَرها باستخدام مربّع الاختيار بجانب أسماء الملفات على يمين اللوحة.
- انقر على حذف، وتأكّد من حذف الملفات.
يُرجى الرجوع إلى مستنداتنا للحصول على معلومات إضافية حول إدارة استضافة الموارد باستخدام أدوات Firebase وحِزم Cloud Storage for Firebase من خلال مكتبات العملاء.
الاستضافة: لماذا يعرض جدول سجلّ إصدارات الاستضافة في وحدة تحكُّم Firebase أعداد ملفات أكبر من العدد الفعلي لمشروعي المحلي؟
يضيف Firebase تلقائيًا ملفات إضافية تحتوي على بيانات وصفية حول الموقع الإلكتروني المضيف، ويتم تضمين هذه الملفات في إجمالي عدد ملفات الإصدار.
الاستضافة: ما هو أكبر حجم ملف يمكنني نشره في "استضافة Firebase"؟
يبلغ الحد الأقصى لحجم الملفات في الاستضافة 2 غيغابايت لكل ملف.
ننصحك بتخزين الملفات الأكبر حجمًا باستخدام خدمة Cloud Storage التي توفّر حدًا أقصى لحجم العناصر في نطاق تيرابايت لكل عنصر على حدة.
الاستضافة: كم عدد مواقع الاستضافة التي يمكنني امتلاكها لكل مشروع في Firebase؟
تتيح ميزة "استضافة مواقع إلكترونية متعددة على Firebase" إمكانية استخدام 36 موقعًا إلكترونيًا كحد أقصى لكل مشروع.
مراقبة الأداء
يمكنك الانتقال إلى صفحة تحديد المشاكل وحلّها والأسئلة الشائعة حول تتبُّع الأداء للحصول على نصائح وإجابات مفيدة لمزيد من الأسئلة الشائعة.
مراقبة الأداء: كم عدد أنماط عناوين URL المخصصة التي يمكنني إنشاؤها؟
يمكنك إنشاء ما يصل إلى 400 نمط عنوان URL مخصص لكل تطبيق وما يصل إلى 100 نمط عنوان URL مخصص لكل نطاق لهذا التطبيق.
مراقبة الأداء: لماذا لا يظهر لي عرض لبيانات الأداء في الوقت الفعلي؟
لعرض بيانات الأداء في الوقت الفعلي، تأكَّد من أنّ تطبيقك يستخدم إصدارًا من حزمة تطوير البرامج (SDK) لمراقبة الأداء متوافقًا مع معالجة البيانات في الوقت الفعلي.
- iOS: الإصدار 7.3.0 أو إصدار أحدث
- tvOS: الإصدار 8.9.0 أو إصدار أحدث
- Android: الإصدار 19.0.10 أو إصدار أحدث (أو الإصدار 26.1.0 من Firebase Android BoM أو إصدار أحدث)
- الويب: الإصدار 7.14.0 أو إصدار أحدث
ننصح دائمًا باستخدام أحدث إصدار من حزمة تطوير البرامج (SDK)، إلا أنّ أي إصدار مدرَج أعلاه سيتيح لميزة "مراقبة الأداء" معالجة بياناتك في الوقت الفعلي تقريبًا.
قاعدة بيانات الوقت الفعلي
قاعدة بيانات الوقت الفعلي: لماذا كان معدل نقل بيانات قاعدة البيانات في الوقت الفعلي أقل من المتوسط بين أيلول (سبتمبر) 2016 وآذار (مارس) 2017؟
بالنسبة إلى عمليات احتساب معدل نقل البيانات، يتم عادةً تضمين النفقات العامة لتشفير طبقة المقابس الآمنة (استنادًا إلى الطبقة 5 من نموذج OSI). مع ذلك، طرحنا في أيلول (سبتمبر) 2016 خطأً أدى إلى تجاهل تقارير معدل نقل البيانات لتكاليف التشفير. من المحتمل أن يكون هذا الإجراء قد أدّى إلى انخفاض معدّل نقل البيانات والفواتير في حسابك بشكل زائف لبضعة أشهر.
لقد أصدرنا إصلاحًا لهذا الخطأ في أواخر آذار (مارس) 2017، وهو إعادة إعداد تقارير معدل نقل البيانات والفوترة إلى المستويات العادية.
Realtime Database: ما هي قيود التوسّع في قاعدة بيانات الوقت الفعلي؟
لكل مثيل من قاعدة بيانات "الوقت الفعلي" حدود في عدد عمليات الكتابة في الثانية. وبالنسبة إلى عمليات الكتابة الصغيرة، يبلغ هذا الحد الأقصى 1, 000 عملية كتابة في الثانية تقريبًا. وإذا أوشكت على بلوغ هذا الحدّ الأقصى، يمكن أن يساعدك تجميع العمليات باستخدام التحديثات المتعدّدة المسارات في زيادة سرعة معالجة البيانات.
بالإضافة إلى ذلك، يكون لكل مثيل في قاعدة البيانات حد أقصى لعدد اتصالات قاعدة البيانات المتزامنة. حدودنا التلقائية كبيرة بما يكفي لمعظم التطبيقات. إذا كنت تنشئ تطبيقًا يتطلب مقياسًا إضافيًا، قد تحتاج إلى تقسيم تطبيقك على عدّة مثيلات قاعدة بيانات لتوسيع نطاقه. يمكنك أيضًا استخدام Cloud Firestore كقاعدة بيانات بديلة.
Realtime Database: ما الذي يمكنني فعله إذا تجاوزت حدود استخدام قاعدة البيانات في الوقت الفعلي؟
إذا تلقيت تنبيهًا أو إشعارًا عبر البريد الإلكتروني في "وحدة تحكُّم Firebase" يفيد بأنّك قد تجاوزت حدود استخدام "قاعدة البيانات في الوقت الفعلي"، يمكنك معالجة الأمر على أساس الحدّ الأقصى للاستخدام الذي تجاوزته. للاطّلاع على استخدام "قاعدة البيانات في الوقت الفعلي"، انتقِل إلى لوحة بيانات استخدام قاعدة البيانات في الوقت الفعلي في وحدة تحكّم Firebase.
إذا تجاوزت الحدّ الأقصى المسموح به لعمليات التنزيل، يمكنك ترقية خطة أسعار Firebase أو الانتظار إلى أن تتم إعادة ضبط الحدّ الأقصى المسموح به لعمليات التنزيل في بداية دورة الفوترة التالية. لتقليل عمليات التنزيل، جرِّب الخطوات التالية:
- أضف استعلامات لتقييد البيانات التي تعرضها عمليات الاستماع.
- تحقَّق من أنّ طلبات البحث غير مفهرسة.
- استخدِم أدوات معالجة البيانات التي تنزّل تحديثات البيانات فقط، على سبيل المثال،
on()
بدلاً منonce()
. - استخدام قواعد الأمان لحظر عمليات التنزيل غير المصرّح بها
إذا تجاوزت الحد الأقصى المسموح به لمساحة التخزين، عليك ترقية خطة الأسعار لتجنُّب انقطاع الخدمة. ولخفض كمية البيانات في قاعدة البيانات، يمكنك تجربة الخطوات التالية:
- تنفيذ مهام التنظيف الدورية
- تقليل أي بيانات مكررة في قاعدة البيانات.
يُرجى العلم بأنّ ظهور أي عمليات حذف للبيانات في حصة مساحة التخزين قد يستغرق بعض الوقت.
إذا تجاوزت الحد الأقصى لاتصالات قاعدة البيانات المتزامنة، عليك ترقية خطتك لتجنُّب انقطاع الخدمة. لإدارة الاتصالات المتزامنة بقاعدة بياناتك، جرِّب الاتصال عبر المستخدمين عبر REST API إذا لم تكن تتطلب اتصالاً في الوقت الفعلي.
الإعداد عن بُعد
الإعداد عن بُعد: لماذا لا تؤدي القيم التي يتم استرجاعها إلى تغيير سلوك تطبيقي ومظهره؟
ما لم يتم استرجاع القيم باستخدام fetchAndActivate()
، يتم تخزين القيم محليًا ولكن لا يتم تفعيلها. لتفعيل القيم التي تم استرجاعها
كي تدخل حيز التنفيذ، يمكنك طلب activate
. ويتيح لك هذا التصميم إمكانية التحكّم في تغيُّر سلوك تطبيقك ومظهره، لأنّه بإمكانك اختيار وقت الاتصال بـ activate
. بعد طلب
activate
، يحدِّد رمز مصدر التطبيق وقت استخدام
قيم المَعلمات المعدّلة.
على سبيل المثال، يمكنك استرجاع القيم ثم تفعيلها في المرة التالية التي يبدأ فيها المستخدم تشغيل تطبيقك، ما يلغي الحاجة إلى تأخير بدء تشغيل التطبيق أثناء انتظاره للقيم التي يتم جلبها من الخدمة. بعد ذلك، تطرأ تغييرات على سلوك تطبيقك ومظهره عندما يستخدم قيم المَعلمات المعدّلة.
لمعرفة مزيد من المعلومات حول واجهة برمجة التطبيقات عن بُعد ونموذج الاستخدام، يمكنك الاطّلاع على نظرة عامة على واجهة برمجة التطبيقات عن بُعد.
الإعداد عن بُعد: أُجري الكثير من طلبات الجلب أثناء تطوير تطبيقي. لماذا لا يحصل تطبيقي دائمًا على أحدث القيم من الخدمة عند إرسال طلبات الاسترجاع؟
أثناء تطوير التطبيق، قد تحتاج إلى جلب الإعدادات وتفعيلها بشكل متكرّر جدًا (عدة مرات في الساعة) للسماح لك بالتكرار السريع أثناء تطوير تطبيقك واختباره. ولاستيعاب التكرار السريع لمشروع ما يصل إلى 10 مطوّرين، يمكنك ضبط كائن
FirebaseRemoteConfigSettings
مؤقتًا مع حد أدنى منخفض للفاصل الزمني
للجلب (setMinimumFetchIntervalInSeconds
) في تطبيقك.
الإعداد عن بُعد: ما مدى سرعة عرض خدمة "الإعداد عن بُعد" للقيم التي تم جلبها بعد أن يرسل تطبيقي طلب جلب؟
تتلقّى الأجهزة عادةً القيم التي تم استرجاعها في أقل من ثانية، وغالبًا ما تتلقّى القيم التي تم الحصول عليها بالمللي ثانية. تعالج خدمة "الإعداد عن بُعد" طلبات الجلب خلال مللي ثانية، ولكن الوقت اللازم لإكمال طلب الاسترجاع يعتمد على سرعة الشبكة للجهاز ووقت استجابة الاتصال بالشبكة الذي يستخدمه الجهاز.
إذا كان هدفك هو تنفيذ القيم التي تم جلبها في تطبيقك في أسرع وقت ممكن، ولكن بدون تقديم تجربة مستخدم مزعجة، ننصحك بإضافة المكالمات إلى fetchAndActivate
في كل مرة تتم فيها إعادة تحميل الشاشة بملء الشاشة.
مركز الاختبار الافتراضي
انتقِل إلى صفحة تحديد المشاكل وحلّها في مركز الاختبار الافتراضي للحصول على نصائح وإجابات مفيدة عن الأسئلة الشائعة.
مساحة تخزين تصنيف المستخدمين في Firebase
ما المقصود بمساحة تخزين المستخدمين في Firebase؟
وتخزِّن مساحة التخزين لميزة "تقسيم المستخدمين في Firebase" أرقام تعريف التثبيت من Firebase والسمات والشرائح ذات الصلة التي أنشأتها لتوفير معلومات استهداف لخدمات Firebase الأخرى التي تستخدم هذه الخدمات، مثل Crashlytics وFCM وتخصيص ميزة "الإعداد عن بُعد" وغيرها.