What is a Firebase project?

A Firebase project is the top-level entity for Firebase.

What is a Google Cloud organization?

A Google Cloud organization is a container for Google Cloud projects (including Firebase projects). This hierarchy enables better organization, access management, and auditing of your Google Cloud and Firebase projects. For more information, refer to Creating and Managing Organizations.

How do I add Firebase to an existing Google Cloud project?

You may have existing projects managed through the Google Cloud Console or the Google APIs console.

Why does my Google Cloud project have a label of firebase:enabled?

In the Labels page for your project in the Google Cloud Console, you may see a label of firebase:enabled (specifically, a Key of firebase with a Value of enabled).

Why isn't my Firebase project showing up in my list of Firebase projects?

This FAQ is applicable if you don't see your Firebase project in the following places: In a list of projects that you're viewing within the Firebase console; In the response from calling the REST API projects.list endpoint; In the response from running the Firebase CLI command firebase projects:list.

How many projects can I have per account?

The limit on project quota is rarely a concern for most developers, but if needed, you can request an increase in your project quota.

How many Firebase Apps can I have in a Firebase project?

A Firebase project is a container for Firebase Apps across Apple, Android, and web. Firebase restricts the total number of Firebase Apps within a Firebase project to 30.

What happens if I tag my project as a production environment?

In the Firebase console, you can tag your Firebase projects with their environment type, either as Production or Unspecified (non-prod) environments.

Where can I find the App ID for my Firebase app?

In the Firebase console, go to your settings Project settings. Scroll down to the Your apps card, then click on the desired Firebase App to view the app's information, including its App ID.

What are the prerequisites for linking Google Play / AdMob / Google Ads / BigQuery to my Firebase project or app?

For linking your Google Play account, you need the following: Either of the following Firebase roles: Owner or Firebase Admin and Either of the following Google Play access levels: account Owner or Admin.

What open source notices should I include in my app?

On Apple platforms, the Firebase pod contains a NOTICES file which includes the relevant entries. The Firebase Android SDK contains a helper Activity for showing license information.

How do I assign a project member a role, like the Owner role?

To manage the role(s) assigned to each project member, you must be an Owner of the Firebase project (or be assigned a role with the permission resourcemanager.projects.setIamPolicy).

How do I find the Owner of a Firebase project?

If you have access to the project in the Firebase console, you can view the list of project members, including Owners, in the Users and permissions page of the Firebase console. If you do not have access to the project in the Firebase console, check if you have access to the project in the Google Cloud Console. You can view the list of project members, including Owners, in the IAM page of the Google Cloud Console. If the Owner of your project can no longer perform the tasks of an Owner (for example, the person left your company) and your project isn't managed via a Google Cloud organization (see next paragraph), you can contact Firebase Support to have a temporary Owner assigned.

Why or when should I assign a project member the Owner role?

To ensure proper management of a Firebase project, it must have an Owner.

I don't think that I have a Firebase project, but I got an email about one. How do I access this project?

The email you received should contain a link to open your Firebase project.

What are the supported browsers for accessing the Firebase console?

The Firebase console can be accessed from recent versions of popular desktop browsers such as Chrome, Firefox, Safari and Edge. Mobile browsers are currently not fully supported.

If none of the troubleshooting steps in this FAQ enable you to find or access your project, contact Firebase Support.

Why is the Firebase console not loading for me?

If none of the troubleshooting steps in this FAQ resolve the issue, contact Firebase Support.

How is my Firebase console language determined?

The language setting for the Firebase console is based on the language selected in your Google account settings.

What roles and permissions does the Firebase console support?

The Firebase console and Google Cloud Console use the same underlying roles and permissions. Learn more about roles and permissions in the Firebase IAM documentation.

Which products are paid? Which are no-cost?

Firebase's paid infrastructure products are the Realtime Database, Cloud Storage for Firebase, Cloud Functions, Hosting, Test Lab, and phone authentication. We offer a no-cost tier for all of these features.

Does Firebase offer no-cost trial credits for paid products?

Firebase paid services can be used under the Google Cloud Free Trial.

How do I know which pricing plan is right for me?

Our Spark plan is a great place to develop your app at no cost. Our Blaze plan is designed for production apps. The Blaze plan also allows you to extend your app with paid Google Cloud features. You pay only for the resources that you consume, allowing you to scale with demand. We strive to make our Blaze plan prices competitive with industry-leading cloud providers.

How can I monitor my usage and billing?

You can track your usage of project resources in the Firebase console.

What happened to the Flame pricing plan?

In January 2020, the Flame pricing plan ($25/mo of additional quota) was removed as an option for new sign-ups. Existing plan users were granted a grace period to migrate their projects off the Flame plan. In February 2022, the remaining projects on the Flame pricing plan were downgraded to the Spark pricing plan.

How is the no-cost usage in the Blaze plan different from the no-cost usage in the Spark plan?

No-cost usage on the Blaze plan is calculated daily.

Does the no-cost usage quota reset when I change from a Spark to a Blaze plan?

No-cost usage from the Spark plan is included in the Blaze plan. No-cost usage does not reset when moving to a Blaze plan.

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.

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

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

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

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

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

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

How does Firebase's integration with Google Cloud work?

Firebase is deeply integrated with Google Cloud.

What happens to my Firebase project if I add or remove billing accounts for that project in the Google Cloud Console?

If a Cloud Billing account is added to a project in the Google Cloud Console, the same project will automatically be upgraded to the Firebase Blaze plan if that project is currently on the Spark plan.

Can I upgrade, downgrade, or cancel at any time?

Yes, you can upgrade, downgrade, or cancel at any time. Note that we don't provide prorated refunds for downgrades or cancellations. This means that if you downgrade or cancel before the end of your billing period, you still pay for the remainder of the month.

What kind of support will I receive?

All Firebase apps, including those using no-cost plans, come with email support from Firebase staff during US Pacific business hours. All accounts have unlimited support for billing-related issues, account-related issues, technical (troubleshooting) questions, and incident reports.

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.

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.

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.

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

Does Cloud Functions for Firebase still have no-cost usage?

Yes. On the Blaze 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 above those thresholds.

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

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

How can I check my current billing charges?

View the Usage and billing dashboard in the Firebase console.

I use Firebase Extensions. Do I need a billing account?

Yes. Since extensions use Cloud Functions, extensions will be subject to the same charges as other functions.

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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

الأسئلة الشائعة حول Firebase

هل لديك تحديات أخرى أو ألا ترى مشكلتك موضّحة أدناه؟ يُرجى الإبلاغ عن خطأ أو طلب ميزة والانضمام إلى مناقشات تجاوز تكديس.

مشاريع Firebase وتطبيقات Firebase

ما هو مشروع Firebase؟

مشروع Firebase هو الكيان ذو المستوى الأعلى في Firebase. وفي المشروع، يمكنك تسجيل تطبيقات Apple أو Android أو تطبيقات الويب. بعد تسجيل تطبيقاتك في Firebase، يمكنك إضافة حِزم تطوير البرامج (SDK) لمنصّة Firebase الخاصة بالمنتجات إلى تطبيقك، مثل "إحصاءات Google" أو Cloud Firestore أو Crashlytics أو "الإعداد عن بُعد".

عليك تسجيل خيارات Apple وAndroid وتطبيقات الويب في مشروع واحد على Firebase. يمكنك استخدام مشاريع متعددة في Firebase لدعم بيئات متعددة، مثل التطوير والتقسيم المرحلي والإنتاج.

في ما يلي بعض المراجع للاطّلاع على مزيد من المعلومات عن مشاريع Firebase:

فهم مشاريع Firebase: يوفّر هذا القسم نظرة عامة مختصرة حول العديد من المفاهيم المهمة حول مشاريع Firebase، بما في ذلك علاقتها بخدمة Google Cloud والتسلسل الهرمي الأساسي للمشروع وتطبيقاته وموارده.
أفضل الممارسات العامة لإعداد مشاريع Firebase: توفّر أفضل الممارسات العامة وعالية المستوى لإعداد مشاريع Firebase وتسجيل تطبيقاتك في مشروع لكي تكون لديك سير عمل تطوير واضح يستخدم بيئات مختلفة.

يُرجى العِلم أنّه بالنسبة إلى جميع مشاريع Firebase، يضيف Firebase تلقائيًا تصنيف firebase:enabled ضمن صفحة التصنيفات لمشروعك في Google Cloud Console. يمكنك الاطّلاع على مزيد من المعلومات حول هذا التصنيف في الأسئلة الشائعة.

ما هي مؤسسة Google Cloud؟

مؤسسة Google Cloud هي حاوية لمشاريع Google Cloud (بما في ذلك مشاريع Firebase). يتيح هذا العرض الهرمي تنظيم مشاريعك على Google Cloud وFirebase بشكلٍ أفضل، وإدارة أذونات الوصول، والتدقيق فيها. لمزيد من المعلومات، راجِع إنشاء المؤسسات وإدارتها.

كيف يمكنني إضافة Firebase إلى مشروع حالي على Google Cloud؟

قد تكون لديك مشاريع حالية على Google Cloud مُدارة من خلال Google Cloud Console أو وحدة تحكُّم Google APIs.

يمكنك إضافة منصّة Firebase إلى هذه المشاريع الحالية باستخدام أيّ من الخيارات التالية:

باستخدام "وحدة تحكُّم Firebase":
في الصفحة المقصودة لوحدة تحكُّم Firebase، انقر على إضافة مشروع، ثم اختَر مشروعك الحالي من قائمة اسم المشروع.
باستخدام خيار آلي:
- عليك طلب نقطة نهاية واجهة برمجة التطبيقات REST API في Firebase addFirebase.
- شغِّل الأمر CLI في Firebase firebase projects:addfirebase.
- استخدِم Teraform.

لماذا يحمل مشروعي على Google Cloud التصنيف `firebase:enabled`؟

في صفحة التصنيفات الخاصة بمشروعك في Google Cloud Console، قد يظهر لك تصنيف firebase:enabled (على وجه التحديد، Key من firebase مع Value من enabled).

أضافت منصة Firebase هذا التصنيف تلقائيًا لأنّ مشروعك هو مشروع في Firebase، ما يعني أنّ مشروعك يتضمّن إعدادات وخدمات خاصة بمنصة Firebase مفعّلة. يمكنك الاطّلاع على مزيد من المعلومات عن العلاقة بين مشاريع Firebase وGoogle Cloud.

ننصحك بشدة بعدم تعديل هذا التصنيف أو حذفه. يستخدم كل من Firebase وGoogle Cloud هذا التصنيف لإدراج مشاريعك في Firebase (على سبيل المثال، باستخدام نقطة نهاية واجهة برمجة تطبيقات RST projects.list أو في القوائم ضمن "وحدة تحكُّم Firebase").

ويجب الانتباه إلى أنّ إضافة هذا التصنيف يدويًا إلى قائمة تصنيفات المشاريع لا يؤدي إلى تفعيل الإعدادات والخدمات الخاصة بمنصة Firebase لمشروعك على Google Cloud. لتنفيذ ذلك، يجب إضافة Firebase من خلال وحدة تحكُّم Firebase (أو من خلال واجهة برمجة تطبيقات Firebase Management REST أو واجهة سطر الأوامر في Firebase، وذلك في حالات الاستخدام المتقدّمة).

لماذا لا يظهر مشروعي في Firebase في قائمة مشاريع Firebase؟

يمكن استخدام هذه الأسئلة الشائعة إذا لم يظهر لك مشروع Firebase في الأماكن التالية:

في قائمة المشاريع التي تشاهدها ضمن وحدة تحكُّم Firebase
في الرد من طلب نقطة نهاية REST API projects.list
في الاستجابة من تشغيل الأمر CLI في Firebase firebase projects:list

جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

أولاً، جرِّب الوصول إلى مشروعك من خلال الانتقال إلى عنوان URL الخاص بالمشروع مباشرةً. استخدِم التنسيق التالي:
https://console.firebase.google.com/project/PROJECT-ID/overview
إذا لم تتمكّن من الوصول إلى المشروع أو لم تظهر لك أخطاء في الأذونات، تحقَّق مما يلي:
- تأكّد من تسجيل الدخول إلى Firebase باستخدام حساب Google نفسه الذي يملك إذن الوصول إلى المشروع. يمكنك تسجيل الدخول إلى "وحدة تحكُّم Firebase" والخروج منها من خلال الصورة الرمزية لحسابك في أعلى يسار وحدة التحكُّم.
- تحقَّق مما إذا كان بإمكانك عرض المشروع في وحدة تحكُّم Google Cloud.
- تأكَّد من أنّ مشروعك يحمل التصنيف firebase:enabled في صفحة التصنيفات لمشروعك على Google Cloud Console. ويستخدم Firebase وGoogle Cloud هذا التصنيف لإدراج مشاريعك في Firebase. إذا لم يظهر لك هذا التصنيف ولكن واجهة برمجة التطبيقات لإدارة Firebase مفعّلة لمشروعك، أضِف التصنيف يدويًا (خصوصًا Key من firebase مع Value من enabled).
- تأكَّد من إسناد أحد أدوار إدارة الهوية وإمكانية الوصول الأساسية (المالك أو المحرِّر أو المُشاهد) أو دور يتضمّن أذونات ذات صلة بمنصة Firebase، على سبيل المثال، دور محدّد مسبقًا في Firebase. يمكنك الاطّلاع على أدوارك في صفحة إدارة الهوية وإمكانية الوصول في Google Cloud Console.
- إذا كان مشروعك ينتمي إلى مؤسسة على Google Cloud، قد تحتاج إلى الحصول على أذونات إضافية للاطّلاع على المشروع المُدرَج في "وحدة تحكُّم Firebase". يمكنك التواصل مع الشخص الذي يدير مؤسستك على Google Cloud لمنحك الدور المناسب لعرض المشروع، مثل دور المتصفّح.

إذا لم تسمح لك أي من خطوات تحديد المشاكل وحلّها المذكورة أعلاه بعرض مشروعك في قائمة مشاريع Firebase، يُرجى التواصل مع فريق دعم Firebase.

كم عدد المشاريع التي يمكنني امتلاكها في كل حساب؟

خطة التسعير Spark خطة الأسعار: تقتصر حصة مشروعك على عدد صغير من المشاريع (عادةً من 5 إلى 10 مشاريع).
خطة الأسعار - تزيد حصة مشروعك لكل حساب فوترة في Cloud بشكل كبير ما دام حساب فوترة Cloud في وضع جيد.

نادرًا ما يكون الحدّ الأقصى لحصة المشروع مهمًا بالنسبة إلى معظم المطوّرين، ولكن يمكنك طلب زيادة الحصة الخاصة بالمشروع إذا لزم الأمر.

يُرجى العِلم أنّ الحذف الكامل للمشروع يتطلب 30 يومًا ويتم احتسابه ضمن حصتك إلى أن يتم حذفه بالكامل.

كم عدد تطبيقات Firebase التي يمكنني الحصول عليها في مشروع على Firebase؟

مشروع Firebase هو حاوية لتطبيقات Firebase على مستوى Apple وAndroid والويب. تحظر Firebase إجمالي عدد تطبيقات Firebase ضمن مشروع Firebase إلى 30 تطبيقًا.

وبعد هذا العدد، يبدأ تدهور الأداء (خاصةً بالنسبة إلى "إحصاءات Google")، وفي النهاية تتوقف بعض وظائف المنتج عن العمل مع عدد أكبر من التطبيقات. بالإضافة إلى ذلك، إذا كنت تستخدم تسجيل الدخول بحساب Google كموفّر مصادقة، يتم إنشاء معرّف عميل OAuth 2.0 أساسي لكل تطبيق في مشروعك. ويمكن إنشاء حدّ أقصى يبلغ 30 معرّف عميل تقريبًا ضمن مشروع واحد.

يجب التأكّد من أنّ جميع تطبيقات Firebase ضمن مشروع واحد في Firebase هي نُسخ للنظام الأساسي للتطبيق نفسه من منظور المستخدم النهائي. على سبيل المثال، إذا طوّرت تطبيق تسمية أولية، يجب أن يكون لكل تطبيق مصنَّف بشكل مستقل مشروعه الخاص على Firebase، ولكن يمكن أن يكون إصدارا Apple وAndroid من هذا التصنيف ضمن المشروع نفسه. يمكنك الاطّلاع على إرشادات أكثر تفصيلاً في أفضل الممارسات العامة لإعداد مشاريع Firebase.

في الحالات النادرة التي يتطلّب مشروعك فيها أكثر من 30 تطبيقًا، يمكنك طلب زيادة الحدّ الأقصى المسموح به للتطبيقات. يجب أن يكون مشروعك ضمن خطة أسعار Blaze لإرسال هذا الطلب. يمكنك الانتقال إلى Google Cloud Console لتقديم طلبك وتقييمه. تعرَّف على مزيد من المعلومات حول إدارة الحصص ضمن مستندات Google Cloud.

ماذا يحدث إذا وضعت علامة على مشروعي كبيئة "إنتاج"؟

في "وحدة تحكُّم Firebase"، يمكنك وضع علامة على مشاريعك في Firebase باستخدام نوع بيئتها، إمّا كبيئات إنتاج أو غير محدّدة (غير إنتاجية).

إنّ وضع علامة على مشروعك كنوع بيئة لا يؤثر في آلية عمل مشروعك على Firebase أو في ميزاته. في المقابل، يمكن أن يساعدك وضع العلامات أنت وفريقك في إدارة مشاريع Firebase المختلفة طوال مراحل نشاط التطبيق.

إذا وضعت علامة على مشروعك كبيئة إنتاج، سنضيف علامة Prod ذات ألوان زاهية إلى المشروع في وحدة تحكُّم Firebase، لتذكيرك بأنّ أي تغييرات قد تؤثّر في تطبيقات الإنتاج المرتبطة بحسابك. في المستقبل، قد نضيف المزيد من الميزات وإجراءات الوقاية لمشاريع Firebase التي يتم وضع علامة عليها باعتبارها بيئات إنتاج.

لتغيير نوع البيئة في مشروعك على Firebase، انتقِل إلى إعدادات المشروع > الإعدادات العامة، ثم في بطاقة مشروعك ضمن البيئة، انقر على لتغيير نوع البيئة.

أين يمكنني العثور على رقم تعريف التطبيق لتطبيقي في Firebase؟

في "وحدة تحكُّم Firebase"، انتقِل إلى إعدادات المشروع. انتقِل للأسفل وصولاً إلى بطاقة تطبيقاتك، ثم انقر على تطبيق Firebase المطلوب لعرض معلومات التطبيق، بما في ذلك رقم تعريف التطبيق.

في ما يلي بعض الأمثلة على قيم رقم تعريف التطبيق:

تطبيقات Firebase لنظام التشغيل iOS: 1:1234567890:ios:321abc456def7890
تطبيقات Android على Firebase: 1:1234567890:android:321abc456def7890
تطبيقات الويب في Firebase: 1:1234567890:web:321abc456def7890

ما هي المتطلّبات الأساسية لربط Google Play أو AdMob أو "إعلانات Google" أو BigQuery بمشروعي أو تطبيقي على Firebase؟

لربط حسابك على Google Play، يجب توفُّر ما يلي:
- أيٌّ من الدورَين التاليين في Firebase: المالك أو مشرف Firebase
- أيٌّ من مستويات الوصول التالية إلى Google Play: صاحب الحساب أو المشرف
لربط تطبيق AdMob، يجب أن تكون مالك مشروع Firebase ومشرف AdMob في الوقت نفسه.
لربط حسابك على AdWords، يجب أن تكون مالك مشروع Firebase ومشرف AdWords في الوقت نفسه.
لربط مشروعك على BigQuery، يجب أن تكون مالك مشروع Firebase.

ما هي الإشعارات مفتوحة المصدر التي يجب تضمينها في تطبيقي؟

على أنظمة Apple الأساسية، تحتوي مجموعة Firebase المتسلسلة على ملف NotificationsS يتضمّن الإدخالات ذات الصلة. تحتوي حزمة تطوير البرامج (SDK) لنظام التشغيل Android لمنصة Firebase على مساعد Activity لعرض معلومات الترخيص.

الأذونات والوصول إلى مشاريع Firebase

كيف يمكنني تعيين دور لأحد أعضاء المشروع، مثل دور المالك؟

