شما می‌توانید توابعی را در پاسخ به ایجاد و حذف حساب‌های کاربری Firebase فعال کنید. برای مثال، می‌توانید یک ایمیل خوشامدگویی برای کاربری که به تازگی در برنامه شما حساب کاربری ایجاد کرده است، ارسال کنید. مثال‌های این صفحه بر اساس نمونه‌ای است که دقیقاً همین کار را انجام می‌دهد - ارسال ایمیل‌های خوشامدگویی و خداحافظی پس از ایجاد و حذف حساب کاربری.
برای مثال‌های بیشتر از موارد استفاده، به «چه کارهایی می‌توانم با Cloud Functions انجام دهم؟» مراجعه کنید.
فعال کردن یک تابع هنگام ایجاد کاربر
شما می‌توانید با استفاده از رویداد functions.auth.user().onCreate() تابعی ایجاد کنید که هنگام ایجاد کاربر Firebase فعال شود:
exports.sendWelcomeEmail = functions.auth.user().onCreate((user) => { // ... });
حساب‌های Firebase رویدادهای ایجاد کاربر را برای Cloud Functions فعال می‌کنند، زمانی که:
- کاربر یک حساب ایمیل و رمز عبور ایجاد می‌کند.
- کاربری برای اولین بار با استفاده از یک ارائه‌دهنده هویت فدرال وارد سیستم می‌شود.
- توسعه‌دهنده با استفاده از Admin SDK یک حساب کاربری ایجاد می‌کند.
- کاربری برای اولین بار وارد یک جلسه احراز هویت ناشناس جدید می‌شود.
رویداد Cloud Functions زمانی که کاربر برای اولین بار با استفاده از یک توکن سفارشی وارد سیستم می‌شود، فعال نمی‌شود .
دسترسی به ویژگی‌های کاربر
از داده‌های کاربر که به تابع شما برگردانده می‌شود، می‌توانید به لیست ویژگی‌های کاربر موجود در شیء 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 با استفاده از blocking Cloud Functions گسترش دهید.
توابع مسدودکننده به شما امکان می‌دهند کد سفارشی را اجرا کنید که نتیجه ثبت نام یا ورود کاربر به برنامه شما را تغییر می‌دهد. به عنوان مثال، می‌توانید در صورت عدم رعایت معیارهای خاص، از احراز هویت کاربر جلوگیری کنید، یا اطلاعات کاربر را قبل از بازگرداندن آن به برنامه کلاینت خود به‌روزرسانی کنید.