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

بدء استخدام Firebase مع مشروع حالي على Google Cloud

مشروع Firebase هو مشروع Google Cloud تم تفعيل بعض الإعدادات والخدمات الإضافية الخاصة بـ Firebase فيه. ويُطلق على ذلك عادةً اسم "إضافة Firebase" إلى مشروع Google Cloud. توضّح هذه الصفحة كيفية "إضافة Firebase"، بالإضافة إلى بعض الأسئلة الشائعة.

عند إضافة Firebase إلى مشروع Google Cloud، يفعّل Firebase تلقائيًا العديد من واجهات برمجة التطبيقات وينشئ حسابات خدمة لتسهيل استخدام جميع خدمات وواجهات Firebase. تضيف Firebase أيضًا التصنيف firebase:enabled إلى مشروعك ضمن صفحة إدارة الهوية وإمكانية الوصول والمشرف > التصنيفات في وحدة تحكّم Google Cloud. يمكنك الاطّلاع على مزيد من التفاصيل حول ما يحدث عند "إضافة Firebase".

العلاقة بين مشروع Firebase ومشروع Google Cloud

بما أنّ مشروع Firebase هو مشروع Google Cloud:

يمكنك الوصول إلى المشروع والتفاعل معه في Firebase وحدة التحكّم وكذلك في Google Cloud وحدة التحكّم ووحدة تحكّم Google APIs.
يمكنك التفاعل مع المشروع باستخدام Firebase CLI وgcloud CLI وأي مورد Terraform من Google.
يمكنك استخدام المنتجات وواجهات برمجة التطبيقات من كلّ من Firebase وGoogle Cloud في المشروع.
تتم مشاركة أذونات وأدوار نظام "إدارة الهوية وإمكانية الوصول" للمشروع بين Firebase وGoogle Cloud. أي إذن وصول يملكه أحد أعضاء المشروع (أي أحد الأطراف الرئيسية) إلى مشروعك Google Cloud سينطبق أيضًا على مشروعك على Firebase (والعكس صحيح).
تتم مشاركة الفوترة للمشروع بين Firebase وGoogle Cloud. إذا كانت الفوترة مفعّلة في مشروعك Google Cloud، سيكون مشروعك على Firebase ضمن خطة التسعير Blaze للدفع حسب الاستخدام في Firebase.
تتم مشاركة المعرّفات الفريدة للمشروع (مثل رقم المشروع ورقم تعريف المشروع) بين Firebase وGoogle Cloud.
سيتم أيضًا تطبيق أي تسلسل هرمي للموارد مطبّق على Google Cloud مشروعك (مثل المؤسسة والمجلدات وما إلى ذلك) على مشروع Firebase.
سيؤدي حذف المشروع إلى حذفه في كل من Firebase وGoogle Cloud.
يتم تطبيق حذف أو تعديل أحد المراجع أو البيانات داخل المشروع على كل من Firebase وGoogle Cloud.

كيفية إضافة Firebase إلى مشروع Google Cloud حالي

يمكنك "إضافة Firebase" إلى مشروع Google Cloud حالي باستخدام أي من الخيارات التالية. تأكَّد من أنّ لديك الأذونات المطلوبة لإضافة Firebase إلى مشروع Google Cloud.

يُرجى العِلم أنّه بعد "إضافة Firebase" إلى مشروع Google Cloud حالي، لا يمكن التراجع عن ذلك (أي أنّه لا يمكنك إزالة Firebase بالكامل من مشروع Google Cloud). يمكنك الاطّلاع على مزيد من المعلومات في الأسئلة الشائعة هذه.

Firebase وحدة التحكّم

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

يُرجى العِلم أنّ تفعيل ميزة "المساعدة المستندة إلى الذكاء الاصطناعي" في وحدة تحكّم Firebase وGoogle Analytics هو أمر اختياري.

Firebase CLI

