Translator 3.0: Sözlük Örnekleri

Makale
06/13/2024

Sözlükteki terimlerin bağlamda nasıl kullanıldığını gösteren örnekler sağlar. Bu işlem Sözlük araması ile 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 seçilen ağ ve özel uç nokta yapılandırması ve desteği için Destek.

İstek parametreleri

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

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

İstek üst bilgileri şunlardır:

Üst Bilgiler	Açıklama
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	İsteğe bağlı. İ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ı `ClientTraceId`bir sorgu parametresi kullanarak izleme kimliğini sorgu dizesine eklerseniz bu üst bilgiyi atlayabilirsiniz.

Request body

İ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 normalizedText arama 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 alandaki 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ı gerektiği zaman zaten oradadır. Bu değer boş bir dize olabilir.
sourceTerm: Gerçek terime eşit bir dize aranmış. Dize, tam örneği oluşturmak için ve sourceSuffix ile sourcePrefix eklenir. Değeri ayrılmıştır, bu nedenle bir kullanıcı arabiriminde, örneğin kalın yazıyla işaretlenebilir.
- sourceSuffix: değerinin sourceTerm ardından birleştirerek tam bir örnek oluşturacak dize. Boşluk karakteri eklemeyin, çünkü olması gerektiği zaman zaten oradadır. 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 'dir (Tamam) ancak examples liste boş bir listedir.

Örnekler

Bu örnekte, İngilizce teriminden 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) şöyledir:

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

Aracılığıyla paylaş