سؤالات متداول Firebase

پروژه فایربیس چیست؟

یک پروژه 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 اضافه کنید:

• با استفاده از کنسول Firebase
• با استفاده از یک گزینه برنامه نویسی:
  • نقطه پایانی Firebase Management REST API را projects.addFirebase بنامید.
  • دستور Firebase CLI به firebase projects:addfirebase اجرا کنید.
  • از Terraform استفاده کنید.

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

ادغام فایربیس با 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 صادر کنید. برای کسب اطلاعات بیشتر، به Link BigQuery with Firebase مراجعه کنید.

مزایای زیادی در افزایش امنیت، بهبود تأخیر و صرفه‌جویی در زمان در استفاده از Google Cloud با Firebase (در مقایسه با سایر سرویس‌های ابری که در یک مکان نیستند) وجود دارد. برای جزئیات بیشتر به سایت Google Cloud مراجعه کنید.

چرا پروژه Google Cloud من برچسب firebase:enabled دارد؟

در صفحه برچسب‌ها برای پروژه خود در کنسول Google Cloud ، ممکن است برچسبی از firebase:enabled (به طور خاص، یک Key از firebase با Value enabled ) را ببینید.

فایربیس به طور خودکار این برچسب را اضافه کرده است زیرا پروژه شما یک پروژه فایربیس است، به این معنی که پروژه شما پیکربندی‌ها و سرویس‌های مخصوص فایربیس را برای آن فعال کرده است. درباره رابطه بین پروژه‌های فایربیس و 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 برای بارگذاری هزاران پروژه Google Cloud ساخته نشده است. در عوض، توصیه می‌کنیم از Firebase CLI، REST API یا Terraform برای «افزودن فایربیس» به پروژه Google Cloud موجود خود استفاده کنید .

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

چرا پروژه Firebase من در لیست پروژه‌های Firebase من نمایش داده نمی‌شود؟

این سوالات متداول در صورتی قابل استفاده است که پروژه Firebase خود را در مکان‌های زیر مشاهده نمی‌کنید:

• در فهرستی از پروژه‌هایی که در کنسول Firebase مشاهده می‌کنید
• در پاسخ حاصل از فراخوانی نقطه پایانی projects.list در REST API
• در پاسخ اجرای دستور Firebase CLI firebase projects:list

این مراحل عیب‌یابی را امتحان کنید:

1. ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید:
   https://console.firebase.google.com/project/ PROJECT_ID /overview