إذا لم يسبق لك إجراء ذلك، ثبِّت واجهة سطر الأوامر Firebase.
سجِّل الدخول باستخدام حساب Google نفسه الذي يتيح لك الوصول إلى مشروع Google Cloud الحالي.
نفِّذ الأمر التالي:
```
firebase projects:addfirebase
```
عندما يُطلب منك ذلك، اختَر مشروع Google Cloud الحالي من القائمة المعروضة.

REST API

فعِّل Firebase Management API في مشروع Google Cloud الحالي.
أنشئ رمز دخول واجهة برمجة التطبيقات.
فعِّل خدمات Firebase للمشروع من خلال استدعاء projects.addFirebase.

يُرجى العِلم أنّه يجب توفير اسم المورد الخاص بمشروعك لإجراء هذه المكالمة.

للحصول على تعليمات تفصيلية، راجِع مقالة إضافة خدمات Firebase إلى مشروعك في دليل Firebase: "إعداد مشروع Firebase وإدارته باستخدام Management REST API". احرص على اتّباع جميع التعليمات الواردة في قسم قبل البدء من هذا الدليل.

Terraform

فعِّل واجهة Firebase Management API (firebase.googleapis.com) في مشروع Google Cloud الحالي.
فعِّل خدمات Firebase للمشروع باستخدام المورد google_firebase_project.

للحصول على معلومات تفصيلية حول استخدام Firebase وTerraform، يُرجى الاطّلاع على البدء في استخدام Terraform وFirebase.

الأسئلة الشائعة وتحديد المشاكل وحلّها

هل يجب قبول بنود خدمة Firebase لبدء استخدامها؟

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

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

يمكنك قبول "بنود خدمة Firebase" من خلال وحدة تحكّم Firebase باستخدام أيّ من الخيارات التالية. اقبل البنود عند مطالبتك بذلك. إذا لم يُطلب منك قبول بنود خدمة Firebase، يعني ذلك أنّك سبق أن قبلتها.

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

ما هي الأذونات المطلوبة "لإضافة Firebase"؟

لإضافة Firebase إلى مشروع Google Cloud حالي، يجب أن يتوفّر لأحد أعضاء المشروع (أي أحد الجهات الرئيسية) أذونات "إدارة الهوية وإمكانية الوصول" التالية:

firebase.projects.update
resourcemanager.projects.get
serviceusage.services.enable
serviceusage.services.get

تتضمّن أدوار "المحرّر" و"المالك" في نظام "إدارة الهوية وإمكانية الوصول" هذه الأذونات تلقائيًا.

لماذا يتعذّر على وحدة تحكّم Firebase تحميل قائمة بمشاريع Google Cloud الحالية؟

تنطبق الأسئلة الشائعة هذه في أغلب الأحيان إذا كنت تحاول "إضافة Firebase" إلى مشروع Google Cloud حالي باستخدام وحدة تحكّم Firebase وكان بإمكانك الوصول إلى آلاف المشاريع على Google Cloud.

لم يتم تصميم وحدة تحكّم Firebase لتحميل آلاف المشاريع من النوع Google Cloud. بدلاً من ذلك، ننصحك باستخدام Firebase CLI أو REST API أو Terraform من أجل "إضافة Firebase" إلى مشروعك الحالي Google Cloud.

يمكنك أيضًا مراجعة الأسئلة الشائعة "لماذا لا يظهر مشروعي على Firebase في قائمة مشاريع Firebase؟"

هل إضافة التصنيف `firebase:enabled` كافية لإضافة Firebase؟

تحتوي جميع مشاريع Firebase على تصنيف firebase:enabled ضمن صفحة إدارة الهوية وإمكانية الوصول والمشرف > التصنيفات في وحدة تحكّم Google Cloud.

ومع ذلك، فإنّ إضافة التصنيف firebase:enabled يدويًا إلى قائمة تصنيفات المشاريع لن يتيح إعدادات وخدمات خاصة بـ Firebase لمشروعك Google Cloud. لإجراء ذلك، عليك إضافة Firebase باستخدام وحدة تحكّم Firebase (أو، لحالات الاستخدام المتقدّمة، باستخدام واجهة سطر الأوامر Firebase أو واجهة برمجة التطبيقات REST الخاصة بخدمة Firebase Management أو Terraform).

