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

پروژه Firebase چیست؟

پروژه Firebase موجودیت سطح بالایی برای Firebase است. در یک پروژه، می توانید اپلیکیشن های اپل، اندروید یا وب خود را ثبت کنید. پس از ثبت برنامه های خود در Firebase، می توانید SDK های Firebase خاص محصول را به برنامه خود اضافه کنید، مانند Analytics، Cloud Firestore، Crashlytics یا Remote Config.

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

در اینجا چند منبع برای کسب اطلاعات بیشتر در مورد پروژه های Firebase آورده شده است:

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

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

سازمان Google Cloud چیست؟

سازمان Google Cloud محفظه‌ای برای پروژه‌های Google Cloud (از جمله پروژه‌های Firebase) است. این سلسله مراتب سازماندهی، مدیریت دسترسی و ممیزی بهتر پروژه های Google Cloud و Firebase را امکان پذیر می کند. برای اطلاعات بیشتر به ایجاد و مدیریت سازمان ها مراجعه کنید.

چگونه Firebase را به پروژه Google Cloud موجود اضافه کنم؟

ممکن است پروژه‌های موجود را از طریق Google Cloud Console یا کنسول Google APIs مدیریت کنید. به طور پیش‌فرض، این پروژه‌ها در کنسول Firebase قابل مشاهده هستند، اما پروژه‌های Firebase محسوب نمی‌شوند.

برای افزودن Firebase به پروژه Google Cloud موجود خود، روی Add Project در صفحه فرود کنسول Firebase کلیک کنید، سپس پروژه خود را در منوی Project name انتخاب کنید.

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

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

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

ما قویاً توصیه می کنیم که این برچسب را اصلاح یا حذف نکنید. این برچسب توسط Firebase و Google Cloud برای فهرست کردن پروژه‌های Firebase شما استفاده می‌شود (به عنوان مثال، از طریق نقطه پایانی REST API projects.list یا در منوهای داخل کنسول Firebase).

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

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

اگر پروژه Firebase خود را در مکان‌های زیر نمی‌بینید، این سؤالات متداول قابل اجرا است:

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

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

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

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

در هر حساب چند پروژه می توانم داشته باشم؟

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

محدودیت در سهمیه پروژه به ندرت برای اکثر توسعه دهندگان نگران کننده است، اما در صورت نیاز، می توانید درخواست افزایش سهمیه پروژه خود را داشته باشید .

توجه داشته باشید که حذف کامل یک پروژه به 30 روز زمان نیاز دارد و تا حذف کامل سهمیه شما به حساب می آید.

چند برنامه Firebase می توانم در یک پروژه Firebase داشته باشم؟

پروژه Firebase محفظه ای برای برنامه های Firebase در سراسر اپل، اندروید و وب است. Firebase تعداد کل برنامه های Firebase را در پروژه Firebase به 30 محدود می کند.

پس از این تعداد، عملکرد شروع به کاهش می کند (مخصوصاً برای Google Analytics) و در نهایت در تعداد بیشتری از برنامه ها، برخی از عملکردهای محصول کار نمی کنند. علاوه بر این، افزودن یک برنامه Firebase به یک پروژه، یک یا چند شناسه مشتری OAuth 2.0 را ایجاد می کند. حدود 30 شناسه مشتری وجود دارد که می توان در یک پروژه ایجاد کرد.

باید اطمینان حاصل کنید که همه برنامه‌های Firebase در یک پروژه Firebase، انواع پلتفرم یک برنامه از دیدگاه کاربر نهایی هستند. به عنوان مثال، اگر یک برنامه white label توسعه می‌دهید، هر برنامه دارای برچسب مستقل باید پروژه Firebase خود را داشته باشد، اما نسخه‌های Apple و Android آن برچسب می‌توانند در همان پروژه باشند. راهنمای دقیق‌تر را در بهترین شیوه‌های کلی ما برای راه‌اندازی پروژه‌های Firebase بخوانید.

در موارد نادری که پروژه شما به بیش از 30 برنامه نیاز دارد، می توانید درخواست افزایش محدودیت برنامه کنید. برای ارائه این درخواست، پروژه شما باید در برنامه قیمت گذاری Blaze باشد. برای ارائه درخواست خود و ارزیابی آن از Google Cloud Console دیدن کنید. درباره مدیریت سهمیه در اسناد Google Cloud بیشتر بیاموزید.

اگر پروژه خود را به عنوان یک محیط "تولید" برچسب گذاری کنم چه اتفاقی می افتد؟

در کنسول Firebase، می‌توانید پروژه‌های Firebase خود را با نوع محیط آن‌ها به عنوان محیط‌های تولیدی یا نامشخص (غیر تولیدی) برچسب‌گذاری کنید.

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

