يمكنك تشغيل الدوال استجابةً لإنشاء وحذف حسابا مستخدمَين (Firebase) على سبيل المثال، يمكنك إرسال رسالة ترحيب إلكترونية إلى المستخدم الذي أنشأ حسابًا في تطبيقك. الأمثلة في هذه الصفحة هي: استنادًا إلى عينة تنفِّذ ذلك بالضبط - يتم إرسال رسائل إلكترونية ترحيبية وودية عند إنشاء الحساب وحذفه.
للحصول على مزيد من الأمثلة على حالات الاستخدام، يمكنك الاطّلاع على كيف يمكنني الاستفادة من "Cloud Functions"؟.
تشغيل دالة عند إنشاء المستخدم
يمكنك إنشاء دالة يتم تشغيلها عندما يكون مستخدم Firebase
تم إنشاؤه باستخدام
functions.auth.user().onCreate()
معالج الحدث:
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => {
// ...
});
سيؤدي حسابان (Firebase) إلى تفعيل أحداث إنشاء المستخدمين لما يلي: Cloud Functions عند:
- ينشئ المستخدم حساب بريد إلكتروني وكلمة مرور.
- يسجِّل المستخدم الدخول لأول مرة باستخدام موفِّر هوية موحّد.
- يُنشئ مطوّر البرامج حسابًا باستخدام حزمة تطوير البرامج (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 Authentication with Identity Platform، يمكنك تمديد فترة Firebase Authentication باستخدام حظر Cloud Functions
تتيح لك دوال الحظر تنفيذ رموز مخصَّصة تعمل على تعديل نتيجة تسجيل المستخدم في تطبيقك أو تسجيل الدخول إليه على سبيل المثال، يمكنك منع مستخدم من المصادقة إذا كانت لا تستوفي معايير معينة، أو يمكنها تحديث صفحة المعلومات قبل إعادتها إلى تطبيق العميل.