لإدارة الأدوار التي تم إسنادها إلى كل عضو في المشروع، يجب أن تكون مالكًا لمشروع Firebase (أو أن يتم إسناد دور لك لديه الإذن resourcemanager.projects.setIamPolicy).

في ما يلي الأماكن التي يمكنك من خلالها تعيين الأدوار وإدارتها:

توفّر "وحدة تحكّم Firebase" طريقة مبسّطة لإسناد الأدوار لأعضاء المشروع في علامة التبويب المستخدمون والأذونات ضمن > إعدادات المشروع. في "وحدة تحكُّم Firebase"، يمكنك إسناد أي من الأدوار الأساسية (المالك أو المحرِّر أو المُشاهد) أو أدوار المشرف/المُشاهد في Firebase أو أيّ من أدوار فئة المنتج المحدَّدة مسبقًا في Firebase.
توفِّر Google Cloud Console مجموعة واسعة من الأدوات لإسناد الأدوار لأعضاء المشروع في صفحة إدارة الهوية وإمكانية الوصول. في Cloud Console، يمكنك أيضًا إنشاء أدوار مخصَّصة وإدارتها، بالإضافة إلى منح حسابات الخدمة إذن الوصول إلى مشروعك.
يُرجى ملاحظة أنّه في Google Cloud Console، يُطلق على أعضاء المشروع اسم المبدأون.

إذا لم يعُد بإمكان مالك المشروع أداء مهام أحد المالكين (على سبيل المثال، الشخص الذي غادر شركتك) ولم يكن مشروعك مُدارًا من خلال مؤسسة على Google Cloud (راجِع الفقرة التالية)، يمكنك التواصل مع فريق دعم Firebase لتحديد مالك مؤقت.

تجدر الإشارة إلى أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، قد لا يكون له مالك. إذا لم تتمكن من العثور على مالك لمشروعك على Firebase، تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لتعيين مالك للمشروع.

كيف يمكنني العثور على مالك مشروع على Firebase؟

يمكنك الاطّلاع على أعضاء المشروع وأدوارهم في الأماكن التالية:

إذا كان لديك إذن الوصول إلى المشروع في وحدة تحكُّم Firebase، يمكنك عرض قائمة بأعضاء المشروع، بما في ذلك المالكون، في صفحة "المستخدمون والأذونات" ضمن "وحدة تحكُّم Firebase".
إذا لم يكن لديك إذن الوصول إلى المشروع في وحدة تحكُّم Firebase، تحقَّق مما إذا كان بإمكانك الوصول إلى المشروع في Google Cloud Console. يمكنك عرض قائمة بأعضاء المشروع، بما في ذلك المالكون، في صفحة إدارة الهوية وإمكانية الوصول ضمن Google Cloud Console.

إذا لم يعُد بإمكان مالك المشروع أداء مهام أحد المالكين (على سبيل المثال، مغادرة الشخص شركتك) ولم يكن مشروعك يُدار من خلال مؤسسة في Google Cloud (راجِع الفقرة التالية)، يمكنك التواصل مع فريق دعم Firebase لتحديد مالك مؤقت.

تجدر الإشارة إلى أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، قد لا يكون له مالك. بدلاً من ذلك، يمكن للمستخدم الذي يدير مؤسستك في Google Cloud تنفيذ العديد من المهام التي يمكن للمالك تنفيذها، ولكن لتنفيذ العديد من المهام الخاصة بالمالك (مثل إسناد الأدوار أو إدارة مواقع "إحصاءات Google")، قد يحتاج المشرف إلى إسناد دور المالك الفعلي إلى نفسه لأداء هذه المهام. إذا لم تتمكّن من العثور على مالك لمشروعك على Firebase، تواصَل مع الشخص الذي يدير مؤسستك على Google Cloud لتحديد مالك للمشروع.

لماذا أو متى يجب عليّ تعيين دور "المالك" لأحد أعضاء المشروع؟

لضمان الإدارة المناسبة لمشروع Firebase، يجب أن يكون له مالك. مالك المشروع هو الشخص الذي يمكنه تنفيذ العديد من الإجراءات الإدارية المهمة (مثل تعيين الأدوار وإدارة مواقع "إحصاءات Google")، ويمكن لفريق دعم Firebase تنفيذ الطلبات الإدارية فقط من مالكي المشروعات الذين تم إثبات هويتهم.

بعد إعداد المالكين لمشروع على Firebase، من المهم تعديل هذه المهام باستمرار.

تجدر الإشارة إلى أنّه إذا كان مشروع Firebase جزءًا من مؤسسة على Google Cloud، يمكن للشخص الذي يدير مؤسستك على Google Cloud تنفيذ العديد من المهام التي يمكن للمالك تنفيذها. ومع ذلك، بالنسبة إلى العديد من المهام الخاصة بالمالك (مثل إسناد الأدوار أو إدارة مواقع "إحصاءات Google")، قد يحتاج المشرف إلى إسناد دور المالك الفعلي إلى نفسه لأداء تلك المهام.

لا أعتقد أنّ لديّ مشروع في Firebase، ولكن تلقّيتُ رسالة إلكترونية بشأن هذا المشروع. كيف يمكنني الوصول إلى هذا المشروع؟

يجب أن تحتوي الرسالة الإلكترونية التي تلقّيتها على رابط لفتح مشروعك على Firebase. من المفترض أن يؤدي النقر على الرابط في الرسالة الإلكترونية إلى فتح المشروع في "وحدة تحكُّم Firebase".

إذا لم تتمكّن من فتح المشروع في الرابط، تأكّد من تسجيل الدخول إلى Firebase باستخدام حساب Google نفسه الذي تلقّى الرسالة الإلكترونية المتعلّقة بالمشروع. يمكنك تسجيل الدخول إلى "وحدة تحكُّم Firebase" والخروج منها من خلال الصورة الرمزية لحسابك في أعلى يسار وحدة التحكُّم.

يُرجى العِلم أنّه إذا كنت مشرفًا لمؤسسة على Google Cloud، قد يتم إعلامك بالتغييرات التي تطرأ على مشاريع Firebase داخل مؤسستك. وبالمقابل، قد لا تكون لديك أذونات كافية لفتح مشروع Firebase. في هذه الحالات، يكون أبسط الحلول هو أن تمنح نفسك دور المالك الفعلي لفتح المشروع وتنفيذ الإجراءات المطلوبة. مزيد من المعلومات عن سبب تعيين دور المالك ومتى يتم ذلك.

الأنظمة الأساسية وأطر العمل

انتقِل إلى صفحات تحديد المشاكل وحلّها الخاصة بالمنصة والأسئلة الشائعة للحصول على نصائح وإجابات مفيدة لمزيد من الأسئلة الشائعة.

وحدة تحكُّم Firebase

ما هي المتصفّحات المتوافقة للوصول إلى "وحدة تحكّم Firebase"؟

يمكن الوصول إلى "وحدة تحكُّم Firebase" من خلال إصدارات حديثة من المتصفحات الشائعة المتوافقة مع أجهزة الكمبيوتر المكتبي، مثل Chrome وFirefox وSafari وEdge. متصفِّحات الأجهزة الجوّالة غير متوافقة حاليًا بشكل كامل.

يمكنني تحميل "وحدة تحكُّم Firebase"، ولكن لماذا لا يمكنني العثور على مشروعي في Firebase أو الوصول إليه؟

يمكنك الاطّلاع على هذه الأسئلة الشائعة إذا كنت تواجه أيًا من المشاكل التالية:

تعرض "وحدة تحكُّم Firebase" صفحة خطأ تفيد بأنّ مشروعك قد لا يكون متاحًا أو أنّه ليس لديك إذن بالوصول إليه.
لا تعرض "وحدة تحكُّم Firebase" مشروعك حتى عند إدخال رقم تعريف المشروع أو اسم المشروع في حقل البحث بوحدة التحكّم.

جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

أولاً، جرِّب الوصول إلى مشروعك من خلال الانتقال إلى عنوان URL الخاص بالمشروع مباشرةً. استخدِم التنسيق التالي:
https://console.firebase.google.com/project/PROJECT-ID/overview
إذا تعذّر عليك الوصول إلى المشروع أو ظهرت لك أخطاء في الأذونات، تحقَّق مما يلي:
- تأكّد من تسجيل الدخول إلى Firebase باستخدام حساب Google نفسه الذي يملك إذن الوصول إلى المشروع. يمكنك تسجيل الدخول إلى "وحدة تحكُّم Firebase" والخروج منها من خلال الصورة الرمزية لحسابك في أعلى يسار وحدة التحكُّم.
- تأكَّد من أنّ واجهة برمجة التطبيقات لإدارة Firebase مفعّلة للمشروع.
- تأكَّد من إسناد أحد أدوار إدارة الهوية وإمكانية الوصول الأساسية (المالك أو المحرِّر أو المُشاهد) أو دور يتضمّن أذونات ذات صلة بمنصّة Firebase، على سبيل المثال دور محدَّد مسبقًا في Firebase. يمكنك الاطّلاع على أدوارك في صفحة إدارة الهوية وإمكانية الوصول في Google Cloud Console.
- إذا كان مشروعك تابعًا لمؤسسة على Google Cloud، قد تحتاج إلى الحصول على أذونات إضافية للاطّلاع على المشروع المُدرَج في "وحدة تحكُّم Firebase". يمكنك التواصل مع الشخص الذي يدير مؤسستك على Google Cloud لمنحك الدور المناسب لعرض المشروع، مثل دور المتصفّح.

إذا لم تساعدك أي من خطوات تحديد المشاكل وحلّها المذكورة أعلاه في العثور على مشروعك أو الوصول إليه، يُرجى التواصل مع فريق دعم Firebase.

لماذا لا يتم تحميل "وحدة تحكُّم Firebase" بالنيابة عني؟

يمكنك استخدام هذه الأسئلة الشائعة إذا كنت تواجه أيًا من المشاكل التالية:

لا ينتهي تحميل صفحة في "وحدة تحكُّم Firebase" مطلقًا.
لا يتم تحميل البيانات داخل الصفحة على النحو المتوقّع.
ستظهر لك رسائل خطأ في المتصفِّح عند تحميل "وحدة تحكُّم Firebase".

جرِّب الخطوات التالية لتحديد المشاكل وحلّها:

تحقَّق من صف وحدة التحكّم في لوحة بيانات حالة Firebase بحثًا عن أي انقطاعات محتمَلة في الخدمة.
احرص على استخدام متصفّح متوافق.
يمكنك محاولة تحميل "وحدة تحكُّم Firebase" في نافذة تصفّح متخفٍ أو نافذة خاصة.
أوقِف جميع إضافات المتصفِّح.
تأكَّد من عدم حظر الاتصال بالشبكة باستخدام أداة حظر الإعلانات أو برنامج مكافحة الفيروسات أو الخادم الوكيل أو جدار الحماية أو أي برنامج آخر.
جرِّب تحميل "وحدة تحكُّم Firebase" باستخدام شبكة مختلفة أو جهاز مختلف.
في حال استخدام Chrome، تحقَّق من وحدة تحكم أدوات المطوّرين بحثًا عن أي أخطاء.

إذا لم تنجح أي من خطوات تحديد المشاكل وحلّها المذكورة أعلاه في حلّ المشكلة، يُرجى التواصل مع فريق دعم Firebase.

كيف يتم تحديد لغة "وحدة تحكُّم Firebase"؟

يستند إعداد اللغة في "وحدة تحكّم Firebase" إلى اللغة المحدّدة في إعدادات حسابك على Google.

لتغيير إعدادات اللغة المفضّلة، يُرجى الاطّلاع على تغيير اللغة.

تتوفّر "وحدة تحكُّم Firebase" باللغات التالية:

الإنجليزية
البرتغالية البرازيلية
مأكولات فرنسية
الألمانية
الإندونيسية
مأكولات يابانية
الكورية
الروسية
الصينية المبسطة
مأكولات إسبانية
الصينية التقليدية

ما هي الأدوار والأذونات التي توفّرها "وحدة تحكُّم Firebase"؟

تستخدم "وحدة تحكُّم Firebase" وGoogle Cloud Console الأدوار والأذونات الأساسية نفسها. اطّلِع على مزيد من المعلومات عن الأدوار والأذونات في مستندات "إدارة الهوية وإمكانية الوصول" على Firebase.

يتيح Firebase الأدوار الأساسية (الأساسية) للمالك والمحرِّر والمُشاهد:

يمكن لمالك المشروع إضافة أعضاء آخرين إلى المشروع، وإعداد عمليات الدمج (ربط المشروع بخدمات مثل BigQuery أو Slack)، ولديه إمكانية الوصول الكامل لإجراء تعديلات على المشروع.
يملك محرِّر المشروع الإذن الكامل بتعديل المشروع.
يملك مُشاهد المشروع إذن وصول للقراءة فقط. تجدر الإشارة إلى أنّ وحدة تحكُّم Firebase لا تخفي أو توقِف حاليًا عناصر التحكّم في تعديل واجهة المستخدم من مشاهدي المشروع، ولكن ستتعذّر هذه العمليات لأعضاء المشروع الذين تم تعيين دور "المُشاهد" لهم.

يتوافق Firebase أيضًا مع:

الأدوار المحدَّدة مسبقًا في Firebase : أدوار منظَّمة في Firebase وتتيح إمكانية التحكّم في الوصول بدقة أكبر مقارنةً بالأدوار الأساسية لكل من "المالك" و"المحرِّر" و"المُشاهد".
الأدوار المخصَّصة - أدوار مخصَّصة بالكامل في "إدارة الهوية وإمكانية الوصول" تُنشئها لتخصيص مجموعة من الأذونات التي تستوفي المتطلبات المحدّدة لمؤسستك.

الأسعار

ما هي المنتجات التي يتم دفع رسومها؟ وأيها يتوفّر بدون تكلفة؟

ومنتجات البنية الأساسية المدفوعة من Firebase هي "قاعدة بيانات الوقت الفعلي" وCloud Storage لبرنامج Firebase ووظائف Cloud و"الاستضافة" وTest Lab والمصادقة على الهاتف. ونقدّم فئة مجانية لكل هذه الميزات.

وتوفّر منصة Firebase أيضًا العديد من المنتجات المجانية، وهي: "إحصاءات Google" و"المراسلة عبر السحابة الإلكترونية" وأداة إنشاء الإشعارات و"الإعداد عن بُعد" و"فهرسة التطبيقات" و"الروابط الديناميكية" و"إعداد تقارير الأعطال". يخضع استخدام هذه المنتجات لسياسات مراقبة الزيارات الخاصة بالمنتج فقط (مثل الحصص وإمكانية الوصول العادل ووسائل حماية الخدمة الأخرى) في جميع الخطط، بما في ذلك خطة Spark بدون تكلفة. بالإضافة إلى ذلك، فإنّ جميع ميزات "المصادقة" التي تتجاوز المصادقة على الهاتف لن تُفرَض أي تكلفة.

هل يقدّم Firebase أرصدة فترة تجريبية بدون تكلفة للمنتجات المدفوعة؟

يمكن استخدام خدمات Firebase المدفوعة ضمن الفترة التجريبية المجانية من Google Cloud. يمكن لمستخدمي Google Cloud وFirebase الجدد الاستفادة من فترة تجريبية مدتها 90 يومًا تتضمن أرصدة فوترة Cloud مجانية بقيمة 300 دولار أمريكي (أو ما يعادلها بالعملة المحلية) لاستكشاف منتجات وخدمات Google Cloud وFirebase وتقييمها.

خلال الفترة التجريبية المجانية من Google Cloud، سيتوفّر لك "حساب فوترة Cloud للفترة التجريبية المجانية". وسيكون أي مشروع في Firebase يستخدم حساب الفوترة هذا ضمن خطة أسعار Blaze خلال الفترة التجريبية المجانية.

لا داعي للقلق، لا يتيح لنا إعداد حساب فوترة "الفترة التجريبية المجانية" هذا تحصيل الرسوم منك. ولن يتم تحصيل أي رسوم منك ما لم تفعِّل الفوترة صراحةً من خلال ترقية حساب فوترة "الفترة التجريبية المجانية في Cloud" إلى حساب مدفوع. يمكنك الترقية إلى حساب مدفوع في أي وقت أثناء الفترة التجريبية. بعد الترقية، سيظل بإمكانك استخدام أي أرصدة متبقية (خلال فترة 90 يومًا).

بعد انتهاء الفترة التجريبية المجانية، ستحتاج إما إلى إرجاع مشروعك إلى خطة أسعار Spark أو إعداد خطة أسعار Blaze في وحدة تحكُّم Firebase لمواصلة استخدام مشروعك في Firebase.

تعرَّف على مزيد من المعلومات حول الفترة التجريبية المجانية من Google Cloud.

كيف يمكنني معرفة خطة الأسعار المناسبة لي؟

خطة أسعار Spark

تُعد خطة Spark موقع مثالي لتطوير تطبيقك بدون تكلفة. يمكنك الاستفادة من جميع ميزات Firebase المجانية ("إحصاءات Google" وأداة إنشاء الإشعارات وCrashlytics وما إلى ذلك) والكثير من ميزات البنية الأساسية المدفوعة. في حال تجاوز موارد خطة Spark خلال شهر تقويمي معيّن، سيتم إيقاف تطبيقك لبقية الشهر. بالإضافة إلى ذلك، لا تتوفر ميزات Google Cloud عند استخدام خطة Spark.

خطة أسعار Blaze

صُمِّمت خطة Blaze لتطبيقات الإنتاج. تسمح لك خطة Blaze أيضًا بتوسيع نطاق تطبيقك باستخدام ميزات Google Cloud المدفوعة. لن تدفع إلا مقابل الموارد التي تستهلكها، ما يتيح لك التوسّع في نطاق الطلب. نسعى جاهدين لجعل أسعار خطط Blaze تنافسية مع مقدّمي خدمات السحابة الإلكترونية الرائدين في المجال.

كيف يمكنني مراقبة الاستخدام والفوترة؟

يمكنك تتبُّع استخدامك لموارد المشاريع في "وحدة تحكُّم Firebase" على أيّ من لوحات البيانات التالية:

ماذا حدث لخطة أسعار Flame؟

في كانون الثاني (يناير) 2020، تمت إزالة خطة أسعار Flame (25 دولار أمريكي في الشهر من الحصة الإضافية) كخيار للاشتراكات الجديدة. وتم منح مستخدمي الخطة الحاليين فترة سماح لنقل مشاريعهم من خطة Flame. في شباط (فبراير) 2022، تم خفض ترتيب المشاريع المتبقية في خطة أسعار Flame إلى خطة أسعار Spark.
وبناءً عليه،

لا يمكن لمشاريع خطط Spark and Blaze الحالية وأي مشاريع جديدة التبديل إلى خطة Flame أو الاشتراك فيها بعد ذلك.
في حال نقل مشروع خطة Flame حالي إلى خطة أسعار مختلفة، لا يمكن إعادة المشروع إلى خطة Flame.
يمكن ترقية المشاريع التي تم الرجوع إليها إلى خطة Spark إلى خطة Blaze لاستئناف الخدمات المدفوعة الإضافية.
تمت إزالة الإشارات إلى خطة Flame من المستندات.

هل لديك المزيد من الأسئلة حول إيقاف خطة Flame؟ يمكنك الاطّلاع على بعض الأسئلة الشائعة الإضافية أدناه.

هل تريد التعرّف على خطط الأسعار الأخرى التي يقدّمها Firebase؟ انتقِل إلى صفحة أسعار Firebase. إذا أردت البدء في نقل أي مشاريع حالية إلى خطة أسعار أخرى، يمكنك إجراء ذلك في وحدة تحكّم Firebase الخاصة بمشروعك.

أسئلة شائعة إضافية حول إيقاف خطة Flame

لديّ مشروع أو عملية أو نموذج أعمال يعتمد على تكلفة ثابتة في Firebase. ماذا يجب أن أفعل؟

اشترِك في خطة أسعار Blaze وتأكَّد من ضبط تنبيهات بشأن الميزانية.

هل سيتم منحني إذن وصول خاص لإنشاء مشاريع خطة Flame جديدة؟

لا، لا يوفّر Firebase وصولاً خاصًا للمشاريع للتبديل إلى خطة Flame أو الاشتراك فيها.

