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

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

وقتی 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 از گوگل با پروژه تعامل داشته باشید.

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

• مجوزها و نقش‌های IAM برای پروژه بین Firebase و Google Cloud به اشتراک گذاشته شده است. هرگونه دسترسی که یک عضو پروژه (یعنی یک مدیر) به پروژه Google Cloud شما داشته باشد، برای پروژه Firebase شما نیز اعمال خواهد شد (و برعکس).

• هزینه‌ی پروژه بین Firebase و Google Cloud مشترک است. اگر هزینه‌ی پروژه در پروژه‌ی Google Cloud شما فعال باشد، پروژه‌ی Firebase شما در طرح قیمت‌گذاری Blaze فایربیس که به صورت پرداخت در حین استفاده است، قرار خواهد گرفت.

• شناسه‌های منحصر به فرد برای پروژه (مانند شماره پروژه و شناسه پروژه ) در 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. با حسابی که به شما امکان دسترسی به پروژه Google Cloud موجود را می‌دهد، وارد کنسول Firebase شوید.

2. برای ایجاد یک پروژه جدید Firebase، روی دکمه کلیک کنید.

3. در پایین صفحه، روی «افزودن Firebase به پروژه Google Cloud» کلیک کنید.

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

5. روی باز کردن پروژه کلیک کنید.

6. در صورت درخواست، شرایط Firebase را بپذیرید.

7. دستورالعمل‌های روی صفحه را برای «افزودن Firebase» و راه‌اندازی یک پروژه Firebase دنبال کنید.

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

رابط خط Firebase

1. اگر هنوز رابط خط فرمان Firebase CLI) را نصب نکرده‌اید، آن را نصب کنید .

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

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

   firebase projects:addfirebase

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

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

API رست

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

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

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

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

برای دستورالعمل‌های دقیق، به بخش «افزودن سرویس‌های فایربیس به پروژه خود» در راهنمای فایربیس مراجعه کنید: «راه‌اندازی و مدیریت یک پروژه فایربیس با استفاده از مدیریت REST API». حتماً تمام دستورالعمل‌های بخش « قبل از شروع» آن راهنما را دنبال کنید.

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

ترافرم

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

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

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

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

سوالات متداول و رفع اشکال

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

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

شما فقط باید یک بار شرایط فایربیس را برای حساب گوگل خود بپذیرید، مهم نیست به چند پروژه دسترسی داشته باشید. وقتی شرایط را می‌پذیرید، آنها را فقط برای حساب گوگل خود می‌پذیرید؛ پذیرش در سطح پروژه برای همه اعضای پروژه نیست .

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

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

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

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

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

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

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

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

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

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

چرا کنسول Firebase نمی‌تواند لیستی از پروژه‌های موجود Google Cloud من را بارگذاری کند؟

این پرسش‌های متداول اغلب زمانی کاربرد دارد که می‌خواهید با استفاده از کنسول Firebase ، Firebase را به یک پروژه Google Cloud موجود «اضافه کنید» و به هزاران پروژه Google Cloud دسترسی داشته باشید .

کنسول Firebase برای بارگذاری هزاران پروژه Google Cloud ساخته نشده است. در عوض، توصیه می‌کنیم از Firebase CLI، REST API یا Terraform برای «افزودن فایربیس» به پروژه Google Cloud موجود خود استفاده کنید .

همچنین، شاید بخواهید سوالات متداول «چرا پروژه Firebase من در لیست پروژه‌های Firebase من نمایش داده نمی‌شود؟» را مرور کنید.

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

تمام پروژه‌های فایربیس دارای برچسب firebase:enabled در صفحه برچسب‌ها (Labels) کنسول 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 را در صفحه برچسب‌ها (Labels) کنسول Google Cloud اضافه می‌کند.

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

• حساب‌های سرویس زیر را ایجاد می‌کند:

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

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

  • API مدیریت موتور برنامه
  • API ابری Pub/Sub
  • رابط برنامه‌نویسی کاربردی (API) مدیریت منابع ابری
  • رابط برنامه‌نویسی کاربردی پیکربندی زمان اجرای ابری
  • API تست ابری
  • API پیام‌رسانی ابری فایربیس
  • API لینک‌های پویای فایربیس
  • API میزبانی فایربیس
  • API نصب فایربیس
  • رابط برنامه‌نویسی کاربردی مدیریت فایربیس
  • API پیکربندی از راه دور فایربیس
  • پیکربندی از راه دور فایربیس، API بلادرنگ
  • API قوانین فایربیس
  • رابط برنامه‌نویسی کاربردی (API) جعبه ابزار هویت
  • API سرویس توکن

آیا می‌توانم فایربیس را از یک پروژه "حذف" کنم؟

بعد از اینکه Firebase را به یک پروژه Google Cloud موجود «اضافه» کردید، دیگر نمی‌توانید آن را لغو کنید (یعنی نمی‌توانید Firebase را به طور کامل از پروژه Google Cloud «حذف» کنید).

فرآیند «افزودن Firebase» رابط‌های برنامه‌نویسی کاربردی (API) و سرویس‌های backend را فعال می‌کند که ممکن است برای سایر ویژگی‌های Google Cloud استفاده شوند. غیرفعال کردن همه این سرویس‌های فعال می‌تواند به دلیل وابستگی‌ها، عواقب غیرمنتظره و ناخواسته‌ای ایجاد کند.

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

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

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

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

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

مراحل بعدی

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

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

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

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