شروع به استفاده از Firebase با یک پروژه Google Cloud موجود کنید

پروژه Firebase یک پروژه Google Cloud است که دارای تنظیمات و سرویس‌های اضافی مخصوص Firebase است. این معمولاً "افزودن Firebase" به پروژه Google Cloud نامیده می شود. این صفحه نحوه "افزودن Firebase" را به همراه برخی از سوالات متداول (سؤالات متداول) توضیح می دهد.

وقتی Firebase را به پروژه Google Cloud اضافه می‌کنید، Firebase به‌طور خودکار چندین API را فعال می‌کند و حساب‌های سرویس ایجاد می‌کند تا استفاده از همه سرویس‌ها و رابط‌های Firebase را ساده کند. Firebase همچنین یک برچسب firebase:enabled را در صفحه Labels کنسول Google Cloud به پروژه شما اضافه می کند. جزئیات بیشتری درباره اتفاقاتی که هنگام "افزودن Firebase" رخ می دهد بیاموزید.

رابطه بین پروژه Firebase و پروژه Google Cloud

از آنجایی که یک پروژه Firebase یک پروژه Google Cloud است :

• می‌توانید در کنسول Firebase و همچنین در کنسول Google Cloud و کنسول Google APIs به پروژه دسترسی داشته باشید و با آن تعامل داشته باشید.

• می‌توانید با استفاده از Firebase CLI ، gcloud CLI و هر منبع Terraform از Google با پروژه تعامل داشته باشید.

• می‌توانید از محصولات و APIهای Firebase و Google Cloud در پروژه استفاده کنید.

• مجوزها و نقش‌های IAM برای پروژه در 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 در پروژه Google Cloud ، باید شرایط خدمات Firebase را بپذیرید. در این سؤالات متداول درباره شرایط Firebase بیشتر بدانید.

کنسول Firebase

1. به کنسول Firebase بروید.

2. با همان حساب Google وارد شوید که به شما امکان می دهد به پروژه Google Cloud موجود دسترسی پیدا کنید.

3. روی ایجاد پروژه کلیک کنید.

4. در پایین صفحه، روی پیوند برای قبلاً پروژه Google Cloud دارید کلیک کنید؟

5. در قسمت متن، شناسه پروژه پروژه موجود را وارد کنید و سپس پروژه را از لیست نمایش داده شده انتخاب کنید.

6. روی Open project کلیک کنید.

7. اگر از شما خواسته شد، شرایط Firebase را بپذیرید.

8. دستورالعمل های روی صفحه را برای "افزودن Firebase" و راه اندازی یک پروژه Firebase دنبال کنید.

   توجه داشته باشید که فعال کردن Google Analytics اختیاری است.

Firebase CLI

1. اگر قبلاً این کار را نکرده‌اید، Firebase CLI را نصب کنید .

2. با همان حساب Google وارد شوید که به شما امکان می دهد به پروژه Google Cloud موجود دسترسی پیدا کنید.

3. دستور زیر را اجرا کنید:

   firebase projects:addfirebase

4. وقتی از شما خواسته شد، پروژه موجود Google Cloud را از لیست نمایش داده شده انتخاب کنید.

توجه: اگر هنگام تلاش برای «افزودن Firebase» به یک پروژه Google Cloud موجود، خطای 403 PERMISSION_DENIED دریافت کردید، می‌تواند به این معنی باشد که مجوزهای لازم را ندارید یا شرایط خدمات Firebase را نپذیرفته‌اید .

REST API

1. Firebase Management API را در پروژه Google Cloud موجود فعال کنید.

2. کد دسترسی API خود را ایجاد کنید.

3. با فراخوانی projects.addFirebase خدمات Firebase را برای پروژه فعال کنید.

   توجه داشته باشید که برای برقراری این تماس به نام منبع پروژه خود نیاز دارید.

برای دستورالعمل های دقیق، به افزودن خدمات Firebase به پروژه خود در راهنمای Firebase مراجعه کنید: "راه اندازی و مدیریت یک پروژه Firebase با استفاده از Management REST API". مطمئن شوید که تمام دستورالعمل‌های موجود در بخش قبل از شروع آن راهنما را دنبال کنید.