لقد غيّرت مشروع خطة Flame إلى خطة أسعار مختلفة. كيف يمكنني تغييره مرة أخرى؟

لم يعُد بإمكانك التبديل إلى خطة Flame. للحصول على الخدمات التي توفّرها خطة Flame، احرص على استخدام خطة أسعار Blaze وفكِّر في إعداد تنبيهات بشأن الميزانية لمشروعك.

تم تبديل مشروعي تلقائيًا إلى خطة أسعار مختلفة كجزء من الإيقاف النهائي لخطة Flame. ماذا يجب أن أفعل؟

إذا كان مشروعك يتطلب حصة إضافية غير تلك المتوفرة في خطة Spark، عليك ترقية مشروعك إلى خطة أسعار Blaze.

لماذا ستتم إزالة خطة Flame؟

على مر السنين، شهدنا تراجعًا في استخدام خطة Flame، وأنّ معظم المشاريع التي تستخدم الخطة لا تستهلك قيمتها بالكامل. لا يُعدّ الإبقاء على خطة الأسعار هذه موفّرة من حيث التكلفة بشكل عام، ونعتقد أنّه يمكننا خدمة الجميع بشكل أفضل إذا تم تخصيص الموارد لمبادرات أخرى من Firebase.

كيف يختلف الاستخدام بدون تكلفة في خطة Blaze بدون تكلفة في خطة Spark؟

يتم احتساب الاستخدام بدون تكلفة ضمن خطة Blaze يوميًا. تختلف أيضًا حدود الاستخدام عن خطة Spark لوظائف Cloud ومصادقة الهاتف وTest Lab.

بالنسبة إلى وظائف Cloud، يتم احتساب الاستخدام بدون تكلفة في خطة Blaze على مستوى حساب الفوترة في Cloud، وليس على مستوى المشروع، ويكون له الحدود التالية:

مليونا استدعاء شهريًا
400 ألف غيغابايت في الثانية/شهر
200 ألف وحدة معالجة مركزية/ثانية/شهر
5 غيغابايت من خروج الاتصال بالشبكة في الشهر

بالنسبة إلى مصادقة الهاتف، يتم احتساب الاستخدام المجاني ضمن خطة Blaze شهريًا.

بالنسبة إلى Test Lab، يتم فرض الحدود التالية على الاستخدام المجاني ضمن خطة Blaze:

30 دقيقة على الجهاز في اليوم
60 دقيقة للأجهزة الافتراضية في اليوم

هل تتم إعادة ضبط حصة الاستخدام بدون تكلفة عند التغيير من خطة Spark إلى خطة Blaze؟

تشمل خطة Blaze الاستخدام بدون تكلفة من خطة Spark. لا تتم إعادة ضبط الاستخدام بدون تكلفة عند الانتقال إلى خطة بليز.

ما المقصود بـ "اتصال قاعدة بيانات متزامن"؟

يعادل الاتصال المتزامن جهاز جوّال واحد أو علامة تبويب في المتصفح أو تطبيق خادم متصل بقاعدة البيانات. يفرض Firebase حدودًا صارمة على عدد الاتصالات المتزامنة بقاعدة بيانات تطبيقك. وقد تم وضع هذه الحدود لحماية كلٍّ من Firebase والمستخدمين من إساءة الاستخدام.

إنّ الحدّ الأقصى المسموح به لخطة Spark هو 100 مستخدم ولا يمكن رفعه. الحد الأقصى لعدد الاتصالات المتزامنة في خُطط Flame وBleze هو 200,000 اتصال متزامن لكل قاعدة بيانات.

يختلف هذا الحدّ عن إجمالي عدد مستخدمي تطبيقك، لأنّه لا يمكن لجميع المستخدمين التواصل في وقت واحد. وإذا كنت بحاجة إلى أكثر من 200,000 اتصال متزامن، يُرجى الاطّلاع على التوسّع في قواعد بيانات متعددة.

ماذا يحدث في حال تجاوزتُ حدود مساحة التخزين أو عمليات التنزيل في خطة Spark Database؟

لعرض سعر يمكن توقّعه، يتم وضع حد أقصى للموارد المتاحة لك في خطط Spark Plan. وهذا يعني أنّه عند تجاوز أي حد للخطة في أي شهر، سيتم إيقاف تطبيقك لمنع أي استخدام للموارد أو تحصيل رسوم إضافية في المستقبل.

ماذا يحدث إذا تجاوزت حدود الاتصال المتزامن في خطة Spark لقاعدة بيانات الوقت الفعلي؟

عندما يبلغ تطبيقك الحدّ الأقصى المسموح به لعدد عمليات الربط في خطة Spark، سيتم رفض أي عمليات ربط لاحقة إلى أن يتم إغلاق بعض عمليات الربط الحالية. سيستمر عمل التطبيق مع المستخدمين المتصلين.

كيف يتم دمج Firebase مع Google Cloud؟

يتم دمج Firebase بشكل كبير مع Google Cloud. تتم مشاركة المشاريع بين Firebase وGoogle Cloud، وبالتالي يمكن تفعيل خدمات Firebase وخدمات Google Cloud للمشاريع. يمكنك الوصول إلى المشروع نفسه من "وحدة تحكُّم Firebase" أو "وحدة تحكُّم Google Cloud". ونخصّ بالذكر الشرط التالي:

تعتمد خدمة Google Cloud مباشرةً على بعض منتجات Firebase، مثل Cloud Storage for Firebase. وستستمر زيادة قائمة المنتجات التي تستند إليها خدمة Google Cloud بمرور الوقت.
تتم مشاركة العديد من إعداداتك، بما في ذلك المتعاونين ومعلومات الفوترة، من خلال Firebase وGoogle Cloud. يظهر استخدامك لكل من Firebase وGoogle Cloud في الفاتورة نفسها.

بالإضافة إلى ذلك، عند الترقية إلى خطة Blaze، يمكنك استخدام أيّ من بنية Google Cloud الأساسية كخدمة على مستوى العالم وواجهات برمجة التطبيقات مباشرةً داخل مشروعك على Firebase، وذلك بسعر Google Cloud العادي. يمكنك أيضًا تصدير البيانات من Google Cloud مباشرةً إلى BigQuery لتحليلها. لمزيد من المعلومات، راجِع ربط BigQuery بمنصة Firebase.

تتوفر العديد من المزايا لتحسين الأمان وتحسين وقت الاستجابة وتوفير الوقت لاستخدام Google Cloud مع Firebase (مقارنةً بخدمات السحابة الإلكترونية الأخرى غير المتوفّرة في الموقع الجغرافي نفسه). يمكنك الانتقال إلى موقع Google Cloud الإلكتروني للاطّلاع على مزيد من التفاصيل.

ماذا يحدث لمشروعي في Firebase إذا أضفت حسابات فوترة أو أزلتها لذلك المشروع في Google Cloud Console؟

في حال إضافة حساب فوترة في السحابة الإلكترونية إلى مشروع في Google Cloud Console، ستتم ترقية المشروع نفسه تلقائيًا إلى خطة Firebase Blaze إذا كان هذا المشروع ضمن خطة Spark حاليًا.

وفي المقابل، في حال إزالة حساب فوترة نشط حالي في Cloud من مشروع على Google Cloud Console، سيتم رجوع هذا المشروع إلى خطة Firebase Spark.

هل يمكنني الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت؟

نعم، يمكنك الترقية أو الاشتراك في خطة أقلّ كلفة أو الإلغاء في أي وقت. ويُرجى العِلم بأنّنا لا نردّ الأموال مقسَّمة حسب الاستخدام مقابل الرجوع إلى إصدار سابق أو إلغاء الاشتراكات. يعني ذلك أنّه في حال الاشتراك في خطة أقلّ كلفة أو إلغاء الاشتراك قبل نهاية المدة الزمنية للفوترة، ستظل ملزمًا بالدفع مقابل الفترة المتبقية من الشهر.

ما نوع الدعم الذي سأحصل عليه؟

إنّ جميع تطبيقات Firebase، بما في ذلك التطبيقات التي تستخدم خططًا بدون تكلفة، تتوفّر مع خدمة الدعم عبر البريد الإلكتروني من موظفي Firebase خلال ساعات العمل في منطقة المحيط الهادئ في الولايات المتحدة. يتوفر في جميع الحسابات دعم غير محدود للمشاكل المتعلقة بالفوترة والمشاكل المتعلقة بالحساب والأسئلة الفنية (تحديد المشاكل وحلّها)، وتقارير الحوادث.

هل يمكنني تحديد الاستخدام وفقًا لخطة Blaze؟

لا، لا يمكنك حاليًا تقييد استخدام خطة Blaze. نعمل على تقييم خيارات إتاحة الحدود القصوى لاستخدام خطة Blaze.

يمكن لمستخدمي Blaze تحديد ميزانية لمشروعهم أو حساباتهم وتلقّي تنبيهات مع اقتراب الإنفاق من هذه الحدود. اطّلِع على كيفية إعداد تنبيهات الميزانية.

ما هي النسخ الاحتياطية التلقائية؟ هل توفرون نسخًا احتياطية كل ساعة؟

النُسخ الاحتياطية المبرمَجة هي ميزة متقدّمة للعملاء المشتركين في خطة أسعار Blaze التي تتيح الاحتفاظ بنسخة احتياطية من بيانات "قاعدة بيانات Firebase في الوقت الفعلي" مرة واحدة في اليوم وتحميلها إلى Google Cloud Storage.

نحن لا نوفر إمكانية النسخ الاحتياطي كل ساعة.

هل تقدّم خصومات برامج مفتوحة المصدر أو غير ربحية أو تعليمية؟

يمكن لأي نوع من الأفراد أو المؤسسات استخدام خطة Spark، بما في ذلك المؤسسات غير الربحية والمؤسسات التعليمية والمشاريع مفتوحة المصدر. وبما أنّ هذه الخطط تتضمّن حصصًا كبيرة، لا نقدّم أي خصومات أو خطط خاصة للمشاريع المفتوحة المصدر أو غير الربحية أو التعليمية.

هل تتوفر عقود خاصة للمؤسسات أو أسعار أو خدمات دعم أو استضافة مخصصة للبنية الأساسية؟

إنّ خطة Blaze مناسبة للمؤسسات بمختلف أحجامها، وتستوفي اتفاقية مستوى الخدمة المعايير المتّبعة في المجال للبنية الأساسية للسحابة الإلكترونية أو تتجاوزها. وفي الوقت الحالي، لا نقدّم عقودًا أو أسعارًا أو دعمًا للمؤسسات، كما لا نقدّم خدمة استضافة مخصّصة للبنية الأساسية (أي عمليات التثبيت داخل المؤسسة) لخدمات مثل "قاعدة بيانات الوقت الفعلي". نحن نعمل جاهدين على إضافة بعض هذه الميزات.

هل توفرون أسعارًا مخصصة؟ أريد استخدام نظام الدفع حسب الاستخدام لميزة واحدة أو اثنتين فقط.

نوفّر أسعارًا مخصّصة في خطة Blaze، حيث يمكنك الدفع مقابل الميزات التي تستخدمها فقط.

كيف تعمل خطط Firebase المدفوعة مع "إعلانات Google"؟ هل هناك أرصدة إعلانية مجانية مع الخطط المدفوعة؟

تختلف خطط أسعار Firebase عن "إعلانات Google"، لذلك لا تتوفّر أرصدة إعلانية بدون تكلفة. وبصفتك مطوِّرًا في Firebase، يمكنك "ربط" حسابك على "إعلانات Google" بمنصّة Firebase لإتاحة تتبُّع الإحالات الناجحة.

تتم إدارة جميع الحملات الإعلانية في "إعلانات Google" مباشرةً، وتتم إدارة الفوترة في "إعلانات Google" من خلال وحدة التحكّم في "إعلانات Google".

أسعار Cloud Functions

لماذا أحتاج إلى حساب فوترة لاستخدام Cloud Functions for Firebase؟

تعتمد وظائف السحابة الإلكترونية لبرنامج Firebase على بعض خدمات Google المدفوعة. تعتمد عمليات نشر الوظائف الجديدة التي تتضمّن واجهة سطر الأوامر في Firebase الإصدار 11.2.0 والإصدارات الأحدث على كل من Cloud Build وArtifact Registry. تستخدم عمليات النشر على الإصدارات الأقدم Cloud Build بالطريقة نفسها، ولكنها تعتمد على Container Registry وCloud Storage لتخزينها بدلاً من Artifact Registry. سيتم تحصيل رسوم استخدام هذه الخدمات بالإضافة إلى الأسعار الحالية.

مساحة تخزين مخصّصة للإصدار 11.2.0 من واجهة سطر الأوامر في Firebase والإصدارات الأحدث

توفّر Artifact Registry الحاويات التي يتم تشغيل الوظائف فيها. توفّر Artifact Registry أول 500 ميغابايت بدون تكلفة، وبالتالي قد لا تترتّب عليك أي رسوم عن عمليات نشر الوظائف الأولى. وعند تجاوز هذا الحدّ، تتم فوترة كل غيغابايت إضافية من مساحة التخزين بقيمة 0.10 دولار أمريكي شهريًا.

مساحة تخزين للإصدار 11.1.x من واجهة سطر الأوامر في Firebase والإصدارات السابقة

بالنسبة إلى الدوال التي تم نشرها في الإصدارات القديمة، يوفّر Container Registry) الحاويات التي يتم تشغيل الدوال فيها. سيتم تحصيل رسوم منك مقابل كل حاوية مطلوبة لنشر دالة. قد تلاحظ رسومًا بسيطة لكل حاوية مخزّنة، مثلاً 1 غيغابايت من مساحة التخزين يتم تحصيل رسومها بقيمة 0.026 دولار أمريكي في الشهر.

لمعرفة المزيد من المعلومات عن التغييرات التي قد تطرأ على فاتورتك، يُرجى مراجعة ما يلي:

أسعار Cloud Functions: لم تتغيّر الفئة الحالية بدون تكلفة.
أسعار Cloud Build: يوفّر Cloud Build فئة بدون تكلفة.
أسعار Artifact Registry:
أسعار Container Registry:

هل لا تزال وظائف السحابة الإلكترونية لبرنامج Firebase متاحة بدون تكلفة؟

نعم. في خطة Blaze، توفّر Cloud Functions فئة بدون تكلفة للاستدعاءات ووقت الاحتساب وحركة البيانات على الإنترنت. يتم تقديم أول 2,000,000 طلب استدعاء و400,000 غيغابايت في الثانية و200,000 وحدة معالجة مركزية (CPU) ثانية و5 غيغابايت من حركة بيانات خروج الإنترنت بدون تكلفة شهريًا. لن يتم تحصيل رسوم منك إلا مقابل الاستخدام الذي يتجاوز هذه الحدود

بعد أول 500 ميغابايت من مساحة التخزين بدون تكلفة، ستتحمّل كل عملية نشر رسومًا على نطاق صغير مقابل مساحة التخزين المستخدَمة لحاوية الوظيفة. إذا كانت عملية التطوير تعتمد على نشر الوظائف للاختبار، يمكنك تقليل التكاليف باستخدام مجموعة المحاكي المحلي من Firebase أثناء عملية التطوير.

يمكنك الاطّلاع على أمثلة على سيناريوهات أسعار Firebase وأسعار وظائف السحابة الإلكترونية.

هل يخطط Firebase لزيادة الحصص والقيود لوظائف السحابة الإلكترونية لبرنامج Firebase؟

لا، ليس هناك أي خطط لتغيير الحصص باستثناء إزالة الحدّ الأقصى لوقت الإنشاء، فبدلاً من تلقّي أخطاء أو تحذيرات عند بلوغ الحدّ الأقصى اليومي للإصدار الذي يبلغ 120 دقيقة، سيتم تحصيل الرسوم منك وفقًا لبنود خطة تسعير Blaze. راجِع الحصص والحدود.

هل يمكنني الحصول على رصيد بقيمة 300 دولار أمريكي على Google Cloud؟

نعم، يمكنك إنشاء حساب فوترة في Cloud في وحدة تحكُّم Google Cloud للحصول على رصيد بقيمة 300 دولار أمريكي، ثم ربط حساب فوترة Cloud هذا بمشروع على Firebase.

تعرَّف على مزيد من المعلومات حول رصيد Google Cloud هنا.

تجدر الإشارة إلى أنّه في حال إجراء ذلك، عليك إعداد خطة أسعار Blaze في "وحدة تحكُّم Firebase" كي يواصل مشروعك العمل بعد نفاد الرصيد بقيمة 300 دولار أمريكي (أو ما يعادله بالعملة المحلية).

أريد اتّباع درس تطبيقي حول الترميز للتعرّف على Firebase. هل يمكنك تزويدي بحساب فوترة مؤقت؟

لا، عذرًا. يمكنك استخدام مُحاكي Firebase للتطوير بدون الحاجة إلى حساب فوترة في السحابة الإلكترونية. يمكنك بدلاً من ذلك تقديم طلب للحصول على فترة تجريبية مجانية من Google Cloud. إذا كنت لا تزال تواجه مشكلة في دفع فاتورتك بسبب هذا التغيير، تواصَل مع فريق دعم Firebase.

أشعر بالقلق من أن أتراكم فاتورة ضخمة.

يمكنك إعداد تنبيهات الميزانية في Google Cloud Console للمساعدة في التحكم في التكاليف. يمكنك أيضًا ضبط حدود لعدد النُسخ الافتراضية التي تمت فوترتها والتي تم إنشاؤها لكل دالة من الدوال. للحصول على فكرة عن التكلفة في السيناريوهات النموذجية، راجِع أمثلة أسعار وظائف السحابة الإلكترونية.

كيف يمكنني التحقّق من رسوم الفوترة الحالية؟

اطّلِع على لوحة بيانات الاستخدام والفوترة في وحدة تحكّم Firebase.

أستخدم إضافات Firebase. هل أحتاج إلى حساب فوترة؟

نعم. وبما أنّ الإضافات تستخدم وظائف السحابة الإلكترونية، ستخضع الإضافات للرسوم نفسها التي تحصّلها الوظائف الأخرى.

