المترجم 3.0: أمثلة على القاموس

  • مقالة
  • قراءة خلال 2 دقائق

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

URL للطلب

أرسل طلبا POST إلى:

https://api.cognitive.microsofttranslator.com/dictionary/examples?api-version=3.0

معلمات الطلب

معلمات الطلب التي تم تمريرها على سلسلة الاستعلام هي:

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

تتضمن رؤوس الطلبات ما يلي:

الرؤوس الوصف
رأس (رؤوس) المصادقة رأس الطلب المطلوب.
راجع الخيارات المتاحة للمصادقة.
نوع المحتوى رأس الطلب المطلوب.
يحدد نوع محتوى الحمولة. القيم المحتملة هي: application/json.
طول المحتوى رأس الطلب المطلوب.
طول نص الطلب.
X-ClientTraceId اختياري.
معرّف GUID تم إنشاؤه بواسطة العميل لتعريف الطلب بشكل فريد. يمكنك حذف هذا الرأس إذا قمت بتضمين معرف التتبع في سلسلة الاستعلام باستخدام معلمة الاستعلام المسماة ClientTraceId.

نص الطلب

نص الطلب عبارة عن صفيف JSON. كل عنصر صفيف هو كائن JSON مع الخصائص التالية:

  • Textسلسلة تحدد المصطلح المراد البحث عنه.: يجب أن تكون هذه هي قيمة normalizedText حقل من الترجمات الخلفية لطلب بحث سابق في القاموس . يمكن أن يكون أيضا قيمة الحقل normalizedSource .

  • Translationسلسلة تحدد النص المترجم الذي تم إرجاعه مسبقا بواسطة عملية البحث في القاموس .: يجب أن تكون هذه هي القيمة من الحقل normalizedTarget في translations قائمة استجابة البحث في القاموس . ستقوم الخدمة بإرجاع أمثلة لزوج الكلمات المحدد بين المصدر والهدف.

مثال على ذلك:

[
    {"Text":"fly", "Translation":"volar"}
]

تنطبق القيود التالية:

  • يمكن أن تحتوي الصفيف على 10 عناصر على الأكثر.
  • لا يمكن أن تتجاوز القيمة النصية لعنصر الصفيف 100 حرف بما في ذلك المسافات.

هيئة الاستجابة

الاستجابة الناجحة هي صفيف JSON مع نتيجة واحدة لكل سلسلة في صفيف الإدخال. يتضمن كائن النتيجة الخصائص التالية:

  • normalizedSourceسلسلة تعطي الشكل العادي للمصطلح المصدر.: وعموما، ينبغي أن يكون ذلك مطابقا لقيمة الحقل Text في فهرس القائمة المطابقة في نص الطلب.

  • normalizedTargetسلسلة تعطي الشكل العادي للمصطلح المستهدف.: وعموما، ينبغي أن يكون ذلك مطابقا لقيمة الحقل Translation في فهرس القائمة المطابقة في نص الطلب.

  • examplesقائمة بالأمثلة للزوج (مصطلح المصدر، المصطلح المستهدف).: كل عنصر من عناصر القائمة هو كائن له الخصائص التالية:

    • sourcePrefixالسلسلة المراد تسلسلها قبل قيمة sourceTerm لتشكيل مثال كامل.: لا تقم بإضافة حرف مسافة ، لأنه موجود بالفعل عندما يجب أن يكون. قد تكون هذه القيمة سلسلة فارغة.

    • sourceTermتم البحث عن سلسلة مساوية للمصطلح الفعلي.: تتم إضافة السلسلة مع sourcePrefix المثال الكامل وتشكيله sourceSuffix . يتم فصل قيمته بحيث يمكن تمييزه في واجهة مستخدم ، على سبيل المثال ، عن طريق تثبيته.

    • sourceSuffixالسلسلة المراد تسلسلها بعد قيمة sourceTerm لتشكيل مثال كامل.: لا تقم بإضافة حرف مسافة ، لأنه موجود بالفعل عندما يجب أن يكون. قد تكون هذه القيمة سلسلة فارغة.

    • targetPrefixسلسلة مشابهة ولكن sourcePrefix للهدف.:

    • targetTermسلسلة مشابهة ولكن sourceTerm للهدف.:

    • targetSuffixسلسلة مشابهة ولكن sourceSuffix للهدف.:

    ملاحظة

    إذا لم تكن هناك أمثلة في القاموس، تكون الاستجابة 200 (موافق) ولكن القائمة عبارة عن examples قائمة فارغة.

أمثلة

يوضح هذا المثال كيفية البحث عن أمثلة للزوج المكون من المصطلح fly الإنجليزي وترجمته volarالإسبانية .

curl -X POST "https://api.cognitive.microsofttranslator.com/dictionary/examples?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Content-Type: application/json" -d "[{'Text':'fly', 'Translation':'volar'}]"

هيئة الاستجابة (مختصرة للتوضيح) هي:

[
    {
        "normalizedSource":"fly",
        "normalizedTarget":"volar",
        "examples":[
            {
                "sourcePrefix":"They need machines to ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Necesitan máquinas para ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },      
            {
                "sourcePrefix":"That should really ",
                "sourceTerm":"fly",
                "sourceSuffix":".",
                "targetPrefix":"Eso realmente debe ",
                "targetTerm":"volar",
                "targetSuffix":"."
            },
            //
            // ...list abbreviated for documentation clarity
            //
        ]
    }
]