ماذا يحدث عند "إضافة Firebase" إلى مشروع Google Cloud حالي؟

مشروع Firebase هو مشروع Google Cloud تم تفعيل بعض الإعدادات والخدمات الإضافية الخاصة بـ Firebase فيه. لذلك، عند "إضافة Firebase" إلى مشروع Google Cloud حالي، يتّخذ Firebase الإجراءات التالية لتسهيل استخدام جميع خدمات وواجهات Firebase:

تضيف هذه الإذن التسمية firebase:enabled ضمن صفحة المشرف وإدارة الهوية وإمكانية الوصول > التصنيفات في وحدة تحكّم Google Cloud.
ينشئ مفتاح واجهة برمجة تطبيقات من النوع "متصفّح" ويقيّده تلقائيًا على واجهات برمجة التطبيقات ذات الصلة بـ Firebase.
يتم إنشاء حسابات الخدمة التالية:
- service-PROJECT_NUMBER@gcp-sa-firebase.iam.gserviceaccount.com
- firebase-adminsdk-random5chars@PROJECT_ID.iam.gserviceaccount.com
تفعيل واجهات برمجة التطبيقات التالية:
- App Engine Admin API
- Cloud Pub/Sub API
- Cloud Resource Manager API
- Cloud Runtime Configuration API
- Cloud Testing API
- Firebase Cloud Messaging API
- Firebase Dynamic Links API
- Firebase Hosting API
- Firebase Installations API
- Firebase Management API
- ‫واجهة برمجة تطبيقات الإعداد عن بُعد عبر Firebase
- Firebase Remote Config Realtime API
- Firebase Rules API
- Identity Toolkit API
- Token Service API

هل يمكنني "إزالة Firebase" من مشروع؟

بعد "إضافة Firebase" إلى مشروع Google Cloud حالي، لا يمكن التراجع عن ذلك (أي أنّه لا يمكنك إزالة Firebase بالكامل من مشروع Google Cloud).

تتيح عملية "إضافة Firebase" واجهات برمجة التطبيقات وخدمات الخلفية التي يمكن استخدامها لميزات Google Cloud الأخرى. قد يؤدي إيقاف جميع هذه الخدمات المفعّلة إلى عواقب غير متوقّعة وغير مقصودة بسبب التبعيات.

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

هل يمكنني حظر "إضافة Firebase" إلى مشروع Google Cloud حالي؟

على الرغم من أنّه لا يمكنك منع إمكانية "إضافة Firebase" إلى مشروع Google Cloud حالي، يمكنك إجراء ما يلي:

تقييد أعضاء المشروع (أي الجهات الرئيسية) الذين لديهم إذن firebase.projects.update في إدارة الهوية وإمكانية الوصول (IAM)، وهو إذن مطلوب "لإضافة Firebase"

الخطوات التالية

اطّلِع على المراجع التالية لمعرفة المزيد عن مشاريع Firebase:
- التعرّف على مشاريع Firebase: تقدّم هذه الصفحة نظرة عامة موجزة على العديد من المفاهيم المهمة حول مشاريع Firebase، بما في ذلك علاقتها بـ Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.
- أفضل الممارسات العامة لإعداد مشاريع Firebase: تقدّم هذه الصفحة أفضل الممارسات العامة والمتقدّمة لإعداد مشاريع Firebase وتسجيل تطبيقاتك في مشروع، وذلك لضمان سير عمل واضح للتطوير يستخدم بيئات مختلفة.
ابدأ استخدام Firebase في تطبيقاتك على الأجهزة الجوّالة وتطبيقات الويب من خلال تسجيل تطبيقاتك في مشروع Firebase وربطها بمنصة Firebase: iOS+ | Android | الويب | ‫Flutter | ‫Unity | ‫C++‎.