لاستخدام الإضافات، عليك الترقية إلى خطة أسعار Blaze. سيتم تحصيل رسوم صغيرة منك (عادةً حوالي 0.01 دولار أمريكي شهريًا مقابل موارد Firebase المطلوبة لكل إضافة تثبِّتها (حتى في حال عدم استخدامها)، بالإضافة إلى أي رسوم مرتبطة باستخدامك لخدمات Firebase.

أسعار Cloud Storage for Firebase

كيف أتوقّع مقدار الرسوم التي سيتم تحصيلها مني مقابل عمليات التحميل والتنزيل؟

انتقِل إلى صفحة "أسعار Firebase" واستخدِم الآلة الحاسبة لخطط Blaze. تسرد الآلة الحاسبة جميع أنواع استخدام Cloud Storage for Firebase.

استخدِم أشرطة التمرير لإدخال الاستخدام المتوقّع لمجموعة بيانات "مساحة التخزين". ستقدّر الآلة الحاسبة فاتورتك الشهرية.

ماذا يحدث في حال تجاوزتُ الحدود القصوى المسموح بها لتحميل بيانات خطة Spark أو تنزيلها أو مساحة التخزين في Cloud Storage for Firebase؟

عند تجاوز الحدود القصوى المسموح بها على Cloud Storage في مشروع ضمن خطة Spark، تعتمد النتيجة على نوع الحدّ الأقصى الذي تتجاوزه:

في حال تجاوز الحدّ الأقصى البالغ غيغابايت المخزَّنة، لن تتمكّن من تخزين أي بيانات أخرى في هذا المشروع ما لم تتم إزالة بعض البيانات المخزَّنة أو الترقية إلى خطة توفّر مساحة تخزين أكبر أو مساحة تخزين غير محدودة.
في حال تجاوز الحدّ الأقصى المسموح به لعدد الملفات التي يمكن تنزيلها على غيغابايت، لن يتمكّن تطبيقك من تنزيل مزيد من البيانات حتى اليوم التالي (بدءًا من منتصف الليل بتوقيت المحيط الهادئ في الولايات المتحدة)، ما لم تتم الترقية إلى خطة ذات حدود أقلّ تقييدًا أو بلا حدود.
في حال تجاوز الحدّ الأقصى لعمليات التحميل أو التنزيل، لن يتمكّن تطبيقك من تحميل المزيد من البيانات أو تنزيلها حتى اليوم التالي (بدءًا من منتصف الليل، بتوقيت المحيط الهادئ في الولايات المتحدة)، ما لم تتم الترقية إلى خطة ذات حدود أقلّ تقييدًا أو بدون حدود.

الخصوصية

هل تسجّل حِزم تطوير البرامج (SDK) لمنصة Firebase أي معلومات استخدام أو بيانات تشخيص خارج "إحصاءات Google"؟

نعم. يقتصر تنفيذ هذا الإجراء على نظام التشغيل iOS فقط في الوقت الحالي، ولكن قد يتغيّر في المستقبل. تتضمّن حزمة تطوير البرامج (SDK) لمنصة Apple لنظام التشغيل Firebase إطار عمل FirebaseCoreDiagnostics تلقائيًا. يستخدم Firebase إطار العمل هذا لجمع معلومات الاستخدام وبيانات التشخيص المتعلّقة بحزمة تطوير البرامج (SDK) للمساعدة في تحديد أولويات تحسينات المنتجات المستقبلية. إنّ FirebaseCoreDiagnostics اختيارية، لذا إذا كنت تريد إيقاف إرسال سجلات بيانات تشخيص Firebase، يمكنك إجراء ذلك من خلال إلغاء ربط المكتبة بتطبيقك. يمكنك تصفّح المصدر الكامل، بما في ذلك القيم المسجَّلة، على GitHub.

من Firebase

اختبار A/B: كم عدد التجارب التي يمكنني إنشاؤها وتنفيذها؟

يُسمح لك بما يصل إلى 300 تجربة لكل مشروع، والتي يمكن أن تشتمل على ما يصل إلى 24 تجربة قيد التنفيذ، وتكون الباقية كمسودة أو مكتملة.

اختبار A/B: لماذا لا يمكنني عرض تجاربي بعد إلغاء ربط مشروعي وإعادة ربطه بخدمة "إحصاءات Google"؟

سيؤدي الربط بموقع مختلف على "إحصاءات Google" إلى فقدان إمكانية الوصول إلى التجارب التي تم إنشاؤها مسبقًا. لاستعادة إمكانية الوصول إلى تجربة سابقة، يجب إعادة ربط مشروعك بموقع "إحصاءات Google" الذي تم ربطه عند إنشاء التجربة.

اختبار A/B: لماذا تظهر لي رسالة "المشروع غير مرتبط بخدمة إحصاءات Google" عند إنشاء تجربة "الإعداد عن بُعد"؟

إذا سبق لك ربط Firebase و"إحصاءات Google"، ولكن لا تزال ترى رسالة تفيد بأنّه لم يتم ربط "إحصاءات Google"، تأكَّد من توفّر مصدر بيانات "إحصاءات Google" لجميع التطبيقات في مشروعك. في الوقت الحالي، يجب ربط جميع التطبيقات في المشروع بمصدر بيانات "إحصاءات Google" لاستخدام اختبار A/B.

يمكنك العثور على قائمة بجميع ساحات المشاركات النشطة في صفحة تفاصيل دمج "إحصاءات Google" ضمن "وحدة تحكُّم Firebase"، والتي يمكن الوصول إليها من إعدادات المشروع عمليات الدمج إحصاءات Google إدارة.

ومن المفترض أن يؤدي إنشاء مصدر بيانات على "إحصاءات Google" لأي تطبيق لا يتضمّن مصدرًا إلى حل هذه المشكلة. هناك بضع طرق لإنشاء ساحات مشاركات للتطبيقات غير المتوفّرة:

إذا كان هناك تطبيق واحد أو تطبيقَين لا يتضمّنان مصدر بيانات "إحصاءات Google" مرتبطَين، يمكنك اختيار إحدى الطرق التالية لإضافة مصدر بيانات من "إحصاءات Google":
- يمكنك حذف أي تطبيق بدون مصدر بيانات نشط وإعادة إضافته في "وحدة تحكُّم Firebase".
- من وحدة تحكُّم "إحصاءات Google"، اختَر المشرف، وانقر على مصادر البيانات، ثم انقر على إضافة مصدر بيانات، وأضِف تفاصيل التطبيق غير المتوفّرة، ثم انقر على تسجيل التطبيق.
إذا كان هناك أكثر من عدد قليل من مصادر بيانات التطبيق غير متوفّرة، يكون إلغاء ربط موقعك على "إحصاءات Google" وإعادة ربطه الطريقة الأسرع والأكثر فعالية لإنشاء مصادر بيانات التطبيقات غير المتوفّرة:
1. من إعدادات المشروع، اختَر عمليات الدمج.
2. ضمن بطاقة إحصاءات Google، انقر على إدارة للوصول إلى إعدادات Firebase و"إحصاءات Google".
3. دوِّن رقم تعريف الموقع في "إحصاءات Google" وحساب "إحصاءات Google" المرتبط.
4. انقر على المزيد واختَر إلغاء ربط "إحصاءات Google" بهذا المشروع.
5. راجِع التحذير الذي يظهر (لا داعي للقلق، لأنّه عليك إعادة ربط الموقع نفسه في الخطوة التالية)، ثم انقر على إلغاء ربط "إحصاءات Google".
  
  عند اكتمال عملية إلغاء الربط، ستتم إعادة توجيهك إلى صفحة عمليات الدمج.
6. ضمن بطاقة إحصاءات Google، انقر على تفعيل لبدء عملية إعادة الربط.
7. اختَر حسابك على "إحصاءات Google" من القائمة اختيار حساب.
8. بجانب إنشاء موقع جديد تلقائيًا في هذا الحساب، انقر على تعديل، ومن قائمة موقع "إحصاءات Google" التي تظهر، اختَر رقم تعريف موقعك.
  
  ستظهر قائمة بجميع التطبيقات في مشروعك. يتم إدراج عمليات ربط مصادر البيانات الحالية لكل تطبيق، كما سيتم إنشاء مجموعة لها للتطبيقات التي لا تتضمّن مصدر بيانات.
9. انقر على تفعيل "إحصاءات Google" لإعادة ربط الموقع.
10. انقر على إنهاء.

إذا استمرّت رسالة الخطأ بإنشاء اختبارات A/B باستخدام ميزة "الإعداد عن بُعد" بعد تنفيذ هذه الخطوات، يُرجى التواصل مع فريق دعم Firebase.

AdMob

AdMob: هل يمكنني ربط تطبيقاتي على Windows بمنصّة Firebase؟

لا، تطبيقات Windows غير متوافقة حاليًا.

AdMob: لماذا لا يمكنني ربط تطبيقي بخدمة AdMob من "وحدة تحكُّم Firebase"؟

يمكنك ربط تطبيق على AdMob بتطبيق على Firebase من خلال "وحدة تحكُّم AdMob". يمكنك التعرّف على كيفية إجراء ذلك.

AdMob: ما هي الأذونات أو أذونات الوصول اللازمة لربط تطبيق Firebase بتطبيق AdMob؟

لإجراء هذا الربط، يجب أن يكون لديك إذن الوصول التالي:

AdMob: يجب أن تكون مشرفًا في AdMob.
Firebase: يجب أن يكون لديك إذن firebase.links.create، وهو مُدرَج في دور المالك ودور مشرف Firebase.
إحصاءات Google: يجب أن يكون لديك دور "التعديل" أو دور "إدارة المستخدمين" للموقع المرتبط بمشروع Firebase. مزيد من المعلومات

AdMob: هل يمكن لعدة مستخدمين في حساب AdMob نفسه ربط تطبيقات AdMob وتطبيقات Firebase؟

بالنسبة إلى حسابات AdMob المتعددة المستخدمين، يكون المستخدم الذي أنشأ أول رابط في Firebase ووافق على بنود خدمة Firebase هو المستخدم الوحيد الذي يمكنه إنشاء روابط جديدة بين تطبيقات AdMob وتطبيقات Firebase.

AdMob: ما هي حِزم تطوير البرامج (SDK) التي يجب أن أستخدمها حتى تتمكّن من استخدام AdMob؟

لاستخدام AdMob، استخدِم دائمًا حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" كما هو موضّح في هذه الأسئلة الشائعة. بالإضافة إلى ذلك، وإذا كنت تريد جمع مقاييس سلوك المستخدمين في AdMob، يمكنك تضمين حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" في تطبيقك.

بالنسبة إلى مشاريع iOS:
استورِد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من خلال اتّباع التعليمات الواردة في مستندات AdMob iOS.
بالنسبة إلى مشاريع Android:
أضِف الاعتمادية لحزمة SDK لإعلانات Google على الأجهزة الجوّالة إلى ملف build.gradle:
implementation 'com.google.android.gms:play-services-ads:23.0.0'
بالنسبة إلى مشاريع C++ و مشاريع Unity: اتّبِع التعليمات الواردة في المستندات ذات الصلة.

لاستخدام AdMob، استخدِم دائمًا حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" كما هو موضّح سابقًا في هذه الأسئلة الشائعة.

سنُجري التغييرات التالية في أيلول (سبتمبر) 2024 لمنحك المزيد من التحكّم في العناصر التابعة التي تضيفها إلى تطبيقاتك.

بالنسبة إلى نظام التشغيل Android: سنتوقف عن نشر حِزم تطوير البرامج (SDK) لمنصة Firebase لبرنامج AdMob (firebase-ads أو firebase-ads-lite)، وبدلاً من ذلك، استخدِم حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" كما هو موضّح سابقًا في هذه الأسئلة الشائعة.
لم توفّر هذه العناصر برنامجها الثنائي الخاص بها ولم تكن سوى برنامج تضمين حول تبعياتها، ولا سيما حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة وحزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google". لذلك، إذا كان تطبيقك يطلب أيًا من واجهات برمجة تطبيقات "إحصاءات Google" وبدّلت إلى استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة"، تأكَّد من إضافة التبعية لحزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصة بخدمة "إحصاءات Google" (com.google.firebase:firebase-analytics) إلى ملف build.gradle الخاص بتطبيقك.

حتى بعد إيقاف نشر هذه العناصر، ستظل أي نُسخ حالية صالحة. لإصلاح الأخطاء وتقديم ميزات جديدة، عليك نقل البيانات لاستخدام حِزم SDK كما هو موضّح سابقًا في هذه الأسئلة الشائعة.
على أجهزة iOS: لن يعود بإمكانك إضافة "Google-Mobile-Ads-SDK" من توزيع ملف zip على Firebase أو إضافة FirebaseAdMob من Carthage. وبدلاً من ذلك، يمكنك استيراد "SDK لإعلانات Google على الأجهزة الجوّالة" كما هو موضّح سابقًا في هذه الأسئلة الشائعة. يُرجى العِلم أنّ برنامج FirebaseAdMob الثنائي مكافئ من الناحية الوظيفية للسمة Google-Mobile-Ads-SDK.
حتى بعد أن توقف Firebase عن إجراء عمليات التوزيع الثنائية هذه، ستظل أي إصدارات حالية من توزيعات ZIP على Firebase متاحة. لإصلاح الأخطاء والحصول على ميزات جديدة، عليك نقل البيانات لاستخدام المجموعة كما هو موضّح سابقًا في هذه الأسئلة الشائعة.

إحصاءات Google

الإحصاءات: لماذا تعتبر "إحصاءات Google" جزءًا مقترَحًا من استخدام منتجات Firebase؟

خدمة "إحصاءات Google" هي حلّ مجاني وغير محدود للإحصاءات يتوافق مع ميزات Firebase لتقديم إحصاءات فعّالة. ويتيح لك هذا الترميز عرض سجلات الأحداث في Crashlytics وفعالية الإشعارات في ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" وأداء الروابط الديناميكية المؤدية إلى صفحات في التطبيق وبيانات الشراء داخل التطبيق من Google Play. توفِّر هذه الميزة استهداف الجمهور المتقدّم في "الإعداد عن بُعد" و"الإعداد عن بُعد" وغير ذلك.

تعمل "إحصاءات Google" كطبقة من الذكاء في وحدة تحكُّم Firebase لتزويدك بالمزيد من الإحصاءات القابلة للاستخدام حول كيفية تطوير تطبيق عالي الجودة وزيادة قاعدة المستخدمين وتحقيق المزيد من الأرباح.

للبدء، يمكنك الاطّلاع على المستندات.

إحصاءات: كيف يمكنني تعديل إعدادات موقع "إحصاءات Google"؟

من صفحة المشرف في موقعك على "إحصاءات Google"، يمكنك تعديل إعدادات الموقع، مثل:

إعدادات مشاركة البيانات
إعدادات الاحتفاظ بالبيانات
إعدادات المنطقة الزمنية والعملة

لتعديل إعدادات موقعك، اتّبِع الخطوات التالية:

في "وحدة تحكُّم Firebase"، انتقِل إلى > إعدادات المشروع.
انتقِل إلى علامة التبويب عمليات الدمج، ثم انقر على إدارة أو عرض الرابط في بطاقة "إحصاءات Google".
انقر على رابط حسابك على "إحصاءات Google" لفتح إعدادات الحساب والموقع.

"إحصاءات Google" في تطبيق iOS: هل يمكنني تثبيت "إحصاءات Google" بدون ميزات إحالة الإعلانات وجمع معرّف المعلِنين (IDFA)؟

نعم. راجِع صفحة ضبط جمع البيانات واستخدامها للحصول على مزيد من التفاصيل.

الإحصاءات: ما التغيير الذي حدث في قسم "إحصاءات Google" بعد التحديث الذي تم إجراؤه في تشرين الأول (أكتوبر) 2021؟

يمكنك العثور على ملخّص لهذه التغييرات في المقالة بعنوان وظيفة "إحصاءات Google 4" الجديدة في "إحصاءات Google لبرنامج Firebase".

إحصاءات Google: لماذا لا تظهر لي أي بيانات من "إحصاءات Google" في وحدة تحكُّم Firebase بعد إلغاء ربط Firebase بخدمة "إحصاءات Google"؟

تتوفّر بيانات "إحصاءات Google" في موقع "إحصاءات Google"، وليس في مشروع Firebase. في حال حذفت الموقع أو ألغيت ربطه، لن تتمكّن منصّة Firebase من الوصول إلى بيانات "إحصاءات Google" وستظهر لوحة بيانات إحصاءات Google فارغة في وحدة تحكُّم Firebase. يُرجى العلم بأنّه بما أنّ البيانات لا تزال متوفّرة في الموقع المرتبط سابقًا، يمكنك دائمًا إعادة ربط الموقع بمنصة Firebase والاطّلاع على بيانات "إحصاءات Google" في وحدة تحكّم Firebase.

سيؤدي ربط حساب جديد تمامًا على "إحصاءات Google" (وبالتالي موقع جديد على "إحصاءات Google") بمشروعك على Firebase إلى توفّر لوحة بيانات إحصاءات Google فارغة في وحدة تحكُّم Firebase. مع ذلك، إذا كان موقعك الذي تم ربطه سابقًا متوفرًا، يمكنك عندئذٍ نقل البيانات الحالية من الموقع القديم إلى الموقع الجديد.

إحصاءات: إذا تم حذف موقعي على "إحصاءات Google" وبياناته، هل هناك أي طريقة لاستعادتها؟

لا، إذا تم حذف موقعك، لا يمكن إلغاء حذفه أو استرداد بيانات "إحصاءات Google" التي تم جمعها في السابق والمحفوظة في ذلك الموقع.

إذا أردت بدء استخدام "إحصاءات Google" مرة أخرى، يمكنك ربط موقع جديد أو موقع حالي بمشروعك على Firebase. يمكنك إجراء هذا الربط إمّا في وحدة تحكُّم Firebase أو في واجهة مستخدم "إحصاءات Google". اطّلِع على مزيد من المعلومات عن ربط موقع على "إحصاءات Google" بمشروعك على Firebase.

إحصاءات Google: إذا تم حذف موقعي على "إحصاءات Google"، هل يمكنني ربط موقع جديد على "إحصاءات Google" بمشروعي على Firebase وبدء استخدام "إحصاءات Google" مرة أخرى؟

يُرجى العلم بأنّه لا يمكن استرداد بيانات "إحصاءات Google" التي تم جمعها في السابق، وذلك بسبب تخزين جميع بيانات "إحصاءات Google" في الموقع (وليس مشروع Firebase).

إحصاءات Google: كيف ستتأثر منتجات Firebase أو منتجات Google المدمجة بحذف موقعي على "إحصاءات Google"؟

تعتمد العديد من منتجات Firebase على دمج "إحصاءات Google". إذا تم حذف موقعك على "إحصاءات Google" وبياناته، سيحدث ما يلي في حال استخدام المنتجات التالية:

Crashlytics: لن يبقى بإمكانك الاطّلاع على المستخدمين الذين لم يواجههم أي تعطُّل و/أو سجلّات شريط التنقّل و/أو تنبيهات السرعة.
"المراسلة عبر السحابة الإلكترونية" و"المراسلة داخل التطبيق" - لم يعُد بإمكانك استخدام الاستهداف ومقاييس الحملات وتصنيف الجمهور وتصنيفات "الإحصاءات".
"الإعداد عن بُعد": لن يعود بإمكانك استخدام الإعدادات المستهدَفة أو "التخصيص".
اختبار A/B: لم يعُد بإمكانك استخدام اختبار A/B لأنّ "إحصاءات Google" يوفّر قياس التجربة.
الروابط الديناميكية: ستتوقف أي ميزة تعتمد على بيانات من "إحصاءات Google" .

بالإضافة إلى ذلك، ستتأثر عمليات الدمج التالية:

لن تتمكّن بعد ذلك من تصدير بيانات "إحصاءات Google" إلى BigQuery.
لن يعود بإمكانك الاستفادة من عمليات الدمج مع "إعلانات Google" أو عمليات الدمج مع Google AdMob.

إحصاءات Google: كيف يمكنني تقسيم المستخدمين الذين لم يستوفوا معايير معيّنة؟

ويمكنك إعادة صياغة المشكلة عن طريق "استهداف هؤلاء المستخدمين بصورة سلبية". على سبيل المثال، يمكنك إعادة صياغة المشكلة على النحو التالي: "عدم عرض الإعلانات للأشخاص الذين اشتروا شيئًا ما"، وتكوين شريحة جمهور من هؤلاء المستخدمين لاستهدافهم.

إحصاءات: هل شرائح الجمهور و/أو الأحداث المحدّدة في واجهة "إحصاءات Google" متوفّرة أيضًا في "وحدة تحكّم Firebase"؟

ستتم مزامنة شرائح الجمهور وخصائص المستخدمين. بالنسبة إلى بعض الميزات، عليك استخدام واجهة "إحصاءات Google"، مثل التصنيف إلى شرائح ومسارات الإحالة الناجحة المغلقة. يمكنك الوصول إلى واجهة "إحصاءات Google" مباشرةً من خلال روابط لصفحات معيّنة من وحدة تحكُّم Firebase.

يمكن أيضًا تنفيذ أي تغييرات تجريها من وحدة تحكُّم Firebase في "إحصاءات Google"، وستظهر هذه التغييرات في Firebase.

المصادقة

مصادقة Firebase: ما هي البلدان التي تتوفر فيها مصادقة الهاتف؟

تتيح مصادقة Firebase التحقق من أرقام الهاتف في جميع أنحاء العالم، ولكن لا ترسل جميع الشبكات رسائل التحقق بشكل موثوق. تقدّم البلدان التالية معدّلات تسليم جيدة، ومن المتوقّع أن تنجح في تسجيل الدخول باستخدام رقم الهاتف.

Country	الرمز
م	أندورا
الإمارات العربية المتحدة	الإمارات العربية المتحدة
تحويل الصوت إلى نص	أفغانستان
متوسط	أنتيغوا وبربودا
ألبانيا	ألبانيا
صباحًا	أرمينيا
AO	أنغولا
تنسيق بتكنولوجيا الواقع المعزّز	الأرجنتين
خادم مصادقة	ساموا الأمريكية
النمسا	النمسا
AU	أستراليا
AW	أروبا
أريزونا	أذربيجان
حمّام عام	البوسنة والهرسك
BB	بربادوس
BD	بنغلاديش
بلجيكا	بلجيكا
BF	بوركينا فاسو
بلغاريا	بلغاريا
جمال	بنين
BM	برمودا
بوليفيان	بروناي (دار السلام)
بوليفيا	بوليفيا
البرازيل	البرازيل
بكالوريوس	جزر البهاما
تقنية BT	بوتان
أبيض وأسود	بتسوانا
بواسطة	بيلاروس
BZ	بليز
مصدر الشهادة	كندا
قرص مضغوط	الكونغو، (كينشاسا)
CF	جمهورية أفريقيا الوسطى
CG	الكونغو (برازافيل)
سويسرا	سويسرا
CI	كوت ديفوار
كرونة تشيكية	جزر كوك
شيلي	تشيلي
مدير الحملة	الكاميرون
كولورادو	كولومبيا
رد جاهز	كوستاريكا
السيرة الذاتية	الرأس الأخضر
CW	كوراساو
السنة التقويمية	قبرص
تشيكيا	جمهورية التشيك
ألمانيا	ألمانيا
منسّق الموسيقى	جيبوتي
الدانمرك	الدانمرك
رسالة مباشرة	دومينيكا
إجراءات ننصح بها	جمهورية الدومينيكان
الجزائر	الجزائر
EC	الإكوادور
مصر	مصر
الإسبانية	إسبانيا
وقت إضافي	إثيوبيا
فنلندا	فنلندا
FJ	فيجي
FK	جزر فوكلاند (مالفيناس)
إرسال FM	ولايات ميكرونيسيا المتحدة
جُزر فارو	جزر فارو
الفرنسية	فرنسا
GA	الغابون
متوسط التأخُّر عن الصدارة	المملكة المتحدة
GD	غرينادا
جورجيا	جورجيا
GF	غويانا الفرنسية
هدف	غيرنزي
الزهري	غانا
GI	جبل طارق
GL	غرينلاند
المدير العام	غامبيا
GP	غوادلوب
هدف	غينيا الاستوائية
GR	اليونان
غواتيمالا	غواتيمالا
رمادي	غيانا
هونغ كونغ	هونغ كونغ، المنطقة الإدارية الخاصة التابعة للصين
هنغاريا	هندوراس
الموارد البشرية	كرواتيا
استراحة	هايتي
الوحدة الرئيسية (HU)	هنغاريا
رقم التعريف	إندونيسيا
أيرلندا	أيرلندا
إلينوي	إسرائيل
المراسلة الفورية	آيل أوف مان
IN	الهند
الذكاء	العراق
تكنولوجيا المعلومات	إيطاليا
ياسمين	جيرسي
ج	جامايكا
يو	الأردن
اليابان	اليابان
كينيا	كينيا
كيلوغرام	قيرغيزستان
كيلو هاس	كمبوديا
كم	جزر القمر
KN	سانت كيتس ونيفس
كوريا الجنوبية	كوريا (الجنوبية)
الكويت	الكويت
كنتاكي	جزر كايمان
KZ	كازاخستان
لوس أنجلوس	جمهورية لاو الديمقراطية الشعبية
نقاط بسبب اصطدام الكرة بجسم ضارب الكرة	لبنان
خبير محلّي	سانت لوشيا
ليلي	ليشتنشتاين
ليرة	سريلانكا
LS	ليسوتو
LT	ليتوانيا
LU	لكسمبورغ
LV	لاتفيا
ليلى	ليبيا
ماساتشوستس	المغرب
ماريلاند	مولدوفا
أنا	الجبل الأسود
متوسط	سانت مارتن (الجزء الفرنسي)
ام جي	مدغشقر
مقدونيا	جمهورية مقدونيا
الشهر	ميانمار
مينيسوتا	منغوليا
الهدف	ماكاو، جمهورية الصين الإدارية الخاصة
تصليح مرضية	مونتسيرات
MT	مالطا
MU	موريشيوس
ميغاواط	ملاوي
MX	المكسيك
ماليزيا	ماليزيا
ميغاهرتز	موزمبيق
غير متاح	ناميبيا
كارولاينا الشمالية	كاليدونيا الجديدة
الشمال الشرقي	النيجر
هدف	جزيرة نورفولك
NG	نيجيريا
أيرلندا الشمالية	نيكاراغوا
هولندا	هولندا
لا	النرويج
قطب شمالي	نيبال
نيوزيلندا	نيوزيلندا
عُمان	عُمان
PA	بنما
خبير منتجات	بيرو
PG	بابوا غينيا الجديدة
PH	الفلبين
PK	باكستان
بولندا	بولندا
مساءً	سان بيير وميكلون
PR	بورتوريكو
ضربات الجزاء	فلسطين
البرتغالية	البرتغال
بيرو	باراغواي
تأكيد الجودة	قطر
رد	ريونيون
رومانيا	رومانيا
دينار صربي	صربيا
روسيا	روسيا الاتحادية
RW	رواندا
SA	المملكة العربية السعودية
التلوين الانتقائي	سيشيل
السويد	السويد
SG	سنغافورة
ركلات الترجيح	سانت هلينا
مع نسبة شوائب صغيرة	سلوفينيا
سلوفاكيا	سلوفاكيا
SL	سيراليون
السنغال	السنغال
SR	سورينام
ST	سان تومي وبرينسيبي
SV	السلفادور
سنغافورة	سوازيلند
TC	جزر توركس وكايكوس
تريليون	توغو
تايلاند	تايلاند
قائد فريق	تيمور - ليشتي
TM	تركمانستان
فقد الاستحواذ	تونغا
بالليرة التركية	تركيا
TT	ترينيداد وتوباغو
تايوان	جمهورية تايوان والصين
تنزانيا	حمهورية تنزانيا المتحدة
UA	أوكرانيا
UG	أوغندا
الولايات المتحدة	الولايات المتحدة الأمريكية
UY	أوروغواي
أوزبكستان	أوزباكستان
VC	سانت فنسنت وجزر غرينادين
فنزويلا	فنزويلا (جمهورية بوليفاريا)
مع نسبة شوائب صغيرة	جزر فيرجن البريطانية
6	جزر فيرجن الأمريكية
فيتنام	فيتنام
WS	ساموا
نعم	اليمن
YouTube	مايوت
جنوب أفريقيا	جنوب أفريقيا
د	زامبيا
زمبابوي	زمبابوي

مصادقة Firebase: كيف يمكنني منع إساءة استخدام الرسائل القصيرة عند استخدام مصادقة الهاتف؟

للمساعدة في حماية مشروعك من الرسائل القصيرة SMS وإساءة استخدام واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

ننصحك بضبط سياسة منطقة الرسائل القصيرة SMS.

عرض استخدام الرسائل القصيرة SMS في المنطقة

ابحث عن المناطق التي تحتوي على عدد كبير جدًا من الرسائل القصيرة SMS المُرسلة وعدد قليل جدًا (أو صفر) من الرسائل القصيرة التي تم التحقق منها. نسبة ما تم التحقق منه/إرساله هي معدل نجاحك. تقع معدلات النجاح الصحي عادةً في النطاق الذي يتراوح بين 70 و85% لأنّ الرسائل القصيرة ليست بروتوكول تسليم مضمونًا، وقد تتعرض بعض المناطق لإساءة الاستخدام. تشير معدلات النجاح التي تقل عن 50% إلى أنّ الكثير من الرسائل القصيرة التي تم إرسالها، إلا أنّ عمليات تسجيل الدخول قليلة بنجاح، ما يُعدّ مؤشرًا شائعًا على وجود جهات مسيئة ومعدّلات زيادة عدد الزيارات الواردة من الرسائل القصيرة SMS.
يمكنك استخدام سياسة منطقة الرسائل القصيرة SMS إما لمنع استخدام مناطق الرسائل القصيرة SMS ذات معدلات النجاح المنخفضة أو السماح فقط بمناطق معينة إذا كان تطبيقك مخصَّصًا للتوزيع في أسواق معيّنة فقط.

تقييد نطاقات المصادقة المعتمَدة

ويمكنك استخدام لوحة بيانات إعدادات المصادقة لإدارة النطاقات المعتمَدة. تتم تلقائيًا إضافة النطاق localhost إلى نطاقات المصادقة الموافَق عليها لتسهيل عملية التطوير. ننصحك بإزالة localhost من النطاقات المسموح بها في مشروع الإنتاج لمنع الجهات المسيئة من تشغيل رموز على الجهات localhost للوصول إلى مشروعك الإنتاجي.

تفعيل ميزة "فحص التطبيقات" وفرضها

فعِّل ميزة فحص التطبيقات للمساعدة في حماية مشروعك من إساءة استخدام واجهة برمجة التطبيقات من خلال الإقرار بأنّ الطلبات واردة من التطبيقات المرتبطة بمشروعك فقط.

لاستخدام ميزة "التحقّق من التطبيقات" مع "مصادقة Firebase"، يجب الترقية إلى مصادقة Firebase باستخدام Identity Platform.

تذكَّر أنّه عليك فرض ميزة "فحص التطبيقات" لمصادقة وحدة تحكُّم Firebase (ننصحك بتتبُّع عدد الزيارات قبل فرضها). عليك أيضًا التحقّق مرة أخرى من قائمة المواقع الإلكترونية الموافَق عليها من reCAPTCHA Enterprise للتأكّد من أنّها لا تتضمّن سوى مواقع إلكترونية للإنتاج ومن أنّ قائمة التطبيقات المسجَّلة في مشروعك في صفحة "فحص التطبيقات" دقيقة.

تجدر الإشارة إلى أنّ ميزة "فحص التطبيقات" تساعد في الحماية من الهجمات الآلية من خلال التأكيد على أنّ المكالمة واردة من أحد تطبيقاتك المسجَّلة. ولا يمنع ذلك المستخدمين من استخدام تطبيقك بطرق غير مقصودة (على سبيل المثال، بدءًا من عدم إنهاء خطوات تسجيل الدخول لإنشاء رسائل SMS المُرسَلة).

اتّبع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:

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)

تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد للمصادقة:
1. في "وحدة تحكُّم Firebase"، افتح قسم المصادقة.
2. ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة):
  1. افتح طريقة تسجيل الدخول إلى Google وأوقفها، ثم انقر على حفظ.
  2. أعِد فتح طريقة تسجيل الدخول على Google وفعِّلها، ثم انقر على حفظ.
تأكَّد من أنّ تطبيقك يستخدم ملف إعداد Firebase المحدّث (google-services.json).
احصل على ملف الإعداد الخاص بتطبيقك.
تحقَّق مما إذا كانت لا تزال رسالة الخطأ تظهر لك. إذا كنت قد فعلت ذلك، فتابع إلى الخطوة التالية لاستكشاف الأخطاء وإصلاحها.
تأكَّد من توفر برامج OAuth 2.0 الأساسية المطلوبة.
1. في صفحة بيانات الاعتماد ضمن وحدة تحكُّم Google Cloud، ابحث في قسم معرِّفات عملاء OAuth 2.0.
2. في حال عدم توفّر برامج OAuth 2.0 (وكنت قد نفّذت جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يُرجى التواصل مع فريق الدعم.

مصادقة Firebase: في تطبيق نظام التشغيل Apple، لماذا يظهر لي الخطأ التالي:
`You must specify <clientID> in <GIDConfiguration>`؟

اتّبع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:

You must specify |clientID| in |GIDConfiguration|

تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد للمصادقة:
1. في "وحدة تحكُّم Firebase"، افتح قسم المصادقة.
2. ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة):
  1. افتح طريقة تسجيل الدخول إلى Google وأوقفها، ثم انقر على حفظ.
  2. أعِد فتح طريقة تسجيل الدخول على Google وفعِّلها، ثم انقر على حفظ.
تأكَّد من أنّ تطبيقك يستخدم ملف إعداد Firebase المحدّث (GoogleService-Info.plist).
احصل على ملف الإعداد الخاص بتطبيقك.
تحقَّق مما إذا كانت لا تزال رسالة الخطأ تظهر لك. إذا كنت قد فعلت ذلك، فتابع إلى الخطوة التالية لاستكشاف الأخطاء وإصلاحها.
تأكَّد من توفر برامج OAuth 2.0 الأساسية المطلوبة.
1. في صفحة بيانات الاعتماد ضمن وحدة تحكُّم Google Cloud، ابحث في قسم معرِّفات عملاء OAuth 2.0.
2. في حال عدم توفّر برامج OAuth 2.0 (وكنت قد نفّذت جميع خطوات تحديد المشاكل وحلّها المذكورة أعلاه)، يُرجى التواصل مع فريق الدعم.

مصادقة Firebase: لماذا يظهر لي الخطأ التالي في تطبيق الويب:
`AuthErrorCode.INVALID_OAUTH_CLIENT_ID`؟

اتّبع خطوات تحديد المشاكل وحلّها الواردة في هذه الأسئلة الشائعة إذا ظهر لك الخطأ التالي:

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

تأكَّد من تفعيل تسجيل الدخول إلى Google بشكل صحيح كمزوّد للمصادقة:
1. في "وحدة تحكُّم Firebase"، افتح قسم المصادقة.
2. ضمن علامة التبويب طريقة تسجيل الدخول، أوقِف طريقة تسجيل الدخول إلى Google ثم أعِد تفعيلها (حتى إذا كانت مفعّلة):
  1. افتح طريقة تسجيل الدخول إلى Google وأوقفها، ثم انقر على حفظ.
  2. أعِد فتح طريقة تسجيل الدخول على Google وفعِّلها، ثم انقر على حفظ.
أيضًا، في إعدادات موفّر تسجيل الدخول إلى Google ضمن قسم المصادقة، تأكَّد من تطابق معرّف عميل OAuth وسر عميل OAuth مع عميل الويب المعروض في صفحة بيانات الاعتماد ضمن وحدة تحكُّم Google Cloud (اطّلِع على قسم معرِّفات عملاء OAuth 2.0).

