بدء استخدام Perspective API

بدء استخدام Perspective API

لمحة عن هذا الدرس التطبيقي حول الترميز

تاريخ التعديل الأخير: مارس 10, 2022

تأليف: Jigsaw

1. قبل البدء

واجهة برمجة التطبيقات النظرية هي واجهة برمجة تطبيقات مجانية تساعدك في استضافة محادثات أفضل على الإنترنت. تستخدِم واجهة برمجة التطبيقات تعلُّم الآلة (ML) لتحليل سلسلة من النص وتوقّع التأثير الملموس عليها في المحادثة.

في هذا الدرس التطبيقي حول الترميز، يمكنك إعداد Perspective API.

ملاحظة: تهدف واجهة برمجة التطبيقات المنظور إلى تسهيل الإشراف على المحتوى. ولا يهدف ذلك إلى استبدال عمل صانعي القرار البشرية بالكامل.

ما ستتعرَّف عليه

• نهج يستند إلى الذكاء الاصطناعي للإشراف على المحتوى في لحظة إنشاءه.

الأشياء التي تحتاج إليها

• حساب Google للوصول إلى Google Cloud
• سرعة إنترنت مناسبة

2. البدء

للبدء، عليك امتلاك مشروع على Google Cloud لمصادقة طلبات البيانات من واجهة برمجة التطبيقات.

1. في Google Cloud Console، استخدِم مشروعًا حاليًا.
2. إذا لزم الأمر، اتّبِع الخطوات التالية لإنشاء مشروع جديد:

• سجِّل الدخول باستخدام حسابك على Google.
• افتح Cloud Console.
• انقر على إنشاء مشروع أو افتح القائمة اختيار مشروع، ثم انقر على مشروع جديد في مربّع الحوار.
• أدخِل اسمًا لمشروعك، ثم انقر على إنشاء.

سيظهر المشروع الآن في القائمة المنسدلة.

طلب الوصول إلى واجهة برمجة التطبيقات

• لطلب الوصول إلى واجهة برمجة التطبيقات، أكمِل هذا النموذج.

في غضون ساعة، من المفترض أن تتلقى رسالة إلكترونية تؤكد أنه يمكنك عرض واجهة برمجة التطبيقات وتفعيلها في Google Cloud.

ملاحظة: إذا لم تتلقَّ رسالة إلكترونية في غضون يوم عمل واحد، يُرجى إكمال النموذج مرة أخرى أو التواصل مع فريق الدعم.

3. تفعيل واجهة برمجة التطبيقات

• في Cloud Console، انتقِل إلى نظرة عامة على واجهة برمجة التطبيقات Perspective، ثم انقر على تفعيل.

4. إنشاء مفتاح واجهة برمجة التطبيقات

1. في قائمة التنقل، انقر على واجهات برمجة التطبيقات &amp؛ الخدمات &gt؛ بيانات الاعتماد &gt؛ إنشاء بيانات الاعتماد &gt؛ مفتاح واجهة برمجة التطبيقات.

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

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

2. انسخ مفتاح واجهة برمجة التطبيقات.

5. طلبات نموذجية

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

1. تقديم طلب AnalyzeComment
2. يمكنك تشغيل أحد نماذج طلبات البيانات من واجهة برمجة التطبيقات هذه للحصول على النتائج مباشرةً من واجهة برمجة التطبيقات Perspective.

تُصدِر طريقة AnalyzeComment طلبًا من واجهة برمجة التطبيقات لتحليل الحقل comment.text للسمة requestedAttributes، وفي هذه الحالة، النموذج TOXICITY.

3. الصِق مفتاح واجهة برمجة التطبيقات في حقل API_KEY.

ويمكنك الاستفادة من العلامة doNotStore، إذا كنت تريد ذلك، لضمان حذف جميع التعليقات المُرسَلة تلقائيًا بعد عرض النتائج.

4. اقرأ المستندات المرجعية لواجهة برمجة التطبيقات للحصول على تفاصيل عن جميع حقول الطلب والاستجابة، بالإضافة إلى القيم المتاحة لـ requestedAttributes.

هناك سمات تجريبية، مثل OBSCENE وATTACK_ON_DUNS وSPAM يمكنك استخدامها أيضًا.

Python

يستخدم نموذج الطلب والاستجابة هذا إصدار Python من مكتبات عميل Google API.

1. ثبِّت مكتبة برامج Python.
2. شغِّل الأوامر التالية:

من المفترَض أن تظهر لك النتائج التالية:

حصل تحيتك الودية على درجة تسامح منخفضة.

Node.js

يستخدم نموذج الطلب والاستجابة إصدار Node.js من مكتبات عميل Google API.

1. ثبِّت مكتبة برامج Node.js أو ثبِّت حزمة npm googleapis.
2. شغِّل الأوامر التالية:

من المفترَض أن تظهر لك النتائج التالية:

cURL

يستخدم نموذج الطلب والاستجابة هذا الأمر cURL. يجب أن يعمل هذا الأمر مع معظم مستخدمي نظامي التشغيل MacOS وLinux. قد تحتاج إلى تثبيت cURL لتشغيل هذا الأمر.

• استبدِل YOUR_KEY_HERE بمفتاح واجهة برمجة التطبيقات.

في هذا الرد، يمنح الحقل attributeScores.TOXICITY.summaryScore.value درجة الدرجات لتأثير الكثافة في التعليق. حصل التعليق على نتيجة 0.9 من 1.0.

6. تهانينا

لقد أطلقنا واجهة برمجة التطبيقات Perspective.

مزيد من المعلومات

• يحتوي الموقع الإلكتروني لواجهة برمجة التطبيقات Perspective على مزيد من المعلومات حول واجهة برمجة التطبيقات، بما في ذلك دراسات الحالة.
• يحتوي الموقع الإلكتروني لمطوّري واجهة برمجة التطبيقات Perspective على مزيد من المعلومات حول السمات واللغات والأساليب. وإذا أردت البدء بسرعة، تصف صفحة الطُرق كيفية استخدام الطُرق AnalyzeComment وSuggestCommentScore.