Translator 3.0: Sözlük Örnekleri

  • Makale

Sözlükteki terimlerin bağlamda nasıl kullanıldığını gösteren örnekler sağlar. Bu işlem Sözlük aramasıyla birlikte kullanılır.

İstek URL’si

Şuraya bir POST isteği gönderin:

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

Bkz. Sanal Ağ Translator hizmeti için destek seçili ağ ve özel uç nokta yapılandırması ve desteği.

İstek parametreleri

Sorgu dizesinde geçirilen istek parametreleri şunlardır:

Sorgu Parametresi Description
api sürümü Gerekli parametre.
İstemci tarafından istenen API sürümü. Değer olmalıdır 3.0.
Kaynak Gerekli parametre.
Giriş metninin dilini belirtir. Kaynak dil, kapsama dahil edilen desteklenen dillerdendictionary biri olmalıdır.
kullanıcısı Gerekli parametre.
Çıkış metninin dilini belirtir. Hedef dil, kapsama dahil edilen desteklenen dillerdendictionary biri olmalıdır.

İstek üst bilgileri şunlardır:

Üst Bilgiler Description
Kimlik doğrulama üst bilgileri Gerekli istek üst bilgisi.
Bkz . Kimlik doğrulaması>için kullanılabilir kimlik doğrulaması seçenekleri.
İçerik Türü Gerekli istek üst bilgisi.
Yükün içerik türünü belirtir. Olası değerler şunlardır: application/json.
İçerik Uzunluğu Gerekli istek üst bilgisi.
İstek gövdesinin uzunluğu.
X-ClientTraceId İsteğe bağlı.
İsteği benzersiz olarak tanımlamak için istemci tarafından oluşturulan GUID. adlı ClientTraceIdbir sorgu parametresi kullanarak sorgu dizesine izleme kimliğini eklerseniz bu üst bilgiyi atlayabilirsiniz.

İstek gövdesi

İsteğin gövdesi bir JSON dizisidir. Her dizi öğesi aşağıdaki özelliklere sahip bir JSON nesnesidir:

  • Text: Arama terimini belirten bir dize. Bu özellik, önceki sözlük normalizedTextarama isteğinin arka çevirilerinden bir alanın değeri olmalıdır. Alanın değeri normalizedSource de olabilir.

  • Translation: Sözlük arama işlemi tarafından daha önce döndürülen çevrilmiş metni belirten bir dize. Bu özellik, Sözlük arama yanıtı listesindeki alandan translations değer normalizedTarget olmalıdır. Hizmet, belirli bir kaynak hedef sözcük çifti için örnekler döndürür.

Örnek olarak:

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

Aşağıdaki sınırlamalar geçerlidir:

  • Dizide en fazla 10 öğe olabilir.
  • Bir dizi öğesinin metin değeri boşluklar dahil 100 karakteri aşamaz.

Yanıt gövdesi

Başarılı bir yanıt, giriş dizisindeki her dize için bir sonuç içeren bir JSON dizisidir. Sonuç nesnesi aşağıdaki özellikleri içerir:

  • normalizedSource: Kaynak terimin normalleştirilmiş biçimini veren bir dize. Genellikle, bu özellik isteğin gövdesindeki Text eşleşen liste dizinindeki alanın değeriyle aynı olmalıdır.

  • normalizedTarget: Hedef terimin normalleştirilmiş biçimini veren bir dize. Genellikle, bu özellik isteğin gövdesindeki Translation eşleşen liste dizinindeki alanın değeriyle aynı olmalıdır.

  • examples: (kaynak terim, hedef terim) çifti için örneklerin listesi. Listenin her öğesi aşağıdaki özelliklere sahip bir nesnedir:

  • sourcePrefix: Tam bir örnek oluşturmak için değerinden sourceTermönce birleştirilme dizesi. Boşluk karakteri eklemeyin çünkü olması gereken yerde zaten var. Bu değer boş bir dize olabilir.

  • sourceTerm: Gerçek terime eşit bir dize arandı. Dize, tam örneği oluşturmak için ve sourceSuffix ile sourcePrefix eklenir. Değeri, örneğin kalın yazıyla bir kullanıcı arabiriminde işaretlenebilir şekilde ayrılır.

    • sourceSuffix: Tam bir örnek oluşturmak için değerinden sourceTermsonra birleştirilme dizesi. Boşluk karakteri eklemeyin çünkü olması gereken yerde zaten var. Bu değer boş bir dize olabilir.

    • targetPrefix: Ama hedefine benzer bir sourcePrefix dize.

    • targetTerm: Ama hedefine benzer bir sourceTerm dize.

    • targetSuffix: Ama hedefine benzer bir sourceSuffix dize.

      Not

      Sözlükte örnek yoksa, yanıt 200 'dür (Tamam) ancak examples liste boş bir listedir.

Örnekler

Bu örnekte, İngilizce terimden fly ve İspanyolca çeviriden volaroluşan çift için örneklerin nasıl aranacakları gösterilmektedir.

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'}]"

Yanıt gövdesi (netlik için kısaltılır) şu şekildedir:

[
    {
        "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
            //
        ]
    }
]