مصادقة Firebase: في تطبيق الويب، لماذا يتعذّر تسجيل الدخول باستخدام عمليات إعادة التوجيه مع ظهور الخطأ التالي:
`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 أو لأنّ مفتاح واجهة برمجة التطبيقات الذي تستخدمه مع خدمة مصادقة Firebase غير صالح.

تأكَّد أولاً من أنّ YOUR_REDIRECT_DOMAIN مُدرَج في قائمة النطاقات المعتمَدة لمشروعك على Firebase. إذا كان نطاق إعادة التوجيه مُدرجًا هناك، استمر في استكشاف أخطاء مفتاح واجهة برمجة تطبيقات غير صالح وإصلاحها.

وفقًا للإعدادات التلقائية، تعتمد حزمة تطوير البرامج (SDK) لمصادقة Firebase على مفتاح واجهة برمجة التطبيقات لمشروعك في Firebase الذي يحمل تصنيف Browser key، وتستخدم هذه الحزمة هذا المفتاح للتحقّق من أنّ عنوان URL لإعادة التوجيه الخاص بتسجيل الدخول صالح وفقًا لقائمة النطاقات المُصرَّح بها. تحصل المصادقة على مفتاح واجهة برمجة التطبيقات هذا بناءً على كيفية وصولك إلى حزمة SDK للمصادقة:

إذا كنت تستخدم أدوات مساعدة المصادقة المقدّمة من المضيف لتسجيل دخول المستخدمين باستخدام حزمة تطوير البرامج (SDK) لمصادقة JavaScript، سيحصل Firebase تلقائيًا على مفتاح واجهة برمجة التطبيقات الخاص بك مع بقية إعدادات Firebase في كل مرة تفعِّل فيها ميزة "استضافة Firebase". عليك التأكّد من أنّ authDomain في تطبيق الويب firebaseConfig قد تم ضبطه بشكلٍ صحيح لاستخدام أحد النطاقات للموقع الإلكتروني للاستضافة هذا. يمكنك التحقّق من ذلك من خلال الانتقال إلى https://authDomain__/firebase/init.json والتأكّد من أنّ projectId تطابق ذلك في firebaseConfig.
في حال استضافة ذاتي لرمز تسجيل الدخول، يمكنك استخدام ملف __/firebase/init.json لتوفير إعدادات Firebase في أداة إعادة التوجيه لحزمة تطوير البرامج (SDK) للمصادقة الذاتية الخاصة بالمصادقة. يجب أن يتطابق مفتاح واجهة برمجة التطبيقات وprojectId المدرَج في ملف الإعداد هذا مع تطبيق الويب firebaseConfig.

تحقَّق للتأكُّد من عدم حذف مفتاح واجهة برمجة التطبيقات هذا: انتقِل إلى لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد في وحدة تحكُّم Google Cloud حيث تم إدراج جميع مفاتيح واجهة برمجة التطبيقات لمشروعك.

إذا لم يتم حذف Browser key، تحقَّق مما يلي:
- تأكَّد من إدراج واجهة برمجة التطبيقات لمصادقة Firebase في قائمة واجهات برمجة التطبيقات المسموح بها للمفتاح الذي يجب الوصول إليه (تعرَّف على مزيد من المعلومات عن قيود واجهة برمجة التطبيقات الخاصة بمفاتيح واجهة برمجة التطبيقات).
- في حال استضافة رمز تسجيل الدخول بنفسك، تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المدرَج في ملف __/firebase/init.json يتطابق مع مفتاح واجهة برمجة التطبيقات في Cloud Console. صحِّح المفتاح في الملف إذا لزم الأمر، ثم أعِد نشر التطبيق.
- إذا تم حذف Browser key، يمكنك الطلب من Firebase إنشاء مفتاح واجهة برمجة تطبيقات جديد لك: في وحدة تحكُّم Firebase، انتقِل إلى > إعدادات المشروع، ثم في قسم تطبيقاتك، انقر على تطبيق الويب. يُنشئ هذا الإجراء تلقائيًا مفتاح واجهة برمجة تطبيقات يمكنك الاطّلاع عليه في قسم إعداد حزمة SDK وضبطها لتطبيق الويب الخاص بك.
تجدر الإشارة إلى أنّه في Cloud Console، لن يُعرف مفتاح واجهة برمجة التطبيقات الجديد هذا باسم Browser key، وبدلاً من ذلك، سيكون الاسم نفسه المستخدَم في لقب تطبيق الويب Firebase. إذا قررت إضافة قيود واجهة برمجة التطبيقات إلى مفتاح واجهة برمجة التطبيقات الجديد هذا، تأكَّد من إدراج واجهة برمجة تطبيقات مصادقة Firebase في قائمة واجهات برمجة التطبيقات المسموح بها.

بعد إنشاء مفتاح واجهة برمجة التطبيقات الجديد، يجب إكمال الخطوات الموضّحة أدناه:
- إذا كنت تستخدم عناوين URL محجوزة للاستضافة، عليك إعادة نشر تطبيقك على Firebase حتى يتمكّن تلقائيًا من الحصول على مفتاح واجهة برمجة التطبيقات الجديد مع بقية إعدادات Firebase.
- إذا استضافت بنفسك رمز تسجيل الدخول، انسخ مفتاح واجهة برمجة التطبيقات الجديد وأضِفه إلى ملف __/firebase/init.json، ثم أعِد نشر التطبيق.

مصادقة Firebase: كيف يمكنني إنشاء عميل OAuth على الويب يدويًا؟

افتح صفحة بيانات الاعتماد في Google Cloud Console.
في أعلى الصفحة، اختَر إنشاء بيانات اعتماد > معرِّف عميل OAuth.
إذا طُلب منك ضبط شاشة طلب الموافقة، اتّبِع التعليمات الظاهرة على الشاشة، ثم واصِل تنفيذ الخطوات التالية من الأسئلة الشائعة.
إنشاء عميل OAuth على الويب:
1. في حقل نوع التطبيق، اختَر تطبيق الويب.
2. بالنسبة إلى مصادر JavaScript المسموح بها، أضِف ما يلي:
  - http://localhost
  - http://localhost:5000
  - https://PROJECT_ID.firebaseapp.com
  - https://PROJECT_ID.web.app
3. بالنسبة إلى معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، أضِف ما يلي:
  - https://PROJECT_ID.firebaseapp.com/__/auth/handler
  - https://PROJECT_ID.web.app/__/auth/handler
4. احفظ عميل OAuth.
ملاحظة: لا تستخدم بعض نطاقات "استضافة Firebase" رقم تعريف مشروع Firebase، لذا تأكَّد من أنّ النطاقات التي تُدخلها تتطابق مع النطاقات المتوفرة لمشروعك على Firebase.
انسخ معرِّف عميل OAuth الجديد وسر العميل إلى الحافظة.
في "وحدة تحكُّم Firebase"، افتح قسم المصادقة.
ضمن علامة التبويب طريقة تسجيل الدخول، افتح موفّر خدمة تسجيل الدخول بحساب Google، ثم الصِق معرِّف العميل لخادم الويب والسر الذي أنشأته ونسخته من وحدة تحكّم Google Cloud. النقر على حفظ

مصادقة Firebase: كيف يتم تحديد `%APP_NAME%` لنموذج البريد الإلكتروني لرسالة التأكيد الإلكترونية التي يمكن إرسالها إلى المستخدم عند الاشتراك باستخدام عنوان بريد إلكتروني وكلمة مرور؟

قبل كانون الأول (ديسمبر) 2022، كانت تتم تعبئة %APP_NAME% في نموذج الرسالة الإلكترونية باسم علامة OAuth التجارية التي كان يتم توفيرها تلقائيًا كلما تم تسجيل تطبيق Android في مشروع Firebase. والآن، بما أنّه لا يتم توفير المتطلبات اللازمة لعلامة OAuth التجارية إلا عند تفعيل تسجيل الدخول بحساب Google، سيوضّح ما يلي كيفية تحديد %APP_NAME%:

وفي حال توفُّر اسم علامة OAuth التجارية، سيكون %APP_NAME% في نموذج الرسالة الإلكترونية هو اسم علامة OAuth التجارية (كما هو الحال في سلوك ما قبل كانون الأول (ديسمبر) 2022).
إذا لم يكن اسم علامة OAuth التجارية متاحًا، إليك كيفية تحديد %APP_NAME% في نموذج الرسالة الإلكترونية:
- بالنسبة إلى تطبيقات الويب، سيكون %APP_NAME% هو الاسم التلقائي لموقع استضافة Firebase (القيمة التي تسبق .firebaseapp.com و.web.app عادةً رقم تعريف مشروع Firebase).
- بالنسبة إلى التطبيقات المتوافقة مع الأجهزة الجوّالة:
  - إذا كان اسم حزمة Android أو معرّف حزمة iOS مُدرَجَين في الطلب، سيكون %APP_NAME% هو اسم التطبيق المستخدَم في "متجر Play" أو App Store (على التوالي).
  - وفي حال عدم إجراء ذلك، سيكون %APP_NAME% هو اسم الموقع الإلكتروني التلقائي لـ "استضافة Firebase" (القيمة السابقة .firebaseapp.com و.web.app عادةً رقم تعريف مشروع Firebase).
تجدر الإشارة إلى أنّه في حال تعذّر البحث عن اسم الموقع الإلكتروني التلقائي لـ "استضافة Firebase"، يكون الإجراء الاحتياطي النهائي هو استخدام رقم تعريف مشروع Firebase على أنّه %APP_NAME%.

وظائف السحابة الإلكترونية

إتاحة وقت تشغيل دوال السحابة

كيف يمكنني الترقية إلى أحدث إصدار متوافق من Node.js؟

احرص على اتّباع خطة أسعار بليز.
تأكّد من استخدام أحدث إصدار من واجهة سطر الأوامر في Firebase.
يمكنك تعديل الحقل engines في package.json للدوال الخاصة بك.
ويمكنك اختياريًا اختبار التغييرات باستخدام مجموعة محاكيات Firebase المحلية.
أعِد نشر جميع الدوال.

كيف يمكنني التأكّد من أنّني نشرتُ الدوال إلى وقت تشغيل Node.js محدّد؟

في وحدة تحكُّم Firebase، انتقِل إلى لوحة بيانات الدوال، واختَر دالة، ثم تحقَّق من لغة الدالة ضمن تفاصيل إضافية.

أستخدم إضافات Firebase. هل سأتأثّر بتحديثات وقت تشغيل Cloud Functions؟

نعم. بما أنّ الإضافات تستخدم دوال Cloud، ستحتاج إلى تعديل وقت تشغيل الإضافات على المخطط الزمني نفسه مثل "دوال Cloud".

ننصحك بالتحديث الدوري إلى أحدث إصدار من كل إضافة تم تثبيتها في مشروعك. يمكنك ترقية إضافات مشاريعك من خلال وحدة تحكُّم Firebase أو واجهة سطر الأوامر في Firebase.

خدمة المراسلة عبر السحابة الإلكترونية

المراسلة عبر السحابة الإلكترونية: ما الفرق بين منشئ "الإشعارات" و"المراسلة عبر السحابة الإلكترونية"؟

توفر خدمة المراسلة عبر السحابة الإلكترونية من Firebase مجموعة كاملة من إمكانات المراسلة من خلال حِزم SDK للعميل وبروتوكولات خادم HTTP وXMPP. بالنسبة إلى عمليات النشر التي تتضمن متطلبات مراسلة أكثر تعقيدًا، يُعد خيار "المراسلة عبر السحابة الإلكترونية من Firebase" الخيار الأمثل.

أداة إنشاء الإشعارات هي حلّ خفيف للمراسلة بدون خادم ومستند إلى خدمة "المراسلة عبر السحابة الإلكترونية من Firebase". بفضل وحدة التحكم الرسومية السهلة الاستخدام ومتطلبات الترميز المخفّضة، تتيح أداة إنشاء الإشعارات للمستخدمين إرسال الرسائل بسهولة لإعادة جذب المستخدمين والاحتفاظ بهم، وتعزيز نمو التطبيق، ودعم الحملات التسويقية.

الإمكانات		منشئ الإشعارات	المراسلة عبر السحابة الإلكترونية
الهدف	جهاز واحد
	اشترك العملاء في المواضيع (أي الطقس)
	العملاء في شريحة المستخدمين المحدَّدة مسبقًا (التطبيق والإصدار واللغة)
	العملاء في شرائح جمهور محدّدة من "إحصاءات Google"
	العملاء في مجموعات الأجهزة
	البث المباشر من العميل إلى الخادم
نوع الرسالة	إشعارات يصل حجمها إلى 2 كيلوبايت
	رسائل البيانات حتى 4 كيلوبايت
التسليم	فوري
	التوقيت المحلي لجهاز العميل المستقبلي
إحصاءات Google	مجموعة مضمّنة من إحصاءات الإشعارات وإحصاءات حول مسار الإحالة الناجحة

خدمة "المراسلة عبر السحابة الإلكترونية": أعلنت شركة Apple أنّها ستوقف نهائيًا البروتوكول الثنائي القديم لأسماء نقاط الوصول (APN). هل أحتاج إلى اتخاذ أي إجراء؟

لا، فقد تحوّلت خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" إلى بروتوكول أسماء نقاط الوصول (APN) المستنِد إلى HTTP/2 في عام 2017. إذا كنت تستخدم ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" لإرسال إشعارات إلى أجهزة iOS، ليس عليك اتّخاذ أي إجراء.

المراسلة عبر السحابة الإلكترونية: هل أحتاج إلى استخدام خدمات Firebase أخرى حتى أتمكن من استخدام "المراسلة عبر السحابة الإلكترونية من Firebase"؟

يمكنك استخدام خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" كمكوّن مستقل، بالطريقة نفسها التي كنت تستخدمها مع GCM، بدون استخدام خدمات Firebase الأخرى.

خدمة "المراسلة عبر السحابة الإلكترونية من Google": أنا مطوّر برامج حالي لخدمة "المراسلة عبر السحابة الإلكترونية من Google" (GCM). هل يجب عليّ الانتقال إلى استخدام "المراسلة عبر السحابة الإلكترونية من Firebase"؟

خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" هي الإصدار الجديد من خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" تحت علامة Firebase التجارية. وتكتسب هذه الخدمة البنية الأساسية الأساسية لخدمة "المراسلة عبر السحابة الإلكترونية من Google"، مع حِزم تطوير برامج (SDK) جديدة لتسهيل عملية تطوير خدمة "المراسلة عبر السحابة الإلكترونية".

تشمل مزايا الترقية إلى حزمة تطوير البرامج (SDK) للمراسلة عبر السحابة الإلكترونية من Firebase ما يلي:

تطوير أكثر بساطة للعملاء. لم تعُد مضطرًا لكتابة منطقك الخاص بالتسجيل أو إعادة محاولة الاشتراك.
حل مبتكر لإرسال الإشعارات. يمكنك استخدام أداة إنشاء الإشعارات، وهو حلّ إشعارات بدون خادم مع وحدة تحكّم على الويب تتيح لأي مستخدم إرسال إشعارات لاستهداف شرائح جمهور معيّنة استنادًا إلى إحصاءات من "إحصاءات Google".

للترقية من حِزم تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة إلى حِزم تطوير البرامج (SDK) الخاصة بخدمة "المراسلة عبر السحابة الإلكترونية من Firebase"، يمكنك الاطّلاع على أدلة نقل بيانات تطبيقات Android وiOS.

المراسلة عبر السحابة الإلكترونية: لماذا لا تتلقى الأجهزة المستهدفة الرسائل على ما يبدو؟

عندما يبدو أنّ الأجهزة لم تتلقَّ الرسائل بنجاح، تحقَّق أولاً من هذين السببَين المحتملَين:

التعامل مع الرسائل التي تعمل في المقدّمة لرسائل الإشعارات: تحتاج تطبيقات العملاء إلى إضافة منطق لمعالجة الرسائل من أجل معالجة رسائل الإشعارات عندما يكون التطبيق قيد التشغيل على الجهاز. اطّلِع على تفاصيل نظامَي التشغيل iOS و Android.

قيود جدار الحماية للشبكة. إذا كانت مؤسستك تمتلك جدار حماية يحصر الزيارات الواردة من الإنترنت أو إليه، عليك ضبطه للسماح بالاتصال بخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" حتى تتمكّن تطبيقات برنامج "المراسلة عبر السحابة الإلكترونية من Firebase" من تلقّي الرسائل. المنافذ المطلوب فتحها هي:

5228
5229
5230

عادةً ما تستخدم ميزة "المراسلة عبر السحابة الإلكترونية من Firebase" الترميز 5228، لكنها في بعض الأحيان تستخدم الترميزَين 5229 و5230. لا توفّر خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" عناوين IP محدّدة، لذا عليك السماح لجدار الحماية بقبول الاتصالات الصادرة لجميع عناوين IP المضمّنة في مجموعات عناوين IP المدرَجة في ASN من 15169 من Google.

خدمة "المراسلة عبر السحابة الإلكترونية": لقد نفّذت `onMessageReceived` في تطبيق Android الخاص بي، ولكن لا يتم استدعاؤه.

عندما يكون تطبيقك في الخلفية، يتم عرض رسائل الإشعارات في لوحة النظام، ولا يتم استدعاء onMessageReceived. وبالنسبة إلى رسائل الإشعار التي تتضمّن حمولة بيانات، يتم عرض رسالة الإشعار في لوحة النظام، ويمكن استرداد البيانات المضمَّنة في رسالة الإشعار من الغرض الذي تم إطلاقه عندما ينقر المستخدم على الإشعار.

للحصول على مزيد من المعلومات، راجِع تلقّي الرسائل ومعالجتها.

منشئ الإشعارات: ما الفرق بين مؤلف الإشعارات والمراسلة عبر السحابة الإلكترونية؟

وفي ما يلي مقارنة بين إمكانات المراسلة التي توفِّرها خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" وأداة إنشاء الإشعارات:

الإمكانات		منشئ الإشعارات	المراسلة عبر السحابة الإلكترونية
الهدف	جهاز واحد
	اشترك العملاء في المواضيع (أي الطقس)
	العملاء في شريحة المستخدمين المحدَّدة مسبقًا (التطبيق والإصدار واللغة)
	العملاء في شرائح جمهور محدّدة من "إحصاءات Google"
	العملاء في مجموعات الأجهزة
	البث المباشر من العميل إلى الخادم
نوع الرسالة	إشعارات يصل حجمها إلى 2 كيلوبايت
	رسائل البيانات حتى 4 كيلوبايت
التسليم	فوري
	التوقيت المحلي لجهاز العميل المستقبلي
إحصاءات Google	مجموعة مضمّنة من إحصاءات الإشعارات وإحصاءات حول مسار الإحالة الناجحة

منشئ الإشعارات: أنا مطوّر حاليًا لخدمة "مراسلة عبر السحابة الإلكترونية من Google" (GCM)، وأريد استخدام منشئ الإشعارات. ماذا يجب أن أفعل؟

إنّ أداة إنشاء الإشعارات هي حلّ مبتكر يتيح لأي مستخدم إرسال إشعارات لاستهداف شرائح جمهور معيّنة استنادًا إلى الإحصاءات الواردة من "إحصاءات Google". بالإضافة إلى ذلك، يوفّر منشئ تطبيق "الإشعارات" تحليلاً لمسار الإحالة الناجحة لكل رسالة، ما يتيح تقييم مدى فعالية الإشعارات بسهولة.

إذا كنت من المطوّرين الحاليين في "GCM"، عليك الترقية من حِزم تطوير البرامج (SDK) لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" إلى حِزم تطوير البرامج (SDK) لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase". اطّلِع على أدلة نقل بيانات تطبيقات Android وiOS.

سيتم إيقاف ميزات "المراسلة عبر السحابة الإلكترونية من Firebase" نهائيًا في حزيران (يونيو) 2023.

أي واجهات برمجة تطبيقات لخدمة "المراسلة عبر السحابة الإلكترونية من Firebase" تم إيقافها نهائيًا في 20 حزيران (يونيو) 2023، وماذا يجب أن أفعل إذا كنت أستخدم هذه الواجهات؟

ستتأثر واجهات برمجة التطبيقات/حِزم تطوير البرامج (SDK) التالية بالإيقاف النهائي:

واجهات برمجة تطبيقات الخادم

اسم واجهة برمجة التطبيقات	نقطة نهاية واجهة برمجة التطبيقات	التأثير في المستخدمين	مطلوب اتخاذ إجراء.
بروتوكول HTTP القديم	https://fcm.googleapis.com/fcm/send	سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024.	نقل البيانات إلى واجهة برمجة تطبيقات HTTP v1
بروتوكول XMPP القديم	fcm-xmpp.googleapis.com:5235	سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024.	نقل البيانات إلى واجهة برمجة تطبيقات HTTP v1
واجهات برمجة تطبيقات خادم رقم تعريف المثيل	https://iid.googleapis.com/v1/web/iid	سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024.	استخدِم حزمة تطوير البرامج (SDK) ل JavaScript على الويب لإنشاء عمليات تسجيل على الويب في خدمة "المراسلة عبر السحابة الإلكترونية من Firebase".
واجهات برمجة تطبيقات خادم رقم تعريف المثيل	https://iid.googleapis.com/iid/*	ستواصل نقاط النهاية العمل، ولكنها لن تتيح المصادقة باستخدام مفاتيح الخادم الثابتة بعد 21/6/2024.	استخدام رمز دخول OAuth 2.0 مشتق من حساب خدمة.
واجهة برمجة التطبيقات لإدارة مجموعة الأجهزة	https://fcm.googleapis.com/fcm/notification	ستواصل نقطة النهاية العمل، ولكنها لن تتيح المصادقة باستخدام مفاتيح الخادم الثابتة بعد 21/6/2024.	استخدام رمز دخول OAuth 2.0 مشتق من حساب خدمة.
المراسلة قبل البث عبر XMPP	fcm-xmpp.googleapis.com:5235	إنّ طلبات البيانات من واجهة برمجة التطبيقات المرسَلة إلى FirebaseMessaging.send في التطبيق لن تؤدي إلى إرسال الرسائل إلى خادم التطبيق بعد تاريخ 21 حزيران (يونيو) 2024.	تنفيذ هذه الوظيفة وفقًا لمنطق الخادم. على سبيل المثال، ينفّذ بعض المطوّرين نقطة نهاية HTTP/gRPC الخاصة بهم ويطلبون نقطة النهاية مباشرةً لإرسال الرسائل من عملائهم إلى خادم التطبيق. راجِع البدء السريع لـ gRPC للاطّلاع على مثال لتنفيذ المراسلة من خلال عملية التحميل الرئيسية باستخدام gRPC.
واجهة برمجة تطبيقات الإرسال المجمَّع	https://fcm.googleapis.com/batch	سيبدأ تعذّر إرسال الطلبات إلى نقطة النهاية بعد 21 حزيران (يونيو) 2024.	عليك نقل البيانات إلى طريقة الإرسال العادية لواجهة برمجة التطبيقات HTTP v1، والتي تتيح استخدام HTTP/2 لتعدد الإرسال.

واجهات برمجة تطبيقات SDK لمشرف Firebase

اسم واجهة برمجة التطبيقات	لغة واجهة برمجة التطبيقات	التأثير في المستخدمين	مطلوب اتخاذ إجراء.
`sendToDevice()`	Node.js	ستتوقف واجهة برمجة التطبيقات عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تستدعي واجهة برمجة التطبيقات القديمة لإرسال HTTP.	استخدِم الطريقة `send()` .
`sendToDeviceGroup()`	Node.js	ستتوقف واجهة برمجة التطبيقات عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تستدعي واجهة برمجة التطبيقات القديمة لإرسال HTTP.	استخدِم الطريقة `send()` .
`sendAll()/sendAllAsync()/send_all()/sendMulticast()/SendMulticastAsync()/send_multicast()`	Node.js وJava وPython وGo وC#	ستتوقّف واجهات برمجة التطبيقات هذه عن العمل بعد 21 حزيران (يونيو) 2024 لأنّها تستدعي واجهة برمجة تطبيقات الإرسال المجمّع .	عليك الترقية إلى أحدث حزمة SDK لمشرف Firebase واستخدام واجهات برمجة التطبيقات الجديدة بدلاً من ذلك: `sendEach()/ sendEachAsync()/send_each()/sendEachForMulticast()/sendEachForMulticastAsync()/ send_each_for_multicast()`. تجدر الإشارة إلى أنّ واجهات برمجة التطبيقات الجديدة لم تعُد تستدعي واجهة برمجة التطبيقات للإرسال المجمّع المتوقّف نهائيًا، ولهذا السبب قد تنشئ اتصالات HTTP متزامنة أكثر من واجهات برمجة التطبيقات القديمة.

حِزم تطوير البرامج (SDK) للعملاء

إصدارات حزمة تطوير البرامج (SDK)	التأثير في المستخدمين	مطلوب اتخاذ إجراء.
حزم GCM SDK (تم إيقافها في 2018)	بعد 21/6/2024، لن تتمكّن التطبيقات التي تستخدم حِزم تطوير البرامج (SDK) من إنشاء "GCM" من تسجيل الرموز المميّزة أو تلقّي رسائل منها.	عليك ترقية حزمة تطوير البرامج (SDK) لنظام التشغيل Android إلى أحدث حزمة تطوير برامج (SDK) لمنصّة Firebase إذا لم يسبق لك ذلك.
الإصدار <7.0.0 من حِزم تطوير البرامج (SDK) بلغة JavaScript (إحداث تغيير جذري في الإصدار 7.0.0 في عام 2019)	بعد 21 حزيران (يونيو) 2024، لن تتمكّن تطبيقات الويب التي تستخدم حِزم تطوير برامج JavaScript قديمة من تسجيل الرموز المميّزة.	عليك ترقية حزمة تطوير البرامج (SDK) للويب على Firebase إلى أحدث إصدار.

هل سيتم خفض مستوى الخدمة قبل حزيران (يونيو) 2024؟

لا، لديك فترة 12 شهرًا (بين 20/06/2023 و21/06/2024) لنقل البيانات من واجهات برمجة التطبيقات القديمة إلى واجهات برمجة تطبيقات جديدة بدون الحاجة إلى الرجوع إلى إصدار سابق من الخدمة. ننصحك بشدة بالتخطيط لعملية نقل البيانات في أقرب وقت ممكن حتى لا تتأثر بإيقاف واجهات برمجة التطبيقات في حزيران (يونيو) 2024.

بعد حزيران (يونيو) 2024، قد تلاحظ زيادةً في عدد الأخطاء أو نقص في الوظائف عند استخدام واجهات برمجة التطبيقات/حِزم تطوير البرامج (SDK) المذكورة أعلاه.

ما هو الفرق بين رموز OAuth 2.0 المميزة ومفاتيح الخادم؟

رمز OAuth 2.0 المميز هو رمز مميّز قصير الأجل تم اشتقاقه من حساب الخدمة. إنّه نموذج المصادقة العادي من Google، وهو أكثر أمانًا من مفاتيح الخادم الثابتة.

يمكنك مراجعة القسم استخدام بيانات الاعتماد لإنشاء رموز الدخول للحصول على إرشادات حول استخدام Google Auth Library للحصول على الرموز المميّزة.

تجدر الإشارة إلى أنّ عناوين الطلبات تختلف عند استخدام رموز OAuth 2.0 المميّزة للطلبات الواردة إلى نقاط نهاية مختلفة.

واجهة برمجة تطبيقات HTTP v1: Authorization: Bearer $oauth_token
واجهة برمجة تطبيقات خادم معرِّف المثيل وواجهة برمجة تطبيقات إدارة مجموعة الأجهزة: Authorization: Bearer $oauth_token
access_token_auth: true

هل يمكنني نقل طلباتي إلى واجهة برمجة التطبيقات الجديدة دُفعة واحدة؟

ننصحك بزيادة عدد الزيارات ببطء إلى واجهة برمجة التطبيقات الجديدة. إذا كنت تتوقع إرسال أكثر من 600,000 رسالة/الدقيقة بشكل منتظم، يمكنك التواصل مع فريق دعم Firebase للحصول على تعليمات حول كيفية زيادة الحصة أو الحصول على اقتراحات حول كيفية زيادة عدد الزيارات.

ما الفرق بين واجهة برمجة التطبيقات HTTP v1 وواجهات برمجة التطبيقات القديمة عند إرسال رسائل إلى مجموعات المواضيع أو الأجهزة؟

المواضيع: لست بحاجة إلى إضافة البادئة "/topics/" إلى استهداف الموضوع عند استخدام v1 API.

مجموعات الأجهزة: يمكنك استخدام رمز مميّز للمجموعة كهدف رمز مميّز في واجهة برمجة التطبيقات HTTP v1. مع ذلك، لا تعرض واجهة برمجة التطبيقات HTTP v1 عدد أعداد النجاح أو الإخفاق في الاستجابة. ننصحك باستخدام مواضيع "المراسلة عبر السحابة الإلكترونية من Firebase" أو إدارة مجموعات الأجهزة بنفسك.

هل تتيح واجهة برمجة التطبيقات HTTP v1 API إرسال الرسائل إلى رموز مميّزة متعدّدة في طلب واحد؟

لا، إنّ هذه الميزة التي تُعرف باسم "البث المتعدد" في واجهات برمجة تطبيقات HTTP القديمة غير متوافقة مع واجهة برمجة التطبيقات HTTP v1 التي تم تصميمها بشكل أفضل لإتاحة إمكانية التوسّع.

في حالات الاستخدام التي يكون فيها وقت الاستجابة التام بين الأطراف أمرًا بالغ الأهمية أو الذي يكون إجمالي حجم التوزيع فيه صغيرًا (أقل من مليون)، تنصح Google بإرسال عدة طلبات منفصلة باستخدام HTTP v1 API. تعمل واجهة برمجة التطبيقات HTTP v1 عبر HTTP/2 بالطريقة نفسها بالنسبة إلى 99.9% من طلبات البث المتعدد (إرسال أقل من 100 رمز مميّز). في حالات الاستخدام غير المعتادة (إرسال 1,000 رمز مميّز)، يحقّق المنتج ما يصل إلى ثلث معدّل سرعة معالجة البيانات، لذلك يجب إجراء تزامن إضافي لتحسين حالة الاستخدام غير المعتادة هذه. يمكن للمستخدمين استخدام واجهة برمجة التطبيقات HTTP v1 API لمزيد من الموثوقية ومدى التوفّر مقارنةً بالبث المتعدد القديم.

في حالات الاستخدام التي يتم فيها إعطاء الأولوية لمعدل نقل البيانات ومعدّل نقل البيانات أو التي يكون إجمالي حجم التوزيع فيها كبيرًا (أكبر من مليون)، تنصح Google بمراسلة المواضيع. على الرغم من أنّ المراسلة حول موضوع تتطلب إجراءً لمرة واحدة لاشتراك المستلمين في موضوع ما، فإنها توفر ما يصل إلى 10000 لقطة في الثانية لكل مشروع بدون حد أقصى لحجم الموضوع.

ما هي إصدارات "SDK لمشرف Firebase" التي تتضمّن واجهات برمجة التطبيقات الجديدة؟

النظام الأساسي	إصدار حزمة تطوير البرامج (SDK) لمشرف Firebase
Node.js	>=11.7.0
Python	>=6.2.0
Java	>=9.2.0
Go	>=4.12.0
NET.	>=2.4.0

ما الفرق بين واجهة برمجة التطبيقات للإرسال المجمّع وواجهة برمجة التطبيقات HTTP v1؟

تستخدم واجهة برمجة التطبيقات للإرسال المجمّع في خدمة FCM تنسيق الرسالة وآلية المصادقة نفسها مثل واجهة برمجة التطبيقات HTTP v1. ومع ذلك، فإنه يستخدم نقطة نهاية مختلفة. إذا أردت تحسين الكفاءة، يمكنك استخدام HTTP/2 لإرسال طلبات متعددة من خلال اتصال HTTP نفسه إلى واجهة برمجة التطبيقات HTTP v1.

ماذا يجب أن أفعل إذا تعذّر عليَّ الوصول إلى مشروعي؟

يُرجى التواصل مع فريق دعم Google Cloud للحصول على المساعدة.

هل يمكن للمشاريع الجديدة تفعيل واجهة Cloud Messaging API القديمة؟

لا، اعتبارًا من 20/5/2024، لن يُسمح للمشاريع الجديدة بتفعيل واجهات برمجة التطبيقات القديمة.

التخزين في السحابة الإلكترونية لبرنامج Firebase

Cloud Storage for Firebase: لماذا لا يمكنني استخدام Cloud Storage for Firebase؟

تنشئ خدمة Cloud Storage for Firebase حزمة تلقائية في فئة App Engine بدون تكلفة. ويتيح لك ذلك بدء استخدام Firebase وCloud Storage for Firebase بسرعة، بدون الحاجة إلى إضافة بطاقة ائتمان أو تفعيل حساب فوترة في Cloud. ويسمح لك أيضًا بمشاركة البيانات بسهولة بين Firebase ومشروع على Google Cloud.

ومع ذلك، لا يمكن إنشاء هذه الحزمة في حالتين معروفتين ولن تتمكّن من استخدام Cloud Storage for Firebase:

مشروع تم استيراده من Google Cloud وكان يحتوي على تطبيق App Engine Master/Slave Datastore.
مشروع تم استيراده من Google Cloud يحتوي على مشاريع تبدأ بنطاق. مثلاً: domain.com:project-1234

لا تتوفّر حاليًا حلول لهذه المشاكل، وننصحك بإنشاء مشروع جديد في وحدة تحكُّم Firebase وتفعيل Cloud Storage for Firebase في هذا المشروع.

Cloud Storage for Firebase: لماذا أحصل على ردود رمز الخطأ 412 حول أذونات حساب الخدمة والعمليات الفاشلة لحساب الخدمة عند استخدام Cloud Storage for Firebase API؟

من المحتمل أن يظهر لك رمز خطأ 412 إما لأنّ واجهة برمجة التطبيقات Cloud Storage for Firebase API غير مفعّلة لمشروعك أو لأنّ حساب الخدمة الضروري لا يتضمّن الأذونات المطلوبة.

يُرجى الاطّلاع على الأسئلة الشائعة ذات الصلة.

Cloud Storage for Firebase: هل يمكنني تخزين ملفات قابلة للتنفيذ في مشاريع خطة Spark؟

بالنسبة إلى مشاريع الخطط بدون تكلفة (Spark)، يحظر Firebase عمليات تحميل واستضافة أنواع معيّنة من الملفات القابلة للتنفيذ لأنظمة التشغيل Windows وAndroid وApple من خلال Cloud Storage for Firebase وFirebase. تهدف هذه السياسة إلى منع إساءة الاستخدام على منصتنا.

سيتم حظر عرض واستضافة وتحميل الملفات غير المسموح بها لجميع مشاريع Spark التي تم إنشاؤها في 28 أيلول (سبتمبر) 2023 أو بعد هذا التاريخ. بالنسبة إلى مشاريع Spark الحالية التي تتضمن ملفات تم تحميلها قبل ذلك التاريخ، سيبقى بإمكانك تحميل هذه الملفات واستضافتها.

ينطبق هذا الشرط على مشاريع خطة Spark. لا تتأثر المشاريع المستندة إلى خطة "الدفع حسب الاستخدام" (Blaze).

لا يمكن استضافة أنواع الملفات التالية على "استضافة Firebase" و"التخزين في السحابة الإلكترونية" لمنصّة Firebase:

ملفات Windows ذات الامتدادات .exe و.dll و.bat
ملفات Android ذات الامتداد .apk
ملفات نظام Apple الأساسي بامتداد .ipa

ما هو الإجراء الذي عليّ اتّخاذه؟

إذا أردت استضافة أنواع الملفات هذه بعد 28 أيلول (سبتمبر) 2023:

بالنسبة إلى الاستضافة: يجب الترقية إلى خطة Blaze قبل أن تتمكّن من نشر أنواع الملفات هذه في "استضافة Firebase" باستخدام الأمر firebase deploy.
بالنسبة إلى مساحة التخزين: يمكنك الترقية إلى خطة Blaze لتحميل أنواع الملفات هذه إلى الحزمة التي تختارها باستخدام GCS CLI أو "وحدة تحكُّم Firebase" أو Google Cloud Console.

استخدِم أدوات Firebase لإدارة موارد خدمة "استضافة Firebase" و"التخزين في السحابة الإلكترونية".

لإدارة الموارد في "استضافة Firebase"، استخدِم وحدة تحكّم Firebase لحذف الإصدارات وفقًا لهذا الدليل.
لإدارة الموارد في Cloud Storage، انتقِل إلى صفحة المنتج الخاصة بمساحة التخزين في مشروعك.

في علامة التبويب الملفات، حدِّد الملفات التي لا يُسمح بحذفها في التسلسل الهرمي للمجلدات، ثم اختَرها باستخدام مربع الاختيار بجانب أسماء الملفات على الجانب الأيمن من اللوحة.
انقر على حذف، وأكد على حذف الملفات.

يُرجى الرجوع إلى مستنداتنا للحصول على معلومات إضافية عن إدارة استضافة الموارد باستخدام أدوات Firebase وحِزم Cloud Storage for Firebase التي تتضمّن مكتبات العملاء.

Cloud Storage for Firebase: لماذا أرى زيادة غير متوقعة في عمليات التحميل والتنزيل؟

في السابق، لم يكن يتم احتساب طلبات التنزيل والتحميل في Cloud Storage for Firebase API بشكل صحيح. لقد اتّخذنا خطوات لحلّ هذه المشكلة اعتبارًا من 15 أيلول (سبتمبر) 2023.

بالنسبة إلى مستخدمي Blaze، سيبدأ احتساب عمليات التحميل والتنزيل ضمن فاتورتك الشهرية. بالنسبة إلى مستخدمي Spark، سيبدأ احتسابهم ضمن الحدّ الأقصى الشهري المجاني.

ننصحك بتتبُّع صفحة الاستخدام بحثًا عن أي زيادات قد تُحتسب ضمن الحدود المسموح بها.

Cloud Storage for Firebase: لماذا أرى أرقام تعريف حسابات خدمة جديدة مرتبطة بمشاريع Firebase التي تستخدم Cloud Storage for Firebase؟

يستخدم Firebase حسابات الخدمة لتشغيل الخدمات وإدارتها بدون مشاركة بيانات اعتماد المستخدمين. عند إنشاء مشروع على Firebase، قد تلاحظ أنّ عددًا من حسابات الخدمة متوفّر في مشروعك.

إنّ حساب الخدمة الذي تستخدمه Cloud Storage for Firebase مخصّص لمشروعك وهو باسم
service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.

إذا استخدمت Cloud Storage لبرنامج Firebase قبل 19 أيلول (سبتمبر) 2022، قد يظهر لك حساب خدمة إضافي ضمن حِزم Cloud Storage التي تم ربطها سابقًا باسم firebase-storage@system.gserviceaccount.com. اعتبارًا من 19 أيلول (سبتمبر) 2022، لن يعود حساب الخدمة هذا متاحًا.

يمكنك الاطّلاع على جميع حسابات الخدمة المرتبطة بمشروعك في "وحدة تحكُّم Firebase" ضمن علامة التبويب "حسابات الخدمة".

إضافة حساب الخدمة الجديد

إذا أزلت حساب الخدمة سابقًا أو لم يكن حساب الخدمة مضمَّنًا في مشروعك، يمكنك تنفيذ أحد الإجراءات التالية لإضافة الحساب.

(إجراء يُنصح به) مبرمَجة: استخدِم نقطة نهاية إضافة Firebase REST لإعادة استيراد الحزمة إلى Firebase. ستحتاج إلى طلب نقطة النهاية هذه مرة واحدة فقط، وليس مرة واحدة لكل حزمة مرتبطة.
يدويًا: اتّبِع الخطوات الواردة في إنشاء حسابات الخدمة وإدارتها. باتّباع هذا الدليل، أضِف حساب خدمة يتضمّن دور "إدارة الهوية وإمكانية الوصول" Cloud Storage for Firebase Service Agent واسم حساب الخدمة
service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com.

إزالة حساب الخدمة الجديد

ننصحك بشدة بعدم إزالة حساب الخدمة لأنّ ذلك قد يؤدي إلى حظر الوصول إلى حِزم Cloud Storage من تطبيقاتك. لإزالة حساب الخدمة من مشروعك، اتّبِع التعليمات الواردة في المقالة إيقاف حساب الخدمة.

Crashlytics

انتقِل إلى صفحة تحديد المشاكل وحلّها في Crashlytics والأسئلة الشائعة للحصول على نصائح وإجابات مفيدة عن المزيد من الأسئلة الشائعة.

الروابط الديناميكية

الروابط الديناميكية: ما هي خطط Firebase المستقبلية للروابط الديناميكية؟

اطّلِع على الأسئلة الشائعة حول الروابط الديناميكية.

الروابط الديناميكية: لماذا يصل تطبيق Android إلى كل رابط ديناميكي مرتين؟

وتمحو واجهة برمجة تطبيقات getInvitation الرابط الديناميكي المحفوظ لمنع الوصول إليه مرتين. احرص على طلب البيانات من واجهة برمجة التطبيقات هذه مع ضبط المعلَمة autoLaunchDeepLink على false في كل نشاط من أنشطة الروابط المؤدية إلى صفحات في التطبيق، وذلك لإزالة البيانات المطابِقة للحالة التي يتم فيها بدء النشاط خارج النشاط الرئيسي.

مجموعة أدوات المحاكاة المحلية لمنصة Firebase

لماذا تعرض سجلات حزمة Emulator Suite خطأً يبدأ بـ "لا يوصى بأرقام تعريف مشاريع متعددة في وضع المشروع الواحد"؟

تعني هذه الرسالة أنّ "حزمة المحاكي" قد رصدت أنّها تشغَل محاكي منتج معيّن باستخدام أرقام تعريف مشاريع مختلفة. وقد يشير ذلك إلى وجود خطأ في الإعداد ويمكن أن يتسبب في حدوث مشاكل عندما تحاول المحاكيات التواصل مع بعضها البعض، وعندما تحاول التفاعل مع أدوات المحاكاة من خلال الرمز البرمجي الخاص بك. في حال عدم تطابق أرقام تعريف المشاريع، غالبًا ما يبدو أنّ البيانات غير متوفّرة، وذلك لأنّ البيانات المخزَّنة في المحاكاة يتم ربطها بمعرّف المشروع، وتعتمد إمكانية التشغيل التفاعلي على أرقام تعريف المشاريع المطابقة.

لطالما كان هذا الأمر مصدر ارتباك شائعًا بين المطوّرين، لذا فإنّ "حزمة المحاكي المحلية" لن تسمح الآن إلا بتشغيلها باستخدام رقم تعريف مشروع واحد تلقائيًا، ما لم تحدّد خلاف ذلك في ملف الإعداد firebase.json. وإذا اكتشف المحاكي أكثر من رقم تعريف مشروع واحد، سيسجِّل تحذيرًا وقد يؤدي إلى حدوث خطأ جسيم.

راجِع بيانات رقم تعريف المشروع بحثًا عن حالات عدم التطابق في:

يتم تحديد المشروع التلقائي في سطر الأوامر. سيتم تلقائيًا أخذ رقم تعريف المشروع عند بدء تشغيله من المشروع الذي تم اختياره باستخدام firebase init أو firebase use. لعرض قائمة المشاريع (ومعرفة المشروع الذي تم اختياره)، استخدِم firebase projects:list.
اختبارات الوحدات: غالبًا ما يتم تحديد رقم تعريف المشروع في طلبات مكتبة اختبار وحدة القواعد initializeTestEnvironment أو initializeTestApp. قد يتم إعداد رمز اختبار آخر باستخدام initializeApp(config).
علامة سطر الأوامر --project يؤدي تمرير علامة واجهة سطر الأوامر في Firebase --project إلى إلغاء المشروع التلقائي. وعليك التأكّد من تطابق قيمة العلامة مع رقم تعريف المشروع في اختبارات الوحدات وإعداد التطبيق.

الأماكن الخاصة بالنظام الأساسي التي يجب الاطّلاع عليها:

الويب	السمة `projectId` في كائن `firebaseConfig` بلغة JavaScript، والمستخدمة في `initializeApp`.
Android	السمة `project_id` في ملف الإعداد `google-services.json`
منصات Apple	السمة `PROJECT_ID` في ملف الإعداد `GoogleService-Info.plist`

لإيقاف وضع مشروع واحد، حدِّث firebase.json باستخدام المفتاح singleProjectMode:

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

الاستضافة

الاستضافة: في مشاريع خطة Spark، هل يمكنني تخزين ملفات قابلة للتنفيذ؟

ينطبق هذا الشرط على مشاريع خطة Spark. لا تتأثر المشاريع المستندة إلى خطة "الدفع حسب الاستخدام" (Blaze).

لا يمكن استضافة أنواع الملفات التالية على "استضافة Firebase" و"التخزين في السحابة الإلكترونية" لمنصّة Firebase:

ملفات Windows ذات الامتدادات .exe و.dll و.bat
ملفات Android ذات الامتداد .apk
ملفات نظام Apple الأساسي بامتداد .ipa

ما هو الإجراء الذي عليّ اتّخاذه؟

إذا أردت استضافة أنواع الملفات هذه بعد 28 أيلول (سبتمبر) 2023:

بالنسبة إلى الاستضافة: يجب الترقية إلى خطة Blaze قبل أن تتمكّن من نشر أنواع الملفات هذه في "استضافة Firebase" باستخدام الأمر firebase deploy.
بالنسبة إلى مساحة التخزين: يمكنك الترقية إلى خطة Blaze لتحميل أنواع الملفات هذه إلى الحزمة التي تختارها باستخدام GCS CLI أو "وحدة تحكُّم Firebase" أو Google Cloud Console.

استخدِم أدوات Firebase لإدارة موارد خدمة "استضافة Firebase" و"التخزين في السحابة الإلكترونية".

لإدارة الموارد في "استضافة Firebase"، استخدِم وحدة تحكّم Firebase لحذف الإصدارات وفقًا لهذا الدليل.
لإدارة الموارد في Cloud Storage، انتقِل إلى صفحة المنتج الخاصة بمساحة التخزين في مشروعك.

في علامة التبويب الملفات، حدِّد الملفات التي لا يُسمح بحذفها في التسلسل الهرمي للمجلدات، ثم اختَرها باستخدام مربع الاختيار بجانب أسماء الملفات على الجانب الأيمن من اللوحة.
انقر على حذف، وأكد على حذف الملفات.

الاستضافة: لماذا يعرض جدول سجلّ إصدار "الاستضافة" في وحدة تحكُّم Firebase عدد الملفات التي تزيد عن العدد الذي يظهر في مشروعي المحلي؟

تضيف منصة Firebase تلقائيًا ملفات إضافية تحتوي على بيانات وصفية حول الموقع الإلكتروني للاستضافة، ويتم تضمين هذه الملفات في إجمالي عدد الملفات للإصدار.

الاستضافة: ما هو أكبر حجم ملف يمكنني نشره على خدمة "استضافة Firebase"؟

الحد الأقصى المسموح به لحجم خدمة الاستضافة هو 2 غيغابايت للملفات الفردية.

ننصحك بتخزين ملفات أكبر حجمًا باستخدام خدمة Cloud Storage التي توفّر حدًا أقصى لحجم العناصر الفردية ضمن النطاق الذي يتراوح بين التيابايت.

الاستضافة: كم عدد "مواقع الاستضافة" التي يمكنني امتلاكها لكل مشروع على Firebase؟

تتيح ميزة "استضافة المواقع الإلكترونية المتعددة" على Firebase إنشاء 36 موقعًا إلكترونيًا كحدّ أقصى لكل مشروع.

مراقبة الأداء

انتقِل إلى صفحة الأسئلة الشائعة وتحديد المشاكل وحلّها في "مراقبة الأداء" للحصول على نصائح مفيدة وإجابات عن المزيد من الأسئلة الشائعة.

مراقبة الأداء: كم عدد أنماط عناوين URL المخصصة التي يمكنني إنشاؤها؟

يمكنك إنشاء ما يصل إلى 400 نمط عنوان URL مخصّص إجمالاً لكل تطبيق وما يصل إلى 100 نمط عنوان URL مخصّص لكل نطاق لذلك التطبيق.

مراقبة الأداء: لماذا لا أرى عرض بيانات الأداء في الوقت الفعلي؟

للاطّلاع على بيانات الأداء في الوقت الفعلي، تأكَّد من أنّ تطبيقك يستخدم إصدار حزمة تطوير البرامج (SDK) لتتبُّع الأداء يتوافق مع معالجة البيانات في الوقت الفعلي.

iOS: الإصدار 7.3.0 أو إصدار أحدث
tvOS: الإصدار 8.9.0 أو إصدار أحدث
نظام التشغيل Android: الإصدار 19.0.10 أو إصدار أحدث (أو الإصدار 26.1.0 من Firebase Android BoM أو إصدار أحدث)
الويب: الإصدار 7.14.0 أو إصدار أحدث

تجدر الإشارة إلى أنّنا ننصح دائمًا باستخدام أحدث إصدار من حزمة SDK، إلا أنّ أيّ إصدار مدرَج أعلاه سيتيح ميزة "مراقبة الأداء" لمعالجة بياناتك في الوقت الفعلي تقريبًا.

قاعدة بيانات الوقت الفعلي

قاعدة بيانات في الوقت الفعلي: لماذا تم تسجيل معدّل نقل البيانات في قاعدة بيانات الوقت الفعلي أقل من المتوسط بين أيلول (سبتمبر) 2016 وآذار (مارس) 2017؟

بالنسبة إلى عمليات احتساب معدل نقل البيانات، عادةً ما يتم تضمين النفقات العامة لتشفير طبقة المقابس الآمنة (SSL) (استنادًا إلى الطبقة 5 من نموذج OSI). وفي أيلول (سبتمبر) 2016، قدّمنا خطأً تسبب في تجاهل بيانات التشفير الزائدة في تقارير معدل نقل البيانات. ومن المحتمل أن يكون هذا قد أدّى إلى انخفاض زائف في معدّل نقل البيانات ووجود فواتير في حسابك لبضعة أشهر.

لقد أطلقنا إصلاحًا للخطأ في أواخر آذار (مارس) 2017، مع إعادة تقارير معدّل نقل البيانات والفوترة إلى المستويات العادية.

قاعدة بيانات الوقت الفعلي: ما هي قيود القياس في قاعدة بيانات الوقت الفعلي؟

لكل مثيل قاعدة بيانات في الوقت الفعلي حدود لعدد عمليات الكتابة في الثانية. ويصل هذا الحدّ إلى 1, 000 عملية كتابة في الثانية تقريبًا، وذلك بالنسبة إلى عمليات الكتابة الصغيرة. وعند الاقتراب من هذا الحدّ، قد تساعدك عمليات التجميع باستخدام التحديثات المتعدّدة المسارات في تحقيق سرعة أعلى في معالجة البيانات.

بالإضافة إلى ذلك، يكون لكل مثيل قاعدة بيانات حد أقصى لعدد الاتصالات المتزامنة لقاعدة البيانات. وتكون الحدود الافتراضية كبيرة بما يكفي لمعظم التطبيقات. إذا كنت بصدد إنشاء تطبيق يتطلب مقياسًا إضافيًا، قد تحتاج إلى تقسيم تطبيقك على مثيلات قاعدة بيانات متعددة لإضافة مقياس. يمكنك أيضًا استخدام Cloud Firestore كقاعدة بيانات بديلة.

قاعدة بيانات الوقت الفعلي: ما الذي يمكنني فعله إذا تجاوزت حدود استخدام قاعدة بيانات الوقت الفعلي؟

إذا تلقّيت تنبيهًا أو إشعارًا عبر البريد الإلكتروني في "وحدة تحكُّم Firebase" يفيد بأنّك تجاوزت حدود الاستخدام الخاصة بقاعدة البيانات في الوقت الفعلي، يمكنك حلّ هذه المشكلة بناءً على الحدّ الأقصى للاستخدام الذي تجاوزته. للاطّلاع على استخدام قاعدة البيانات في الوقت الفعلي، انتقِل إلى لوحة بيانات استخدام قاعدة البيانات في الوقت الفعلي في وحدة تحكُّم Firebase.

إذا تجاوزت الحدّ الأقصى المسموح به لعمليات التنزيل، يمكنك ترقية خطة أسعار Firebase أو الانتظار إلى أن تتم إعادة ضبط الحدّ الأقصى للتنزيل في بداية دورة الفوترة التالية. لتقليل عمليات التنزيل، جرِّب الخطوات التالية:

أضف استعلامات للحد من البيانات التي تعرضها عمليات الاستماع.
تحقّق من عدم وجود طلبات بحث غير مفهرسة.
استخدام أدوات معالجة البيانات التي تعمل على تنزيل تعديلات البيانات فقط، على سبيل المثال، on() بدلاً من once()
استخدِم قواعد الأمان لحظر عمليات التنزيل غير المصرَّح بها.

إذا تجاوزت الحدّ الأقصى المسموح به لمساحة التخزين، يمكنك ترقية خطة الأسعار لتجنُّب انقطاع الخدمة. لتقليل كمية البيانات في قاعدة البيانات، جرِّب الخطوات التالية:

تنفيذ مهام تنظيف دورية.
قلل من أي بيانات مكررة في قاعدة البيانات.

يُرجى العلم أنّ ظهور أي عمليات حذف للبيانات تظهر في مساحة التخزين المخصّصة لك قد يستغرق بعض الوقت.

إذا تجاوزت الحدّ الأقصى المسموح به لعمليات ربط قاعدة البيانات المتزامنة، يمكنك ترقية خطتك لتجنُّب انقطاع الخدمة. لإدارة عمليات الربط المتزامنة بقاعدة البيانات، جرِّب الاتصال عبر المستخدمين عبر واجهة برمجة تطبيقات REST إذا لم تكن تتطلّب اتصالاً في الوقت الفعلي.

الإعداد عن بُعد

الإعداد عن بُعد: لماذا لا تؤدي القيم التي يتم استرجاعها إلى تغيير سلوك تطبيقي ومظهره؟

إذا لم يتم استرجاع القيم باستخدام fetchAndActivate()، يتم تخزين القيم محليًا ولكن لا يتم تفعيلها. لتفعيل القيم التي تم استرجاعها كي تصبح سارية، عليك طلب الرقم activate. يتيح لك هذا التصميم التحكّم في الحالات التي يطرأ فيها تغيير على سلوك التطبيق ومظهره، لأنّه يمكنك اختيار الوقت المناسب لطلب الاتصال بـ activate. بعد طلب activate، يحدِّد رمز المصدر لتطبيقك وقت استخدام قيم المَعلمات المعدّلة.

على سبيل المثال، يمكنك استرجاع القيم ثم تفعيلها في المرة التالية التي يبدأ فيها المستخدم تطبيقك، ما يغنيك عن تأخير بدء تشغيل التطبيق أثناء انتظار القيم التي تم استرجاعها من الخدمة. بعد ذلك، تحدث التغييرات في سلوك تطبيقك ومظهره عندما يستخدم التطبيق قيم المَعلمات المعدّلة.

لمزيد من المعلومات حول واجهة برمجة التطبيقات عن بُعد في "الإعداد عن بُعد" ونموذج الاستخدام، يمكنك مراجعة نظرة عامة على واجهة برمجة التطبيقات عن بُعد في "الإعداد عن بُعد".

الإعداد عن بُعد: أُرسل الكثير من طلبات الجلب أثناء تطوير تطبيقي. لماذا لا يحصل تطبيقي دائمًا على أحدث القيم من الخدمة عند إرسال طلبات الجلب؟

أثناء تطوير التطبيق، قد تحتاج إلى جلب الإعدادات وتفعيلها بشكل متكرر (عدد مرات في الساعة) للسماح لك بتكرار التحسين واختباره بسرعة أثناء تطوير تطبيقك واختباره. ولاستيعاب التكرار السريع في مشروع مع ما يصل إلى 10 مطوّري برامج، يمكنك ضبط عنصر FirebaseRemoteConfigSettings مؤقتًا بحدّ أدنى منخفض لفترة الاسترجاع (setMinimumFetchIntervalInSeconds) في تطبيقك.

الإعداد عن بُعد: ما مدى سرعة عرض خدمة "الإعداد عن بُعد" للقيم التي تم استرجاعها بعد أن يرسل تطبيقي طلب الاسترجاع؟

تتلقّى الأجهزة عادةً قيمًا تم استرجاعها في أقل من ثانية، وغالبًا ما تتلقّى قيمًا تم استرجاعها بالملي ثانية. وتتعامل خدمة "الإعداد عن بُعد" مع طلبات الجلب خلال أجزاء من الثانية، ولكن يعتمد الوقت اللازم لإكمال طلب الاسترجاع على سرعة الشبكة للجهاز ووقت استجابة الاتصال بالشبكة الذي يستخدمه الجهاز.

إذا كان هدفك هو تفعيل القيم المأخوذة في تطبيقك في أقرب وقت ممكن، وبدون ترك تجربة مزعجة للمستخدم، ننصحك بإضافة طلبات إلى fetchAndActivate في كل مرة يُجري فيها تطبيقك تحديثًا بملء الشاشة.

مركز الاختبار الافتراضي

انتقِل إلى صفحة تحديد المشاكل وحلّها في Test Lab للحصول على نصائح مفيدة وإجابات عن الأسئلة الشائعة.

مساحة تخزين تصنيف مستخدمي Firebase

ما هي "مساحة تخزين تصنيف مستخدمي Firebase"؟

تخزِّن مساحة تخزين تصنيف المستخدِمين في Firebase أرقام تعريف تثبيت Firebase والسمات والشرائح ذات الصلة، بالإضافة إلى قوائم المستخدمين التي أنشأتها لتوفير معلومات الاستهداف لخدمات Firebase الأخرى التي تستخدمها، مثل Crashlytics و"المراسلة عبر السحابة الإلكترونية من Firebase" وميزة "الإعداد عن بُعد" وغير ذلك.

الأسئلة الشائعة حول Firebase

مشاريع Firebase وتطبيقات Firebase

ما هو مشروع Firebase؟

ما هي مؤسسة Google Cloud؟

كيف يمكنني إضافة Firebase إلى مشروع حالي على Google Cloud؟

لماذا يحمل مشروعي على Google Cloud التصنيف firebase:enabled؟

لماذا لا يظهر مشروعي في Firebase في قائمة مشاريع Firebase؟

كم عدد المشاريع التي يمكنني امتلاكها في كل حساب؟

كم عدد تطبيقات Firebase التي يمكنني الحصول عليها في مشروع على Firebase؟

ماذا يحدث إذا وضعت علامة على مشروعي كبيئة "إنتاج"؟

أين يمكنني العثور على رقم تعريف التطبيق لتطبيقي في Firebase؟

ما هي المتطلّبات الأساسية لربط Google Play أو AdMob أو "إعلانات Google" أو BigQuery بمشروعي أو تطبيقي على Firebase؟

ما هي الإشعارات مفتوحة المصدر التي يجب تضمينها في تطبيقي؟

الأذونات والوصول إلى مشاريع Firebase

كيف يمكنني تعيين دور لأحد أعضاء المشروع، مثل دور المالك؟

كيف يمكنني العثور على مالك مشروع على Firebase؟

لماذا أو متى يجب عليّ تعيين دور "المالك" لأحد أعضاء المشروع؟

لا أعتقد أنّ لديّ مشروع في Firebase، ولكن تلقّيتُ رسالة إلكترونية بشأن هذا المشروع. كيف يمكنني الوصول إلى هذا المشروع؟

الأنظمة الأساسية وأطر العمل

وحدة تحكُّم Firebase

ما هي المتصفّحات المتوافقة للوصول إلى "وحدة تحكّم Firebase"؟

يمكنني تحميل "وحدة تحكُّم Firebase"، ولكن لماذا لا يمكنني العثور على مشروعي في Firebase أو الوصول إليه؟

لماذا لا يتم تحميل "وحدة تحكُّم Firebase" بالنيابة عني؟

كيف يتم تحديد لغة "وحدة تحكُّم Firebase"؟

ما هي الأدوار والأذونات التي توفّرها "وحدة تحكُّم Firebase"؟

الأسعار

ما هي المنتجات التي يتم دفع رسومها؟ وأيها يتوفّر بدون تكلفة؟

هل يقدّم Firebase أرصدة فترة تجريبية بدون تكلفة للمنتجات المدفوعة؟

كيف يمكنني معرفة خطة الأسعار المناسبة لي؟

خطة أسعار Spark

خطة أسعار Blaze

كيف يمكنني مراقبة الاستخدام والفوترة؟

ماذا حدث لخطة أسعار Flame؟

أسئلة شائعة إضافية حول إيقاف خطة Flame

كيف يختلف الاستخدام بدون تكلفة في خطة Blaze بدون تكلفة في خطة Spark؟

هل تتم إعادة ضبط حصة الاستخدام بدون تكلفة عند التغيير من خطة Spark إلى خطة Blaze؟

ما المقصود بـ "اتصال قاعدة بيانات متزامن"؟

ماذا يحدث في حال تجاوزتُ حدود مساحة التخزين أو عمليات التنزيل في خطة Spark Database؟

ماذا يحدث إذا تجاوزت حدود الاتصال المتزامن في خطة Spark لقاعدة بيانات الوقت الفعلي؟

كيف يتم دمج Firebase مع Google Cloud؟

ماذا يحدث لمشروعي في Firebase إذا أضفت حسابات فوترة أو أزلتها لذلك المشروع في Google Cloud Console؟

هل يمكنني الترقية أو الرجوع إلى إصدار سابق أو الإلغاء في أي وقت؟

ما نوع الدعم الذي سأحصل عليه؟

هل يمكنني تحديد الاستخدام وفقًا لخطة Blaze؟

ما هي النسخ الاحتياطية التلقائية؟ هل توفرون نسخًا احتياطية كل ساعة؟

هل تقدّم خصومات برامج مفتوحة المصدر أو غير ربحية أو تعليمية؟

هل تتوفر عقود خاصة للمؤسسات أو أسعار أو خدمات دعم أو استضافة مخصصة للبنية الأساسية؟

هل توفرون أسعارًا مخصصة؟ أريد استخدام نظام الدفع حسب الاستخدام لميزة واحدة أو اثنتين فقط.

كيف تعمل خطط Firebase المدفوعة مع "إعلانات Google"؟ هل هناك أرصدة إعلانية مجانية مع الخطط المدفوعة؟

أسعار Cloud Functions

لماذا أحتاج إلى حساب فوترة لاستخدام Cloud Functions for Firebase؟

هل لا تزال وظائف السحابة الإلكترونية لبرنامج Firebase متاحة بدون تكلفة؟

هل يخطط Firebase لزيادة الحصص والقيود لوظائف السحابة الإلكترونية لبرنامج Firebase؟

هل يمكنني الحصول على رصيد بقيمة 300 دولار أمريكي على Google Cloud؟

أريد اتّباع درس تطبيقي حول الترميز للتعرّف على Firebase. هل يمكنك تزويدي بحساب فوترة مؤقت؟

أشعر بالقلق من أن أتراكم فاتورة ضخمة.

كيف يمكنني التحقّق من رسوم الفوترة الحالية؟

أستخدم إضافات Firebase. هل أحتاج إلى حساب فوترة؟

أسعار Cloud Storage for Firebase

كيف أتوقّع مقدار الرسوم التي سيتم تحصيلها مني مقابل عمليات التحميل والتنزيل؟

ماذا يحدث في حال تجاوزتُ الحدود القصوى المسموح بها لتحميل بيانات خطة Spark أو تنزيلها أو مساحة التخزين في Cloud Storage for Firebase؟

الخصوصية

أين يمكنني العثور على معلومات عن الخصوصية والأمان في Firebase؟

هل تسجّل حِزم تطوير البرامج (SDK) لمنصة Firebase أي معلومات استخدام أو بيانات تشخيص خارج "إحصاءات Google"؟

من Firebase

اختبار A/B: كم عدد التجارب التي يمكنني إنشاؤها وتنفيذها؟

اختبار A/B: لماذا لا يمكنني عرض تجاربي بعد إلغاء ربط مشروعي وإعادة ربطه بخدمة "إحصاءات Google"؟

اختبار A/B: لماذا تظهر لي رسالة "المشروع غير مرتبط بخدمة إحصاءات Google" عند إنشاء تجربة "الإعداد عن بُعد"؟

AdMob

AdMob: هل يمكنني ربط تطبيقاتي على Windows بمنصّة Firebase؟

AdMob: لماذا لا يمكنني ربط تطبيقي بخدمة AdMob من "وحدة تحكُّم Firebase"؟

AdMob: ما هي الأذونات أو أذونات الوصول اللازمة لربط تطبيق Firebase بتطبيق AdMob؟

AdMob: هل يمكن لعدة مستخدمين في حساب AdMob نفسه ربط تطبيقات AdMob وتطبيقات Firebase؟

AdMob: ما هي حِزم تطوير البرامج (SDK) التي يجب أن أستخدمها حتى تتمكّن من استخدام AdMob؟

إحصاءات Google

الإحصاءات: لماذا تعتبر "إحصاءات Google" جزءًا مقترَحًا من استخدام منتجات Firebase؟

إحصاءات: كيف يمكنني التحكّم في طريقة مشاركة بياناتي في "إحصاءات Google" مع باقي Firebase؟

إحصاءات: كيف يمكنني تعديل إعدادات موقع "إحصاءات Google"؟

"إحصاءات Google" في تطبيق iOS: هل يمكنني تثبيت "إحصاءات Google" بدون ميزات إحالة الإعلانات وجمع معرّف المعلِنين (IDFA)؟

الإحصاءات: ما التغيير الذي حدث في قسم "إحصاءات Google" بعد التحديث الذي تم إجراؤه في تشرين الأول (أكتوبر) 2021؟

لماذا يحمل مشروعي على Google Cloud التصنيف `firebase:enabled`؟

مصادقة Firebase: لماذا يظهر لي الخطأ التالي في تطبيق Android:
`Google sign in failed`؟

مصادقة Firebase: في تطبيق نظام التشغيل Apple، لماذا يظهر لي الخطأ التالي:
`You must specify <clientID> in <GIDConfiguration>`؟

مصادقة Firebase: لماذا يظهر لي الخطأ التالي في تطبيق الويب:
`AuthErrorCode.INVALID_OAUTH_CLIENT_ID`؟

مصادقة Firebase: في تطبيق الويب، لماذا يتعذّر تسجيل الدخول باستخدام عمليات إعادة التوجيه مع ظهور الخطأ التالي:
`This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation`؟

خدمة "المراسلة عبر السحابة الإلكترونية": لقد نفّذت `onMessageReceived` في تطبيق Android الخاص بي، ولكن لا يتم استدعاؤه.