# صيغ GenderAPI لـ Microsoft Excel

> استخدم GENDER.FROM_NAME وGENDER.FROM_EMAIL وGENDER.FROM_USERNAME في Excel. راجع الوسيطات والقيم الافتراضية والمخرجات الموسّعة والأخطاء الشائعة.

Canonical HTML: https://www.genderapi.io/ar/blog/gender-formula-for-microsoft-excel

Last reviewed: 2026-09-29

## اختر الدالة المناسبة لبيانات الإدخال لديك

ثبّت إضافة GenderAPI لـ Excel، واحفظ مفتاح API في شريطها الجانبي، ثم استخدم GENDER.FROM_NAME للأسماء، أو GENDER.FROM_EMAIL لعناوين البريد الإلكتروني، أو GENDER.FROM_USERNAME لأسماء المستخدمين. تقبل كل دالة الإدخال أولًا، ثم علامة اختيارية للمعلومات الإضافية، وأخيرًا سياق دولة اختياريًا.

تعتمد صيغ Excel الأصلية هذه على الـ API القديم. أما صيغة GENDER في Google Sheets فلها توقيع مختلف، ولواجهة REST V2 المباشرة عقد JSON خاص بها.

- [تثبيت إضافة Excel](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [إعداد الشريط الجانبي في Excel](https://www.genderapi.io/ar/blog/genderize-excel-names-using-genderapi-excel-add-in)

## ثلاث وسيطات بترتيب ثابت

| الوسيطة | النوع | القيمة الافتراضية | الوصف |
| --- | --- | --- | --- |
| `name / email / username` | نص أو مرجع خلية | إلزامية | الإدخال للدالة المختارة، مثل A2. |
| `enable_additional_info` | قيمة منطقية | FALSE | تعيد TRUE أو 1 أربعة أعمدة. احذف الوسيطة أو استخدم FALSE/0 للحصول على الجنس فقط. |
| `country` | نص | دون مرشّح دولة | رمز دولة اختياري من حرفين، مثل IT أو US أو DE أو TR. إذا حدّدت هذه الوسيطة الثالثة فحدّد الثانية أيضًا. |

**مثال على صيغة Excel**

كل سطر مثال مستقل. ضع في A2 الاسم أو عنوان البريد الإلكتروني أو اسم المستخدم المناسب. وقد تستخدم الإعدادات الإقليمية في Excel الفاصلة المنقوطة بدل الفاصلة للفصل بين الوسيطات.

```text
=GENDER.FROM_NAME(A2)
=GENDER.FROM_NAME(A2, TRUE, "IT")
=GENDER.FROM_EMAIL(A2, TRUE)
=GENDER.FROM_USERNAME(A2, FALSE)
```

## تستخدم المخرجات الموسّعة في Excel أربعة أعمدة

دون المعلومات الإضافية تعيد الصيغة الجنس فقط. وعند تفعيلها تشغل المخرجات الموثَّقة في Excel صفًا واحدًا يضم الجنس وprobability والدولة والاسم المطابق بهذا الترتيب. اترك الخلايا الثلاث على اليمين فارغة.

تضع صيغة Google Sheets الدولة قبل probability؛ لذا لا تُعِد استخدام عناوين أعمدتها دون التحقق من الترتيب المعمول به في Excel.

| الموضع | مخرجات Excel | المعنى |
| --- | --- | --- |
| 1 | Gender | الجنس المحدَّد أو قيمة غير محسومة. تعامل مع أخطاء التشغيل بشكل منفصل. |
| 2 | Probability | إشارة ثقة من الـ API القديم؛ ليست confidence_kind في V2 ولا دقة مقيسة للنموذج. |
| 3 | Country | سياق الدولة الذي يعيده البحث، وليس سمة موثَّقة للشخص. |
| 4 | Matched name | تحقق من الاسم المستخدم أو المستخرَج، خاصةً لعناوين البريد الإلكتروني وأسماء المستخدمين. |

## أصلح أخطاء الإعداد قبل نسخ الصيغة إلى الأسفل

قد تؤدي إعادة الحساب إلى بحث جديد. إذا كنت تحتاج إلى لقطة ثابتة، فالصق النتائج المكتملة كقيم، واحتفظ بجانبها بالبيانات الأصلية وتاريخ المراجعة.

| العَرَض | ما الذي تتحقق منه |
| --- | --- |
| الدالة غير متاحة | تأكد من أن الإضافة مثبّتة ومتاحة في هذا المصنف وفي بيئة Excel هذه. |
| مفتاح API غير مضبوط | افتح الشريط الجانبي لـ GenderAPI واحفظ المفتاح. المفتاح المكتوب في خلية لا يحل محل بيانات الاعتماد المحفوظة في الإضافة. |
| الإدخال فارغ | تحقق من الخلية التي تشير إليها الصيغة، واختر الدالة المطابقة للنوع الفعلي للإدخال. |
| المخرجات الموسّعة لا تظهر | أفرغ خلايا الوجهة المجاورة اللازمة دون الكتابة فوق بيانات مفيدة. |
| رسالة خطأ أو unknown error | تحقق من الاتصال وحالة الحساب والرسالة المُعادة. خطأ التشغيل ليس تقديرًا غير محسوم. |

## خطّط للأرصدة والحدود وإعادة التشغيل

يتضمن حساب GenderAPI المجاني المسجَّل 200 رصيد يوميًا. وهذا رصيد في الحساب، وليس وعدًا بالحصول على 200 نتيجة identified في كل سير عمل. قبل البدء تحقّق من رصيد المفتاح المختار ومن خيارات المعالجة الحالية في الأداة.

تتبع الإضافات ومعالجة الملفات مسارات معالجة خاصة بها. فحدّ الطلب المجمّع في واجهة REST API في V2 وخيارات الذكاء الاصطناعي وحقول الخصم في الطلبات الفردية لا تنطبق تلقائيًا على هذه الأدوات. وقد ترسل إعادة التشغيل أو إعادة الحساب طلبات جديدة وتستهلك أرصدة، فلا تفترض أنها مجانية.

ابدأ بعيّنة صغيرة، واحفظ النتائج التي حصلت عليها، وراجع الصفوف الفاشلة قبل إعادة التشغيل. وإذا كنت تحتاج فقط إلى إصلاح تصدير أو تحديث في الوجهة، فأعد استخدام النتائج الموجودة لديك.

- [خطط الحساب والأرصدة](https://www.genderapi.io/ar/price)

## متى تستخدم V2 API مباشرة

أعدّ تكامل HTTP منفصلًا إذا كان تطبيقك يحتاج إلى خيارات صريحة للذكاء الاصطناعي وإلى معلومات status وsource وconfidence_kind وusage في V2 لكل عنصر. واتبع عقد الطلب والاستجابة في V2، إذ إن إضافة أسماء حقول V2 إلى صيغة خاصة أو إلى إضافة قائمة لا يغيّر سلوكها.

- [معاملات الطلب](https://www.genderapi.io/ar/docs/v2/request-parameters)
- [حقول الاستجابة في V2](https://www.genderapi.io/ar/docs/v2/responses)
- [تكامل V2 مع Python](https://www.genderapi.io/ar/integrations/python)
- [تكامل V2 مع Node.js](https://www.genderapi.io/ar/integrations/javascript)

## هل يمكنني استخدام =GENDER(A2) في Microsoft Excel؟

الدوال الموثَّقة في إضافة Excel هي GENDER.FROM_NAME وGENDER.FROM_EMAIL وGENDER.FROM_USERNAME. أما صيغة GENDER البسيطة فتخص إضافة Google Sheets.

## كيف أحدد دولة دون مخرجات إضافية؟

اترك الوسيطة الثانية معطّلة، مثل =GENDER.FROM_NAME(A2, FALSE, "IT"). الدولة هي الوسيطة الثالثة وليست الثانية.

## ما القيمة الافتراضية لإعداد المعلومات الإضافية؟

إذا حُذفت الوسيطة فالإعداد معطّل. تفعّل TRUE أو 1 مخرجات من أربعة أعمدة: الجنس وprobability والدولة والاسم المطابق.

## هل تعيد الدوال معلومات الخصم الخاصة بـ V2؟

لا. تعرض الصيغ الأصلية حقول النتائج في الـ API القديم. استخدم تكاملًا منفصلًا مع V2 عندما تحتاج إلى بيانات وصفية للطلب أو source أو confidence_kind أو الاستهلاك لكل طلب.

## المصادر والوثائق

- [الصفحة الرسمية للإضافة على Microsoft AppSource](https://appsource.microsoft.com/en-us/product/office/WA200008555)
- [وثائق صيغة Excel: gender_from_name](https://excel.genderapi.io/help/gender_from_name.html)
- [وثائق صيغة Excel: gender_from_email](https://excel.genderapi.io/help/gender_from_email.html)
- [وثائق صيغة Excel: gender_from_username](https://excel.genderapi.io/help/gender_from_username.html)
- [تعريفات دوال Excel المنشورة](https://excel.genderapi.io/functions_v2.json)
- [خطط GenderAPI والأرصدة](https://www.genderapi.io/ar/price)
- [سياسة خصوصية GenderAPI](https://www.genderapi.io/ar/privacy-policy)
- [عقد طلبات V2](https://www.genderapi.io/ar/docs/v2/request-parameters)