توجه: اگر هنگام تلاش برای «افزودن Firebase» به یک پروژه Google Cloud موجود، خطای 403 PERMISSION_DENIED دریافت کردید، می‌تواند به این معنی باشد که مجوزهای لازم را ندارید یا شرایط خدمات Firebase را نپذیرفته‌اید .

Terraform

1. API مدیریت Firebase ( firebase.googleapis.com ) را در پروژه Google Cloud موجود فعال کنید.

2. با استفاده از منبع google_firebase_project ، خدمات Firebase را برای پروژه فعال کنید.

برای اطلاعات دقیق درباره استفاده از Firebase و Terraform، به شروع کار با Terraform و Firebase مراجعه کنید.

توجه: اگر هنگام تلاش برای «افزودن Firebase» به یک پروژه Google Cloud موجود، خطای 403 PERMISSION_DENIED دریافت کردید، می‌تواند به این معنی باشد که مجوزهای لازم را ندارید یا شرایط خدمات Firebase را نپذیرفته‌اید .

سوالات متداول و عیب یابی

آیا پذیرش شرایط خدمات Firebase برای شروع استفاده از Firebase الزامی است؟

برای دسترسی و استفاده از همه قابلیت‌های Firebase در پروژه Google Cloud ، باید شرایط خدمات Firebase را بپذیرید. همچنین برای «افزودن Firebase» به پروژه Google Cloud موجود، باید شرایط Firebase را بپذیرید.

صرف نظر از اینکه به چند پروژه دسترسی دارید ، فقط باید یک بار شرایط Firebase را برای حساب Google خود بپذیرید . وقتی شرایط را می پذیرید، آنها را فقط برای حساب Google خود می پذیرید. پذیرش در سطح پروژه برای همه اعضای پروژه نیست .

با استفاده از یکی از گزینه های زیر می توانید شرایط Firebase را از طریق کنسول Firebase بپذیرید. وقتی از شما خواسته شد، شرایط را بپذیرید.

• با استفاده از کنسول Firebase یک پروژه Firebase جدید ایجاد کنید.

• یک پروژه Firebase موجود را در کنسول Firebase باز کنید (به عنوان مثال، شخصی از شما دعوت کرده است که عضو پروژه (یعنی یک مدیر) در پروژه شوید).

• یک Google Cloud موجود را در کنسول Firebase باز کنید و Firebase را به آن اضافه کنید .

توجه: پذیرش شرایط Firebase با استفاده از Firebase CLI، REST API یا Terraform امکان پذیر نیست . این کار فقط با استفاده از کنسول Firebase قابل انجام است.

مهم: اگر یک نوع آفلاین توافقنامه Google Cloud Master را برای استفاده از خدمات مشخص شده Firebase تحت همان حساب Google Cloud Platform امضا کرده اید، شرایط Firebase برای استفاده شما از چنین خدمات Firebase اعمال نمی شود و شرایط آفلاین شما بر استفاده شما از چنین خدمات Firebase.

کدام مجوزها برای "افزودن Firebase" مورد نیاز است؟

برای «افزودن Firebase» به پروژه Google Cloud موجود، یکی از اعضای پروژه (یعنی یک اصلی) باید مجوزهای IAM زیر را داشته باشد:

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

نقش های IAM ویرایشگر و مالک به طور پیش فرض حاوی این مجوزها هستند.

آیا افزودن برچسب firebase:enabled برای افزودن Firebase کافی است؟

همه پروژه‌های Firebase دارای برچسب firebase:enabled در صفحه برچسب‌های کنسول Google Cloud هستند.

با این حال، فقط افزودن برچسب firebase:enabled به صورت دستی به لیست برچسب‌های پروژه، تنظیمات و سرویس‌های خاص Firebase را برای پروژه Google Cloud شما فعال نمی‌کند. برای انجام این کار، باید Firebase را با استفاده از کنسول Firebase اضافه کنید (یا برای موارد استفاده پیشرفته، با استفاده از Firebase CLI، Firebase Management REST API یا Terraform).