2. اگر نمی‌توانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت می‌کنید، موارد زیر را بررسی کنید:
   • مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شده‌اید. می‌توانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
   • بررسی کنید که آیا می‌توانید پروژه را در کنسول Google Cloud مشاهده کنید یا خیر.
   • مطمئن شوید که پروژه شما برچسب firebase:enabled در صفحه Labels برای پروژه‌تان در کنسول Google Cloud دارد. Firebase و Google Cloud از این برچسب برای فهرست کردن پروژه‌های Firebase شما استفاده می‌کنند. اگر این برچسب را نمی‌بینید اما Firebase Management API برای پروژه شما فعال است ، برچسب را به صورت دستی اضافه کنید (به طور خاص، یک Key firebase با Value enabled ).
   • مطمئن شوید که یکی از نقش‌های اصلی IAM (مالک، ویرایشگر، مشاهده‌گر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریف‌شده Firebase ، به شما اختصاص داده شده است. می‌توانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
   • اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت می‌کند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.

اگر هیچ یک از مراحل عیب‌یابی بالا به شما امکان مشاهده پروژه‌تان در فهرست پروژه‌های Firebase را نداد، با پشتیبانی Firebase تماس بگیرید.

با هر حساب گوگل (آدرس ایمیل) چند پروژه می‌توانم داشته باشم؟

• طرح قیمت‌گذاری اسپارک : سهمیه ایجاد پروژه به تعداد کمی پروژه (معمولاً حدود ۵ تا ۱۰ پروژه) محدود می‌شود.
• طرح قیمت‌گذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است، اما ممکن است با اتصال یک حساب Cloud Billing با وضعیت خوب، افزایش یابد.

در مورد محدودیت سهمیه ایجاد پروژه به موارد زیر توجه کنید:

• این محدودیت مختص فایربیس نیست . محدودیت‌های فایربیس در سهمیه پروژه مشابه محدودیت‌های Google Cloud است .
• در موارد نادری که لازم باشد، می‌توانید درخواست افزایش سهمیه پروژه را بدهید .
• حذف کامل یک پروژه به 30 روز زمان نیاز دارد و تا زمان حذف کامل پروژه، جزو سهمیه پروژه محسوب می‌شود.

با بهترین شیوه‌های عمومی توصیه‌شده توسط فایربیس برای راه‌اندازی پروژه‌های فایربیس آشنا شوید.

چند برنامه 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 پروژه خود بروید. به پایین اسکرول کنید تا به کارت «برنامه‌های شما» برسید، سپس روی برنامه فایربیس مورد نظر کلیک کنید تا اطلاعات برنامه، از جمله شناسه برنامه آن، را مشاهده کنید.

در اینجا چند نمونه از مقادیر شناسه برنامه آورده شده است:

• برنامه‌های فایربیس iOS: 1:1234567890:ios:321abc456def7890
• برنامه‌های اندروید فایربیس: 1:1234567890:android:321abc456def7890
• برنامه‌های وب فایربیس: 1:1234567890:web:321abc456def7890

پیش‌نیازهای لازم برای اتصال Google Play / AdMob / Google Ads / BigQuery به پروژه یا برنامه Firebase من چیست؟

• برای اتصال حساب Google Play خود ، به موارد زیر نیاز دارید:
  • هر یک از نقش‌های فایربیس زیر: مالک یا مدیر فایربیس
    و
  • هر یک از سطوح دسترسی Google Play زیر: مالک حساب یا مدیر
• برای لینک کردن برنامه AdMob خود، باید هم مالک پروژه Firebase و هم مدیر AdMob باشید.
• برای پیوند دادن حساب AdWords خود، باید هم مالک پروژه Firebase و هم مدیر AdWords باشید.
• برای لینک کردن پروژه BigQuery خود، باید مالک پروژه Firebase باشید.

چه اطلاعیه‌های متن‌بازی را باید در برنامه‌ام لحاظ کنم؟

در پلتفرم‌های اپل، غلاف Firebase حاوی یک فایل NOTICES است که شامل ورودی‌های مربوطه می‌شود. کیت توسعه نرم‌افزار اندروید Firebase حاوی یک Activity کمکی برای نمایش اطلاعات مجوز است.

چگونه می‌توانم به یک عضو پروژه نقشی، مانند نقش مالک، اختصاص دهم؟

برای مدیریت نقش(های) اختصاص داده شده به هر عضو پروژه، شما باید مالک پروژه Firebase باشید (یا نقشی با مجوز resourcemanager.projects.setIamPolicy به شما اختصاص داده شده باشد).

در اینجا مکان‌هایی وجود دارد که می‌توانید نقش‌ها را تعیین و مدیریت کنید:

• کنسول Firebase روشی ساده برای اختصاص نقش به اعضای پروژه در تب کاربران و مجوزها در settings > تنظیمات پروژه ارائه می‌دهد. در کنسول Firebase ، می‌توانید هر یک از نقش‌های اساسی (مالک، ویرایشگر، بیننده)، نقش‌های مدیر/بیننده فایربیس یا هر یک از نقش‌های از پیش تعریف شده دسته محصول فایربیس را اختصاص دهید.
• کنسول Google Cloud مجموعه‌ای گسترده از ابزارها را برای اختصاص نقش‌ها به اعضای پروژه در صفحه IAM ارائه می‌دهد. در کنسول Cloud ، می‌توانید نقش‌های سفارشی ایجاد و مدیریت کنید و همچنین به حساب‌های سرویس اجازه دسترسی به پروژه خود را بدهید.

  توجه داشته باشید که در کنسول Google Cloud ، اعضای پروژه، مدیران اصلی (Principal) نامیده می‌شوند.

اگر مالک پروژه شما دیگر نمی‌تواند وظایف یک مالک را انجام دهد (مثلاً شخصی که شرکت شما را ترک کرده است) و پروژه شما از طریق یک سازمان Google Cloud مدیریت نمی‌شود (به پاراگراف بعدی مراجعه کنید)، می‌توانید با پشتیبانی Firebase تماس بگیرید و در مورد نحوه درخواست دسترسی به پروژه Firebase با آنها مشورت کنید.

توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، ممکن است مالک نداشته باشد. اگر نمی‌توانید مالکی برای پروژه Firebase خود پیدا کنید، با شخصی که سازمان Google Cloud شما را مدیریت می‌کند تماس بگیرید تا یک مالک برای پروژه تعیین کند.

چگونه می‌توانم مالک یک پروژه Firebase را پیدا کنم؟

شما می‌توانید اعضای پروژه و نقش‌های آنها را در مکان‌های زیر مشاهده کنید:

• اگر در کنسول Firebase به پروژه دسترسی دارید، می‌توانید لیست اعضای پروژه، از جمله مالکان (Owners)، را در صفحه کاربران و مجوزها (Users and permissions) کنسول 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 را نداشته باشید. در این موارد، ساده‌ترین راه حل این است که نقش مالک واقعی را برای خود تعیین کنید تا پروژه را باز کرده و اقدامات لازم را انجام دهید. درباره دلیل و زمان تعیین نقش مالک بیشتر بدانید.

مرورگرهای پشتیبانی شده برای دسترسی به کنسول Firebase کدامند؟

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

می‌توانم کنسول Firebase را بارگذاری کنم، اما چرا نمی‌توانم پروژه Firebase خود را پیدا کنم یا به آن دسترسی داشته باشم؟

این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:

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

این مراحل عیب‌یابی را امتحان کنید:

1. ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید:
   https://console.firebase.google.com/project/ PROJECT-ID /overview
2. اگر هنوز نمی‌توانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت می‌کنید، موارد زیر را بررسی کنید:
   • مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شده‌اید. می‌توانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
   • مطمئن شوید که API مدیریت Firebase برای پروژه فعال شده است .
   • مطمئن شوید که یکی از نقش‌های اصلی IAM (مالک، ویرایشگر، مشاهده‌گر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریف‌شده Firebase ، به شما اختصاص داده شده است. می‌توانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
   • اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت می‌کند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.

اگر هیچ یک از مراحل عیب‌یابی بالا شما را قادر به یافتن یا دسترسی به پروژه‌تان نکرد، با پشتیبانی Firebase تماس بگیرید.

چرا کنسول Firebase برای من بارگذاری نمی‌شود؟

این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:

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

این مراحل عیب‌یابی را امتحان کنید:

1. ردیف کنسول در داشبورد وضعیت فایربیس را برای هرگونه وقفه احتمالی در سرویس بررسی کنید.
2. مطمئن شوید که از یک مرورگر پشتیبانی‌شده استفاده می‌کنید.
3. سعی کنید کنسول Firebase را در یک پنجره ناشناس یا خصوصی بارگذاری کنید.
4. غیرفعال کردن همه افزونه‌های مرورگر.
5. تأیید کنید که اتصال شبکه توسط مسدودکننده تبلیغات، آنتی‌ویروس، پروکسی، فایروال یا سایر نرم‌افزارها مسدود نشده باشد.
6. سعی کنید کنسول Firebase را با استفاده از یک شبکه یا دستگاه دیگر بارگیری کنید.
7. اگر از کروم استفاده می‌کنید، کنسول ابزارهای توسعه‌دهندگان را برای هرگونه خطا بررسی کنید.

اگر هیچ یک از مراحل عیب‌یابی بالا مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید.

زبان کنسول Firebase من چگونه تعیین می‌شود؟

تنظیم زبان کنسول Firebase بر اساس زبانی است که در تنظیمات حساب گوگل شما انتخاب شده است.

برای تغییر ترجیح زبان خود، به تغییر زبان مراجعه کنید.

کنسول Firebase از زبان‌های زیر پشتیبانی می‌کند:

• انگلیسی
• پرتغالی برزیلی
• فرانسوی
• آلمانی
• اندونزیایی
• ژاپنی
• کره ای
• روسی
• چینی ساده‌شده
• اسپانیایی
• چینی سنتی

کنسول Firebase از چه نقش‌ها و مجوزهایی پشتیبانی می‌کند؟

کنسول Firebase و کنسول Google Cloud از نقش‌ها و مجوزهای اساسی یکسانی استفاده می‌کنند. برای کسب اطلاعات بیشتر در مورد نقش‌ها و مجوزها به مستندات Firebase IAM مراجعه کنید.

فایربیس از نقش‌های اساسی (پایه‌ای) مالک، ویرایشگر و مشاهده‌گر پشتیبانی می‌کند:

• مالک پروژه می‌تواند اعضای دیگری را به پروژه اضافه کند، یکپارچه‌سازی‌ها را تنظیم کند (پروژه به سرویس‌هایی مانند BigQuery یا Slack متصل شود) و دسترسی کامل به ویرایش پروژه داشته باشد.
• یک ویرایشگر پروژه، دسترسی کامل به ویرایش پروژه دارد.
• یک نمایشگر پروژه فقط دسترسی خواندن پروژه را دارد. توجه داشته باشید که کنسول Firebase در حال حاضر کنترل‌های ویرایش رابط کاربری را از نمایشگرهای پروژه پنهان/غیرفعال نمی‌کند، اما این عملیات برای اعضای پروژه که نقش نمایشگر به آنها اختصاص داده شده است، با شکست مواجه خواهد شد.

فایربیس همچنین از موارد زیر پشتیبانی می‌کند:

• نقش‌های از پیش تعریف‌شده‌ی فایربیس — نقش‌های منتخب مختص فایربیس که کنترل دسترسی جزئی‌تری نسبت به نقش‌های پایه‌ی مالک، ویرایشگر و مشاهده‌گر فراهم می‌کنند.
• نقش‌های سفارشی — نقش‌های IAM کاملاً سفارشی‌سازی‌شده‌ای که شما ایجاد می‌کنید تا مجموعه‌ای از مجوزها را متناسب با الزامات خاص سازمان شما تنظیم کنند.

چرا گزارش‌های Emulator Suite خطایی را نشان می‌دهند که با عبارت «استفاده از چندین شناسه پروژه در حالت تک پروژه توصیه نمی‌شود» شروع می‌شود؟

این پیام به این معنی است که مجموعه شبیه‌ساز تشخیص داده است که ممکن است یک شبیه‌ساز محصول خاص را با استفاده از شناسه‌های پروژه مختلف اجرا کند. این ممکن است نشان‌دهنده یک پیکربندی نادرست باشد و می‌تواند هنگام تلاش شبیه‌سازها برای برقراری ارتباط با یکدیگر و هنگامی که شما سعی می‌کنید از کد خود با شبیه‌سازها تعامل داشته باشید، مشکلاتی ایجاد کند. اگر شناسه‌های پروژه مطابقت نداشته باشند، اغلب به نظر می‌رسد که داده‌ها از دست رفته‌اند، زیرا داده‌های ذخیره شده در شبیه‌سازها به شناسه پروژه مرتبط هستند و قابلیت همکاری به تطبیق شناسه‌های پروژه بستگی دارد.

این موضوع باعث سردرگمی رایجی در بین توسعه‌دهندگان شده است، بنابراین به‌طور پیش‌فرض Local Emulator Suite اکنون فقط اجازه اجرا با یک شناسه پروژه را می‌دهد، مگر اینکه در فایل پیکربندی firebase.json خلاف آن را مشخص کنید. اگر یک شبیه‌ساز بیش از یک شناسه پروژه را شناسایی کند، یک هشدار ثبت می‌کند و به‌طور بالقوه یک خطای مهلک ایجاد می‌کند.

اعلامیه(های) شناسه پروژه خود را برای عدم تطابق در موارد زیر بررسی کنید:

• پروژه پیش‌فرض در خط فرمان تنظیم شده است. به طور پیش‌فرض، شناسه پروژه در هنگام راه‌اندازی از پروژه انتخاب شده با firebase init یا firebase use گرفته می‌شود. برای مشاهده لیست پروژه‌ها (و دیدن اینکه کدام یک انتخاب شده است) از firebase projects:list استفاده کنید.
• تست‌های واحد. شناسه پروژه اغلب در فراخوانی متدهای کتابخانه تست واحد Rules initializeTestEnvironment یا initializeTestApp مشخص می‌شود. سایر کدهای تست ممکن است با initializeApp(config) مقداردهی اولیه شوند.
• پرچم --project در خط فرمان. ارسال پرچم --project در Firebase CLI، پروژه پیش‌فرض را لغو می‌کند. باید مطمئن شوید که مقدار این پرچم با شناسه پروژه در تست‌های واحد و مقداردهی اولیه برنامه مطابقت دارد.

مکان‌های مخصوص پلتفرم برای بررسی:

برای غیرفعال کردن حالت تک پروژه، firebase.json با کلید singleProjectMode به‌روزرسانی کنید:

{
  "firestore": {
    ...
  },
  "functions": {
    ...
  },
  "hosting": {
    ...
  },
  "emulators": {
    "singleProjectMode": false,
    "auth": {
      "port": 9099
    },
    "functions": {
      "port": 5001
    },
    ...
  }
}

کدام محصولات پولی هستند؟ کدام‌ها رایگان؟

برای اطلاعات دقیق در مورد محصولات پولی در مقابل محصولات رایگان، به طرح‌های قیمت‌گذاری Firebase مراجعه کنید.

چگونه بفهمم کدام طرح قیمت گذاری برای من مناسب است؟

برای اطلاعات دقیق در مورد طرح‌های قیمت‌گذاری، به طرح‌های قیمت‌گذاری Firebase مراجعه کنید.

طرح قیمت گذاری اسپارک

طرح اسپارک ما مکانی عالی برای توسعه رایگان اپلیکیشن شماست. شما تمام ویژگی‌های رایگان فایربیس ( Analytics ، Remote Config ، Crashlytics و غیره) و مقادیر قابل توجهی از ویژگی‌های زیرساخت پولی ما را دریافت می‌کنید. با این حال، اگر در یک ماه تقویمی از منابع طرح اسپارک خود فراتر بروید، اپلیکیشن شما برای مدت باقی‌مانده آن ماه غیرفعال خواهد شد. علاوه بر این، ویژگی‌های Google Cloud هنگام استفاده از طرح اسپارک در دسترس نیستند.

طرح قیمت گذاری بلیز

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

آیا می‌توانم در هر زمانی ارتقا، تنزل یا لغو کنم؟

بله، شما می‌توانید در هر زمانی ارتقا، تنزل یا لغو اشتراک را انجام دهید. توجه داشته باشید که ما برای تنزل یا لغو اشتراک، بازپرداخت متناسب ارائه نمی‌دهیم. این بدان معناست که اگر قبل از پایان دوره صورتحساب خود، اشتراک خود را تنزل یا لغو کنید، همچنان هزینه باقیمانده ماه را پرداخت خواهید کرد.

استفاده رایگان در طرح Blaze چه تفاوتی با استفاده رایگان در طرح Spark دارد؟

استفاده رایگان در طرح Blaze روزانه محاسبه می‌شود. محدودیت‌های استفاده برای Cloud Functions ، احراز هویت تلفنی و Test Lab نیز با طرح Spark متفاوت است.

برای Cloud Functions ، استفاده رایگان در طرح Blaze در سطح حساب Cloud Billing محاسبه می‌شود، نه در سطح پروژه و محدودیت‌های زیر را دارد:

• ۲ میلیون فراخوانی در ماه
• ۴۰۰ هزار گیگابایت ثانیه در ماه
• ۲۰۰ هزار ثانیه CPU در ماه
• ۵ گیگابایت فضای شبکه در ماه

برای احراز هویت از طریق تلفن، هزینه استفاده رایگان در طرح Blaze ماهانه محاسبه می‌شود.

برای Test Lab ، استفاده رایگان در طرح Blaze محدودیت‌های زیر را دارد:

• ۳۰ دقیقه استفاده فیزیکی از دستگاه در روز
• ۶۰ دقیقه مجازی دستگاه در روز

آیا سهمیه استفاده رایگان هنگام تغییر از طرح Spark به Blaze بازنشانی می‌شود؟

استفاده رایگان از طرح Spark در طرح Blaze نیز لحاظ شده است. استفاده رایگان با انتقال به طرح Blaze بازنشانی نمی‌شود.

اگر یک حساب پرداخت را در کنسول Google Cloud به پروژه Firebase خود پیوند دهم، چه اتفاقی برای آن پروژه می‌افتد؟

اگر یک حساب Cloud Billing به یک پروژه در کنسول Google Cloud متصل باشد، همان پروژه به طور خودکار به طرح Firebase pay-as-you-go Blaze ارتقا می‌یابد (اگر آن پروژه در حال حاضر در طرح Spark باشد).

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 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:

• Overall project-level Usage and billing dashboard
• Authentication Usage dashboard (specifically for Phone authentication instances)
• Cloud Firestore Usage dashboard
• Cloud Functions Usage dashboard
• Cloud Storage Usage dashboard
• Hosting Usage dashboard
• Realtime Database Usage dashboard

Can I cap usage on the Blaze plan?

No, you cannot currently cap your Blaze plan usage. We are evaluating options for supporting caps on Blaze plan usage.

Blaze users can define a budget for their project or account, and receive alerts as their 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?

Our Spark 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?

Our Blaze plan is suitable for enterprises of all sizes, and our SLA meets or exceeds the industry standard for cloud infrastructure. However, we do not currently offer enterprise contracts, pricing, or support, nor do we offer dedicated infrastructure hosting (that is, on-premises installations) for services like our Realtime Database . We are hard at work 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 in the Blaze plan, where you pay only for the features 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 Spark pricing plan.
بر این اساس،

• Existing Spark and Blaze 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 plan can be upgraded to the Blaze 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

Where can I find information about privacy and security in Firebase?

Check out the page Privacy and Security in Firebase .

Do the Firebase SDKs log any usage/diagnostic information outside of Analytics?

Yes. This is currently 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

A/B Testing : How many experiments can I create and run?

You are allowed up to 300 experiments per project, which could consist of up to 24 running experiments, with the rest as draft or completed.

A/B Testing : Why can't I view my experiments after unlinking and re-linking my project to Google Analytics?

Linking to a different Google Analytics property will cause you to lose access to experiments created beforehand. To regain access to a previous experiment, re-link your project to the Google Analytics property that was linked when the experiment was created.

A/B Testing : Why do I receive a "Project not linked to Google Analytics" message when creating a Remote Config experiment?

If you've already linked Firebase and Google Analytics , but still see a message that Google Analytics is not linked, make sure that an Analytics stream exists for all apps in your project. Currently, all apps in a project must be connected to a Google Analytics stream to use A/B Testing.

You can find the list of all active streams on the Google Analytics integration details page within the Firebase console, accessed from settings Project Settings chevron_right Integrations chevron_right Google Analytics chevron_right Manage .

Creating a Google Analytics stream for any app that does not have one should resolve the issue. There are a few ways to create streams for missing apps:

• If you only have one or two apps missing an associated Google Analytics stream, you can choose one of the following methods to add a Google Analytics stream:
  • Delete and re-add any app without an active stream in the Firebase console.
  • From the Google Analytics console , select Admin , click Data Streams , then click Add stream , add the missing app's details, and click Register app .
• If you have more than a few missing app streams, unlinking and relinking your Google Analytics property is the fastest and most efficient way to create the missing app streams:
  1. From settings Project Settings , select Integrations .
  2. Within the Google Analytics card, click Manage to access Firebase and Google Analytics settings.
  3. Make a note of the Google Analytics Property ID and the Linked Google Analytics account .
  4. Click more_vert More and select Unlink Analytics from this project .
  5. Review the warning that appears (don't worry here; you will relink the same property in the next step), then click Unlink Google Analytics .
     
     When unlinking is complete, you'll be redirected to the Integrations page.
  6. Within the Google Analytics card, click Enable to begin the relinking process.
  7. Select your Analytics account from the Select account list.
  8. Next to Automatically create a new property in this account , click edit Edit and, from the Analytics property list that appears, select your property ID.
     
     A list of all apps in your project appears. Existing stream mappings for each app are listed, and apps that do not have a stream will have one created for them.
  9. Click Enable Google Analytics to relink the property.
  10. Click Finish .

If you still receive an error creating A/B Tests with Remote Config after performing these steps, contact Firebase Support .

AdMob : Can I link my Windows apps to Firebase?

No, Windows apps are not currently supported.

AdMob : Why can't I link my app to AdMob from the Firebase console?

You can link an AdMob app to a Firebase app via the AdMob console. Learn how.

AdMob : What permissions or access do I need to link a Firebase app to an AdMob app?

In order to do this linking, you need the following access:

• AdMob : You need to be an AdMob admin.
• Firebase : You must have the firebase.links.create permission, which is included in the Owner role and the Firebase Admin role .
• Google Analytics : You must have the Edit role or Manage Users role for the property associated with the Firebase project. Learn more.

AdMob : Can multiple users in the same AdMob account link AdMob apps and Firebase apps?

For multi-user AdMob accounts , the user who created the first Firebase link and accepted the Firebase Terms of Service is the only user who can create new links between AdMob apps and Firebase apps.

AdMob : To use AdMob , which SDKs should I use?

To use AdMob , always use the Google Mobile Ads SDK as described in this FAQ. Additionally and optionally, if you want to collect user metrics for AdMob , then include the Firebase SDK for Google Analytics in your app.

• For iOS projects :
  Import the Google Mobile Ads SDK by following the instructions in the AdMob iOS documentation .
• For Android projects :
  Add the dependency for the Google Mobile Ads SDK to your build.gradle file:
  implementation 'com.google.android.gms:play-services-ads:24.7.0'
  
• For C++ projects and Unity projects : Follow the instructions in the respective documentation.

Analytics : Why is Google Analytics a recommended part of using Firebase products?

Google Analytics is a free and unlimited analytics solution that works with Firebase features to deliver powerful insights. It enables you to view event logs in Crashlytics , notification effectiveness in FCM , deep link performance for Dynamic Links , and in-app purchase data from Google Play . It powers advanced audience targeting in Remote Config , Remote Config personalization, and more.

Google Analytics acts as a layer of intelligence in the Firebase console to provide you with more actionable insights about how to develop a high quality app, grow your user base, and earn more money.

To get started, read the documentation .

Analytics : How do I control how my Analytics data is shared with the rest of Firebase?

By default, your Google Analytics data is used to enhance other Firebase and Google features. You can control how your Google Analytics data is shared in your project settings anytime. Learn more about Data sharing settings .

Analytics : How do I update my Analytics property settings?

From the Admin page in your Google Analytics property, you can update your property settings, such as:

• Data sharing settings
• Data retention settings
• Time zone and currency settings

To update your property settings, follow these steps:

1. In the Firebase console, go to your settings > Project settings .
2. Go to the Integrations tab, and then in the Google Analytics card, click Manage or View link .
3. Click the link for your Google Analytics account to open the account and property settings .

Analytics on-device measurement in my iOS app: How was the Analytics SDK updated for on-device conversion measurement support, and am I required to upgrade?

Before our release updating on-device conversion measurement using event data, developers had to manually include multiple SDK modules to use on-device measurement capabilities, a time-consuming process. As a result, we updated the existing default SDK module ( FirebaseAnalytics ) to include on-device conversion measurement capabilities as well for Google Ads.

If you install the default Google Analytics for Firebase iOS SDK, your app can also benefit from on-device conversion measurement capabilities .

If you've pinned the SDK to a specific version, update to version 11.14.0 or higher and release a new version of your app.

* - This configuration will include On-Device Conversion Measurement (Event Data) as well. If needed, you can disable the feature by setting the value of GOOGLE_ADS_ON_DEVICE_CONVERSION_EVENT_DATA_ENABLED to NO (Boolean) in your app's Info.plist file.

Analytics in my iOS app: Can I install Analytics without ad attribution and IDFA collection features?

Yes. See the Configure Data Collection and Usage page for more details.

Analytics : What changed in the Google Analytics section with the October 2021 update?

You can find a summary of these changes in the Firebase Help Center article New Google Analytics 4 functionality in Google Analytics for Firebase .

Analytics : Why don't I see any Analytics data in the Firebase console after unlinking Firebase from Google Analytics?

Analytics data resides within the Google Analytics property — not within the Firebase project. If you delete or unlink the property, then the Analytics data will not be accessible to Firebase and you'll see an empty Analytics dashboard in the Firebase console. Note that since the data still resides in the previously linked property, you can always relink the property to Firebase and see the Analytics data in the Firebase console.

Linking a brand new Google Analytics account (and thus a new Google Analytics property) to your Firebase project will result in an empty Analytics dashboard in the Firebase console. However, if your previously linked property still exists, then you can move the existing data from the old property to the new property.

Analytics : If my Analytics property and its data were deleted, is there any way to get them back?

No. If your property has been deleted, it isn't possible to undelete the property or retrieve the previously collected Analytics data stored in that property.

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Analytics : If my Analytics property was deleted, can I link a new Google Analytics property to my Firebase project and start using Analytics again?

If you'd like to start using Google Analytics again, you can link either a new property or an existing property to your Firebase project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a Google Analytics property to your Firebase project.

Note that since all Analytics data is stored in the property (not the Firebase project), the previously collected Analytics data cannot be retrieved.

Analytics : How will Firebase products or integrated Google products be affected by the deletion of my Analytics property?

Several Firebase products rely on the Google Analytics integration. If your Analytics property and its data are deleted, the following will happen if you use the following products:

• Crashlytics — You can no longer see crash-free users, breadcrumb logs, and/or velocity alerts.
• Cloud Messaging and In-App Messaging — You can no longer use targeting, campaign metrics, audience segmentation, and analytics labels.
• Remote Config — You can no longer use targeted configurations or Personalization.
• A/B Testing — You can no longer use A/B Testing since the experiment measurement is supplied by Google Analytics.
• Dynamic Links — Any feature that relies on data from Google Analytics will be disrupted.

In addition, the following integrations will be affected:

• You can no longer export Analytics data to BigQuery .
• You can no longer take advantage of Google Ads integrations or Google AdMob integrations .

Analytics: Can I move Analytics data from one Firebase project to another project?

No, it isn't possible to directly move Analytics data from one Firebase project to another project. However, you can export and combine data from both projects into a single location, such as BigQuery for analysis.

While moving existing data isn't possible, you can link an existing Analytics property to a new Firebase project and start collecting data from then on in that new project. You can do this linking in either the Firebase console or the Google Analytics UI. Learn more about linking a property to your Firebase project .

Analytics : How do I segment users who have not met some criterion?

You can reframe the problem by "negatively targeting" these users. For example, reframe the problem as "Don't show ads to people who have bought something", and form an audience of those users to target.

Analytics : Are audiences and/or events defined in the Google Analytics interface also available in the Firebase console?

Your audiences and user properties will be synced. For some features, you'll need to use the Google Analytics interface, such as segmentation and closed funnels. You can access the Google Analytics interface directly via deep-links from the Firebase console.

Any changes you make from the Firebase console can also be performed in Google Analytics, and those changes will be reflected in Firebase.

Firebase Authentication : Which regions are supported for phone authentication?

Firebase Authentication supports phone number verification globally, but not all networks reliably deliver verification messages. The following regions have good rates of delivery, and should be expected to work well for phone authentication. Where noted, some carriers are unavailable in a region due to poor delivery success rates.

Firebase Authentication : What happened to the free SMS on the Spark plan?

Starting September 2024, to improve the security and service quality of Phone Authentication, Firebase projects must be linked to a Cloud Billing account to enable and use the SMS Service.

Cloud Messaging : What's the difference between the Notifications composer and Cloud Messaging ?

Firebase Cloud Messaging provides a complete set of messaging capabilities through its client SDKs and HTTP server protocol. For deployments with more complex messaging requirements, FCM is the right choice.

The Notifications composer is a lightweight, serverless messaging solution built on Firebase Cloud Messaging . With a user-friendly graphical console and reduced coding requirements, the Notifications composer lets users easily send messages to reengage and retain users, foster app growth, and support marketing campaigns.

Cloud Messaging : Apple announced they're deprecating the legacy binary protocol for APNs. Do I need to do anything?

No. Firebase Cloud Messaging switched to the HTTP/2-based APNs protocol in 2017. If you are using FCM to send notifications to iOS devices, there should be no action required on your part.

Cloud Messaging : Do I need to use other Firebase services in order to use FCM ?

You can use Firebase Cloud Messaging as a standalone component, in the same manner as you did with GCM, without using other Firebase services.

Cloud Messaging : I am an existing Google Cloud Messaging (GCM) developer. Should I move to Firebase Cloud Messaging ?

FCM is the new version of GCM under the Firebase brand. It inherits GCM's core infrastructure, with new SDKs to make Cloud Messaging development easier.

Benefits of upgrading to FCM SDK include:

• Simpler client development. You no longer have to write your own registration or subscription retry logic.
• An out-of-the-box notification solution. You can use the Notifications composer, a serverless notifications solution with a web console that lets anyone send notifications to target specific audiences based on insights from Google Analytics.

To upgrade from GCM SDKs to FCM SDKs, see the guides for migrating Android and iOS apps.

Cloud Messaging : Why do my targeted devices apparently fail to receive messages?

When it looks like devices haven't successfully received messages, check first for these two potential causes:

Foreground message handling for notification messages . Client apps need to add message handling logic to handle notification messages when the app is in the foreground on the device. See the details for iOS and Android .

Network firewall restrictions . If your organization has a firewall that restricts the traffic to or from the Internet, you need to configure it to allow connectivity with FCM in order for your Firebase Cloud Messaging client apps to receive messages. The ports to open are:

• ۵۲۲۸
• ۵۲۲۹
• 5230

FCM usually uses 5228, but it sometimes uses 5229 and 5230. FCM does not provide specific IPs, so you should allow your firewall to accept outgoing connections to all IP addresses contained in the IP blocks listed in Google's ASN of 15169 .

Cloud Messaging : I have implemented onMessageReceived in my Android app, but it is not being called.

When your app is in the background, notification messages are displayed in the system tray, and onMessageReceived is not called. For notification messages with a data payload, the notification message is displayed in the system tray, and the data that was included with the notification message can be retrieved from the intent launched when the user taps on the notification.

For more information, see Receive and handle messages .

Cloud Messaging : How does an app instance restored from a backup work with FCM?

One FCM token is connected to an app on one device. FCM data is excluded from backup, so an app instance restored from a backup is treated as a new app instance from FCM's perspective. Device users have to open a restored app to be able to get a new FCM token.

To avoid conflict with the original app instance, we also recommend developers to exclude Firebase installation data from backup. The Firebase installation data is stored in a PersistedInstallation....json file. The file name is a constant for an app. For example <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Notifications composer: I am an existing Google Cloud Messaging (GCM) developer, and I want to use the Notifications composer. What should I do?

The Notifications composer is an out-of-the-box solution that lets anyone send notifications to target specific audiences based on insights from Google Analytics. Also, the Notifications composer provides funnel analysis for every message, allowing easy evaluation of notification effectiveness.

If you are an existing GCM developer, to use the Notifications composer you have to upgrade from GCM SDKs to FCM SDKs. See the guides for migrating Android and iOS apps.

How do I notify a large customer base within 2 minutes?

Unfortunately, this use case cannot be supported. You must spread your traffic out over 5 minutes.

My app notifies users of events, and these messages must be delivered immediately to support my business model. Can I get more quota?

Unfortunately, we cannot grant quota increases for this reason. You must spread your traffic out over 5 minutes.

My messages are about scheduled events. How can I send all my traffic at the top of the hour?

We recommend that you start sending the notifications at least 5 minutes prior to the event.

How long will it take for my quota request to be fulfilled?

This depends a bit on your use of FCM. In any case, you can expect an answer in a few business days. In some cases, there may be some back-and-forth regarding your usage of FCM and various circumstances, which can prolong the process. If all requirements are met, most requests will be handled within 2 weeks.

How can I monitor my quota usage?

See Google Cloud guidance on how to chart and monitor quota metrics .

429s are hard for me / my business to deal with. Can I get an exemption or more quota to avoid getting 429s?

While we understand that quota limits can be challenging, quotas are vital to keeping the service reliable and we can't grant exemptions.

Can I get more quota for a temporary event?

You may request additional quota to support an event lasting up to 1 month. File the request at least 1 month in advance of the event and with clear details on when the event starts and ends, and FCM will make every practical effort to fulfill the request (no increase can be guaranteed). These quota increases will be reverted after the event's end date.

Is my current quota subject to change?

While Google will not do so lightly, quotas may be changed as needed to protect the integrity of the system. When possible, Google will notify you in advance of such changes.

Cloud Storage for Firebase : Why can't I use Cloud Storage for Firebase ?

Cloud Storage for Firebase creates a default bucket in the App Engine no-cost tier. This allows you to quickly get up and running with Firebase and Cloud Storage for Firebase , without having to put in a credit card or enable a Cloud Billing account. It also allows you to easily share data between Firebase and a Google Cloud project.

There are, however, two known cases where this bucket cannot be created and you will be unable to use Cloud Storage for Firebase :

• A project imported from Google Cloud which had a App Engine Master/Slave Datastore application.
• A project imported from Google Cloud which has domain prefixed projects. For example: domain.com:project-1234 .

There are currently no workarounds to these issues, and we recommend that you create a new project in the Firebase console and enable Cloud Storage for Firebase in that project.

Cloud Storage for Firebase : Why do I get error code 412 responses about service account permissions and failed service account operations when using the Cloud Storage for Firebase API?

It's likely you're getting 412 error codes either because the Cloud Storage for Firebase API is not enabled for your project or a necessary service account is missing the required permissions.

See the related FAQ .

Cloud Storage for Firebase : On Spark plan projects, can I store executable files?

For no-cost (Spark) plan projects, Firebase blocks uploads and hosting of certain executable file types for Windows, Android and Apple by Cloud Storage for Firebase and Firebase Hosting . This policy exists to prevent abuse on our platform.

Serving, hosting and file uploads of disallowed files are blocked for all Spark projects created on or after Sept 28th, 2023. For existing Spark projects with files uploaded before that date, such files can still be uploaded and hosted.

This restriction applies to Spark plan projects. Projects on the pay as you go (Blaze) plan are not affected.

The following file types cannot be hosted on Firebase Hosting and Cloud Storage for Firebase :

• Windows files with .exe , .dll and .bat extensions
• Android files with .apk extension
• Apple platform files with .ipa extension

چه کاری باید انجام دهم؟

If you still want to host these file types after September 28th, 2023:

• For Hosting: upgrade to the Blaze plan before you can deploy these file types to Firebase Hosting via the firebase deploy command.
• For Storage: upgrade to the Blaze plan to upload these file types to the bucket of your choice using the GCS CLI, the Firebase console, or Google Cloud console.

Use Firebase tools to manage your Firebase Hosting and Cloud Storage resources.

• For managing resources in Firebase Hosting , use the Firebase console to delete releases according to this guide .
• For managing resources in Cloud Storage , navigate to the Storage product page in your project.
1. On the Files tab, locate disallowed files to delete in your folder hierarchy, then select them using the checkbox next to the filename(s) on the left-hand side of the panel.
2. Click Delete , and confirm the files were deleted.

Please refer to our documentation for additional information on managing Hosting resources with Firebase tools and Cloud Storage for Firebase buckets with client libraries .

Cloud Storage for Firebase : Why do I see an unexpected increase in upload and download operations?

Previously, download and upload requests to the Cloud Storage for Firebase API were not being counted properly. We have taken steps to fix this issue, starting from September 15, 2023.

For Blaze users, upload and download operations will start counting towards your monthly bill. For Spark users, they will start counting towards your monthly free limit.

We recommend monitoring your Usage page for any increases that may count towards your limits.

Cloud Storage for Firebase : Why do I see new service account IDs associated with my Firebase projects that use Cloud Storage for Firebase ?

Firebase uses service accounts to operate and manage services without sharing user credentials. When you create a Firebase project, you might notice that a number of service accounts are already available in your project.

The service account that Cloud Storage for Firebase uses is scoped to your project and is named
service- PROJECT_NUMBER @gcp-sa-firebasestorage.iam.gserviceaccount.com .

If you used Cloud Storage for Firebase before September 19, 2022, you may see an additional service account on previously-linked Cloud Storage buckets named firebase-storage@system.gserviceaccount.com . As of September 19, 2022, this service account is no longer supported.

You can view all service accounts associated with your project in the Firebase console, on the Service accounts tab .

Adding the new service account

If you removed the service account previously or the service account is not present in your project, you may do one of the following to add the account.

• (Recommended) Automated: Use the AddFirebase REST endpoint to re-import your bucket into Firebase. You will only need to call this endpoint once, not once for each linked bucket.
• Manual: Follow the steps in Creating and managing service accounts . Following that guide, add a service account with the IAM role Cloud Storage for Firebase Service Agent , and service account name
  service- PROJECT_NUMBER @gcp-sa-firebasestorage.iam.gserviceaccount.com .

Removing the new service account

We strongly discourage you from removing the service account because this may block access to your Cloud Storage buckets from your apps. To remove the service account from your project, follow the instructions in Disabling a service account .

How do I predict how much I will be billed for upload and download operations?

Visit the Firebase Pricing page and use the Blaze plan calculator . The calculator lists all the usage types for Cloud Storage for Firebase .

Use the sliders to input the expected usage of your Storage bucket. The calculator will estimate your monthly bill.

What happens if I exceed Spark plan upload, download or storage limits for Cloud Storage for Firebase ?

When you exceed limits for Cloud Storage in a project on the Spark plan, the result depends on the type of limit that you exceed:

• If you exceed the GB stored limit, you will not be able to store any more data in that project unless you remove some of the data stored or upgrade to a plan that provides more storage space, or unlimited storage space.
• If you exceed the GB downloaded limit, your app will not be able to download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.
• If you exceed the upload or download operations limit, your app will not be able to upload or download more data until the next day (starting at midnight, US Pacific Time), unless you upgrade to a plan with less restrictive limits, or with no limits.

Dynamic Links : What are Firebase's future plans for Dynamic Links ?

See Dynamic Links FAQ .

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.

Hosting : On Spark plan projects, can I store executable files?

For no-cost (Spark) plan projects, Firebase blocks uploads and hosting of certain executable file types for Windows, Android and Apple by Cloud Storage for Firebase and Firebase Hosting . This policy exists to prevent abuse on our platform.

Serving, hosting and file uploads of disallowed files are blocked for all Spark projects created on or after Sept 28th, 2023. For existing Spark projects with files uploaded before that date, such files can still be uploaded and hosted.

This restriction applies to Spark plan projects. Projects on the pay as you go (Blaze) plan are not affected.

The following file types cannot be hosted on Firebase Hosting and Cloud Storage for Firebase :

• Windows files with .exe , .dll and .bat extensions
• Android files with .apk extension
• Apple platform files with .ipa extension

چه کاری باید انجام دهم؟

If you still want to host these file types after September 28th, 2023:

• For Hosting: upgrade to the Blaze plan before you can deploy these file types to Firebase Hosting via the firebase deploy command.
• For Storage: upgrade to the Blaze plan to upload these file types to the bucket of your choice using the GCS CLI, the Firebase console, or Google Cloud console.

Use Firebase tools to manage your Firebase Hosting and Cloud Storage resources.

• For managing resources in Firebase Hosting , use the Firebase console to delete releases according to this guide .
• For managing resources in Cloud Storage , navigate to the Storage product page in your project.
1. On the Files tab, locate disallowed files to delete in your folder hierarchy, then select them using the checkbox next to the filename(s) on the left-hand side of the panel.
2. Click Delete , and confirm the files were deleted.

Please refer to our documentation for additional information on managing Hosting resources with Firebase tools and Cloud Storage for Firebase buckets with client libraries .

Hosting : Why does my Hosting release history table in the Firebase console show file counts that are more than what my local project actually has?

Firebase automatically adds extra files containing metadata about the Hosting site, and these files are included in the total file count for the release.

Hosting : What's the largest file size that I can deploy to Firebase Hosting ?

Hosting has a maximum size limit of 2 GB for individual files.

We recommend storing larger files using Cloud Storage , which offers a maximum size limit in the terabyte range for individual objects.

Hosting : How many Hosting sites can I have per Firebase project?

The Firebase Hosting multisite feature supports a maximum of 36 sites per project.

Performance Monitoring : How many custom URL patterns can I create?

You can create up to 400 total custom URL patterns per app and up to 100 custom URL patterns per domain for that app.

Performance Monitoring : Why am I not seeing real time display of performance data?

To view real time performance data, make sure that your app uses a Performance Monitoring SDK version that's compatible with real time data processing.

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Realtime Database : What is a "simultaneous database connection"?

A simultaneous connection is equivalent to one mobile device, browser tab, or server app connected to the database. Firebase imposes hard limits on the number of simultaneous connections to your app's database. These limits are in place to protect both Firebase and our users from abuse.

The Spark plan limit is 100 and cannot be raised. The Flame and Blaze plans have a limit of 200,000 simultaneous connections per database.

This limit isn't the same as the total number of users of your app, because your users don't all connect at once. If you need more than 200,000 simultaneous connections, please read Scale with Multiple Databases .

Realtime Database : What are the scaling limitations of the Realtime Database ?

Each Realtime Database instance has limits on the number of write operations per second. For small writes, this limit is approximately 1000 write operations per second. If you are approaching this limit, batching operations using multi-path updates can help you achieve higher throughput.

In addition, each database instance has a cap on the number of simultaneous database connections . Our default limits are large enough for most applications. If you are building an app that requires additional scale, you may need to shard your application across multiple database instances for added scale. You may also consider Cloud Firestore as an alternative database.

Realtime Database : What can I do if I'm over my Realtime Database usage limits?

If you've received an email alert or notification in the Firebase console that you've exceeded your Realtime Database usage limits, you can address it based on the usage limit you've exceeded. To see your Realtime Database usage, go to the Realtime Database Usage dashboard in the Firebase console.

If you're over your download limit, you can upgrade your Firebase pricing plan or wait until your download limit resets at the start of your next billing cycle. To decrease your downloads, try the following steps:

• Add queries to limit the data that your listen operations return.
• Check for unindexed queries.
• Use listeners that only download updates to data — for example, on() instead of once() .
• Use security rules to block unauthorized downloads.

If you're over your storage limit, upgrade your pricing plan to avoid service disruptions. To reduce the amount of data in your database, try the following steps:

• Run periodic cleanup jobs.
• Reduce any duplicate data in your database.

Note that it may take some time to see any data deletions reflected in your storage allotment.

If you're over your simultaneous database connections limit, upgrade your plan to avoid any service disruptions. To manage simultaneous connections to your database, try connecting via users via the REST API if they don't require a realtime connection.

Realtime Database : What happens if I exceed Spark plan storage or download limits for Realtime Database ?

To provide you with a predictable price, the resources available to you in the Spark plans are capped. This means that when you exceed any plan limit in any month, your app will be turned off to prevent any further resource usage and additional charges.

Realtime Database : What happens if I exceed Spark plan simultaneous connection limits for Realtime Database ?

When your app reaches its concurrency limit on the Spark plan, any subsequent connections will be rejected until some of the existing connections are closed. The app will continue to work for users who are connected.

Realtime Database : What are automated backups? Do you offer hourly backups for Realtime Database ?

Automated backups are an advanced feature for customers on our Blaze pricing plan that backs up your Firebase Realtime Database data once a day and uploads it to Google Cloud Storage .

We do not offer hourly backups.

Realtime Database : Why was my Realtime Database reported bandwidth lower than average between September 2016 and March 2017?

For our bandwidth calculations, we normally include SSL encryption overhead (based on layer 5 of the OSI model). However, in September 2016, we introduced a bug that caused our bandwidth reporting to ignore encryption overhead. This might have resulted in artificially low reported bandwidth and bills on your account for a few months.

We released a fix for the bug in late March 2017, returning bandwidth reporting and billing to their normal levels.

Remote Config : Why don't fetched values change the behavior and appearance of my app?

Unless you fetch values with fetchAndActivate() , values are stored locally but not activated. To activate fetched values so that they can take effect, call activate . This design lets you control when the behavior and appearance of your app changes, because you can choose when to call activate . After you call activate , your app source code determines when updated parameter values are used.

For example, you could fetch values and then activate them the next time a user starts your app, which removes the need to delay app startup while your app waits for fetched values from the service. Changes to your app's behavior and appearance then occur when your app uses the updated parameter values.

To learn more about the Remote Config API and usage model, see Remote Config API Overview .

Remote Config : I am making a lot of fetch requests while developing my app. Why doesn't my app always get the latest values from the service when it sends fetch requests?

During app development, you might want to fetch and activate configs very frequently (many times per hour) to let you rapidly iterate as you develop and test your app. To accommodate rapid iteration on a project with up to 10 developers, you can temporarily set a FirebaseRemoteConfigSettings object with a low minimum fetch interval ( setMinimumFetchIntervalInSeconds ) in your app.

Remote Config : How quickly does the Remote Config service return fetched values after my app sends a fetch request?

Devices usually receive fetched values in less than a second, and often receive fetched values in milliseconds. The Remote Config service handles fetch requests within milliseconds, but the time required to complete a fetch request will depend on the network speed of the device and the latency of the network connection used by the device.

If your goal is to make fetched values take effect in your app as soon as possible, but without creating a jarring user experience, consider adding calls to fetchAndActivate each time that your app does a full screen refresh.

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.