اربط الحقول باستخدام إضافة Airtable
تقرأ إضافة GenderAPI اسمًا أو عنوان بريد إلكتروني من حقل تختاره، وتكتب تقدير الجنس في حقل وجهة منفصل. يمكنك أيضًا ربط البلد وprobability والاسم الذي عُثر عليه، وتخطي السجلات التي يحتوي حقل وجهة الجنس فيها على قيمة مسبقًا.
تستخدم شيفرة الإضافة، التي رُوجعت في 27 سبتمبر 2026، نقاط النهاية في V1 للأسماء وعناوين البريد الإلكتروني وحقول الاستجابة ذات المستوى الأعلى المرتبطة بها. يصف هذا الدليل سير العمل الأصلي هذا. قد تتغير الإضافة المثبّتة بمعزل عن هذا الدليل، لذا تحقّق من الإعدادات المتاحة قبل تطبيق عمليات الربط التالية.
اربط القاعدة وجهّز الحقول
- افتح القاعدة الصحيحة، وأضف GenderAPI.io من Extensions، ثم شغّل الإضافة. أكمل خطوات الاتصال التي تعرضها الإضافة.
- اختر المفتاح الذي ستُخصم منه الأرصدة. تحقّق من الرصيد المتبقي ومن أنه يخص حساب GenderAPI الصحيح.
- اختر الجدول وحقل المصدر الذي يحتوي على الأسماء أو عناوين البريد الإلكتروني. أبقِ المُدخل الأصلي في ذلك الحقل وأنشئ حقولًا منفصلة للنتائج.
- حدّد حقل وجهة الجنس الإلزامي وأي حقول وجهة إضافية. استخدم حقلًا من نوع percent لقيمة مئوية منسّقة، أو حقلًا رقميًا للحفاظ على المقياس الأصلي لقيمة probability.
- قرّر ما إذا كنت ستحتفظ بحقول وجهة الجنس المعبّأة مسبقًا. يحتفظ خيار التخطي أيضًا بالقيم النصية غير المحسومة من تشغيل سابق، لذا امسح فقط النتائج التي تريد معالجتها من جديد عن قصد.
اربط مُدخلات الإضافة ومُخرجاتها
يمكن أن يحتوي حقل المصدر على أسماء وعناوين بريد إلكتروني معًا. في التنفيذ الذي رُوجع، تسلك القيمة التي تحتوي على @ مسار البريد الإلكتروني؛ ولا تتحقق قاعدة التوجيه هذه من وجود صندوق البريد.
| إعداد الإضافة | إلزامي | القيمة والسلوك |
|---|---|---|
| مفتاح الأرصدة | نعم | يوفّر مفتاح حساب GenderAPI المحدد الأرصدة للطلبات التي تمت معالجتها. |
| الجدول وحقل المصدر | نعم | تحتوي خلية المصدر على اسم أو عنوان بريد إلكتروني. تُتخطى خلايا المصدر الفارغة. |
| حقل وجهة الجنس | نعم | يستقبل الحقل الأصلي gender. أبقِ القيمة غير المحسومة منفصلة عن male وfemale. |
| حقل وجهة البلد | لا | يستقبل قيمة country المُعادة. هذا عمود مُخرجات، وليس مرشّح بلد للطلب. |
| حقل وجهة probability | لا | يستقبل قيمة probability من الواجهة القديمة. يستقبل حقل percent القيمة مقسومة على 100، بينما يحتفظ الحقل الرقمي بالمقياس الأصلي. |
| حقل وجهة Found Name | لا | يستقبل الاسم الأول الذي تعيده الواجهة الأصلية عند توفره. أبقِ هذا الاسم المُستنتج المرشّح منفصلًا عن قيمة المصدر. |
| تخطي حقول الجنس المعبّأة | لا | يحتفظ بالسجلات التي يحتوي حقل الوجهة فيها على قيمة مسبقًا، بما في ذلك النص غير المحسوم. تحقّق من حالة هذا الخيار قبل كل تشغيل. |
اختبر مجموعة صغيرة قبل معالجة الجدول
ابدأ بجدول اختبار صغير يحتوي على اسم وعنوان بريد إلكتروني وخلية فارغة ومُدخل ملتبس. تحقّق من حقول الوجهة المختارة ومن طريقة عرض Airtable لمقياس probability قبل معالجة الجدول الرئيسي.
في الشيفرة التي رُوجعت، قد تظهر القيم الافتراضية غير المحسومة على شكل النص null وقيمة probability تساوي 0. وقد تترك بعض الاستجابات الأصلية غير الناجحة هذه القيم الافتراضية أيضًا، بينما قد يترك خطأ الاتصال السجل دون تغيير. تحقّق من حالة التشغيل ومن الصفوف المتأثرة؛ فالنص null وحده لا يثبت أن البحث نجح.
راجع القيم الموجودة بعد التشغيل. احتفظ بالنتائج غير المحسومة للمراجعة بدلًا من تعيين جنس بنفسك. التقدير المبني على الاسم لا يؤكد الهوية الجنسية للشخص، والبلد المُعاد لا يثبت مكان إقامته.
| ما تراه | ما يجب فعله |
|---|---|
| النتيجة المتوقعة في الأعمدة المتوقعة | احتفظ بالمُدخل الأصلي وبأي حقول إضافية حتى يبقى الربط قابلًا للمراجعة. |
| النص null أو probability تساوي 0 | اترك الحالة غير محسومة وتحقّق من حالة المعالجة قبل أن تقرر إجراء بحث جديد. |
| حقل وجهة معبّأ مسبقًا بقي دون تغيير | تحقّق من خيار التخطي؛ فقد يكون الاحتفاظ بالقيمة مقصودًا. |
| رسالة تتعلق بالمفتاح أو الأرصدة، أو نتيجة لم تتغير بعد خطأ | عالج مشكلة الحساب أو الاتصال وحدّد السجلات المتأثرة قبل إعادة التشغيل. |
راقب الأرصدة المستهلكة وعمليات إعادة التشغيل
تبحث الإضافة الأصلية عن القيم واحدة تلو الأخرى باستخدام مفتاح GenderAPI المحدد. قد يؤدي تشغيل جديد على السجلات نفسها غير المتخطاة إلى إرسال طلبات جديدة وخصم الأرصدة مرة أخرى. خطة Airtable وتوفر الإضافة منفصلان عن رصيد الحساب هذا.
لا تعرض المُخرجات الأصلية data/meta من استجابة V2، ولا خيارًا صريحًا لوضع الذكاء الاصطناعي، ولا كائن usage لكل عنصر، ولا عقد الطلب المجمّع في V2. استخدم وثائق V1 لسير العمل هذا، والبديل المستقل عبر API الموضح أدناه عندما تحتاج إلى هذه الإعدادات.
ترسل الإضافة القيم المربوطة للمعالجة وتكتب النتائج مجددًا في قاعدتك. راجع سياسة معالجة البيانات المنشورة وأذونات الإضافة للسجلات المعنية، ولا تُدرج حقولًا غير ذات صلة في ربط المصدر.
استخدم V2 عندما تحتاج إلى استجابة منظّمة
للتكامل المخصّص، تقبل GenderAPI V2 الأسماء وعناوين البريد الإلكتروني وأسماء المستخدمين، وتعيد حقولًا صريحة للنتيجة ودرجة الثقة والمصدر والاستهلاك. اضبط ذلك الاتصال بشكل منفصل؛ فقراءة دليل V2 لا تغيّر التطبيق المثبّت ولا أعمدة مُخرجاته.
تغطي أمثلة Python وNode.js الطلبات الفردية والطلبات المجمّعة ونتائج unknown والأخطاء التشغيلية. ابدأ بدليل المصادقة واختر وضع الذكاء الاصطناعي قبل إرسال طلب تُخصم عليه الأرصدة.
الأسئلة الشائعة
هل تستخدم إضافة Airtable واجهة GenderAPI V2؟
تستخدم شيفرة الإضافة، التي رُوجعت في 27 سبتمبر 2026، نقاط النهاية في V1 للأسماء وعناوين البريد الإلكتروني. للاتصال المخصّص عبر V2 حقول طلب واستجابة مختلفة، ولا يؤدي إلى تحديث الإضافة المثبّتة.
هل يمكن أن يحتوي حقل مصدر واحد على أسماء وعناوين بريد إلكتروني معًا؟
نعم. ترسل الإضافة التي رُوجعت القيم غير الفارغة التي تحتوي على @ إلى البحث بالبريد الإلكتروني، والقيم الأخرى إلى البحث بالاسم. هذا توجيه للمُدخل، وليس تحققًا من صندوق البريد.
لماذا تظهر قيمة probability مختلفة في حقل مئوي؟
تقسم الإضافة قيمة probability من الواجهة القديمة على 100 لحقل percent في Airtable، حتى يتمكن Airtable من عرضها كنسبة مئوية. يحتفظ الحقل الرقمي بالمقياس الأصلي؛ وهذه القيمة ليست حقل confidence في V2.
هل يحتفظ خيار التخطي بالنتائج غير المحسومة؟
نعم، عندما يحتوي حقل الوجهة على قيمة مسبقًا، بما في ذلك النص null من تشغيل سابق. راجع تلك السجلات وامسح فقط القيم التي تريد معالجتها من جديد عن قصد.
المصادر والوثائق
رُوجع هذا الدليل آخر مرة في . تحقّق من طريقة التثبيت في وثائق المنصة، واستخدم وثائق API أدناه لبناء تكامل V2 منفصل.