اگر پروژه خود را به‌عنوان یک محیط تولید برچسب‌گذاری کنید، یک تگ Prod با رنگ روشن به پروژه در کنسول Firebase اضافه می‌کنیم و به شما یادآوری می‌کنیم که هر گونه تغییری می‌تواند بر برنامه‌های تولید مرتبط شما تأثیر بگذارد. در آینده، ممکن است ویژگی‌ها و حفاظت‌های بیشتری را برای پروژه‌های Firebase که به عنوان محیط‌های تولید برچسب‌گذاری شده‌اند، اضافه کنیم.

برای تغییر نوع محیط پروژه Firebase خود، به settings Project settings > General بروید، سپس در Your project card در قسمت Environment ، روی edit کلیک کنید تا نوع محیط را تغییر دهید.

از کجا می توانم شناسه برنامه را برای برنامه Firebase خود پیدا کنم؟

در کنسول Firebase، به settings خود ، تنظیمات پروژه بروید. به سمت پایین به کارت برنامه های شما بروید، سپس روی برنامه Firebase مورد نظر کلیک کنید تا اطلاعات برنامه، از جمله شناسه برنامه آن را مشاهده کنید.

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

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

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

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

چه اعلان های منبع باز را باید در برنامه خود قرار دهم؟

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

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

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

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

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

  توجه داشته باشید که در Google Cloud Console، به اعضای پروژه ، اصلی گفته می شود.

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

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

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

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

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

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

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

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

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

پس از تنظیم مالک(ها) برای پروژه Firebase، مهم است که آن تکالیف را به روز نگه دارید.

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

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

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

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

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

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

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

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

اگر با یکی از مشکلات زیر مواجه هستید، این سؤالات متداول قابل اجرا است:

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

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

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

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

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

اگر با هر یک از مشکلات زیر مواجه هستید، این سؤالات متداول قابل اجرا است:

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

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

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

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

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

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

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

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

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

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

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

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

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

Firebase همچنین پشتیبانی می کند:

• نقش‌های از پیش تعریف‌شده Firebase - نقش‌های خاص Firebase انتخاب‌شده که کنترل دسترسی دقیق‌تری را نسبت به نقش‌های اصلی Owner، Editor و Viewer فعال می‌کنند.
• نقش‌های سفارشی - نقش‌های IAM کاملاً سفارشی‌سازی‌شده که شما ایجاد می‌کنید تا مجموعه‌ای از مجوزها را مطابق با الزامات خاص سازمان شما تنظیم کنید.

کدام محصولات پرداخت می شوند؟ کدام بدون هزینه هستند؟

محصولات زیرساخت پولی Firebase عبارتند از: پایگاه داده بیدرنگ، فضای ذخیره سازی ابری برای Firebase، توابع ابری، میزبانی، آزمایشگاه تست و احراز هویت تلفن. ما یک ردیف بدون هزینه برای همه این ویژگی ها ارائه می دهیم.

Firebase همچنین دارای بسیاری از محصولات بدون هزینه است: Analytics، Cloud Messaging، Notifications composer، Remote Config، App Indexing، Dynamic Links و Crash Reporting. شما می توانید مقدار نامحدودی از هر یک از این محصولات را در همه طرح ها از جمله طرح Spark بدون هزینه ما استفاده کنید. علاوه بر این، تمام ویژگی‌های احراز هویت فراتر از احراز هویت تلفن، بدون هزینه هستند.

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

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

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

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

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

چگونه می توانم استفاده و صورتحساب خود را کنترل کنم؟

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

• داشبورد استفاده و صورتحساب در سطح پروژه کلی
• داشبورد استفاده از احراز هویت (مخصوصاً برای موارد احراز هویت تلفن)
• داشبورد Cloud Firestore Usage
• داشبورد استفاده از توابع ابری
• داشبورد استفاده از فضای ذخیره‌سازی ابری
• داشبورد استفاده از هاستینگ
• داشبورد استفاده از پایگاه داده بیدرنگ

طرح قیمت گذاری شعله چه شد؟

در ژانویه 2020، طرح قیمت گذاری Flame (25 دلار در ماه سهمیه اضافی) به عنوان گزینه ای برای ثبت نام های جدید حذف شد. به کاربران طرح موجود مهلتی اعطا شد تا پروژه های خود را به خارج از طرح Flame منتقل کنند. در فوریه 2022، پروژه‌های باقی‌مانده در طرح قیمت‌گذاری Flame به طرح قیمت‌گذاری اسپارک تنزل یافتند.
بر این اساس،

