بدء استخدام 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.

• يمكنك التفاعل مع المشروع باستخدام واجهة سطر الأوامر (CLI) في Firebase وgcloud CLI وأي مورد Terraform من Google.

• يمكنك استخدام المنتجات وواجهات برمجة التطبيقات من كل من Firebase وGoogle Cloud في المشروع.

• تتم مشاركة أذونات وأدوار "إدارة الهوية وإمكانية الوصول" للمشروع بين Firebase وGoogle Cloud. أي إذن وصول يحصل عليه أحد أعضاء المشروع (أي المستخدم الأساسي) إلى مشروعك على "Google Cloud" سيتم تطبيقه أيضًا على مشروعك على Firebase (والعكس صحيح).

• تتم مشاركة الفوترة للمشروع بين Firebase وGoogle Cloud. إذا كانت الفوترة مفعَّلة في مشروعك على "Google Cloud"، سيتم تطبيق خطة أسعار Blaze المَرِنة في Firebase على مشروعك على 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 واستخدامها في مشروع Google Cloud، عليك قبول بنود خدمة Firebase. مزيد من المعلومات عن متطلبات قبول بنود Firebase

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

وحدة تحكّم "Firebase"

1. سجِّل الدخول إلى وحدة تحكّم Firebase باستخدام الحساب الذي يمنحك إمكانية الوصول إلى مشروع Google Cloud الحالي.

2. انقر على الزر لإنشاء مشروع Firebase جديد.

3. في أسفل الصفحة، انقر على إضافة Firebase إلى مشروع Google Cloud.

4. في حقل النص، ابدأ بإدخال اسم المشروع الحالي، ثم اختَر المشروع من القائمة المعروضة.

5. انقر على فتح المشروع.

6. اقبل بنود Firebase إذا طُلب منك ذلك.

7. اتّبِع التعليمات الظاهرة على الشاشة من أجل "إضافة Firebase" وإعداد مشروع Firebase.

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

‫Firebase CLI

1. ثبِّت واجهة سطر الأوامر (CLI) في Firebase إذا لم يسبق لك ذلك.

2. سجِّل الدخول باستخدام حساب Google نفسه الذي يمنحك إمكانية الوصول إلى مشروع "Google Cloud" الحالي.

3. نفِّذ الأمر التالي:

   firebase projects:addfirebase

4. عندما يُطلب منك ذلك، اختَر مشروع Google Cloud الحالي من القائمة المعروضة.

ملاحظة: إذا ظهر لك خطأ 403 PERMISSION_DENIED عند محاولة "إضافة Firebase" إلى مشروع Google Cloud حالي، قد يعني ذلك أنّه ليس لديك الأذونات المطلوبة أو أنّك لم تقبل بنود خدمة Firebase.

REST API

1. فعِّل Firebase Management API في مشروع "Google Cloud" الحالي.

2. أنشئ رمز الدخول إلى واجهة برمجة التطبيقات.

3. فعِّل خدمات Firebase للمشروع من خلال استدعاء projects.addFirebase.

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

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

ملاحظة: إذا ظهر لك الخطأ 403 PERMISSION_DENIED عند محاولة "إضافة Firebase" إلى مشروع Google Cloud حالي، قد يعني ذلك أنّه ليس لديك الأذونات المطلوبة أو أنّك لم تقبل بنود خدمة Firebase.

Terraform

1. فعِّل واجهة برمجة التطبيقات Firebase Management API‏ (firebase.googleapis.com) في مشروع "Google Cloud" الحالي.

2. فعِّل خدمات Firebase للمشروع باستخدام المورد google_firebase_project.

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

ملاحظة: إذا ظهر لك الخطأ 403 PERMISSION_DENIED عند محاولة "إضافة Firebase" إلى مشروع Google Cloud حالي، قد يعني ذلك أنّك لا تملك الأذونات المطلوبة أو أنّك لم تقبل بنود خدمة Firebase.

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

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

ملاحظة مهمة: إذا وقّعت على نسخة متوفّرة بلا إنترنت من "اتفاقية Google Cloud الرئيسية" لاستخدام خدمات Firebase المحدّدة ضمن حساب Google Cloud Platform نفسه، لن تنطبق بنود 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. بدلاً من ذلك، ننصحك باستخدام واجهة سطر الأوامر (CLI) في Firebase أو 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 أو Terraform في حالات الاستخدام المتقدّمة).

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

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

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

• يتم إنشاء مفتاح واجهة برمجة تطبيقات "المتصفّح" ويتم حظره تلقائيًا على واجهات برمجة التطبيقات ذات الصلة بمنصة Firebase.

• يتم إنشاء حسابات الخدمة التالية:

  • [e-mail]
  • 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 Remote Config API
  • 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" إلى مشروع حالي على "Google Cloud"، يمكنك إجراء ما يلي:

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

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

• اطّلِع على المراجع التالية لمزيد من المعلومات عن مشاريع Firebase:

  • فهم مشاريع Firebase: يقدّم هذا القسم نظرة عامة موجزة عن عدة مفاهيم مهمة حول مشاريع Firebase، بما في ذلك علاقتها بـ Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.

  • أفضل الممارسات العامة لإعداد مشاريع Firebase: يقدّم هذا القسم أفضل الممارسات العامة والشاملة لإعداد مشاريع Firebase وتسجيل تطبيقاتك في مشروع معيّن ليكون لديك سير عمل واضح للتطوير يستخدم بيئات مختلفة.

• يمكنك البدء في استخدام Firebase في تطبيقاتك للأجهزة الجوّالة وتطبيقات الويب من خلال تسجيل تطبيقاتك في مشروع Firebase وربطها بمنصة Firebase: iOS+‎ | Android | الويب | Flutter | Unity | C++‎.