یک پروژه Firebase، نهاد سطح بالای Firebase است. در یک پروژه، میتوانید برنامههای Apple، Android یا وب خود را ثبت کنید. پس از ثبت برنامههای خود در Firebase، میتوانید SDK های Firebase مخصوص محصول مانند Analytics ، Cloud Firestore ، Crashlytics یا Remote Config را به برنامه خود اضافه کنید.
شما باید انواع برنامههای اپل، اندروید و وب خود را در یک پروژه Firebase ثبت کنید. میتوانید از چندین پروژه Firebase برای پشتیبانی از محیطهای مختلف، مانند توسعه، مرحلهبندی و تولید، استفاده کنید.
در اینجا چند منبع برای یادگیری بیشتر در مورد پروژههای Firebase آورده شده است:
درک پروژههای فایربیس - مروری مختصر بر چندین مفهوم مهم در مورد پروژههای فایربیس، از جمله ارتباط آنها با Google Cloud و سلسله مراتب اساسی یک پروژه و برنامهها و منابع آن، ارائه میدهد.
بهترین شیوههای عمومی برای راهاندازی پروژههای Firebase — بهترین شیوههای عمومی و سطح بالا را برای راهاندازی پروژههای Firebase و ثبت برنامههای شما در یک پروژه ارائه میدهد تا گردش کار توسعه واضحی داشته باشید که از محیطهای مجزا استفاده میکند.
توجه داشته باشید که برای همه پروژههای Firebase، Firebase به طور خودکار برچسب firebase:enabled در صفحه برچسبها برای پروژه شما در کنسول Google Cloud اضافه میکند. برای کسب اطلاعات بیشتر در مورد این برچسب به سوالات متداول ما مراجعه کنید.
سازمان Google Cloud چیست؟
یک سازمان Google Cloud یک ظرف برای پروژههای Google Cloud (از جمله پروژههای Firebase) است. این سلسله مراتب امکان سازماندهی بهتر، مدیریت دسترسی و حسابرسی پروژههای Google Cloud و Firebase شما را فراهم میکند. برای اطلاعات بیشتر، به ایجاد و مدیریت سازمانها مراجعه کنید.
چگونه میتوانم Firebase را به یک پروژه Google Cloud موجود اضافه کنم؟
ممکن است پروژههای موجود Google Cloud شما از طریق کنسول Google Cloud یا کنسول گوگل APIs مدیریت شوند.
شما میتوانید با استفاده از هر یک از گزینههای زیر، فایربیس را به این پروژههای موجود Google Cloud اضافه کنید:
فایربیس عمیقاً با Google Cloud یکپارچه شده است. پروژهها بین فایربیس و Google Cloud به اشتراک گذاشته میشوند، بنابراین پروژهها میتوانند سرویسهای فایربیس و Google Cloud را فعال داشته باشند. میتوانید از کنسول Firebase یا کنسول Google Cloud به یک پروژه دسترسی داشته باشید. به طور خاص:
برخی از محصولات Firebase مستقیماً توسط Google Cloud پشتیبانی میشوند، مانند Cloud Storage for Firebase . فهرست محصولاتی که توسط Google Cloud پشتیبانی میشوند، به مرور زمان افزایش خواهد یافت.
بسیاری از تنظیمات شما، از جمله همکاران و اطلاعات صورتحساب، توسط Firebase و Google Cloud به اشتراک گذاشته میشوند. میزان استفاده شما از Firebase و Google Cloud در یک صورتحساب نمایش داده میشود.
علاوه بر این، وقتی به طرح قیمتگذاری پرداخت در محل Blaze ارتقا میدهید، میتوانید از هر یک از زیرساختهای به عنوان سرویس و APIهای درجه یک Google Cloud مستقیماً در پروژه Firebase خود، با قیمت استاندارد Google Cloud استفاده کنید. همچنین میتوانید دادهها را از Google Cloud مستقیماً برای تجزیه و تحلیل به BigQuery صادر کنید. برای کسب اطلاعات بیشتر، به پیوند BigQuery با Firebase مراجعه کنید.
مزایای زیادی در افزایش امنیت، بهبود تأخیر و صرفهجویی در زمان در استفاده از Google Cloud با Firebase (در مقایسه با سایر سرویسهای ابری که در یک مکان نیستند) وجود دارد. برای جزئیات بیشتر به سایت Google Cloud مراجعه کنید.
چرا پروژه Google Cloud من برچسب firebase:enabled دارد؟
در صفحه برچسبها برای پروژه خود در کنسول Google Cloud ، ممکن است برچسبی از firebase:enabled (به طور خاص، یک Key از firebase با Valueenabled ) را ببینید.
فایربیس به طور خودکار این برچسب را اضافه کرده است زیرا پروژه شما یک پروژه فایربیس است، به این معنی که پروژه شما پیکربندیها و سرویسهای مخصوص فایربیس را برای آن فعال کرده است. درباره رابطه بین پروژههای فایربیس و Google Cloud بیشتر بدانید.
اکیداً توصیه میکنیم که این برچسب را تغییر ندهید یا حذف نکنید. این برچسب توسط Firebase و Google Cloud برای فهرست کردن پروژههای Firebase شما استفاده میشود (برای مثال، با استفاده از نقطه پایانی REST API projects.list یا در منوهای کنسول Firebase ).
توجه داشته باشید که افزودن دستی این برچسب به فهرست برچسبهای پروژه، پیکربندیها و سرویسهای خاص Firebase را برای پروژه Google Cloud شما فعال نمیکند. برای انجام این کار، باید Firebase را با استفاده از کنسول Firebase (یا برای موارد استفاده پیشرفته، با استفاده از Firebase Management REST API یا Firebase CLI ) اضافه کنید.
چرا کنسول Firebase نمیتواند لیستی از پروژههای موجود Google Cloud من را بارگذاری کند؟
این پرسشهای متداول اغلب زمانی کاربرد دارد که میخواهید با استفاده از کنسول Firebase ، Firebase را به یک پروژه Google Cloud موجود «اضافه کنید» و به هزاران پروژه Google Cloud دسترسی داشته باشید .
در پاسخ اجرای دستور Firebase CLI به نام firebase projects:list
این مراحل عیبیابی را امتحان کنید:
ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید: https://console.firebase.google.com/project/ PROJECT-ID /overview
اگر نمیتوانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت میکنید، موارد زیر را بررسی کنید:
مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
بررسی کنید که آیا میتوانید پروژه را در کنسول Google Cloud مشاهده کنید یا خیر.
مطمئن شوید که پروژه شما برچسب firebase:enabled در صفحه Labels برای پروژهتان در کنسول Google Cloud دارد. Firebase و Google Cloud از این برچسب برای فهرست کردن پروژههای Firebase شما استفاده میکنند. اگر این برچسب را نمیبینید اما Firebase Management API برای پروژه شما فعال است ، برچسب را به صورت دستی اضافه کنید (به طور خاص، یک Keyfirebase با Valueenabled ).
مطمئن شوید که یکی از نقشهای اصلی IAM (مالک، ویرایشگر، مشاهدهگر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریفشده Firebase ، به شما اختصاص داده شده است. میتوانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.
اگر هیچ یک از مراحل عیبیابی بالا به شما امکان مشاهده پروژهتان در فهرست پروژههای Firebase را نداد، با پشتیبانی Firebase تماس بگیرید.
با هر حساب گوگل (آدرس ایمیل) چند پروژه میتوانم داشته باشم؟
طرح قیمتگذاری اسپارک : سهمیه ایجاد پروژه به تعداد کمی پروژه (معمولاً حدود ۵ تا ۱۰ پروژه) محدود میشود.
طرح قیمتگذاری Blaze : سهمیه ایجاد پروژه هنوز محدود است، اما ممکن است با اتصال یک حساب Cloud Billing با وضعیت خوب، افزایش یابد.
در مورد محدودیت سهمیه ایجاد پروژه به موارد زیر توجه کنید:
این محدودیت مختص فایربیس نیست . محدودیتهای فایربیس در سهمیه پروژه مشابه محدودیتهای Google Cloud است .
چند برنامه Firebase میتوانم در یک پروژه Firebase داشته باشم؟
یک پروژه Firebase یک ظرف برای برنامههای Firebase در سراسر اپل، اندروید و وب است. Firebase تعداد کل برنامههای Firebase را در یک پروژه Firebase به 30 محدود میکند.
بعد از این تعداد، عملکرد شروع به کاهش میکند (بهخصوص برای Google Analytics ) و در نهایت، در تعداد بیشتری از برنامهها، برخی از قابلیتهای محصول از کار میافتند. علاوه بر این، اگر از ورود به سیستم گوگل به عنوان ارائهدهنده احراز هویت استفاده کنید، یک شناسه کلاینت OAuth 2.0 اساسی برای هر برنامه در پروژه شما ایجاد میشود. محدودیتی در حدود 30 شناسه کلاینت وجود دارد که میتوان در یک پروژه واحد ایجاد کرد.
شما باید اطمینان حاصل کنید که تمام برنامههای Firebase درون یک پروژه Firebase واحد، از دیدگاه کاربر نهایی، انواع پلتفرم یک برنامه مشابه هستند. به عنوان مثال، اگر یک برنامه با برچسب سفید توسعه میدهید، هر برنامه با برچسب مستقل باید پروژه Firebase مخصوص به خود را داشته باشد، اما نسخههای اپل و اندروید آن برچسب میتوانند در یک پروژه باشند. راهنماییهای دقیقتر را در بهترین شیوههای کلی ما برای راهاندازی پروژههای Firebase بخوانید.
در موارد نادری که پروژه شما به بیش از 30 برنامه نیاز دارد، میتوانید درخواست افزایش محدودیت برنامه را بدهید. برای ارائه این درخواست، پروژه شما باید در طرح قیمتگذاری Blaze باشد. برای ارائه درخواست و ارزیابی آن، به کنسول Google Cloud مراجعه کنید. برای کسب اطلاعات بیشتر در مورد مدیریت سهمیه به مستندات Google Cloud مراجعه کنید.
اگر پروژهام را به عنوان یک محیط «تولید» برچسبگذاری کنم، چه اتفاقی میافتد؟
در کنسول Firebase ، میتوانید پروژههای فایربیس خود را با نوع محیط آنها، چه به عنوان محیطهای تولیدی و چه به عنوان محیطهای نامشخص (غیر تولیدی)، برچسبگذاری کنید.
برچسبگذاری پروژه شما به عنوان یک نوع محیط هیچ تاثیری بر نحوه عملکرد یا ویژگیهای پروژه Firebase شما ندارد. با این حال، این برچسبگذاری میتواند به شما و تیمتان کمک کند تا پروژههای مختلف Firebase خود را برای چرخه عمر برنامه مدیریت کنید.
اگر پروژه خود را به عنوان یک محیط تولید برچسبگذاری کنید، ما یک برچسب Prod با رنگ روشن به پروژه در کنسول Firebase اضافه میکنیم و به شما یادآوری میکنیم که هرگونه تغییری میتواند بر برنامههای تولید مرتبط شما تأثیر بگذارد. در آینده، ممکن است ویژگیها و اقدامات حفاظتی بیشتری برای پروژههای Firebase که به عنوان محیطهای تولید برچسبگذاری شدهاند، اضافه کنیم.
برای تغییر نوع محیط پروژه Firebase خود، به مسیر زیر بروید:settingsپروژه > عمومی ، سپس در کارت پروژه شما در زیر محیط ، برای تغییر نوع محیط، روی edit کلیک کنید.
از کجا میتوانم شناسه برنامه (App ID) برنامه Firebase خود را پیدا کنم؟
در کنسول Firebase ، به مسیر زیر بروید:settingsپروژه . به پایین اسکرول کنید تا به کارت «برنامههای شما» برسید، سپس روی برنامه Firebase مورد نظر کلیک کنید تا اطلاعات برنامه، از جمله شناسه برنامه آن، را مشاهده کنید.
در اینجا چند نمونه از مقادیر شناسه برنامه آورده شده است:
هر یک از نقشهای فایربیس زیر: مالک یا مدیر فایربیس
هر یک از سطوح دسترسی Google Play زیر: مالک حساب یا مدیر
برای لینک کردن برنامه AdMob خود، باید هم مالک پروژه Firebase و هم مدیر AdMob باشید.
برای پیوند دادن حساب AdWords خود، باید هم مالک پروژه Firebase و هم مدیر AdWords باشید.
برای لینک کردن پروژه BigQuery خود، باید مالک پروژه Firebase باشید.
مجوزها و دسترسیها به پروژههای فایربیس
چگونه میتوانم به یک عضو پروژه نقشی، مانند نقش مالک، اختصاص دهم؟
برای مدیریت نقش(های) اختصاص داده شده به هر عضو پروژه، شما باید مالک پروژه Firebase باشید (یا نقشی با مجوز resourcemanager.projects.setIamPolicy به شما اختصاص داده شده باشد).
در اینجا مکانهایی وجود دارد که میتوانید نقشها را تعیین و مدیریت کنید:
کنسول Google Cloud مجموعهای گسترده از ابزارها را برای اختصاص نقشها به اعضای پروژه در صفحه IAM ارائه میدهد. در کنسول Cloud ، میتوانید نقشهای سفارشی ایجاد و مدیریت کنید و همچنین به حسابهای سرویس اجازه دسترسی به پروژه خود را بدهید.
توجه داشته باشید که در کنسول Google Cloud ، اعضای پروژه، مدیران اصلی (Principal) نامیده میشوند.
اگر مالک پروژه شما دیگر نمیتواند وظایف یک مالک را انجام دهد (مثلاً شخصی که شرکت شما را ترک کرده است) و پروژه شما از طریق یک سازمان Google Cloud مدیریت نمیشود (به پاراگراف بعدی مراجعه کنید)، میتوانید با پشتیبانی Firebase تماس بگیرید و در مورد نحوه درخواست دسترسی به پروژه Firebase با آنها مشورت کنید.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، ممکن است مالک نداشته باشد. اگر نمیتوانید مالکی برای پروژه Firebase خود پیدا کنید، با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا یک مالک برای پروژه تعیین کند.
چگونه میتوانم مالک یک پروژه Firebase را پیدا کنم؟
شما میتوانید اعضای پروژه و نقشهای آنها را در مکانهای زیر مشاهده کنید:
اگر در کنسول Firebase به پروژه دسترسی ندارید ، بررسی کنید که آیا در کنسول Google Cloud به پروژه دسترسی دارید یا خیر. میتوانید لیست اعضای پروژه، از جمله مالکان، را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر مالک پروژه شما دیگر نمیتواند وظایف یک مالک را انجام دهد (برای مثال، شخصی که شرکت شما را ترک کرده است) و پروژه شما از طریق یک سازمان Google Cloud مدیریت نمیشود (به پاراگراف بعدی مراجعه کنید)، میتوانید با پشتیبانی Firebase تماس بگیرید تا یک مالک موقت به شما اختصاص داده شود.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، ممکن است مالک نداشته باشد. در عوض، شخصی که سازمان Google Cloud شما را مدیریت میکند، میتواند بسیاری از وظایفی را که یک مالک میتواند انجام دهد، انجام دهد. با این حال، برای انجام چندین وظیفه خاص مالک (مانند اختصاص نقشها یا مدیریت ویژگیهای Google Analytics )، ممکن است مدیر نیاز داشته باشد که نقش مالک واقعی را برای انجام آن وظایف به خود اختصاص دهد. اگر نمیتوانید مالکی برای پروژه Firebase خود پیدا کنید، با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا یک مالک برای پروژه تعیین کند.
چرا یا چه زمانی باید به یکی از اعضای پروژه نقش مالک (Owner) را اختصاص دهم؟
برای اطمینان از مدیریت صحیح یک پروژه Firebase، باید یک مالک (Owner) داشته باشد.
اعضای پروژه با نقش مالک اغلب تنها اعضای پروژه هستند که میتوانند وظایف مدیریتی را انجام دهند یا اعلانهای مهم را دریافت کنند :
اعضای پروژه با نقش مالک اغلب تنها اعضایی هستند که میتوانند اقدامات مهم مدیریتی (مانند اختصاص نقشها و مدیریت ویژگیهای Google Analytics ) را انجام دهند، و پشتیبانی Firebase فقط میتواند درخواستهای مدیریتی از مالکان پروژههای مشخصشده را انجام دهد.
اعضای پروژه با نقش مالک اغلب تنها اعضایی هستند که (به طور پیشفرض) اعلانهایی در مورد تغییرات پروژه یا محصولات (مانند تغییرات صورتحساب و قانونی، منسوخ شدن ویژگیها و غیره) دریافت میکنند. اگر میخواهید اعضای خاص یا اضافی پروژه اعلانها را دریافت کنند، میتوانید به صورت اختیاری «مخاطبین ضروری» پروژه خود را سفارشی کنید .
پس از اینکه مالک(گان) یک پروژه Firebase را تعیین کردید، بهروز نگه داشتن این وظایف بسیار مهم است.
توجه داشته باشید که اگر یک پروژه Firebase بخشی از یک سازمان Google Cloud باشد، فردی که سازمان Google Cloud شما را مدیریت میکند میتواند بسیاری از وظایفی را که یک مالک میتواند انجام دهد، انجام دهد. با این حال، برای چندین وظیفه خاص مالک (مانند اختصاص نقشها یا مدیریت ویژگیهای Google Analytics )، ممکن است مدیر نیاز داشته باشد که نقش مالک واقعی را برای انجام آن وظایف به خود اختصاص دهد.
فکر نمیکنم پروژه فایربیس داشته باشم، اما ایمیلی در مورد یکی از آنها دریافت کردهام. چگونه میتوانم به این پروژه دسترسی پیدا کنم؟
ایمیلی که دریافت کردهاید باید حاوی لینکی برای باز کردن پروژه Firebase شما باشد. با کلیک روی لینک موجود در ایمیل، پروژه در کنسول Firebase باز میشود.
اگر نمیتوانید پروژه موجود در لینک را باز کنید، مطمئن شوید که با همان حساب گوگلی که ایمیل مربوط به پروژه را دریافت کردهاید، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول، وارد و از آن خارج شوید.
توجه داشته باشید که اگر شما مدیر یک سازمان Google Cloud هستید، ممکن است از تغییرات پروژههای Firebase در داخل سازمان خود مطلع شوید. با این حال، ممکن است مجوزهای کافی برای باز کردن پروژه Firebase را نداشته باشید. در این موارد، سادهترین راه حل این است که نقش مالک واقعی را برای خود تعیین کنید تا پروژه را باز کرده و اقدامات لازم را انجام دهید. درباره دلیل و زمان تعیین نقش مالک بیشتر بدانید.
کنسول Firebase
مرورگرهای پشتیبانی شده برای دسترسی به کنسول Firebase کدامند؟
کنسول Firebase از طریق نسخههای اخیر مرورگرهای دسکتاپ محبوب مانند کروم، فایرفاکس، سافاری و اج قابل دسترسی است. مرورگرهای موبایل به طور کامل پشتیبانی نمیشوند.
میتوانم کنسول Firebase را بارگذاری کنم، اما چرا نمیتوانم پروژه Firebase خود را پیدا کنم یا به آن دسترسی داشته باشم؟
این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:
کنسول Firebase یک صفحه خطا برمیگرداند که میگوید پروژه شما ممکن است وجود نداشته باشد یا اینکه شما به پروژه دسترسی ندارید.
کنسول Firebase ، حتی وقتی شناسه پروژه یا نام پروژه را در فیلد جستجوی کنسول وارد میکنید، پروژه شما را نمایش نمیدهد.
این مراحل عیبیابی را امتحان کنید:
ابتدا، با مراجعه مستقیم به URL پروژه، سعی کنید به پروژه خود دسترسی پیدا کنید. از فرمت زیر استفاده کنید: https://console.firebase.google.com/project/ PROJECT-ID /overview
اگر هنوز نمیتوانید به پروژه دسترسی پیدا کنید یا خطاهای مجوز دریافت میکنید، موارد زیر را بررسی کنید:
مطمئن شوید که با همان حساب گوگلی که به پروژه دسترسی دارد، وارد Firebase شدهاید. میتوانید از طریق آواتار حساب خود در گوشه سمت راست بالای کنسول Firebase وارد و از آن خارج شوید.
مطمئن شوید که یکی از نقشهای اصلی IAM (مالک، ویرایشگر، مشاهدهگر) یا نقشی که مجوزهای مربوط به Firebase را دارد، مثلاً یک نقش از پیش تعریفشده Firebase ، به شما اختصاص داده شده است. میتوانید نقش(های) خود را در صفحه IAM کنسول Google Cloud مشاهده کنید.
اگر پروژه شما متعلق به یک سازمان Google Cloud است، ممکن است برای مشاهده پروژه ذکر شده در کنسول Firebase به مجوزهای بیشتری نیاز داشته باشید. با شخصی که سازمان Google Cloud شما را مدیریت میکند تماس بگیرید تا نقش مناسب برای مشاهده پروژه، مثلاً نقش مرورگر، را به شما بدهد.
اگر هیچ یک از مراحل عیبیابی بالا شما را قادر به یافتن یا دسترسی به پروژهتان نکرد، با پشتیبانی Firebase تماس بگیرید.
چرا کنسول Firebase برای من بارگذاری نمیشود؟
این سوالات متداول در صورتی قابل استفاده است که با هر یک از مشکلات زیر مواجه هستید:
بارگذاری یک صفحه در کنسول Firebase هرگز تمام نمیشود.
دادههای درون یک صفحه آنطور که انتظار میرود بارگیری نمیشوند.
هنگام بارگذاری کنسول Firebase پیامهای خطای مرورگر دریافت میکنید.
این مراحل عیبیابی را امتحان کنید:
ردیف کنسول در داشبورد وضعیت فایربیس را برای هرگونه وقفه احتمالی در سرویس بررسی کنید.
اگر هیچ یک از مراحل عیبیابی بالا مشکل را حل نکرد، با پشتیبانی Firebase تماس بگیرید.
زبان کنسول Firebase من چگونه تعیین میشود؟
تنظیم زبان کنسول Firebase بر اساس زبانی است که در تنظیمات حساب گوگل شما انتخاب شده است.
برای تغییر ترجیح زبان خود، به تغییر زبان مراجعه کنید.
کنسول Firebase از زبانهای زیر پشتیبانی میکند:
انگلیسی
پرتغالی برزیلی
فرانسوی
آلمانی
اندونزیایی
ژاپنی
کره ای
روسی
چینی سادهشده
اسپانیایی
چینی سنتی
کنسول Firebase از چه نقشها و مجوزهایی پشتیبانی میکند؟
کنسول Firebase و کنسول Google Cloud از نقشها و مجوزهای اساسی یکسانی استفاده میکنند. برای کسب اطلاعات بیشتر در مورد نقشها و مجوزها به مستندات Firebase IAM مراجعه کنید.
مالک پروژه میتواند اعضای دیگری را به پروژه اضافه کند، یکپارچهسازیها را تنظیم کند (پروژه به سرویسهایی مانند BigQuery یا Slack متصل شود) و دسترسی کامل به ویرایش پروژه داشته باشد.
یک ویرایشگر پروژه، دسترسی کامل به ویرایش پروژه دارد.
یک نمایشگر پروژه فقط دسترسی خواندن پروژه را دارد. توجه داشته باشید که کنسول Firebase کنترلهای ویرایش رابط کاربری را از نمایشگرهای پروژه پنهان/غیرفعال نمیکند، اما این عملیات برای اعضای پروژه که نقش نمایشگر به آنها اختصاص داده شده است، با شکست مواجه خواهد شد.
فایربیس همچنین از موارد زیر پشتیبانی میکند:
نقشهای از پیش تعریفشدهی فایربیس — نقشهای منتخب مختص فایربیس که کنترل دسترسی جزئیتری نسبت به نقشهای پایهی مالک، ویرایشگر و مشاهدهگر فراهم میکنند.
نقشهای سفارشی — نقشهای IAM کاملاً سفارشیسازیشدهای که شما ایجاد میکنید تا مجموعهای از مجوزها را متناسب با الزامات خاص سازمان شما تنظیم کنند.
«تجربه برنامه نمونه» کنسول چگونه کار میکند؟ چه اتفاقی میافتد و چه کاری میتوانم انجام دهم؟
کنسول Firebase یک تجربه برنامه نمونه ارائه میدهد تا شما یک برنامه کاربردی واقعی برای کاوش و آزمایش با فایربیس و سایر سرویسهای گوگل (مانند Gemini API ) داشته باشید.
راهاندازی و استقرار خودکار Firebase از برنامه نمونه
وقتی تجربه برنامه نمونه را در کنسول Firebase مرور میکنید، ما به طور خودکار موارد زیر را برای شما انجام میدهیم:
یک پروژه Firebase جدید برای برنامه نمونه خود ایجاد کنید
یک برنامه وب Firebase را در پروژه جدید Firebase ثبت کنید
سرویسها و APIهایی را که توسط برنامه نمونه استفاده میشوند فعال کنید (برای مثال، Firebase Authentication ، Cloud Firestore و غیره)
منابع مورد نیاز را فراهم کنید (برای مثال، نمونههای پایگاه داده و قوانین امنیتی)
تنظیم Firebase AI Logic برای استفاده از Gemini Developer API
برنامه نمونه را با استفاده از Firebase Hosting روی یک URL پیشنمایش موقت مستقر کنید (به طور پیشفرض، این URL ظرف ۷ روز منقضی میشود )
کدبیس برنامه نمونه را بررسی کنید
گزینه ۱: یک نسخه شخصیسازیشده از کدبیس برنامه نمونه را در Firebase Studio باز کنید
تجربه برنامه نمونه، مسیری را برای باز کردن یک نسخه شخصیسازیشده از کدبیس برنامه نمونه در Firebase Studio (فضای کاری مبتنی بر مرورگر گوگل برای توسعه برنامه کامل) فراهم میکند. پس از راهاندازی پروژه و برنامه شما (به بالا مراجعه کنید)، میتوانید پیوندهایی به Firebase Studio را در بنرهای کنسول Firebase و در بالای برنامه مستقر شده پیدا کنید.
وقتی برنامه نمونه خود را در Firebase Studio باز میکنید، ما به طور خودکار موارد زیر را برای شما انجام میدهیم:
از همان پروژه Firebase، برنامه وب Firebase و منابع ایجاد شده در تنظیمات اولیه استفاده کنید (به بالا مراجعه کنید)
پیکربندی Firebase برنامه نمونه خود را در کدبیس (معمولاً در src/bootstrap.js ) وارد کنید.
در Firebase Studio ، میتوانید کدبیس را بررسی کنید تا نحوه تعامل با سرویسهای مختلف Firebase و Google را درک کنید.
گزینه ۲: مشاهده نسخه عمومی و غیرشخصیشده کدبیس برنامه نمونه در گیتهاب
از طرف دیگر، میتوانید نسخه عمومی و غیرشخصیشدهی کدبیس برنامهی نمونه را در گیتهاب مشاهده کنید.
«برنامهریزی با رابط برنامهنویسی Gemini» - مخزن گیتهاب
Firebase Local Emulator Suite
چرا گزارشهای Local Emulator Suite خطایی با عنوان «استفاده از چندین شناسه پروژه در حالت تک پروژه توصیه نمیشود» را نشان میدهند؟
این پیام به این معنی است که Local Emulator Suite تشخیص داده است که ممکن است یک شبیهساز محصول خاص را با استفاده از شناسههای پروژه مختلف اجرا کند. این ممکن است نشاندهنده یک پیکربندی نادرست باشد و میتواند هنگام تلاش شبیهسازها برای برقراری ارتباط با یکدیگر و همچنین هنگام تلاش شما برای تعامل با شبیهسازها از کد شما، مشکلاتی ایجاد کند. اگر شناسههای پروژه مطابقت نداشته باشند، اغلب به نظر میرسد که دادهها از دست رفتهاند، زیرا دادههای ذخیره شده در شبیهسازها به projectID مرتبط هستند و قابلیت همکاری به تطبیق شناسههای پروژه بستگی دارد.
این موضوع باعث سردرگمی رایجی در بین توسعهدهندگان شده است، بنابراین بهطور پیشفرض Local Emulator Suite اکنون فقط اجازه اجرا با یک شناسه پروژه را میدهد، مگر اینکه در فایل پیکربندی firebase.json خلاف آن را مشخص کنید. اگر یک شبیهساز بیش از یک شناسه پروژه را شناسایی کند، یک هشدار ثبت میکند و بهطور بالقوه یک خطای مهلک ایجاد میکند.
اعلامیه(های) شناسه پروژه خود را برای عدم تطابق در موارد زیر بررسی کنید:
پروژه پیشفرض در خط فرمان تنظیم شده است. به طور پیشفرض، شناسه پروژه در هنگام راهاندازی از پروژه انتخاب شده با firebase init یا firebase use گرفته میشود. برای مشاهده لیست پروژهها (و دیدن اینکه کدام یک انتخاب شده است) firebase projects:list استفاده کنید.
تستهای واحد. شناسه پروژه اغلب در فراخوانی متدهای کتابخانه تست واحد Rules به نام initializeTestEnvironment یا initializeTestApp مشخص میشود. سایر کدهای تست ممکن است با initializeApp(config) مقداردهی اولیه شوند.
پرچم --project در خط فرمان. ارسال پرچم --project در Firebase CLI، پروژه پیشفرض را لغو میکند. باید مطمئن شوید که مقدار این پرچم با شناسه پروژه در تستهای واحد و مقداردهی اولیه برنامه مطابقت دارد.
مکانهای مخصوص پلتفرم برای بررسی:
وب
ویژگی projectId در شیء جاوا اسکریپت firebaseConfig شما، که در initializeApp استفاده میشود.
آیا فایربیس اعتبار آزمایشی رایگان برای محصولات پولی ارائه میدهد؟
سرویسهای پولی فایربیس را میتوان تحت دوره آزمایشی رایگان Google Cloud استفاده کرد. کاربران جدید Google Cloud و فایربیس میتوانند از یک دوره آزمایشی ۹۰ روزه که شامل ۳۰۰ دلار اعتبار رایگان Cloud Billing است، برای بررسی و ارزیابی محصولات و خدمات Google Cloud و فایربیس استفاده کنند.
در طول دوره آزمایشی رایگان Google Cloud ، یک حساب Cloud Billing به شما ارائه خواهد شد. هر پروژه فایربیس که به آن حساب کاربری متصل باشد، در طول دوره آزمایشی رایگان، در طرح قیمتگذاری پرداخت در حین استفاده Blaze قرار خواهد گرفت.
نگران نباشید، پیوند دادن یک پروژه فایربیس به این حساب رایگان Cloud Billing ما را قادر نمیسازد که برای استفاده فراتر از این اعتبارات، از شما هزینهای دریافت کنیم . برای استفاده فراتر از این اعتبارات، هزینهای از شما دریافت نمیشود ، مگر اینکه با ارتقاء حساب رایگان Cloud Billing خود به یک حساب پولی، صراحتاً پرداخت صورتحساب را فعال کنید. میتوانید در هر زمان در طول دوره آزمایشی، حساب خود را به یک حساب پولی ارتقا دهید. پس از ارتقاء به یک حساب پولی، همچنان میتوانید از اعتبارات باقیمانده (در دوره ۹۰ روزه) استفاده کنید.
پس از پایان دوره آزمایشی رایگان و اگر حساب Free Trial Cloud Billing خود را به یک حساب پولی ارتقا نداده باشید، پروژه Firebase شما که به آن لینک دادهاید، به طور خودکار به طرح قیمتی Spark تنزل مییابد. توجه داشته باشید که میتوانید در هر زمان دوباره به طرح قیمتی Blaze ارتقا دهید .
طرح قیمتگذاری رایگان اسپارک، مکانی عالی برای توسعه رایگان اپلیکیشن شماست. شما تمام محصولات رایگان فایربیس (مانند Analytics ، Remote Config ، Crashlytics و غیره) و مقادیر زیادی از ویژگیهای زیرساخت پولی ما را دریافت میکنید. با این حال، اگر در یک ماه تقویمی از منابع طرح قیمتگذاری اسپارک خود فراتر بروید، اپلیکیشن شما برای بقیه آن ماه غیرفعال خواهد شد. علاوه بر این، ویژگیهای Google Cloud هنگام استفاده از طرح قیمتگذاری اسپارک در دسترس نیستند.
طرح قیمت گذاری بلیز
طرح قیمتگذاری Blaze با قابلیت پرداخت به ازای استفاده، برای برنامههای تولیدی طراحی شده است. طرح قیمتگذاری Blaze همچنین به شما امکان میدهد برنامه خود را با ویژگیهای پولی Google Cloud گسترش دهید. شما فقط برای منابعی که مصرف میکنید هزینه پرداخت میکنید و به شما امکان میدهد با تقاضا مقیاسپذیری داشته باشید. ما تلاش میکنیم تا قیمتهای طرح قیمتگذاری Blaze خود را با ارائهدهندگان ابری پیشرو در صنعت رقابتی کنیم.
آیا میتوانم در هر زمانی ارتقا، تنزل یا لغو کنم؟
بله، شما میتوانید در هر زمانی ارتقا، تنزل یا لغو اشتراک را انجام دهید. توجه داشته باشید که ما برای تنزل یا لغو اشتراک، بازپرداخت متناسب ارائه نمیدهیم. این بدان معناست که اگر قبل از پایان دوره صورتحساب خود، اشتراک خود را تنزل یا لغو کنید، همچنان هزینه باقیمانده ماه را پرداخت خواهید کرد.
استفاده رایگان در طرح قیمتگذاری 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 باشد).
در مقابل، اگر یک حساب فعال Cloud Billing موجود از یک پروژه در کنسول Google Cloud جدا شود، آن پروژه به طرح قیمتگذاری بدون هزینه Firebase Spark تنزل رتبه خواهد یافت.
چگونه میتوانم میزان مصرف و صورتحساب خود را کنترل کنم؟
شما میتوانید میزان استفاده از منابع پروژه خود را در کنسول Firebase در هر یک از داشبوردهای زیر پیگیری کنید:
آیا میتوانم برای طرح قیمتگذاری Blaze محدودیتی برای استفاده تعیین کنم؟
خیر، شما نمیتوانید در طرح قیمتگذاری Blaze محدودیتی برای میزان استفاده خود تعیین کنید. با این حال، ما به طور فعال در حال ارزیابی گزینههایی برای پشتیبانی از محدودیت در میزان استفاده در طرح قیمتگذاری Blaze هستیم.
اگر پروژه شما در طرح قیمتگذاری Blaze قرار دارد، میتوانید برای پروژه یا حساب خود بودجهای تعریف کنید و با نزدیک شدن هزینهها به آن محدوده، هشدار دریافت کنید. یاد بگیرید که چگونه هشدارهای بودجه را تنظیم کنید .
چه نوع حمایتی دریافت خواهم کرد؟
تمام برنامههای Firebase، از جمله آنهایی که از طرحهای رایگان استفاده میکنند، در ساعات کاری ایالات متحده و اقیانوسیه، از طریق ایمیل توسط کارکنان Firebase پشتیبانی میشوند. همه حسابها دارای پشتیبانی نامحدود برای مسائل مربوط به صورتحساب، مسائل مربوط به حساب، سوالات فنی (عیبیابی) و گزارشهای حادثه هستند.
آیا تخفیفهای متنباز، غیرانتفاعی یا آموزشی ارائه میدهید؟
طرح قیمتگذاری بدون هزینه اسپارک میتواند توسط هر نوع فرد یا سازمانی، از جمله سازمانهای غیرانتفاعی، مدارس و پروژههای متنباز، مورد استفاده قرار گیرد. از آنجایی که این طرحها از قبل سهمیههای سخاوتمندانهای را شامل میشوند، ما هیچ تخفیف یا طرح ویژهای برای پروژههای متنباز، غیرانتفاعی یا آموزشی ارائه نمیدهیم.
آیا قراردادهای سازمانی، قیمتگذاری، پشتیبانی یا میزبانی زیرساخت اختصاصی ارائه میدهید؟
طرح قیمتگذاری Blaze که به صورت پرداخت در محل ارائه میشود، برای شرکتهایی در هر اندازهای مناسب است و SLA ما مطابق یا فراتر از استاندارد صنعت برای زیرساختهای ابری است. با این حال، ما قرارداد، قیمتگذاری یا پشتیبانی سازمانی ارائه نمیدهیم و همچنین میزبانی زیرساخت اختصاصی (یعنی نصب در محل) را برای خدماتی مانند Realtime Database خود ارائه نمیدهیم. با این حال، ما به طور فعال در حال بررسی گزینههایی برای اضافه کردن برخی از این ویژگیها هستیم.
آیا قیمتگذاری موردی ارائه میدهید؟ من فقط میخواهم برای یک یا دو ویژگی، پرداخت در محل داشته باشم.
ما قیمتگذاری موردی را از طریق طرح قیمتگذاری Blaze با پرداخت در محل ارائه میدهیم، که در آن شما فقط برای ویژگیهایی که استفاده میکنید هزینه پرداخت میکنید.
چگونه طرحهای پولی فایربیس با Ads کار میکنند؟ آیا اعتبار تبلیغات رایگان با طرحهای پولی وجود دارد؟
طرحهای قیمتگذاری فایربیس از Ads جدا هستند، بنابراین هیچ اعتبار تبلیغاتی بدون هزینه وجود ندارد. به عنوان یک توسعهدهنده فایربیس، شما میتوانید حساب Ads خود را به فایربیس "پیوند" دهید تا از ردیابی تبدیل پشتیبانی شود.
همه کمپینهای تبلیغاتی مستقیماً در Ads مدیریت میشوند و صورتحساب Ads از کنسول Ads مدیریت میشود.
چه اتفاقی برای طرح قیمتگذاری فلیم افتاد؟
در ژانویه ۲۰۲۰، طرح قیمتگذاری فلیم (۲۵ دلار در ماه سهمیه اضافی) به عنوان گزینهای برای ثبتنامهای جدید حذف شد. به کاربران طرح فعلی یک مهلت داده شد تا پروژههای خود را از طرح فلیم منتقل کنند. در فوریه ۲۰۲۲، پروژههای باقیمانده در طرح قیمتگذاری فلیم به طرح قیمتگذاری بدون هزینه اسپارک تنزل رتبه یافتند. بر این اساس،
پروژههای طرح قیمتگذاری Spark و Blaze موجود و هرگونه پروژه جدید دیگر نمیتوانند به طرح Flame تغییر دهند یا در آن ثبتنام کنند.
اگر یک پروژه طرح فلیم موجود را به یک طرح قیمتگذاری متفاوت منتقل کردید، پروژه نمیتواند به طرح فلیم بازگردد.
پروژههایی که به طرح قیمتگذاری Spark تنزل رتبه یافتهاند، میتوانند برای از سرگیری خدمات پولی اضافی، به طرح قیمتگذاری Blaze ارتقا یابند.
ارجاعات به طرح فلیم از مستندات حذف شدهاند.
آیا سوالات بیشتری در مورد طرح بازنشستگی فلیم دارید؟ برخی از سوالات متداول زیر را بخوانید.
آیا میخواهید درباره سایر طرحهای قیمتگذاری ارائه شده توسط Firebase اطلاعات کسب کنید؟ از صفحه قیمتگذاری Firebase ما دیدن کنید. اگر میخواهید پروژههای موجود خود را به طرح قیمتگذاری دیگری منتقل کنید، میتوانید این کار را در کنسول Firebase برای پروژه خود انجام دهید.
سوالات متداول بیشتر در مورد طرح بازنشستگی فلیم
من یک پروژه یا فرآیند یا مدل کسب و کاری دارم که به هزینه ثابت Firebase متکی است. چه کاری باید انجام دهم؟
آیا ممکن است دسترسی ویژهای برای ایجاد پروژههای جدید طرح شعله (Flame) به من داده شود؟
خیر، فایربیس دسترسی ویژهای برای پروژهها جهت تغییر به طرح فلیم یا ثبتنام در آن ارائه نمیدهد.
من پروژه طرح شعله (Flame) خود را به یک طرح قیمتگذاری متفاوت تغییر دادم. چگونه میتوانم آن را به حالت اول برگردانم؟
تغییر به طرح Flame دیگر امکانپذیر نیست. برای دسترسی به خدمات ارائه شده توسط طرح Flame، مطمئن شوید که از طرح قیمتگذاری Blaze استفاده میکنید و تنظیم هشدارهای بودجه برای پروژه خود را در نظر بگیرید.
پروژه من به عنوان بخشی از طرح بازنشستگی Flame، به طور خودکار به یک طرح قیمتگذاری متفاوت منتقل شد. چه کاری باید انجام دهم؟
اگر پروژه شما به سهمیه اضافی فراتر از آنچه در طرح قیمتگذاری Spark ارائه شده است نیاز دارد، باید پروژه خود را به طرح قیمتگذاری Blaze ارتقا دهید.
چرا طرح فلیم کنار گذاشته میشود؟
در طول این سالها، شاهد کاهش استفاده از طرح Flame بودهایم و اکثر پروژههایی که از این طرح استفاده میکنند، از ارزش کامل آن استفاده نمیکنند. حفظ این طرح قیمتگذاری عموماً مقرونبهصرفه نیست و ما احساس میکنیم که اگر منابع به سایر طرحهای Firebase اختصاص داده شود، میتوانیم به همه بهتر خدمت کنیم.
حریم خصوصی
از کجا میتوانم اطلاعاتی در مورد حریم خصوصی و امنیت در Firebase پیدا کنم؟
آیا SDK های Firebase اطلاعات استفاده/تشخیصی را خارج از Analytics ثبت میکنند؟
بله. در حال حاضر، این فقط برای iOS است، اما ممکن است در آینده تغییر کند. SDK پلتفرمهای Firebase Apple به طور پیشفرض شامل چارچوب FirebaseCoreDiagnostics است. این چارچوب توسط Firebase برای جمعآوری اطلاعات مربوط به استفاده و تشخیص SDK استفاده میشود تا به اولویتبندی پیشرفتهای آینده محصول کمک کند. FirebaseCoreDiagnostics اختیاری است، بنابراین اگر میخواهید از ارسال گزارشهای تشخیصی Firebase خودداری کنید، میتوانید با قطع ارتباط کتابخانه از برنامه خود این کار را انجام دهید. میتوانید منبع کامل، از جمله مقادیر ثبت شده، را در GitHub مرور کنید.
A/B Testing
A/B Testing : چند آزمایش میتوانم ایجاد و اجرا کنم؟
شما مجاز به انجام حداکثر ۳۰۰ آزمایش در هر پروژه هستید که میتواند شامل ۲۴ آزمایش در حال اجرا و بقیه به صورت پیشنویس یا تکمیلشده باشد.
A/B Testing : چرا نمیتوانم آزمایشهایم را بعد از قطع ارتباط و اتصال مجدد پروژهام به گوگل آنالیتیکس مشاهده کنم؟
پیوند دادن به یک ویژگی Google Analytics متفاوت باعث میشود دسترسی شما به آزمایشهای ایجاد شده قبلی از دست برود. برای دسترسی مجدد به یک آزمایش قبلی، پروژه خود را دوباره به ویژگی Google Analytics که هنگام ایجاد آزمایش پیوند داده شده بود، پیوند دهید.
A/B Testing : چرا هنگام ایجاد یک آزمایش Remote Config پیام "پروژه به گوگل آنالیتیکس مرتبط نیست" دریافت میکنم؟
اگر قبلاً Firebase و Google Analytics را به هم متصل کردهاید ، اما هنوز پیامی مبنی بر عدم اتصال Google Analytics مشاهده میکنید، مطمئن شوید که یک جریان Analytics برای همه برنامههای پروژه شما وجود دارد. در حال حاضر، همه برنامههای یک پروژه باید برای استفاده از تست A/B به یک جریان Google Analytics متصل باشند.
میتوانید فهرست تمام جریانهای فعال را در صفحه جزئیات ادغام گوگل آنالیتیکس در کنسول فایربیس پیدا کنید که از settingsپروژه، تنظیماتchevron_rightادغامهاchevron_rightگوگل آنالیتیکسchevron_rightمدیریت قابل دسترسی است.
ایجاد یک جریان گوگل آنالیتیکس برای هر برنامهای که آن را ندارد، باید مشکل را حل کند. چند راه برای ایجاد جریان برای برنامههای از دست رفته وجود دارد:
اگر فقط یک یا دو برنامه دارید که جریان گوگل آنالیتیکس مرتبط با آنها وجود ندارد، میتوانید یکی از روشهای زیر را برای اضافه کردن جریان گوگل آنالیتیکس انتخاب کنید:
هر برنامهای را که در کنسول Firebase جریان فعالی ندارد، حذف و دوباره اضافه کنید.
از کنسول گوگل آنالیتیکس ، گزینه Admin را انتخاب کنید، روی Data Streams کلیک کنید، سپس روی Add stream کلیک کنید، جزئیات برنامهی از دست رفته را اضافه کنید و روی Register app کلیک کنید.
اگر بیش از چند جریان برنامه از دست رفته دارید، لغو پیوند و پیوند مجدد ویژگی Google Analytics شما سریعترین و کارآمدترین راه برای ایجاد جریانهای برنامه از دست رفته است:
در داخل کارت گوگل آنالیتیکس ، روی مدیریت کلیک کنید تا به تنظیمات فایربیس و گوگل آنالیتیکس دسترسی پیدا کنید.
شناسه ویژگی گوگل آنالیتیکس و حساب گوگل آنالیتیکس لینکشده را یادداشت کنید.
روی more_vertMore کلیک کنید و گزینه Unlink Analytics from this project را انتخاب کنید.
هشداری که ظاهر میشود را بررسی کنید (نگران نباشید؛ در مرحله بعدی همان ویژگی را دوباره پیوند خواهید داد)، سپس روی لغو پیوند Google Analytics کلیک کنید.
وقتی لغو پیوند کامل شد، به صفحه ادغامها هدایت خواهید شد.
در داخل کارت گوگل آنالیتیکس ، روی فعال کردن (Enable) کلیک کنید تا فرآیند لینکسازی مجدد آغاز شود.
حساب کاربری آنالیتیکس خود را از لیست حسابهای انتخابی انتخاب کنید.
در کنار «ایجاد خودکار یک ملک جدید در این حساب» ، رویedit کلیک کنید و از فهرست املاک آنالیتیکس که ظاهر میشود، شناسه ملک خود را انتخاب کنید.
فهرستی از تمام برنامههای موجود در پروژه شما ظاهر میشود. نگاشتهای جریان موجود برای هر برنامه فهرست شدهاند و برنامههایی که جریان ندارند، یک جریان برای آنها ایجاد خواهد شد.
برای پیوند مجدد ملک، روی فعال کردن Google Analytics کلیک کنید.
AdMob : آیا میتوانم برنامههای ویندوز خود را به Firebase متصل کنم؟
خیر، برنامههای ویندوز پشتیبانی نمیشوند.
AdMob : چرا نمیتوانم برنامهام را از کنسول Firebase به AdMob لینک کنم؟
شما میتوانید یک برنامه AdMob را از طریق کنسول AdMob به یک برنامه Firebase لینک کنید. یاد بگیرید چگونه.
AdMob : برای اتصال یک برنامه Firebase به یک برنامه AdMob به چه مجوزها یا دسترسیهایی نیاز دارم؟
برای انجام این لینکسازی، به دسترسیهای زیر نیاز دارید:
AdMob : شما باید ادمین AdMob باشید.
فایربیس : شما باید مجوز firebase.links.create را داشته باشید که در نقش Owner و نقش Firebase Admin گنجانده شده است.
Google Analytics : شما باید نقش ویرایش یا مدیریت کاربران را برای ویژگی مرتبط با پروژه فایربیس داشته باشید. اطلاعات بیشتر.
AdMob : آیا چندین کاربر در یک حساب AdMob میتوانند برنامههای AdMob و برنامههای Firebase را به هم لینک کنند؟
برای حسابهای کاربری چندکاربره AdMob ، کاربری که اولین لینک Firebase را ایجاد کرده و شرایط خدمات Firebase را پذیرفته است، تنها کاربری است که میتواند لینکهای جدید بین برنامههای AdMob و برنامههای Firebase ایجاد کند.
AdMob : برای استفاده از AdMob ، از کدام SDK ها باید استفاده کنم؟
برای استفاده از AdMob ، همیشه از SDK Google Mobile Ads همانطور که در این سوالات متداول توضیح داده شده است، استفاده کنید. علاوه بر این و به صورت اختیاری، اگر میخواهید معیارهای کاربر را برای AdMob جمعآوری کنید، SDK فایربیس را برای Google Analytics در برنامه خود قرار دهید.
برای پروژههای اندروید : وابستگی مربوط به SDK Google Mobile Ads را به فایل build.gradle خود اضافه کنید: implementation 'com.google.android.gms:play-services-ads:25.0.0'
برای پروژههای ++C و Unity : دستورالعملهای موجود در مستندات مربوطه را دنبال کنید.
تجزیه و تحلیل
Analytics : چرا استفاده از گوگل آنالیتیکس در محصولات فایربیس توصیه میشود؟
Google Analytics یک راهکار تحلیلی رایگان و نامحدود است که با ویژگیهای فایربیس برای ارائه بینشهای قدرتمند کار میکند. این ابزار به شما امکان میدهد گزارشهای رویداد را در Crashlytics ، اثربخشی اعلانها را در FCM ، عملکرد لینکهای عمیق برای Dynamic Links و دادههای خرید درونبرنامهای از Google Play را مشاهده کنید. این ابزار، هدفگیری پیشرفته مخاطبان را در Remote Config ، شخصیسازی Remote Config و موارد دیگر پشتیبانی میکند.
Google Analytics به عنوان یک لایه اطلاعاتی در کنسول Firebase عمل میکند تا بینشهای عملیتری در مورد چگونگی توسعه یک برنامه با کیفیت بالا، افزایش تعداد کاربران و کسب درآمد بیشتر در اختیار شما قرار دهد.
Analytics : چگونه میتوانم نحوه اشتراکگذاری دادههای Analytics خود با بقیه Firebase را کنترل کنم؟
به طور پیشفرض، دادههای Google Analytics شما برای بهبود سایر ویژگیهای فایربیس و گوگل استفاده میشود. میتوانید نحوه اشتراکگذاری دادههای Google Analytics خود را در تنظیمات پروژه خود در هر زمان کنترل کنید. درباره تنظیمات اشتراکگذاری دادهها بیشتر بدانید.
Analytics : چگونه تنظیمات ویژگی آنالیتیکس خود را بهروزرسانی کنم؟
از صفحه مدیریت در بخش Google Analytics خود، میتوانید تنظیمات بخش خود را بهروزرسانی کنید، مانند:
تنظیمات اشتراکگذاری دادهها
تنظیمات نگهداری دادهها
تنظیمات منطقه زمانی و واحد پول
برای بهروزرسانی تنظیمات ویژگی خود، مراحل زیر را دنبال کنید:
در کنسول Firebase ، به مسیر زیر بروید:settings > تنظیمات پروژه .
به برگه «یکپارچهسازیها» بروید و سپس در کارت گوگل آنالیتیکس، روی پیوند«مدیریت» یا «مشاهده» کلیک کنید.
اندازهگیری تبدیل روی دستگاه Analytics در اپلیکیشن iOS من: چگونه SDK آنالیتیکس برای پشتیبانی از اندازهگیری تبدیل روی دستگاه بهروزرسانی شد و آیا من ملزم به بهروزرسانی هستم؟
قبل از انتشار بهروزرسانی اندازهگیری تبدیل روی دستگاه با استفاده از دادههای رویداد، توسعهدهندگان مجبور بودند چندین ماژول SDK را به صورت دستی برای استفاده از قابلیتهای اندازهگیری روی دستگاه اضافه کنند، که یک فرآیند زمانبر بود. در نتیجه، ما ماژول SDK پیشفرض موجود ( FirebaseAnalytics ) را بهروزرسانی کردیم تا قابلیتهای اندازهگیری تبدیل روی دستگاه و همچنین برای Google Ads را در بر بگیرد.
تجزیه و تحلیل ایدفا اندازهگیری تبدیل روی دستگاه (دادههای رویداد)
ناموجود
فایربیس آنالیتیکس
* این پیکربندی شامل اندازهگیری تبدیل روی دستگاه (دادههای رویداد) نیز خواهد بود. در صورت نیاز، میتوانید با تنظیم مقدار GOOGLE_ADS_ON_DEVICE_CONVERSION_EVENT_DATA_ENABLED به NO (بولی) در فایل Info.plist برنامه خود، این ویژگی را غیرفعال کنید.
Analytics در اپلیکیشن iOS من: آیا میتوانم Analytics بدون ویژگیهای انتساب آگهی و جمعآوری IDFA نصب کنم؟
Analytics : چرا بعد از قطع ارتباط Firebase از Google Analytics، هیچ داده Analytics را در کنسول Firebase نمیبینم؟
دادههای Analytics در داخل ویژگی Google Analytics قرار دارند - نه در داخل پروژه Firebase. اگر ویژگی را حذف یا لغو پیوند کنید، دادههای Analytics برای Firebase قابل دسترسی نخواهند بود و یک داشبورد Analytics خالی در کنسول Firebase مشاهده خواهید کرد. توجه داشته باشید که از آنجایی که دادهها هنوز در ویژگی پیوند شده قبلی قرار دارند، همیشه میتوانید ویژگی را به Firebase پیوند دهید و دادههای Analytics را در کنسول Firebase مشاهده کنید.
پیوند دادن یک حساب گوگل آنالیتیکس کاملاً جدید (و بنابراین یک ویژگی جدید گوگل آنالیتیکس) به پروژه فایربیس شما منجر به ایجاد یک داشبورد خالی Analytics در کنسول Firebase خواهد شد. با این حال، اگر ویژگی پیوند داده شده قبلی شما هنوز وجود دارد، میتوانید دادههای موجود را از ویژگی قدیمی به ویژگی جدید منتقل کنید.
Analytics : اگر ویژگی Analytics من و دادههای آن حذف شده باشند، آیا راهی برای بازگرداندن آنها وجود دارد؟
خیر. اگر ملک شما حذف شده باشد، امکان بازیابی آن یا بازیابی دادههای Analytics که قبلاً جمعآوری شده و در آن ملک ذخیره شدهاند، وجود ندارد.
اگر میخواهید دوباره از گوگل آنالیتیکس استفاده کنید، میتوانید یک ویژگی جدید یا یک ویژگی موجود را به پروژه فایربیس خود پیوند دهید. میتوانید این پیوند را در کنسول Firebase یا رابط کاربری گوگل آنالیتیکس انجام دهید. درباره پیوند دادن یک ویژگی گوگل آنالیتیکس به پروژه فایربیس خود بیشتر بدانید.
Analytics : اگر ویژگی Analytics من حذف شده باشد، آیا میتوانم یک ویژگی جدید Google Analytics را به پروژه Firebase خود پیوند دهم و دوباره Analytics استفاده کنم؟
اگر میخواهید دوباره از گوگل آنالیتیکس استفاده کنید، میتوانید یک ویژگی جدید یا یک ویژگی موجود را به پروژه فایربیس خود پیوند دهید. میتوانید این پیوند را در کنسول Firebase یا رابط کاربری گوگل آنالیتیکس انجام دهید. درباره پیوند دادن یک ویژگی گوگل آنالیتیکس به پروژه فایربیس خود بیشتر بدانید.
توجه داشته باشید که از آنجایی که تمام دادههای Analytics در property (نه پروژه Firebase) ذخیره میشوند، دادههای Analytics که قبلاً جمعآوری شدهاند، قابل بازیابی نیستند.
Analytics : محصولات Firebase یا محصولات یکپارچه Google چگونه تحت تأثیر حذف ویژگی Analytics من قرار خواهند گرفت؟
چندین محصول Firebase به ادغام Google Analytics متکی هستند. اگر ویژگی Analytics و دادههای آن حذف شوند، در صورت استفاده از محصولات زیر، موارد زیر اتفاق خواهد افتاد:
Crashlytics — دیگر نمیتوانید کاربران بدون خرابی، گزارشهای breadcrumb و/یا هشدارهای سرعت را ببینید.
Cloud Messaging و In-App Messaging — دیگر نمیتوانید از برچسبهای هدفگیری، معیارهای کمپین، تقسیمبندی مخاطبان و تجزیه و تحلیل استفاده کنید.
Remote Config — دیگر نمیتوانید از پیکربندیهای هدفمند یا شخصیسازی استفاده کنید.
A/B Testing — دیگر نمیتوانید A/B Testing استفاده کنید زیرا اندازهگیری آزمایش توسط گوگل آنالیتیکس ارائه میشود.
Dynamic Links - هر ویژگی که به دادههای گوگل آنالیتیکس متکی باشد، مختل خواهد شد.
علاوه بر این، ادغامهای زیر تحت تأثیر قرار خواهند گرفت:
تجزیه و تحلیل: آیا میتوانم دادههای Analytics را از یک پروژه Firebase به پروژه دیگری منتقل کنم؟
خیر، انتقال مستقیم دادههای Analytics از یک پروژه Firebase به پروژه دیگر امکانپذیر نیست. با این حال، میتوانید دادهها را از هر دو پروژه به یک مکان واحد، مانند BigQuery برای تجزیه و تحلیل، صادر و ترکیب کنید.
اگرچه انتقال دادههای موجود امکانپذیر نیست، اما میتوانید یک ویژگی موجود Analytics را به یک پروژه جدید Firebase پیوند دهید و از آن به بعد در آن پروژه جدید شروع به جمعآوری دادهها کنید. میتوانید این پیوند را در کنسول Firebase یا رابط کاربری Google Analytics انجام دهید. درباره پیوند دادن یک ویژگی به پروژه Firebase خود بیشتر بدانید.
Analytics : چگونه میتوانم کاربرانی را که معیار خاصی را برآورده نکردهاند ، تقسیمبندی کنم؟
شما میتوانید با «هدفگیری منفی» این کاربران، مشکل را از نو تعریف کنید. برای مثال، مشکل را به این شکل تعریف کنید: «تبلیغات را به افرادی که چیزی خریدهاند نشان ندهید» و مخاطبانی از این کاربران را برای هدفگیری تشکیل دهید.
Analytics : آیا مخاطبان و/یا رویدادهای تعریف شده در رابط گوگل آنالیتیکس در کنسول Firebase نیز موجود هستند؟
مخاطبان و ویژگیهای کاربر شما همگامسازی خواهند شد. برای برخی از ویژگیها، باید از رابط گوگل آنالیتیکس، مانند تقسیمبندی و قیفهای بسته، استفاده کنید. میتوانید مستقیماً از طریق لینکهای عمیق از کنسول Firebase به رابط گوگل آنالیتیکس دسترسی پیدا کنید.
هر تغییری که از کنسول Firebase ایجاد کنید، میتواند در Google Analytics نیز انجام شود و آن تغییرات در Firebase منعکس خواهند شد.
Authentication
Authentication : کدام مناطق برای احراز هویت تلفن پشتیبانی میشوند؟
Firebase Authentication از تأیید شماره تلفن در سطح جهانی پشتیبانی میکند، اما همه شبکهها پیامهای تأیید را به طور قابل اعتمادی تحویل نمیدهند. مناطق زیر نرخ تحویل خوبی دارند و انتظار میرود که برای تأیید هویت تلفنی به خوبی کار کنند. در صورت ذکر، برخی از اپراتورها به دلیل نرخ موفقیت پایین در تحویل، در یک منطقه در دسترس نیستند.
منطقه
کد
آگهی
آندورا
AE
امارات متحده عربی
اف
افغانستان
آ.گ
آنتیگوا و باربودا
ال
آلبانی
صبح
ارمنستان
آئو
آنگولا
واقعیت افزوده
آرژانتین
به عنوان
ساموآی آمریکا
در
اتریش
دانشگاه آئورلی
استرالیا
آ
آروبا
آریزونا
آذربایجان
لیسانس
بوسنی و هرزگوین
بی بی
باربادوس
بی دی
بنگلادش
باش
بلژیک
بی اف
بورکینافاسو
بی جی
بلغارستان
بیجی
بنین
بی ام
برمودا
بی ان
برونئی دارالسلام
بو
بولیوی
بی آر
برزیل
کارشناسی
باهاما
بی تی
بوتان
بی دبلیو
بوتسوانا
توسط
بلاروس
بی.زی.
بلیز
کالیفرنیا
کانادا
سی دی
کنگو، (کینشاسا)
سی اف
جمهوری آفریقای مرکزی
سی جی
کنگو (برازاویل)
چ
سوئیس
سی آی
ساحل عاج
سی کی
جزایر کوک
سی ال
شیلی
سی ام
کامرون
شرکت
کلمبیا
سی آر
کاستاریکا
رزومه
کیپ ورد
سی دابلیو
کوراسائو
سی وای
قبرس
سی زد
جمهوری چک
دی
آلمان
دیجی
جیبوتی
دی کی
دانمارک
دی ام
دومینیکا
انجام دهید
جمهوری دومینیکن
دی زد
الجزایر
ای سی
اکوادور
ای جی
مصر
ای اس
اسپانیا
ای تی
اتیوپی
اف آی
فنلاند
اف جی
فیجی
اف کی
جزایر فالکلند (مالویناس)
اف ام
میکرونزی، ایالات فدرال
فو
جزایر فارو
فرانسوی
فرانسه
جی ای
گابن
گیگابایت
بریتانیا
جی دی
گرنادا
جنرال الکتریک
جورجیا
جی اف
گویان فرانسه
جی جی
گرنزی
جی اچ
غنا
دستگاه گوارش
جبل الطارق
جی ال
گرینلند
جی ام
گامبیا
پزشک عمومی
گوادلوپ
جی کیو
گینه استوایی
جی آر
یونان
جی تی
گواتمالا
جی.
گویانا
هنگ کنگ
هنگ کنگ، منطقه اداری ویژه چین
هِن
هندوراس
منابع انسانی
کرواسی
اچ تی
هائیتی
هو
مجارستان
شناسه
اندونزی
اینترنت اکسپلورر
ایرلند
ایلینویز
اسرائیل
آی ام
جزیره من
در
هند
ضریب هوشی
عراق
فناوری اطلاعات
ایتالیا
جی ای
جرسی
جی ام
جامائیکا
جو
اردن
جی پی
ژاپن
کی ای
کنیا
کیلوگرم
قرقیزستان
خ.
کامبوج
کیلومتر
کومور
KN
سنت کیتس و نویس
کی آر
کره (جنوبی)
کیلو وات
کویت
کی
جزایر کیمن
کی زد
قزاقستان
لس آنجلس
جمهوری خلق لائوس
ل ب
لبنان
ال سی
سنت لوسیا
لی
لیختناشتاین
ال کی
سریلانکا
ال اس
لسوتو
آن
لیتوانی
لو
لوکزامبورگ
ال وی
لتونی
لی
لیبی
کارشناسی ارشد
مراکش
دکتر
مولداوی
من
مونتهنگرو
ام اف
سن مارتین (بخش فرانسوی)
ام جی
ماداگاسکار
ام کی
مقدونیه، جمهوری
میلی متر
میانمار
مینهسوتا
مغولستان
مو
ماکائو، منطقه ویژه اقتصادی چین
اماس
مونتسرات
تن
مالت
مو
موریس
مگاوات
مالاوی
ام ایکس
مکزیک
من
مالزی
ام زد
موزامبیک
نه
نامیبیا
کارولینای شمالی
کالدونیای جدید
شمال شرقی
نیجر
ان اف
جزیره نورفولک
ان جی
نیجریه
ان آی
نیکاراگوئه
هلند
هلند
خیر
نروژ
نپ
نپال
نیوزیلند
نیوزیلند
اوم
عمان
پی. ان.
پاناما
پی ای
پرو
پی جی
پاپوآ گینه نو
پی اچ
فیلیپین
پی کی
پاکستان
پی ال
لهستان
پی ام
سنت پیر و میکلون
روابط عمومی
پورتوریکو
پیاس
سرزمین فلسطین
پی تی
پرتغال
پی وای
پاراگوئه
تضمین کیفیت
قطر
دوباره
رئونیون
رو
رومانی
آر اس
صربستان
آر یو
فدراسیون روسیه
آر دبلیو
رواندا
اس ای
عربستان سعودی
اس سی
سیشل
جنوب شرقی
سوئد
اس جی
سنگاپور
ش
سنت هلنا
سی
اسلوونی
اس کی
اسلواکی
اس ال
سیرالئون
اس ان
سنگال
اس آر
سورینام
خیابان
سائوتومه و پرینسیپ
اس وی
السالوادور
س.ز.
سوازیلند
تی سی
جزایر تورکس و کایکوس
تیجی
توگو
تی اچ
تایلند
تی ال
تیمور شرقی
™
ترکمنستان
به
تونگا
تی آر
ترکیه
تی تی
ترینیداد و توباگو
تی دبلیو
تایوان، جمهوری چین
تیزد
تانزانیا، جمهوری متحده
یو ای
اوکراین
یو جی
اوگاندا
ما
ایالات متحده آمریکا
یو
اروگوئه
یو زد
ازبکستان
وی سی
سنت وینسنت و گرنادینها
وی ای
ونزوئلا (جمهوری بولیواری)
وی جی
جزایر ویرجین بریتانیا
ششم
جزایر ویرجین، ایالات متحده
وی ان
ویتنام
دبلیو اس
ساموآ
بله
یمن
ی تی
مایوت
زا
آفریقای جنوبی
ز.م.
زامبیا
زد دبلیو
زیمبابوه
Authentication : چه اتفاقی برای پیامک رایگان در طرح قیمتگذاری اسپارک افتاد؟
از سپتامبر ۲۰۲۴، برای بهبود امنیت و کیفیت خدمات احراز هویت تلفنی، پروژههای فایربیس باید به یک حساب Cloud Billing متصل شوند تا سرویس پیامک فعال و قابل استفاده شود.
Authentication : چگونه میتوانم هنگام استفاده از احراز هویت تلفنی از سوءاستفاده از طریق پیامک جلوگیری کنم؟
برای محافظت از پروژه خود در برابر افزایش ترافیک پیامکی و سوءاستفاده از API، مراحل زیر را انجام دهید:
به دنبال مناطقی با تعداد بسیار زیاد پیامک ارسالی و تعداد بسیار کم (یا صفر) پیامک تأیید شده باشید. نسبت تأیید شده/ارسال شده، میزان موفقیت شماست. میزان موفقیت سالم معمولاً در محدوده ۷۰ تا ۸۵ درصد است زیرا پیامک یک پروتکل تحویل تضمین شده نیست و برخی از مناطق ممکن است مورد سوءاستفاده قرار گیرند. میزان موفقیت کمتر از ۵۰ درصد به معنای ارسال پیامک زیاد اما ورود موفق کم است که این یک شاخص رایج از بازیگران بد و پمپاژ ترافیک پیامکی است.
از سیاست منطقه پیامکی (SMS Region Policy) استفاده کنید تا یا مناطق پیامکی با نرخ موفقیت پایین را رد کنید، یا فقط در صورتی که برنامه شما فقط برای توزیع در بازارهای خاص در نظر گرفته شده است، به مناطق خاصی اجازه ارسال دهید.
دامنههای احراز هویت مجاز خود را محدود کنید
از داشبورد تنظیمات احراز هویت برای مدیریت دامنههای مجاز استفاده کنید. دامنه localhost به طور پیشفرض به دامنههای احراز هویت تأیید شده اضافه میشود تا توسعه سادهتر شود. حذف localhost از دامنههای مجاز در پروژه عملیاتی خود را در نظر بگیرید تا از اجرای کد توسط افراد خرابکار روی localhostخود برای دسترسی به پروژه عملیاتی شما جلوگیری شود.
فعال کردن و اجرای App Check
با فعال کردن App Check از پروژه خود در برابر سوءاستفاده از API محافظت کنید. این کار با تأیید اینکه درخواستها فقط از برنامههای مرتبط با پروژه شما ارسال میشوند، انجام میشود.
به یاد داشته باشید که باید App Check برای Authentication در کنسول Firebase اعمال کنید (قبل از اعمال، نظارت بر ترافیک را در نظر بگیرید). همچنین، لیست سایتهای تأیید شده توسط reCAPTCHA Enterprise خود را دوباره بررسی کنید تا مطمئن شوید که فقط شامل سایتهای اصلی شما میشود و لیست برنامههای ثبت شده در پروژه شما در App Check دقیق است.
توجه داشته باشید که App Check با اعلام اینکه تماس از یکی از برنامههای ثبتشده شما میآید، به محافظت در برابر حملات خودکار کمک میکند. این ویژگی مانع از استفاده ناخواسته کاربران از برنامه شما نمیشود (برای مثال، شروع و عدم اتمام جریانهای ورود به سیستم برای تولید پیامکهای ارسالی).
Authentication : آیا شماره تلفنهای منتقل شده به اپراتور جدید از احراز هویت تلفنی پشتیبانی میکنند؟
در حال حاضر، شمارههایی که بین اپراتورها منتقل میشوند، منجر به غیرقابل تحویل شدن تمام پیامکها برای آن کاربران نهایی میشوند. هیچ راه حلی وجود ندارد و Firebase در حال کار بر روی این مشکل است.
Authentication : چرا در برنامه اندروید خود با خطای زیر مواجه میشوم؟ Google sign in failed ؟
اگر با خطای زیر مواجه شدید، مراحل عیبیابی موجود در این سوالات متداول را دنبال کنید:
GoogleFragment: Google sign in failed
com.google.android.gms.common.api.ApiException: 13: Unable to get token.
at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)
مطمئن شوید که ورود به سیستم گوگل به عنوان یک ارائه دهنده احراز هویت به درستی فعال شده است:
در تب روش ورود ، روش ورود به سیستم گوگل را غیرفعال و سپس دوباره فعال کنید (حتی اگر از قبل فعال باشد):
روش ورود به سیستم گوگل را باز کنید، آن را غیرفعال کنید و سپس روی ذخیره کلیک کنید.
روش ورود به سیستم گوگل را دوباره باز کنید، آن را فعال کنید و سپس روی ذخیره کلیک کنید.
همچنین، در پیکربندی ارائهدهنده ورود به سیستم گوگل در بخش Authentication ، مطمئن شوید که شناسه و رمز کلاینت OAuth با کلاینت وب نمایش داده شده در صفحه اعتبارنامهها در کنسول Google Cloud مطابقت داشته باشد (به بخش شناسههای کلاینت OAuth 2.0 مراجعه کنید).
Authentication : چرا در برنامه وب من، ورود به سیستم با تغییر مسیرها با خطای زیر مواجه میشود؟ This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation ؟
اگر با خطای زیر مواجه شدید، مراحل عیبیابی موجود در این سوالات متداول را دنبال کنید:
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.
این خطا به احتمال زیاد به این دلیل ایجاد میشود که دامنهی ریدایرکت شما به عنوان یک دامنهی مجاز برای Firebase Authentication فهرست نشده است، یا کلید API که با سرویس Firebase Authentication استفاده میکنید نامعتبر است.
ابتدا مطمئن شوید که YOUR_REDIRECT_DOMAIN در فهرست دامنههای مجاز برای پروژه Firebase شما قرار دارد. اگر دامنه ریدایرکت شما از قبل در آنجا فهرست شده است، عیبیابی کلید API نامعتبر را ادامه دهید.
به طور پیشفرض، Firebase Authentication JS SDK به کلید API پروژه Firebase شما که با عنوان Browser key برچسبگذاری شده است، متکی است و از این کلید برای تأیید اعتبار URL تغییر مسیر ورود به سیستم طبق لیست دامنههای مجاز استفاده میکند. Authentication بسته به نحوه دسترسی شما به Authentication SDK، این کلید API را دریافت میکند:
اگر از کمککنندههای احراز هویت ارائه شده توسط Hosting برای ورود کاربران با Authentication JS SDK استفاده میکنید، Firebase هر بار که در Firebase Hosting مستقر میشوید، به طور خودکار کلید API شما را با بقیه پیکربندی Firebase دریافت میکند. مطمئن شوید که authDomain در firebaseConfig برنامه وب شما به درستی پیکربندی شده است تا از یکی از دامنههای آن سایت Hosting استفاده کند. میتوانید با رفتن به https:// authDomain __/firebase/init.json و بررسی اینکه projectId با firebaseConfig شما مطابقت دارد، این موضوع را تأیید کنید.
اگر کد ورود را خودتان میزبانی میکنید ، میتوانید از فایل __/firebase/init.json برای ارائه پیکربندی Firebase به کمککننده self-hosted Authentication JS SDK Redirect استفاده کنید. کلید API و projectId ذکر شده در این فایل پیکربندی باید با firebaseConfig برنامه وب شما مطابقت داشته باشند.
بررسی کنید که این کلید API حذف نشده باشد: در کنسول Google Cloud به پنل APIs & Services > Credentials بروید، جایی که تمام کلیدهای API پروژه شما فهرست شدهاند.
اگر Browser key حذف نشده است، موارد زیر را بررسی کنید:
If you self-host the sign-in code, make sure the API key listed in your __/firebase/init.json file matches the API key in the Google Cloud console. Correct the key in the file, if necessary, then redeploy your app.
If the Browser key has been deleted, you can have Firebase generate a new API key for you: In the Firebase console, go tosettings > Project settings , then in the Your apps section, click your web app. This action automatically creates an API key that you can see in the SDK setup and configuration section for your web app.
Note that in the Google Cloud console this new API key won't be called Browser key ; instead, it will be the same name as your Firebase Web App's nickname. If you decide to add API restrictions to this new API key, make sure the Firebase Authentication API is in the list of allowed APIs.
Once your new API key is created, complete the applicable steps below:
If you use reserved Hosting URLs , then redeploy your app to Firebase so that it can automatically obtain the new API key with the rest of your Firebase configuration.
If you self-host the sign-in code , copy the new API key and add it to your __/firebase/init.json file, then redeploy your app.
Authentication : How do I manually construct an OAuth web client?
Open the Credentials page of the Google Cloud console.
At the top of the page, select Create credentials > OAuth client ID .
If you're prompted to configure your consent screen, follow the on-screen instructions, and then continue with the following steps of this FAQ.
Create the OAuth web client:
For the Application Type , select Web application .
For the Authorized JavaScript Origins , add the following:
http://localhost
http://localhost:5000
https:// PROJECT_ID .firebaseapp.com
https:// PROJECT_ID .web.app
For the Authorized Redirect URIs , add the following:
Within the Sign in method tab, open the Google sign-in provider, and then paste the web server client ID and secret you just constructed and copied from the Google Cloud console. Click Save .
Authentication : How is %APP_NAME% determined for the email template for the confirmation email that can be sent to a user when they sign up using an email address and password?
Before December 2022, the %APP_NAME% in the email template was populated with the OAuth brand name that was automatically provisioned whenever an Android app was registered in the Firebase project. Now, since the OAuth brand is provisioned only when Google sign-in is enabled, the following describes how %APP_NAME% is determined:
If the OAuth brand name is available, then the %APP_NAME% in the email template will be the OAuth brand name (same as pre-December 2022 behavior).
If the OAuth brand name is not available, here's how the %APP_NAME% in the email template is determined:
For web apps , the %APP_NAME% will be the default Firebase Hosting site name (the value preceding .firebaseapp.com and .web.app and usually the Firebase project ID).
For mobile apps:
If the Android package name or iOS bundle ID is present in the request, then the %APP_NAME% will be the app name used in the Play Store or App Store (respectively).
Otherwise, the %APP_NAME% will be the default Firebase Hosting site name (the value preceding .firebaseapp.com and .web.app and usually the Firebase project ID).
Note that if the lookup of the default Firebase Hosting site name fails, then the final fallback is to use the Firebase project ID as the %APP_NAME% .
Cloud Functions
Cloud Functions runtime support
How do I upgrade to the latest supported version of Node.js?
How can I make sure I deployed my functions to a specific Node.js runtime?
In the Firebase console, go to the functions dashboard , select a function, and check the function's language under Additional details .
I use Firebase Extensions . Will I be affected by Cloud Functions runtime updates?
Yes. Since extensions use Cloud Functions , the runtime of your extensions will need to be updated on the same timeline as Cloud Functions.
We recommend that you periodically update to the latest version of each extension installed in your project. You can upgrade your projects' extensions via the Firebase console or Firebase CLI .
Cloud Functions pricing
Why do I need a billing account to use Cloud Functions for Firebase ?
Cloud Functions for Firebase relies on some paid Google services. New function deployments with Firebase CLI 11.2.0 and higher rely on Cloud Build and Artifact Registry . Deployments to earlier versions use Cloud Build in the same way, but rely on Container Registry and Cloud Storage for storage instead of Artifact Registry . Usage of these services will be billed in addition to existing pricing.
Storage space for Firebase CLI 11.2.0 and newer versions
Artifact Registry provides the containers in which functions run. Artifact Registry provides the first 500MB at no cost, so your first function deployments may not incur any fees. If you exceed that threshold, each additional GB of storage is billed at $0.10 per month .
Storage space for Firebase CLI 11.1.x and prior versions
For functions deployed to earlier versions, Container Registry , provides the containers in which functions run. You'll be billed for each container required to deploy a function. You may notice small charges for each container stored—for example, 1GB of storage is billed at $0.026 per month .
To understand more about how your bill might change, review the following
Does Cloud Functions for Firebase still have no-cost usage?
Yes. Even on the pay-as-you-go Blaze pricing plan, Cloud Functions provides a no-cost tier for invocations, compute time, and internet traffic. The first 2,000,000 invocations, 400,000 GB-sec, 200,000 CPU-sec, and 5 GB of Internet egress traffic is provided at no cost each month. You'll be charged only for usage that exceeds those thresholds.
After the first 500MB of no-cost storage, each deployment operation will incur small-scale charges for the storage space used for the function's container. If your development process depends on deploying functions for testing, you can further minimize costs by using the Firebase Local Emulator Suite during development.
Is Firebase planning to raise the quotas and limits for Cloud Functions for Firebase ?
No. There are no plans to change the quotas except for the removal of a maximum build time limit; instead of receiving errors or warnings when the daily build quota of 120 minutes is reached, you'll be billed under the terms of the pay-as-you-go Blaze pricing plan. See Quotas and limits .
Can I get the Google Cloud $300 credit?
Yes, you can create a Cloud Billing account in the Google Cloud console to get the $300 credit, then link that Cloud Billing account to a Firebase project.
Note that if you do this, you have to then set up the Blaze pricing plan in the Firebase console in order for your project to continue working after the $300 credit is exhausted.
I want to follow a codelab to learn about Firebase. Can you give me a temporary billing account?
No, sorry. You can use the Firebase Local Emulator Suite for development without having a Cloud Billing account. Alternatively, try applying for a Google Cloud free trial . If you're still having trouble paying your bill because of this change, contact Firebase Support.
I'm worried I'm going to rack up a huge bill.
You can set up budget alerts in the Google Cloud console to help control costs. Also, you can set limits on the number of billed instances created for each of your functions. To get an idea of costing for typical scenarios, see the Cloud Functions Pricing examples.
To use extensions, you will need to upgrade to the pay-as-you-go Blaze pricing plan. You will be charged a small amount (typically around $0.01 per month ) for the Firebase resources required by each extension you install (even if they are not used), in addition to any charges associated with your use of Firebase services.
Cloud Messaging
Cloud Messaging : What's the difference between the Notifications composer and Cloud Messaging ?
Firebase Cloud Messaging ( FCM ) 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 you send messages to re-engage and retain your users, foster app growth, and support marketing campaigns.
قابلیتها
Notifications composer
Cloud Messaging
هدف
Single device
Clients subscribed to topics (for example, weather)
Clients in predefined user segment (app, version, language)
Clients in specified analytics audiences
Clients in device groups
Upstream from client to server
Message Type
Notifications up to 2kb
Data messages up to 4kb
تحویل
Immediate
Future client device local time
تجزیه و تحلیل
Built-in Notifications analytics collection and funnel analytics
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.
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 the perspective of FCM . 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 that you excludeFirebase installation data from backup. The Firebase installation data is stored in a PersistedInstallation....json file. The filename 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 easier 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.
FCM quotas and limits
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.
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 end date of the event.
Is my current quota subject to change?
While Google won't 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
Cloud Storage for Firebase : What are the changes to the default bucket announced in September 2024?
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.
We recommend monitoring your Usage page for any increases that may count towards your limits.
Cloud Storage for Firebase : How do I predict how much I will be billed for upload and download operations?
Visit the Firebase Pricing page and use the Blaze pricing 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.
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.
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 namedservice- 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 namedfirebase-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, in 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.
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.
Hosting
Hosting : Can a project on the Spark pricing plan 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.
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.
Click Delete , and confirm the files were deleted.
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 large 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?
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
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 pricing plan limit is 100 and cannot be raised. The Blaze pricing plan has 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, review options in 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.
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 DatabaseUsage 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 the Spark pricing plan storage or download limits for Realtime Database ?
To provide you with a predictable price, the resources available to you are capped when your project is on the Spark pricing plan. 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 pricing plan simultaneous connection limits for Realtime Database ?
When your app reaches its concurrency limit on the Spark pricing 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 projects that are on the Blaze pricing plan. This feature backs up your Firebase Realtime Database data once a day and uploads it to Google Cloud Storage .
We don't offer hourly backups.
Realtime Database : Why was my Realtime Database reported bandwidth lower than average between September 2016 and March 2017?
For 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
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.
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.
Firebase App Indexing is no longer the recommended way of indexing content for display as suggested results in Google Search App. This FAQ points to other useful developer products.
پلتفرمهای اپل
Universal Links are the recommended way of linking users directly from search results, websites and other apps to specific content within your app.
اندروید
Android App Links are the recommended way of linking users directly from search results, websites and other apps to specific content within your app.
You might also be interested in the following options:
App Actions : Let users launch and control Android apps with their voice, using Google Assistant.
Android Shortcuts : Provide users with quick methods to perform an action or access content in your app.
Firebase User Segmentation Storage
What is Firebase User Segmentation Storage?
Firebase User Segmentation Storage stores Firebase installation IDs and related attributes and segments as well as audience lists you've created to provide targeting information to other Firebase services that use them, such as Crashlytics , FCM , Remote Config personalization, and more.