يمكنك تشغيل الدوال استجابةً لإنشاء وحذف حسابات المستخدمين على Firebase. على سبيل المثال، يمكنك إرسال رسالة ترحيب إلكترونية إلى المستخدم الذي أنشأ حسابًا في تطبيقك. الأمثلة في هذه الصفحة هي: استنادًا إلى عينة تنفِّذ ذلك بالضبط - يتم إرسال رسائل إلكترونية ترحيبية وداعية عند إنشاء الحساب وحذفه.
للحصول على مزيد من الأمثلة على حالات الاستخدام، يمكنك الاطّلاع على ما الذي يمكنني فعله باستخدام دوال Cloud؟
تشغيل دالة عند إنشاء المستخدم
يمكنك إنشاء دالة يتم تشغيلها عندما يكون مستخدم Firebase
تم إنشاؤه باستخدام
functions.auth.user().onCreate()
معالج الحدث:
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
// ...
});
ستشغّل حسابات Firebase أحداث إنشاء المستخدمين من أجل وظائف السحابة الإلكترونية في الحالات التالية:
- ينشئ المستخدم حساب بريد إلكتروني وكلمة مرور.
- يسجِّل المستخدم الدخول لأول مرة باستخدام موفِّر هوية موحّد.
- يُنشئ مطوّر البرامج حسابًا باستخدام حزمة تطوير البرامج (SDK) لمشرف Firebase.
- يسجِّل المستخدم الدخول إلى جلسة مصادقة جديدة مجهولة المصدر لأول مرة.
لا يتم تشغيل حدث Cloud Functions عندما يسجِّل المستخدم الدخول إلى باستخدام رمز مميّز مخصّص للمرة الأولى.
الوصول إلى سمات المستخدمين
من بيانات المستخدم التي يتم إرجاعها إلى الدالة، يمكنك
الوصول إلى قائمة سمات المستخدمين المتوفرة في ملف CSV
UserRecord
الخاص بك. على سبيل المثال، يمكنك الحصول على عنوان البريد الإلكتروني للمستخدم والاسم المعروض كما هو موضّح:
const email = user.email; // The email of the user. const displayName = user.displayName; // The display name of the user.
تشغيل دالة عند حذف المستخدم
مثلما يمكنك تشغيل دالة عند إنشاء المستخدم، يمكنك
الاستجابة لأحداث حذف المستخدم يمكنك استخدام
functions.auth.user().onDelete()
معالج الحدث كما هو موضح:
exports.sendByeEmail = functions.auth.user().onDelete((user) => {
// ...
});
تشغيل دوال الحظر
إذا تمت الترقية إلى مصادقة Firebase باستخدام النظام الأساسي للهوية، يمكنك توسيع نطاق مصادقة Firebase باستخدام حظر وظائف السحابة الإلكترونية
تتيح لك دوال الحظر تنفيذ رموز مخصَّصة تعمل على تعديل نتيجة تسجيل المستخدم في تطبيقك أو تسجيل الدخول إليه على سبيل المثال، يمكنك منع مستخدم من المصادقة إذا كانت لا تستوفي معايير معينة، أو يمكنها تحديث صفحة المعلومات قبل إعادتها إلى تطبيق العميل.