• پروژه های موجود طرح Spark و Blaze و هر پروژه جدید دیگر نمی توانند به طرح Flame تغییر یا ثبت نام کنند.
• اگر یک پروژه طرح Flame موجود را به یک طرح قیمت گذاری متفاوت منتقل کنید، پروژه نمی تواند به طرح Flame برگردد.
• پروژه هایی که به طرح Spark تنزل داده شده اند را می توان به طرح Blaze ارتقا داد تا خدمات پولی اضافی از سر گرفته شود.
• ارجاع به طرح شعله از اسناد حذف شده است.

آیا سؤال بیشتری در مورد بازنشستگی طرح شعله دارید؟ برخی از سؤالات متداول اضافی را در زیر بخوانید.

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

سوالات متداول اضافی درباره بازنشستگی طرح شعله

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

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

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

• 2 میلیون فراخوان در ماه
• 400 هزار گیگابایت ثانیه در ماه
• 200K CPU-ثانیه در ماه
• 5 گیگابایت خروجی شبکه در ماه

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

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

• 30 دقیقه دستگاه فیزیکی در روز
• 60 دقیقه دستگاه مجازی در روز

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

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

"اتصال همزمان پایگاه داده" چیست؟

یک اتصال همزمان معادل یک دستگاه تلفن همراه، برگه مرورگر یا برنامه سرور متصل به پایگاه داده است. Firebase محدودیت های سختی را برای تعداد اتصالات همزمان به پایگاه داده برنامه شما اعمال می کند. این محدودیت‌ها برای محافظت از Firebase و کاربران ما در برابر سوء استفاده وجود دارد.

سقف طرح اسپارک 100 است و قابل افزایش نیست. طرح های Flame و Blaze دارای محدودیت 200000 اتصال همزمان در هر پایگاه داده هستند.

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

اگر از محدودیت‌های فضای ذخیره‌سازی یا بارگیری Spark برای پایگاه داده بیدرنگ تجاوز کنم، چه اتفاقی می‌افتد؟

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

اگر از محدودیت های اتصال همزمان طرح Spark برای پایگاه داده بیدرنگ تجاوز کنم چه اتفاقی می افتد؟

وقتی برنامه شما به محدودیت همزمانی خود در طرح Spark رسید، هر گونه اتصال بعدی تا زمانی که برخی از اتصالات موجود بسته نشود، رد می شود. این برنامه برای کاربرانی که متصل هستند به کار خود ادامه خواهد داد.

اگر از محدودیت‌های بارگذاری، بارگیری یا فضای ذخیره‌سازی طرح Spark برای فضای ذخیره‌سازی ابری تجاوز کنم، چه اتفاقی می‌افتد؟

وقتی از محدودیت‌های ذخیره‌سازی ابری در پروژه‌ای در طرح Spark فراتر می‌روید، نتیجه به نوع محدودیتی که از آن فراتر می‌روید بستگی دارد:

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

ادغام Firebase با Google Cloud چگونه کار می کند؟

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

• برخی از محصولات 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 Console اضافه یا حذف کنم، برای پروژه Firebase من چه اتفاقی می‌افتد؟

اگر یک حساب Cloud Billing به پروژه ای در Google Cloud Console اضافه شود، اگر آن پروژه در حال حاضر در طرح Spark باشد، همان پروژه به طور خودکار به طرح Firebase Blaze ارتقا می یابد.

در مقابل، اگر یک حساب فعال Cloud Billing از پروژه‌ای در Google Cloud Console حذف شود، آن پروژه به طرح Firebase Spark تنزل داده می‌شود.

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

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

چه نوع حمایتی دریافت خواهم کرد؟

همه برنامه‌های Firebase، از جمله برنامه‌هایی که از طرح‌های بدون هزینه استفاده می‌کنند، با پشتیبانی ایمیل کارکنان Firebase در ساعات کاری اقیانوس آرام ایالات متحده ارائه می‌شوند. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.

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 are automated backups? Do you offer hourly backups?

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.

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.

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.

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, should I use the Firebase SDK for AdMob or the Google Mobile Ads SDK?

• For iOS projects , use the Google Mobile Ads SDK:
  pod 'Google-Mobile-Ads-SDK'
• For Android projects , use the Google Mobile Ads SDK:
  implementation 'com.google.android.gms:play-services-ads:21.5.0'

  Note that the Firebase Android SDKs for AdMob transitively include the Firebase SDK for Google Analytics. So, if your app calls any Google Analytics APIs and you switch to using the Google Mobile Ads SDK, make sure that you explicitly add the dependency for the Firebase SDK for Google Analytics ( com.google.firebase:firebase-analytics ) to your app's build.gradle file.

• 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 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: Why don't I see any data after unlinking my app from Google Analytics?