چه اتفاقی می‌افتد وقتی Firebase را به پروژه Google Cloud موجود اضافه می‌کنید؟

پروژه Firebase یک پروژه Google Cloud است که دارای تنظیمات و سرویس‌های اضافی مخصوص Firebase است. بنابراین، وقتی Firebase را به پروژه Google Cloud موجود اضافه می‌کنید، Firebase اقدامات زیر را برای ساده‌سازی استفاده از تمام سرویس‌ها و رابط‌های Firebase انجام می‌دهد:

• برچسب firebase:enabled را در صفحه برچسب‌های کنسول Google Cloud اضافه می‌کند.

• یک کلید API "مرورگر" ایجاد می کند و آن را به طور خودکار به API های مربوط به Firebase محدود می کند.

• حساب های خدمات زیر را ایجاد می کند:

  • service- PROJECT_NUMBER @gcp-sa-firebase.iam.gserviceaccount.com
  • firebase-adminsdk- random5chars @ PROJECT_ID .iam.gserviceaccount.com

• API های زیر را فعال می کند:

  • 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» APIها و خدمات پشتیبان را فعال می‌کند که ممکن است برای سایر ویژگی‌های Google Cloud استفاده شوند. غیرفعال کردن همه این سرویس‌های فعال می‌تواند باعث عواقب غیرمنتظره و ناخواسته به دلیل وابستگی‌ها شود.

با این حال، در صورت انتخاب، این امکان برای شما وجود دارد که به‌صورت دستی همه APIها را غیرفعال کنید و برچسب، کلید API و حساب‌های سرویس را که به‌طور خودکار فعال و ایجاد شده‌اند، هنگام «افزودن Firebase» حذف کنید.

هشدار: اگر تصمیم به غیرفعال کردن و حذف دستی آنچه در حین "افزودن Firebase" دارید، این کار را با احتیاط کامل انجام دهید. شما باید کاملاً مطمئن باشید که پروژه Google Cloud و برنامه‌های مرتبط با پروژه از هیچ چیز مرتبط با مواردی که غیرفعال یا حذف می‌کنید استفاده نمی‌کنند. در غیر این صورت پروژه یا برنامه شما ممکن است کار خود را متوقف کند یا به روش های غیرمنتظره ای رفتار کند.

آیا می توان «افزودن Firebase» را برای یک پروژه Google Cloud موجود مسدود کرد؟

بله، می‌توانید امکان «افزودن Firebase» را به پروژه Google Cloud موجود مسدود کنید. در اینجا چند گزینه وجود دارد:

• فعال کردن firebase.googleapis.com API را با استفاده از محدودیت «محدود کردن Google Cloud APIs and services مجاز» مسدود کنید.

• اعضای پروژه (یعنی مدیران) که دارای مجوز IAM firebase.projects.update هستند را محدود کنید، که برای "افزودن Firebase" لازم است. برای انجام کارآمد این کار می توانید از یک خط مشی رد IAM استفاده کنید.

مراحل بعدی

• برای کسب اطلاعات بیشتر در مورد پروژه های Firebase، منابع زیر را بررسی کنید:

  • پروژه‌های Firebase را درک کنید — مروری کوتاه بر چندین مفهوم مهم در مورد پروژه‌های Firebase، از جمله ارتباط آن‌ها با Google Cloud و سلسله مراتب اساسی یک پروژه و برنامه‌ها و منابع آن ارائه می‌کند.

  • بهترین روش‌های عمومی برای راه‌اندازی پروژه‌های Firebase - بهترین روش‌های عمومی و سطح بالا را برای راه‌اندازی پروژه‌های Firebase و ثبت برنامه‌های خود در یک پروژه ارائه می‌کند تا گردش کار توسعه واضحی داشته باشید که از محیط‌های متمایز استفاده می‌کند.

• با ثبت برنامه های خود در پروژه Firebase و اتصال آنها به Firebase، استفاده از Firebase را در برنامه های تلفن همراه و وب خود شروع کنید: iOS+ | اندروید | وب | فلاتر | وحدت | C++ .