ما الذي يمكنك فعله باستخدام دوال Cloud؟
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تمنح Cloud Functions المطوّرين إمكانية الوصول إلى Firebase وأحداث Google Cloud، بالإضافة إلى قدرة حوسبة قابلة للتوسيع لتشغيل الرمز استجابةً لهذه الأحداث. مع أنّه من المتوقّع أن تستخدم تطبيقات Firebase "وظائف السحابة الإلكترونية" بطرق فريدة لتلبية متطلباتها الفريدة، قد تندرج حالات الاستخدام النموذجية ضمن المجالات التالية:
راجِع حالات الاستخدام والأمثلة لكل فئة تهمّك، ثم انتقِل إلى البرنامج التعليمي البدء أو إلى أدلة إرشادية محدّدة حول أحداث المصادقة وأحداث الإحصاءات وغير ذلك.
إرسال إشعارات إلى المستخدمين عند حدوث أمر مهم
يمكن للمطوّرين استخدام Cloud Functions لإبقاء المستخدمين متفاعلين ومطّلعين على آخر المعلومات ذات الصلة بالتطبيق. على سبيل المثال، لنفترض أنّ هناك تطبيقًا يتيح للمستخدمين متابعة أنشطة بعضهم البعض في التطبيق. في كل مرة يضيف فيها مستخدم نفسه كمتابع لمستخدم آخر، تتم عملية كتابة في Realtime Database. بعد ذلك، يمكن أن يؤدي حدث الكتابة هذا إلى تشغيل دالة لإنشاء إشعارات Firebase Cloud Messaging (المراسلة عبر السحابة الإلكترونية من Firebase) لإعلام المستخدمين المعنيين بأنّهم اكتسبوا متابعين جددًا.
- يتم تشغيل الدالة عند الكتابة إلى المسار Realtime Database حيث يتم تخزين المتابعين.
- تنشئ الدالة رسالة لإرسالها عبر FCM.
- يرسل FCM رسالة الإشعار إلى جهاز المستخدم.
لمراجعة الرمز البرمجي، اطّلِع على الرمز النموذجي في GitHub:
حالات استخدام أخرى مثيرة للاهتمام للإشعارات
- إرسال رسائل تأكيد إلكترونية إلى المستخدمين الذين يشتركون في نشرة إخبارية
- إرسال رسالة ترحيب إلكترونية عندما يُكمل المستخدم عملية الاشتراك
- إرسال رسالة تأكيد عبر SMS عندما ينشئ مستخدم حسابًا جديدًا
تنفيذ عمليات تعقيم وصيانة لقاعدة البيانات
باستخدام ميزة معالجة أحداث قاعدة البيانات Cloud Functions، يمكنك تعديل Realtime Database أو Cloud Firestore استجابةً لسلوك المستخدم، ما يحافظ على النظام في الحالة التي تريدها. على سبيل المثال، يمكنك مراقبة أحداث الكتابة وتغيير تنسيق سلاسل معيّنة في رسائل المستخدمين (مثل التغيير إلى جميع الأحرف الكبيرة).
في ما يلي مثال على كيفية عمل ذلك:
- يستمع معالج أحداث قاعدة البيانات الخاص بالدالة إلى أحداث الكتابة على مسار معيّن، ويسترد بيانات الأحداث التي تحتوي على نص الرسائل.
- تعالج الدالة النص لتغيير السلاسل إلى أحرف كبيرة.
- تكتب الدالة النص المعدَّل مرة أخرى في قاعدة البيانات.
لمراجعة الرمز البرمجي، اطّلِع على الرمز النموذجي في GitHub:
حالات الاستخدام الأخرى لتعقيم قواعد البيانات وصيانتها
- إزالة محتوى مستخدم محذوف نهائيًا من Realtime Database
- الحدّ من عدد العُقد الفرعية في قاعدة بيانات Firebase
- تتبُّع عدد العناصر في قائمة Realtime Database
- نسخ البيانات من Realtime Database إلى Google Cloud BigQuery
- تحويل النص إلى إيموجي
- إدارة البيانات الوصفية المحسوبة لسجلات قاعدة البيانات
تنفيذ المهام المكثّفة في السحابة الإلكترونية بدلاً من تنفيذها في تطبيقك
يمكنك الاستفادة من Cloud Functions لتفويض المهام التي تتطلّب موارد كثيرة (وحدة معالجة مركزية أو شبكات) إلى سحابة Google بدلاً من تنفيذها على جهاز المستخدم، ما يؤدي إلى تحسين سرعة استجابة تطبيقك. على سبيل المثال، يمكنك كتابة دالة للاستماع إلى عمليات تحميل الصور إلى Cloud Storage، وتنزيل الصورة إلى المثيل الذي ينفّذ الدالة، وتعديلها، ثم إعادة تحميلها إلى Cloud Storage. قد تتضمّن التعديلات تغيير الحجم أو الاقتصاص أو تحويل الصور باستخدام أدوات مثل sharp أو Pillow.
- يتم تشغيل دالة عند تحميل ملف صورة إلى Cloud Storage.
- تنزّل الدالة الصورة وتنشئ نسخة مصغّرة منها.
- تكتب الدالة موقع الصورة المصغّرة في قاعدة البيانات، حتى يتمكّن تطبيق العميل من العثور عليها واستخدامها.
- تحمّل الدالة الصورة المصغّرة مرة أخرى إلى Cloud Storage في موقع جديد.
- ينزّل التطبيق رابط الصورة المصغّرة.
للحصول على شرح تفصيلي لمثال على معالجة الصور، راجِع دليل
التعامل مع أحداث Cloud Storage.
أمثلة أخرى على مهام المعالجة المجمّعة في سحابة Firebase
- حذف حسابات Firebase غير المستخدَمة بشكل دوري Node.js | Python
- الاحتفاظ بنسخة احتياطية تلقائيًا من الصور التي تم تحميلها Node.js | Python
- إرسال رسائل إلكترونية مجمّعة إلى المستخدمين
- تجميع البيانات وتلخيصها بشكل دوري
- معالجة قائمة انتظار للعمل المعلّق
الدمج مع الخدمات وواجهات برمجة التطبيقات التابعة لجهات خارجية
يمكن أن تساعد Cloud Functions تطبيقك في العمل بشكل أفضل مع الخدمات الأخرى من خلال استدعاء واجهات برمجة التطبيقات على الويب وإتاحتها. على سبيل المثال، يمكن لتطبيق يُستخدم للتعاون في عملية التطوير نشر عمليات إرسال GitHub إلى غرفة دردشة خاصة بفريق عمل.
- يرسل المستخدم عمليات الدمج إلى مستودع GitHub.
- يتم تشغيل دالة HTTPS من خلال GitHub webhook API.
- ترسل الدالة إشعارًا بشأن عملية الدمج إلى قناة فريق Slack.
طرق أخرى للدمج مع الخدمات وواجهات برمجة التطبيقات الخارجية
- استخدام Cloud Vision API من Google لتحليل الصور التي يتم تحميلها ووضع علامات عليها
- ترجمة الرسائل باستخدام "ترجمة Google"
- استخدِم المصادقة المخصّصة لتسجيل دخول المستخدمين.
- إرسال طلب إلى خدمة ربط تطبيقات على عمليات الكتابة في Realtime Database
- فعِّل البحث عن النص الكامل في عناصر Realtime Database.
- معالجة الدفعات من المستخدمين
- إنشاء ردود تلقائية على المكالمات الهاتفية والرسائل القصيرة
- إنشاء روبوت محادثة باستخدام "مساعد Google"
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\nCloud Functions gives developers access to Firebase and Google Cloud\nevents, along with\nscalable computing power to run code in response to those events. While it's\nexpected that Firebase apps will use Cloud Functions in unique ways to meet\ntheir unique requirements, typical use cases might fall into these areas:\n\n- [Notify users when something interesting happens](#notify_users_when_something_interesting_happens).\n- [Perform database sanitization and maintenance](#perform_database_sanitization_and_maintenance).\n- [Execute intensive tasks in the cloud instead of in your app](#execute_intensive_tasks_in_the_cloud_instead_of_in_your_app).\n- [Integrate with third-party services and APIs](#integrate_with_third-party_services_and_apis).\n\nReview the use cases and examples for each category that interests\nyou, and then proceed to our [Get Started](/docs/functions/get-started) tutorial\nor to specific how-to guides\nfor [authentication events](/docs/functions/auth-events),\n[analytics events](/docs/functions/analytics-events), and more.\n\nNotify users when something interesting happens\n\nDevelopers can use Cloud Functions to keep users engaged and up to date\nwith relevant information about an app. Consider, for example, an app that\nallows users to follow one another's activities in the app. Each time a user\nadds themselves as a follower of another user, a write occurs in the\nRealtime Database. Then this write event could trigger a function\nto create Firebase Cloud Messaging (FCM) notifications to let the appropriate\nusers know that they have gained new followers.\n\n1. The function triggers on writes to the Realtime Database path where followers are stored.\n2. The function composes a message to send via .\n3. sends the notification message to the user's device.\n\nTo review working code, see the sample code in GitHub:\n\n- Node.js: [fcm-notifications](https://github.com/firebase/functions-samples/tree/main/Node/fcm-notifications)\n- Python: [fcm-notifications](https://github.com/firebase/functions-samples/tree/main/Python/fcm-notifications)\n\nOther interesting notification use cases\n\n- Send confirmation emails to users subscribing to a newsletter.\n- Send a welcome email when a user completes signup.\n- Send an SMS confirmation when a user creates a new account.\n\nPerform database sanitization and maintenance\n\nWith Cloud Functions database event handling, you can modify Realtime Database or\nCloud Firestore in response to user behavior, keeping the system in your desired\nstate. For example, you could monitor write events and change the format\n(for example, change to all uppercase) of certain strings in users' messages.\nHere's how that could work:\n\n1. The function's database event handler listens for write events on a specific path, and retrieves event data containing the text of a messages.\n2. The function processes the text to change strings to uppercase.\n3. The function writes the updated text back to the database.\n\nTo review working code, see the sample code in GitHub:\n\n- Node.js: [uppercase-rtdb](https://github.com/firebase/functions-samples/tree/main/Node/quickstarts/uppercase-rtdb)\n- Python: [uppercase-rtdb](https://github.com/firebase/functions-samples/tree/main/Python/quickstarts/uppercase-rtdb)\n\nOther database sanitization and maintenance use cases\n\n- Purge a deleted user's content from Realtime Database.\n- Limit the number of child nodes in a Firebase database.\n- Track the number of elements in a Realtime Database list.\n- Copy data from Realtime Database to Google Cloud BigQuery.\n- Convert text to emoji.\n- Manage computed metadata for database records.\n\nExecute intensive tasks in the cloud instead of in your app\n\nYou can take advantage of Cloud Functions to offload to the Google\ncloud resource-intensive work (heavy CPU or networking) instead of running it\non a user's device, improving the responsiveness of your app.\nFor instance, you could write a function\nto listen for image uploads to Cloud Storage, download the image to the instance\nrunning the function, modify it, and upload it back to Cloud Storage. Your\nmodifications could include resizing, cropping, or converting images with tools\nlike [sharp](https://www.npmjs.com/package/sharp) or\n[Pillow](https://pillow.readthedocs.io/en/stable/).\n\n1. A function triggers when an image file is uploaded to Cloud Storage.\n2. The function downloads the image and creates a thumbnail version of it.\n3. The function writes that thumbnail location to the database, so a client app can find and use it.\n4. The function uploads the thumbnail back to Cloud Storage in a new location.\n5. The app downloads the thumbnail link.\n\nFor a walkthrough of an image processing example, see the guide to\n[handling Cloud Storage events](https://firebase.google.com/docs/functions/gcp-storage-events?gen=2nd).\n\nOther examples of batch jobs in the Firebase cloud\n\n- Periodically delete unused Firebase accounts [Node.js](https://github.com/firebase/functions-samples/tree/main/Node/delete-unused-accounts-cron) \\| [Python](https://github.com/firebase/functions-samples/tree/main/Python/delete-unused-accounts-cron).\n- Automatically back up uploaded images [Node.js](https://github.com/firebase/functions-samples/tree/main/Node/taskqueues-backup-images) \\| [Python](https://github.com/firebase/functions-samples/tree/main/Python/taskqueues-backup-images).\n- Send bulk email to users.\n- Aggregate and summarize data periodically.\n- Process a queue of pending work.\n\nIntegrate with third-party services and APIs\n\nCloud Functions can help your app work better with other services by\ncalling and exposing web APIs. For instance, an app used for collaboration on\ndevelopment could post GitHub commits to a workgroup chat room.\n\n1. A user pushes commits to a GitHub repo.\n2. An HTTPS function triggers via the [GitHub webhook API](https://developer.github.com/webhooks/).\n3. The function sends a notification of the commit to a team Slack channel.\n\nOther ways to integrate with third-party services and APIs\n\n- Use Google [Cloud Vision API](https://cloud.google.com/vision/) to analyze and tag uploaded images.\n- Translate messages using Google Translate.\n- Use [custom auth](https://firebase.google.com/docs/auth/where-to-start#custom-auth) to sign in users.\n- Send a request to a webhook on Realtime Database writes.\n- Enable full-text search on Realtime Database elements.\n- Process payments from users.\n- Create auto-responses to phone calls and SMS messages.\n- Create a chatbot using Google Assistant."]]