Your analytics data resides within the Google Analytics property - not within the Firebase project. If you delete or unlink the property, then your data is unlinked from your project as well. The data still resides in that property, however, and you can always relink it to your project.
Creating a new Google Analytics account (and new property) will result in having a blank analytics dashboard in the Firebase console.

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.

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: What is the new fully upgraded Google Analytics account?

You can read more about the new Google Analytics upgrade in our blog post .

Analytics: How do I know if I'm using Google Analytics for Firebase or a fully upgraded Google Analytics account?

If you see a link to "View your data in Google Analytics" from the analytics dashboard in the Firebase console, then your project is using a fully upgraded Google Analytics account.

You can also check by viewing the Google Analytics card in the Firebase console (you can access this from settings > Project Settings > Integrations , then click Manage ). If you see a Linked Google Analytics account listed in the Your Google Analytics property section, your project is using the full Google Analytics experience in Firebase. If you do not see a Linked Google Analytics account , your project is using Google Analytics for Firebase.

Analytics: When must I upgrade my Google Analytics for Firebase property to retain service?

Any Firebase project created before July 31, 2019 must be upgraded to the full Google Analytics 4 experience if it hasn't already. (Banners display in the Analytics dashboard if an upgrade is required.) The associated Terms of Service must be accepted by February 15, 2022 to ensure data collection continues and by March 15, 2022 to prevent the deletion of the Analytics property and its data. If you no longer want to use Google Analytics and the associated data, no action is required and the property will be deleted on March 15, 2022.

Failure to accept the new Google Analytics Terms of Service will disrupt Firebase features, including Crash-Free Users (Crashlytics), targeted Configurations and Remote Config personalization, A/B Testing features, Targeting and Campaign Metrics (Cloud Messaging). It will also disrupt Google Analytics for Firebase Integrations , including Exporting project data to BigQuery , Google Ads Integrations , and AdMob Integrations .

If you have questions about accessing your Firebase project, including finding or assigning an Owner, review the Permissions and access to Firebase projects FAQs .

Analytics: What will happen to my data when I upgrade to the new Google Analytics for Firebase?

This will not affect your existing Firebase project analytics data in the Firebase console.

You will be able to continue using the same dashboard and workflows you are using today, and you will also have access to some advanced features in Google Analytics.

Note that if you decide to enable cross-device reporting after making the upgrade, your data will be de-duplicated using the UserID. This may decrease some user counts in the Firebase console.

Analytics: Why do I get an error when trying to upgrade my project to the new Google Analytics experience?

If you are experiencing an error when upgrading, such as:

  The operation has failed (Reason: Requested entity
  already exists)
  

or

  The operation has failed (Reason: Precondition check failed)
  

This means that there is an association between your project and an already existing Google Analytics property. You can unlink the property, delete it, or upgrade through the Google Analytics interface.

If this is still an issue, you can use the REST API to unlink by using the removeAnalytics method , then use the addGoogleAnalytics method to link a new property.

You can then move the data from one property to another .

Firebase Authentication: Which countries are supported for phone authentication?

Firebase Authentication supports phone number verification across the the world, but not all networks reliably deliver our verification messages. The following countries have good rates of delivery, and should be expected to work well for phone number sign in.

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 and XMPP server protocols. 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 for Firebase.

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:

• 5228
• 5229
• 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 .

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

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.

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

Here's a comparison of the messaging capabilities provided by Firebase Cloud Messaging and the Notifications composer:

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 for Firebase. 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.

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

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.

Why do Emulator Suite logs show an error starting with "Multiple projectIds are not recommended in single project mode"?

This message means the Emulator Suite has detected it may be running a particular product emulator using different project IDs. This may indicate a misconfiguration, and can cause issues when emulators try to communicate with one another, and when you try to interact with emulators from your code. If project IDs don't match, it often appears that data is missing, since data stored in emulators is keyed to projectID, and interoperability depends on matching project IDs.

This has been a common source of confusion among developers, so by default the Local Emulator Suite will now only allow running with a single project ID, unless you specify otherwise in the firebase.json configuration file. If an emulator detects more than one project ID, it will log a warning and potentially throw a fatal error.

Check your project ID declaration(s) for mismatches in:

• The default project set at the command line. By default, the project ID will be taken on startup from the project selected with firebase init or firebase use . To view the list of projects (and see which one is selected) use firebase projects:list .
• Unit tests. The project ID is often specified in calls to the Rules Unit Testing library methods initializeTestEnvironment or initializeTestApp . Other testing code may initialize with initializeApp(config) .
• The command line --project flag. Passing the Firebase CLI --project flag overrides the default project. You'll need to ensure the value of the flag matches the project ID in unit tests and app initialization.

Platform-specific places to check:

To disable single project mode, update firebase.json with the singleProjectMode key:

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

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

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.

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.