یک پروژه Firebase، نهاد سطح بالای Firebase است. در یک پروژه، میتوانید برنامههای Apple، Android یا وب خود را ثبت کنید. پس از ثبت برنامههای خود در Firebase، میتوانید SDK های Firebase مخصوص محصول مانند Analytics ، Cloud Firestore ، Crashlytics یا Remote Config را به برنامه خود اضافه کنید.
شما باید انواع برنامههای اپل، اندروید و وب خود را در یک پروژه Firebase ثبت کنید. میتوانید از چندین پروژه Firebase برای پشتیبانی از محیطهای مختلف، مانند توسعه، مرحلهبندی و تولید، استفاده کنید.
در اینجا چند منبع برای یادگیری بیشتر در مورد پروژههای Firebase آورده شده است:
درک پروژههای فایربیس - مروری مختصر بر چندین مفهوم مهم در مورد پروژههای فایربیس، از جمله ارتباط آنها با Google Cloud و سلسله مراتب اساسی یک پروژه و برنامهها و منابع آن، ارائه میدهد.
بهترین شیوههای عمومی برای راهاندازی پروژههای Firebase — بهترین شیوههای عمومی و سطح بالا را برای راهاندازی پروژههای Firebase و ثبت برنامههای شما در یک پروژه ارائه میدهد تا گردش کار توسعه واضحی داشته باشید که از محیطهای مجزا استفاده میکند.
توجه داشته باشید که برای همه پروژههای Firebase، Firebase به طور خودکار برچسب firebase:enabled در صفحه برچسبها برای پروژه شما در کنسول Google Cloud اضافه میکند. برای کسب اطلاعات بیشتر در مورد این برچسب به سوالات متداول ما مراجعه کنید.
سازمان Google Cloud چیست؟
یک سازمان Google Cloud یک ظرف برای پروژههای Google Cloud (از جمله پروژههای Firebase) است. این سلسله مراتب امکان سازماندهی بهتر، مدیریت دسترسی و حسابرسی پروژههای Google Cloud و Firebase شما را فراهم میکند. برای اطلاعات بیشتر، به ایجاد و مدیریت سازمانها مراجعه کنید.
چگونه میتوانم Firebase را به یک پروژه Google Cloud موجود اضافه کنم؟
ممکن است پروژههای موجود Google Cloud شما از طریق کنسول Google Cloud یا کنسول گوگل APIs مدیریت شوند.
شما میتوانید با استفاده از هر یک از گزینههای زیر، فایربیس را به این پروژههای موجود Google Cloud اضافه کنید:
فایربیس عمیقاً با Google Cloud یکپارچه شده است. پروژهها بین فایربیس و Google Cloud به اشتراک گذاشته میشوند، بنابراین پروژهها میتوانند سرویسهای فایربیس و Google Cloud را فعال داشته باشند. میتوانید از کنسول Firebase یا کنسول Google Cloud به یک پروژه دسترسی داشته باشید. به طور خاص:
برخی از محصولات Firebase مستقیماً توسط Google Cloud پشتیبانی میشوند، مانند Cloud Storage for Firebase . فهرست محصولاتی که توسط Google Cloud پشتیبانی میشوند، به مرور زمان افزایش خواهد یافت.
بسیاری از تنظیمات شما، از جمله همکاران و اطلاعات صورتحساب، توسط Firebase و Google Cloud به اشتراک گذاشته میشوند. میزان استفاده شما از Firebase و Google Cloud در یک صورتحساب نمایش داده میشود.
علاوه بر این، وقتی به طرح قیمتگذاری پرداخت در محل Blaze ارتقا میدهید، میتوانید از هر یک از زیرساختهای به عنوان سرویس و APIهای درجه یک Google Cloud مستقیماً در پروژه Firebase خود، با قیمت استاندارد Google Cloud استفاده کنید. همچنین میتوانید دادهها را از Google Cloud مستقیماً برای تجزیه و تحلیل به BigQuery صادر کنید. برای کسب اطلاعات بیشتر، به پیوند BigQuery با Firebase مراجعه کنید.
مزایای زیادی در افزایش امنیت، بهبود تأخیر و صرفهجویی در زمان در استفاده از Google Cloud با Firebase (در مقایسه با سایر سرویسهای ابری که در یک مکان نیستند) وجود دارد. برای جزئیات بیشتر به سایت Google Cloud مراجعه کنید.
چرا پروژه Google Cloud من برچسب firebase:enabled دارد؟
در صفحه برچسبها برای پروژه خود در کنسول Google Cloud ، ممکن است برچسبی از firebase:enabled (به طور خاص، یک Key از firebase با Valueenabled ) را ببینید.
فایربیس به طور خودکار این برچسب را اضافه کرده است زیرا پروژه شما یک پروژه فایربیس است، به این معنی که پروژه شما پیکربندیها و سرویسهای مخصوص فایربیس را برای آن فعال کرده است. درباره رابطه بین پروژههای فایربیس و Google Cloud بیشتر بدانید.
اکیداً توصیه میکنیم که این برچسب را تغییر ندهید یا حذف نکنید. این برچسب توسط Firebase و Google Cloud برای فهرست کردن پروژههای Firebase شما استفاده میشود (برای مثال، با استفاده از نقطه پایانی REST API projects.list یا در منوهای کنسول Firebase ).
توجه داشته باشید که افزودن دستی این برچسب به فهرست برچسبهای پروژه، پیکربندیها و سرویسهای خاص Firebase را برای پروژه Google Cloud شما فعال نمیکند. برای انجام این کار، باید Firebase را با استفاده از کنسول Firebase (یا برای موارد استفاده پیشرفته، با استفاده از Firebase Management REST API یا Firebase CLI ) اضافه کنید.
چرا کنسول Firebase نمیتواند لیستی از پروژههای موجود Google Cloud من را بارگذاری کند؟
این پرسشهای متداول اغلب زمانی کاربرد دارد که میخواهید با استفاده از کنسول Firebase ، Firebase را به یک پروژه Google Cloud موجود «اضافه کنید» و به هزاران پروژه Google Cloud دسترسی داشته باشید .
در پاسخ اجرای دستور Firebase CLI به نام firebase projects:list
این مراحل عیبیابی را امتحان کنید:
ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید: https://console.firebase.google.com/project/ PROJECT-ID /overview
اگر نمیتوانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت میکنید، موارد زیر را بررسی کنید:
مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
بررسی کنید که آیا میتوانید پروژه را در کنسول Google Cloud مشاهده کنید یا خیر.
مطمئن شوید که پروژه شما برچسب firebase:enabled در صفحه Labels برای پروژهتان در کنسول Google Cloud دارد. Firebase و Google Cloud از این برچسب برای فهرست کردن پروژههای Firebase شما استفاده میکنند. اگر این برچسب را نمیبینید اما Firebase Management API برای پروژه شما فعال است ، برچسب را به صورت دستی اضافه کنید (به طور خاص، یک Keyfirebase با Valueenabled ).
مطمئن شوید که یکی از نقشهای اصلی IAM (مالک، ویرایشگر، مشاهدهگر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریفشده Firebase ، به شما اختصاص داده شده است. میتوانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.
اگر هیچ یک از مراحل عیبیابی بالا به شما امکان مشاهده پروژهتان در فهرست پروژههای Firebase را نداد، با پشتیبانی Firebase تماس بگیرید.
با هر حساب گوگل (آدرس ایمیل) چند پروژه میتوانم داشته باشم؟
طرح قیمتگذاری اسپارک : سهمیه ایجاد پروژه به تعداد کمی پروژه (معمولاً حدود ۵ تا ۱۰ پروژه) محدود میشود.
طرح قیمتگذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است، اما ممکن است با اتصال یک حساب Cloud Billing با وضعیت خوب، افزایش یابد.
در مورد محدودیت سهمیه ایجاد پروژه به موارد زیر توجه کنید:
این محدودیت مختص فایربیس نیست . محدودیتهای فایربیس در سهمیه پروژه مشابه محدودیتهای Google Cloud است .
چند برنامه Firebase میتوانم در یک پروژه Firebase داشته باشم؟
یک پروژه Firebase یک ظرف برای برنامههای Firebase در سراسر اپل، اندروید و وب است. Firebase تعداد کل برنامههای Firebase را در یک پروژه Firebase به 30 محدود میکند.
بعد از این تعداد، عملکرد شروع به کاهش میکند (بهخصوص برای Google Analytics ) و در نهایت، در تعداد بیشتری از برنامهها، برخی از قابلیتهای محصول از کار میافتند. علاوه بر این، اگر از ورود به سیستم گوگل به عنوان ارائهدهنده احراز هویت استفاده کنید، یک شناسه کلاینت OAuth 2.0 اساسی برای هر برنامه در پروژه شما ایجاد میشود. محدودیتی در حدود 30 شناسه کلاینت وجود دارد که میتوان در یک پروژه واحد ایجاد کرد.
شما باید اطمینان حاصل کنید که تمام برنامههای Firebase درون یک پروژه Firebase واحد، از دیدگاه کاربر نهایی، انواع پلتفرم یک برنامه مشابه هستند. به عنوان مثال، اگر یک برنامه با برچسب سفید توسعه میدهید، هر برنامه با برچسب مستقل باید پروژه Firebase مخصوص به خود را داشته باشد، اما نسخههای اپل و اندروید آن برچسب میتوانند در یک پروژه باشند. راهنماییهای دقیقتر را در بهترین شیوههای کلی ما برای راهاندازی پروژههای Firebase بخوانید.
در موارد نادری که پروژه شما به بیش از 30 برنامه نیاز دارد، میتوانید درخواست افزایش محدودیت برنامه را بدهید. برای ارائه این درخواست، پروژه شما باید در طرح قیمتگذاری Blaze باشد. برای ارائه درخواست و ارزیابی آن، به کنسول Google Cloud مراجعه کنید. برای کسب اطلاعات بیشتر در مورد مدیریت سهمیه به مستندات Google Cloud مراجعه کنید.
اگر پروژهام را به عنوان یک محیط «تولید» برچسبگذاری کنم، چه اتفاقی میافتد؟
در کنسول Firebase ، میتوانید پروژههای فایربیس خود را با نوع محیط آنها، چه به عنوان محیطهای تولیدی و چه به عنوان محیطهای نامشخص (غیر تولیدی)، برچسبگذاری کنید.
برچسبگذاری پروژه شما به عنوان یک نوع محیط هیچ تاثیری بر نحوه عملکرد یا ویژگیهای پروژه Firebase شما ندارد. با این حال، این برچسبگذاری میتواند به شما و تیمتان کمک کند تا پروژههای مختلف Firebase خود را برای چرخه عمر برنامه مدیریت کنید.
اگر پروژه خود را به عنوان یک محیط تولید برچسبگذاری کنید، ما یک برچسب Prod با رنگ روشن به پروژه در کنسول Firebase اضافه میکنیم و به شما یادآوری میکنیم که هرگونه تغییری میتواند بر برنامههای تولید مرتبط شما تأثیر بگذارد. در آینده، ممکن است ویژگیها و اقدامات حفاظتی بیشتری برای پروژههای Firebase که به عنوان محیطهای تولید برچسبگذاری شدهاند، اضافه کنیم.
برای تغییر نوع محیط پروژه Firebase خود، به مسیر زیر بروید:settingsپروژه > عمومی ، سپس در کارت پروژه شما در زیر محیط ، برای تغییر نوع محیط، روی edit کلیک کنید.
از کجا میتوانم شناسه برنامه (App ID) برنامه Firebase خود را پیدا کنم؟
در کنسول Firebase ، به مسیر زیر بروید:settingsپروژه . به کارت «برنامههای شما» بروید و روی برنامه Firebase مربوطه کلیک کنید تا اطلاعات برنامه، از جمله شناسه برنامه آن، را مشاهده کنید.
در اینجا چند نمونه از مقادیر شناسه برنامه آورده شده است:
هر یک از نقشهای فایربیس زیر: مالک یا مدیر فایربیس
هر یک از سطوح دسترسی Google Play زیر: مالک حساب یا مدیر
برای لینک کردن برنامه AdMob خود، باید هم مالک پروژه Firebase و هم مدیر AdMob باشید.
برای پیوند دادن حساب AdWords خود، باید هم مالک پروژه Firebase و هم مدیر AdWords باشید.
برای لینک کردن پروژه BigQuery خود، باید مالک پروژه Firebase باشید.
مجوزها و دسترسیها به پروژههای فایربیس
چگونه میتوانم به یک عضو پروژه نقشی، مانند نقش مالک، اختصاص دهم؟
برای مدیریت نقش(های) اختصاص داده شده به هر عضو پروژه، شما باید مالک پروژه Firebase باشید (یا نقشی با مجوز resourcemanager.projects.setIamPolicy به شما اختصاص داده شده باشد).
در اینجا مکانهایی وجود دارد که میتوانید نقشها را تعیین و مدیریت کنید:
کنسول Google Cloud مجموعهای گسترده از ابزارها را برای اختصاص نقشها به اعضای پروژه در صفحه IAM & AdminIAM ارائه میدهد. همچنین میتوانید نقشهای سفارشی ایجاد و مدیریت کنید و به حسابهای سرویس اجازه دسترسی به پروژه خود را بدهید.
توجه داشته باشید که در کنسول Google Cloud ، اعضای پروژه، مدیران اصلی (Principal) نامیده میشوند.
اگر مالک پروژه شما دیگر نمیتواند وظایف یک مالک را انجام دهد (مثلاً شخصی که شرکت شما را ترک کرده است) و پروژه شما از طریق یک سازمان Google Cloud مدیریت نمیشود (به پاراگراف بعدی مراجعه کنید)، میتوانید با پشتیبانی Firebase تماس بگیرید و در مورد نحوه درخواست دسترسی به پروژه Firebase با آنها مشورت کنید.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، ممکن است مالک نداشته باشد. اگر نمیتوانید مالکی برای پروژه Firebase خود پیدا کنید، با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا یک مالک برای پروژه تعیین کند.
چگونه میتوانم مالک یک پروژه Firebase را پیدا کنم؟
شما میتوانید اعضای پروژه و نقشهای آنها را در مکانهای زیر مشاهده کنید:
اگر در کنسول Firebase به پروژه دسترسی ندارید ، بررسی کنید که آیا در کنسول Google Cloud به پروژه دسترسی دارید یا خیر. میتوانید لیست اعضای پروژه، از جمله مالکان، را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر مالک پروژه شما دیگر نمیتواند وظایف یک مالک را انجام دهد (برای مثال، شخصی که شرکت شما را ترک کرده است) و پروژه شما از طریق یک سازمان Google Cloud مدیریت نمیشود (به پاراگراف بعدی مراجعه کنید)، میتوانید با پشتیبانی Firebase تماس بگیرید تا یک مالک موقت به شما اختصاص داده شود.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، ممکن است مالک نداشته باشد. در عوض، شخصی که سازمان Google Cloud شما را مدیریت میکند، میتواند بسیاری از وظایفی را که یک مالک میتواند انجام دهد، انجام دهد. با این حال، برای انجام چندین وظیفه خاص مالک (مانند اختصاص نقشها یا مدیریت ویژگیهای Google Analytics )، ممکن است مدیر نیاز داشته باشد که نقش مالک واقعی را برای انجام آن وظایف به خود اختصاص دهد. اگر نمیتوانید مالکی برای پروژه Firebase خود پیدا کنید، با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا یک مالک برای پروژه تعیین کند.
چرا یا چه زمانی باید به یکی از اعضای پروژه نقش مالک (Owner) را اختصاص دهم؟
برای اطمینان از مدیریت صحیح یک پروژه Firebase، باید یک مالک (Owner) داشته باشد.
اعضای پروژه با نقش مالک اغلب تنها اعضای پروژه هستند که میتوانند وظایف مدیریتی را انجام دهند یا اعلانهای مهم را دریافت کنند :
اعضای پروژه با نقش مالک اغلب تنها اعضایی هستند که میتوانند اقدامات مهم مدیریتی (مانند اختصاص نقشها و مدیریت ویژگیهای Google Analytics ) را انجام دهند، و پشتیبانی Firebase فقط میتواند درخواستهای مدیریتی از مالکان پروژههای مشخصشده را انجام دهد.
اعضای پروژه با نقش مالک اغلب تنها اعضایی هستند که (به طور پیشفرض) اعلانهایی در مورد تغییرات پروژه یا محصولات (مانند تغییرات صورتحساب و قانونی، منسوخ شدن ویژگیها و غیره) دریافت میکنند. اگر میخواهید اعضای خاص یا اضافی پروژه اعلانها را دریافت کنند، میتوانید به صورت اختیاری «مخاطبین ضروری» پروژه خود را سفارشی کنید .
پس از اینکه مالک(گان) یک پروژه Firebase را تعیین کردید، بهروز نگه داشتن این وظایف بسیار مهم است.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، فردی که سازمان Google Cloud شما را مدیریت میکند میتواند بسیاری از وظایفی را که یک مالک میتواند انجام دهد، انجام دهد. با این حال، برای چندین وظیفه خاص مالک (مانند اختصاص نقشها یا مدیریت ویژگیهای Google Analytics )، ممکن است مدیر نیاز داشته باشد که نقش مالک واقعی را برای انجام آن وظایف به خود اختصاص دهد.
فکر نمیکنم پروژه فایربیس داشته باشم، اما ایمیلی در مورد یکی از آنها دریافت کردهام. چگونه میتوانم به این پروژه دسترسی پیدا کنم؟
ایمیلی که دریافت کردهاید باید حاوی لینکی برای باز کردن پروژه Firebase شما باشد. با کلیک روی لینک موجود در ایمیل، پروژه در کنسول Firebase باز میشود.
اگر نمیتوانید پروژه موجود در لینک را باز کنید، مطمئن شوید که با همان حساب گوگلی که ایمیل مربوط به پروژه را دریافت کردهاید، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول، وارد و از آن خارج شوید.
توجه داشته باشید که اگر شما مدیر یک سازمان Google Cloud هستید، ممکن است از تغییرات پروژههای Firebase در داخل سازمان خود مطلع شوید. با این حال، ممکن است مجوزهای کافی برای باز کردن پروژه Firebase را نداشته باشید. در این موارد، سادهترین راه حل این است که نقش مالک واقعی را برای خود تعیین کنید تا پروژه را باز کرده و اقدامات لازم را انجام دهید. درباره دلیل و زمان تعیین نقش مالک بیشتر بدانید.
کلیدهای API برای فایربیس
آیا کلیدهای API فایربیس مخفی هستند؟ آیا میتوان آنها را در کد یا فایلهای پیکربندی من قرار داد؟
در اینجا مهمترین نکاتی که باید در مورد کلیدهای API برای سرویسهای Firebase بدانید، آورده شده است:
عمومی از نظر طراحی : کلیدهای API برای سرویسهای Firebase فقط پروژه و برنامه Firebase شما را به آن سرویسها معرفی میکنند . مجوز از طریق مجوزهای IAM Google Cloud ، Firebase Security Rules و Firebase App Check انجام میشود.
اعمال محدودیتها : تمام کلیدهای API ارائه شده توسط Firebase به طور خودکار به APIهای مرتبط با Firebase محدود میشوند. برای تمام کلیدهای API در پروژه شما، بسیار مهم است که محدودیتهای API مناسبی را اعمال کنید تا از استفاده غیرمجاز از سهمیه API پروژه خود جلوگیری کنید.
فقط برای سرویسهای Firebase استفاده شود : از کلیدهای API ارائه شده توسط Firebase خود فقط برای APIهای مرتبط با Firebase استفاده کنید. اگر برنامه شما از APIهای دیگری (مثلاً Places API برای نقشهها یا Gemini Developer API ) استفاده میکند، از یک کلید API جداگانه استفاده کنید و آن را به API مربوطه محدود کنید. به طور خاص، هرگز API Gemini Developer را در لیست مجاز برای یک کلید API قابل دسترسی عمومی یا کلیدی که برای سایر سرویسها استفاده میشود، قرار ندهید.
Security Rules و App Check بسیار مهم هستند : امنیت دادههایRealtime Database ، Cloud Firestore و Cloud Storage شما با استفاده از Firebase Security Rules اعمال میشود و حفاظت از APIهای تحت پوشش توسط Firebase App Check انجام میشود - نه با مخفی نگه داشتن کلید API Firebase شما.
اگر تنظیمات برنامه شما از دستورالعملهای بالا پیروی میکند، نیازی نیستکلیدهای API محدود به سرویسهای Firebase به عنوان اطلاعات محرمانه در نظر گرفته شوند و میتوان آنها را با خیال راحت در کد یا فایلهای پیکربندی خود قرار داد.
من ایمیلی از Google Cloud در مورد «کلید API گوگل برای پروژه Google Cloud شما که برای عموم قابل دسترسی است» دریافت کردم. چه کاری باید انجام دهم؟
اگر ایمیلی از Google Cloud در مورد «کلید API گوگل برای پروژه Google Cloud شما که در دسترس عموم است» دریافت کردهاید و کلید API ذکر شده در ایمیل، کلید API فایربیس شماست ، مطمئن شوید که کلید API الزامات زیر را برآورده میکند تا بتوانید آن را با خیال راحت در کد یا فایلهای پیکربندی خود قرار دهید. میتوانید موارد زیر را در صفحه APIها و خدمات > اعتبارنامهها در کنسول Google Cloud تأیید کنید.
این کلید API است که شما برای برنامه Firebase خود و فقط برای سرویسهای Firebase استفاده میکنید. این کلیدها معمولاً Browser key (auto created by Firebase) یا Android key (auto created by Firebase) یا iOS key (auto created by Firebase) نامیده میشوند.
مرورگرهای پشتیبانی شده برای دسترسی به کنسول Firebase کدامند؟
کنسول Firebase از طریق نسخههای اخیر مرورگرهای دسکتاپ محبوب مانند کروم، فایرفاکس، سافاری و اج قابل دسترسی است. مرورگرهای موبایل به طور کامل پشتیبانی نمیشوند.
میتوانم کنسول Firebase را بارگذاری کنم، اما چرا نمیتوانم پروژه Firebase خود را پیدا کنم یا به آن دسترسی داشته باشم؟
این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:
کنسول Firebase یک صفحه خطا برمیگرداند که میگوید پروژه شما ممکن است وجود نداشته باشد یا اینکه شما به پروژه دسترسی ندارید.
کنسول Firebase ، حتی وقتی شناسه پروژه یا نام پروژه را در فیلد جستجوی کنسول وارد میکنید، پروژه شما را نمایش نمیدهد.
این مراحل عیبیابی را امتحان کنید:
ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید: https://console.firebase.google.com/project/ PROJECT-ID /overview
اگر هنوز نمیتوانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت میکنید، موارد زیر را بررسی کنید:
مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
مطمئن شوید که یکی از نقشهای اصلی IAM (مالک، ویرایشگر، مشاهدهگر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریفشده Firebase ، به شما اختصاص داده شده است. میتوانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.
اگر هیچ یک از مراحل عیبیابی بالا شما را قادر به یافتن یا دسترسی به پروژهتان نکرد، با پشتیبانی Firebase تماس بگیرید.
چرا کنسول Firebase برای من بارگذاری نمیشود؟
این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:
بارگذاری یک صفحه در کنسول Firebase هرگز تمام نمیشود.
دادههای درون یک صفحه آنطور که انتظار میرود بارگیری نمیشوند.
هنگام بارگذاری کنسول Firebase پیامهای خطای مرورگر دریافت میکنید.
این مراحل عیبیابی را امتحان کنید:
ردیف کنسول در داشبورد وضعیت فایربیس را برای هرگونه وقفه احتمالی در سرویس بررسی کنید.
اگر هیچ یک از مراحل عیبیابی بالا مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید.
زبان کنسول Firebase من چگونه تعیین میشود؟
تنظیم زبان کنسول Firebase بر اساس زبانی است که در تنظیمات حساب گوگل شما انتخاب شده است.
برای تغییر ترجیح زبان خود، به تغییر زبان مراجعه کنید.
کنسول Firebase از زبانهای زیر پشتیبانی میکند:
انگلیسی
پرتغالی برزیلی
فرانسوی
آلمانی
اندونزیایی
ژاپنی
کره ای
روسی
چینی سادهشده
اسپانیایی
چینی سنتی
کنسول Firebase از چه نقشها و مجوزهایی پشتیبانی میکند؟
کنسول Firebase و کنسول Google Cloud از نقشها و مجوزهای اساسی یکسانی استفاده میکنند. برای کسب اطلاعات بیشتر در مورد نقشها و مجوزها به مستندات Firebase IAM مراجعه کنید.
مالک پروژه میتواند اعضای دیگری را به پروژه اضافه کند، یکپارچهسازیها را تنظیم کند (پروژه به سرویسهایی مانند BigQuery یا Slack متصل شود) و دسترسی کامل به ویرایش پروژه داشته باشد.
یک ویرایشگر پروژه، دسترسی کامل به ویرایش پروژه دارد.
یک نمایشگر پروژه فقط دسترسی خواندن پروژه را دارد. توجه داشته باشید که کنسول Firebase کنترلهای ویرایش رابط کاربری را از نمایشگرهای پروژه پنهان/غیرفعال نمیکند، اما این عملیات برای اعضای پروژه که نقش نمایشگر به آنها اختصاص داده شده است، با شکست مواجه خواهد شد.
فایربیس همچنین از موارد زیر پشتیبانی میکند:
نقشهای از پیش تعریفشدهی فایربیس — نقشهای منتخب مختص فایربیس که کنترل دسترسی جزئیتری نسبت به نقشهای پایهی مالک، ویرایشگر و مشاهدهگر فراهم میکنند.
نقشهای سفارشی — نقشهای IAM کاملاً سفارشیسازیشدهای که شما ایجاد میکنید تا مجموعهای از مجوزها را متناسب با الزامات خاص سازمان شما تنظیم کنند.
«تجربه برنامه نمونه» کنسول چگونه کار میکند؟ چه اتفاقی میافتد و چه کاری میتوانم انجام دهم؟
کنسول Firebase یک تجربه برنامه نمونه ارائه میدهد تا شما یک برنامه کاربردی واقعی برای کاوش و آزمایش با فایربیس و سایر سرویسهای گوگل (مانند Gemini API ) داشته باشید.
راهاندازی و استقرار خودکار Firebase از برنامه نمونه
وقتی تجربه برنامه نمونه را در کنسول Firebase مرور میکنید، ما به طور خودکار موارد زیر را برای شما انجام میدهیم:
یک پروژه Firebase جدید برای برنامه نمونه خود ایجاد کنید
یک برنامه وب Firebase را در پروژه جدید Firebase ثبت کنید
سرویسها و APIهایی را که توسط برنامه نمونه استفاده میشوند فعال کنید (برای مثال، Firebase Authentication ، Cloud Firestore و غیره)
منابع مورد نیاز را فراهم کنید (برای مثال، نمونههای پایگاه داده و قوانین امنیتی)
تنظیم Firebase AI Logic برای استفاده از Gemini Developer API
برنامه نمونه را با استفاده از Firebase Hosting روی یک URL پیشنمایش موقت مستقر کنید (به طور پیشفرض، این URL ظرف ۷ روز منقضی میشود )
کدبیس برنامه نمونه را بررسی کنید
گزینه ۱: یک نسخه شخصیسازیشده از کدبیس برنامه نمونه را در Firebase Studio باز کنید
تجربه برنامه نمونه، مسیری را برای باز کردن یک نسخه شخصیسازیشده از کدبیس برنامه نمونه در Firebase Studio (فضای کاری مبتنی بر مرورگر گوگل برای توسعه برنامه کامل) فراهم میکند. پس از راهاندازی پروژه و برنامه شما (به بالا مراجعه کنید)، میتوانید پیوندهایی به Firebase Studio را در بنرهای کنسول Firebase و در بالای برنامه مستقر شده پیدا کنید.
وقتی برنامه نمونه خود را در Firebase Studio باز میکنید، ما به طور خودکار موارد زیر را برای شما انجام میدهیم:
از همان پروژه Firebase، برنامه وب Firebase و منابع ایجاد شده در تنظیمات اولیه استفاده کنید (به بالا مراجعه کنید)
پیکربندی Firebase برنامه نمونه خود را در کدبیس (معمولاً در src/bootstrap.js ) وارد کنید.
در Firebase Studio ، میتوانید کدبیس را بررسی کنید تا نحوه تعامل با سرویسهای مختلف Firebase و Google را درک کنید.
گزینه ۲: مشاهده نسخه عمومی و غیرشخصیشده کدبیس برنامه نمونه در گیتهاب
از طرف دیگر، میتوانید نسخه عمومی و غیرشخصیشدهی کدبیس برنامهی نمونه را در گیتهاب مشاهده کنید.
«برنامهریزی با رابط برنامهنویسی Gemini» - مخزن گیتهاب
آیا فایربیس اعتبار آزمایشی رایگان برای محصولات پولی ارائه میدهد؟
سرویسهای پولی فایربیس را میتوان تحت دوره آزمایشی رایگان Google Cloud استفاده کرد. کاربران جدید Google Cloud و فایربیس میتوانند از یک دوره آزمایشی ۹۰ روزه که شامل ۳۰۰ دلار اعتبار رایگان Cloud Billing است، برای بررسی و ارزیابی محصولات و خدمات Google Cloud و فایربیس استفاده کنند.
در طول دوره آزمایشی رایگان Google Cloud ، یک حساب Cloud Billing به شما ارائه خواهد شد. هر پروژه فایربیس که به آن حساب کاربری متصل باشد، در طول دوره آزمایشی رایگان، در طرح قیمتگذاری پرداخت در حین استفاده Blaze قرار خواهد گرفت.
نگران نباشید، پیوند دادن یک پروژه فایربیس به این حساب رایگان Cloud Billing ما را قادر نمیسازد که برای استفاده فراتر از این اعتبارات، از شما هزینهای دریافت کنیم . برای استفاده فراتر از این اعتبارات، هزینهای از شما دریافت نمیشود ، مگر اینکه با ارتقاء حساب رایگان Cloud Billing خود به یک حساب پولی، صراحتاً پرداخت صورتحساب را فعال کنید. میتوانید در هر زمان در طول دوره آزمایشی، حساب خود را به یک حساب پولی ارتقا دهید. پس از ارتقاء به یک حساب پولی، همچنان میتوانید از اعتبارات باقیمانده (در دوره ۹۰ روزه) استفاده کنید.
پس از پایان دوره آزمایشی رایگان و اگر حساب Free Trial Cloud Billing خود را به یک حساب پولی ارتقا نداده باشید، پروژه Firebase شما که به آن لینک دادهاید، به طور خودکار به طرح قیمتی Spark تنزل مییابد. توجه داشته باشید که میتوانید در هر زمان دوباره به طرح قیمتی Blaze ارتقا دهید .
طرح قیمتگذاری رایگان اسپارک، مکانی عالی برای توسعه رایگان اپلیکیشن شماست. شما تمام محصولات رایگان فایربیس (مانند Analytics ، Remote Config ، Crashlytics و غیره) و مقادیر زیادی از ویژگیهای زیرساخت پولی ما را دریافت میکنید. با این حال، اگر در یک ماه تقویمی از منابع طرح قیمتگذاری اسپارک خود فراتر بروید، اپلیکیشن شما برای بقیه آن ماه غیرفعال خواهد شد. علاوه بر این، ویژگیهای Google Cloud هنگام استفاده از طرح قیمتگذاری اسپارک در دسترس نیستند.
طرح قیمت گذاری بلیز
طرح قیمتگذاری Blaze با قابلیت پرداخت به ازای استفاده، برای برنامههای تولیدی طراحی شده است. طرح قیمتگذاری Blaze همچنین به شما امکان میدهد برنامه خود را با ویژگیهای پولی Google Cloud گسترش دهید. شما فقط برای منابعی که مصرف میکنید هزینه پرداخت میکنید و به شما امکان میدهد با تقاضا مقیاسپذیری داشته باشید. ما تلاش میکنیم تا قیمتهای طرح قیمتگذاری Blaze خود را با ارائهدهندگان ابری پیشرو در صنعت رقابتی کنیم.
آیا میتوانم در هر زمانی ارتقا، کاهش یا لغو کنم؟
Yes, you can upgrade, downgrade, or cancel at any time. Note that we don't provide prorated refunds for downgrades or cancellations. This means that if you downgrade or cancel before the end of your billing period, you still pay for the remainder of the month.
How is the no-cost usage in the Blaze pricing plan different from the no-cost usage in the Spark pricing plan?
No-cost usage on the Blaze pricing plan is calculated daily. Usage limits also differ from the Spark pricing plan for Cloud Functions , phone authentication, and Test Lab .
For Cloud Functions , no-cost usage on the Blaze pricing plan is calculated at the Cloud Billing account level, not the project level and has the following limits:
2M invocations/month
400K GB-seconds/month
200K CPU-seconds/month
5 GB of networking egress/month
For phone authentication, no-cost usage on the Blaze pricing plan is calculated monthly.
For Test Lab , no-cost usage on the Blaze pricing plan has the following limits:
30 physical device minutes/day
60 virtual device minutes/day
Does the no-cost usage quota reset when I change from the Spark pricing plan to the Blaze pricing plan?
No-cost usage from the Spark pricing plan is included in the Blaze pricing plan. No-cost usage does not reset when moving to the Blaze pricing plan.
What happens to my Firebase project if I link a billing account to that project in the Google Cloud console?
If a Cloud Billing account is linked to a project in the Google Cloud console, the same project will automatically be upgraded to the Firebase pay-as-you-go Blaze pricing plan (if that project was on the no-cost Spark pricing plan).
In contrast, if an existing active Cloud Billing account is unlinked from a project in the Google Cloud console, that project will be downgraded to the Firebase no-cost Spark pricing plan.
How can I monitor my usage and billing?
You can track your usage of project resources in the Firebase console on any of the following dashboards:
For several services, you can cap your usage on the Blaze pricing plan by setting budget spend caps . Currently, the following products support spend caps: Firebase AI Logic , Firebase App Hosting , Cloud Functions for Firebase , and Firebase Extensions .
For the other products that have a paid tier of usage, you cannot cap your usage when on the Blaze pricing plan. However, we are actively evaluating options for these products.
For all products that have a paid tier of usage, you can define a budget for your project or account, and receive alerts as spending approaches those limits. Learn how to set up budget alerts .
What kind of support will I receive?
All Firebase apps, including those using no-cost plans, come with email support from Firebase staff during US Pacific business hours. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.
Do you offer open-source, nonprofit, or educational discounts?
The no-cost Spark pricing plan can be used by any type of individual or organization, including nonprofits, schools, and open-source projects. Since these plans already include generous quotas, we don't offer any special discounts or plans for open-source, nonprofit, or educational projects.
Do you offer enterprise contracts, pricing, support, or dedicated infrastructure hosting?
The pay-as-you-go Blaze pricing plan is suitable for enterprises of all sizes, and our SLA meets or exceeds the industry standard for cloud infrastructure. However, we don't offer enterprise contracts, pricing, or support, nor do we offer dedicated infrastructure hosting (that is, on-premises installations) for services like our Realtime Database . However, we're actively investigating options for adding some of these features.
Do you offer ad hoc pricing? I only want pay-as-you-go for one or two features.
We offer ad hoc pricing via the pay-as-you-go Blaze pricing plan, where you pay only for the features that you use.
How do the paid Firebase plans work with Ads ? Are there no-cost advertising credits with paid plans?
The Firebase pricing plans are separate from Ads , so there are no advertising credits without cost. As a Firebase developer, you are able to "link" your Ads account to Firebase to support conversion tracking.
All ads campaigns are managed directly in Ads , and Ads billing is managed from the Ads console.
What happened to the Flame pricing plan?
In January 2020, the Flame pricing plan ($25/mo of additional quota) was removed as an option for new sign-ups. Existing plan users were granted a grace period to migrate their projects off the Flame plan. In February 2022, the remaining projects on the Flame pricing plan were downgraded to the no-cost Spark pricing plan. بر این اساس،
Existing Spark pricing plan and Blaze pricing plan projects and any new projects can no longer switch to or sign up for the Flame plan.
If you moved an existing Flame plan project to a different pricing plan, the project cannot return to the Flame plan.
Projects downgraded to the Spark pricing plan can be upgraded to the Blaze pricing plan to resume additional paid services.
References to the Flame plan have been removed from documentation.
Do you have more questions about the Flame plan retirement? Read some of the additional FAQs below.
Want to learn about the other pricing plans offered by Firebase? Visit our Firebase pricing page . If you'd like to start moving any existing projects to another pricing plan, you can do that in the Firebase console for your project.
Additional FAQs about the Flame plan retirement
I have a project or a process or a business use case that relies on a fixed Firebase cost. What should I do?
Sign up for the Blaze pricing plan, and make sure to set budget alerts . If you use Firebase AI Logic , App Hosting , Cloud Functions for Firebase , or Firebase Extensions , we strongly recommend that you also set up budget spend caps , which will pause the applicable service if your project exceeds the budget set for that service.
May I be given special access to create new Flame plan projects?
No, Firebase isn't offering special access for projects to switch to or sign-up for the Flame plan.
I changed my Flame plan project to a different pricing plan. How do I change it back?
Switching to the Flame plan is no longer possible. For access to services provided by the Flame plan, sign up for the Blaze pricing plan, and make sure to set budget alerts . If you use Firebase AI Logic , App Hosting , Cloud Functions for Firebase , or Firebase Extensions , we strongly recommend that you also set up budget spend caps , which will pause the applicable service if your project exceeds the budget set for that service.
My project was automatically switched to a different pricing plan as part of the Flame plan retirement. What should I do?
If your project requires additional quota beyond what is provided with the Spark pricing plan, you'll need to upgrade your project to the Blaze pricing plan.
Why is the Flame plan being retired?
Over the years, we've seen declining usage of the Flame plan, and most projects that use the plan are not consuming its full value. Maintaining this pricing plan is generally not cost-effective, and we feel that we can serve everyone better if resources went to other Firebase initiatives.
حریم خصوصی
Where can I find information about privacy and security in Firebase?
Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?
Yes. Right now, this is iOS-only, but may change in the future. The Firebase Apple platforms SDK includes the FirebaseCoreDiagnostics framework by default. This framework is used by Firebase to collect SDK usage and diagnostics information to help prioritize future product enhancements. FirebaseCoreDiagnostics is optional, so if you would like to opt out of sending Firebase diagnostic logs, you can do so by unlinking the library from your application. You can browse the full source, including logged values, on GitHub
Dynamic Links : Why does my Android app access each Dynamic Link twice?
The getInvitation API clears the saved Dynamic Link to prevent it from being accessed twice. Be sure to call this API with the autoLaunchDeepLink parameter set to false in each of the deep link activities to clear it for the case when the activity is triggered outside the main activity.
Firebase App Indexing is no longer the recommended way of indexing content for display as suggested results in Google Search App. This FAQ points to other useful developer products.
Apple platforms
Universal Links are the recommended way of linking users directly from search results, websites and other apps to specific content within your app.
اندروید
Android App Links are the recommended way of linking users directly from search results, websites and other apps to specific content within your app.
You might also be interested in the following options:
App Actions : Let users launch and control Android apps with their voice, using Google Assistant.
Android Shortcuts : Provide users with quick methods to perform an action or access content in your app.
Firebase User Segmentation Storage
What is Firebase User Segmentation Storage?
Firebase User Segmentation Storage stores Firebase installation IDs and related attributes and segments as well as audience lists you've created to provide targeting information to other Firebase services that use them, such as Crashlytics , FCM , Remote Config personalization, and more.
تاریخ آخرین بهروزرسانی 2026-08-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-08-10 بهوقت ساعت هماهنگ جهانی."],[],[]]