إضافة مطلوبة
ثبّت إضافة GenderAPI في Google Sheets
تعتمد الدالة المخصصة على الإضافة. ثبّتها من Google Workspace Marketplace وامنحها الصلاحية في جدول البيانات، ثم احفظ مفتاح GenderAPI في إعدادات الدالة.
التثبيت من Google Marketplaceالإعداد
ابدأ استخدام الدالة في أربع خطوات
- 01
افتح لوحة GenderAPI
من قائمة الإضافات في Google Sheets، اختر GenderAPI ثم Determine Gender لفتح اللوحة الجانبية.
- 02
افتح دليل الدالة
افتح دليل دالة GENDER وإعدادات مفتاح API من قائمة اللوحة الجانبية.
- 03
احفظ مفتاح API
اختر مفتاح GenderAPI أو الصقه واحفظه لاستخدامه في جدول البيانات الحالي.
- 04
أدخل الدالة في خلية
استخدم =GENDER(A2) للاسم، وأضف المعاملات الاختيارية للبريد أو اسم المستخدم أو البلد والنتيجة الموسعة.
مرجع الدالة
اختر طريقة الإدخال وتفاصيل النتيجة
=GENDER(A2)تحلّل الاسم في A2 بالإعدادات الافتراضية.
=GENDER(A5, "email", "", true)تحلّل البريد وتعيد الجنس ونسبة الاحتمال والبلد والاسم المستخرج.
| المعامل | وظيفته |
|---|---|
input | اسم أو بريد إلكتروني أو اسم مستخدم |
method | name افتراضياً، أو email أو username |
country_filter | رمز بلد اختياري من حرفين مثل IN أو DE أو US |
additional_info | عند ضبطه على true يعيد نسبة الاحتمال والبلد والاسم المستخرج |
مثال المخرجات
املأ أعمدة النتائج الإضافية تلقائياً
عند تفعيل المعلومات الإضافية، تضع الدالة حقول النتيجة الموسعة في الأعمدة المجاورة.
اختر وفق احتياجك
استخدم الدالة للتحليل المرن والخفيف
الأسئلة الشائعة
أسئلة عن دالة GENDER في Google Sheets
لماذا تظهر ملاحظة JSON في خلية النتيجة؟
تخزّن الملاحظة الدالة والنتيجة مؤقتاً، وقد تمنع استهلاك رصيد API جديد للقيمة نفسها عند إعادة الحساب التلقائي في Google Sheets.
هل تحتاج دالة GENDER إلى إضافة GenderAPI؟
نعم. يجب تثبيت إضافة GenderAPI في Google Sheets ومنحها الصلاحية لتشغيل دالة GENDER المخصصة.
هل يمكن تحليل بريد إلكتروني أو اسم مستخدم؟
نعم. اضبط معامل method على email أو username وفق نوع القيمة المدخلة.
ماذا يحدث إذا أزلت الإضافة؟
قد تتوقف النتائج الديناميكية عن العمل. للحصول على نتائج دائمة، انسخ الخلايا كقيم أو استخدم المعالجة المجمعة عبر الإضافة.
ما الحدود التي تنطبق على استخدام الدالة؟
تنطبق حدود خطة GenderAPI وحصص Google Apps Script معاً. قد تتغير حدود Google، لذلك راجع توثيقها الرسمي الحالي.
هل نتائج الدالة ثابتة؟
لا، المخرجات ديناميكية. للصيانة طويلة المدى، الصق النتيجة كقيمة أو استخدم سير العمل المجمع الذي يكتب النتائج في أعمدة محددة.
من أين أحصل على مفتاح API؟
أنشئ حساب GenderAPI أو سجّل الدخول وانسخ المفتاح من لوحة التحكم. يحصل الحساب الجديد على 200 رصيد API يومياً.