Azure Translator в средстве Foundry 3.0. Примеры словаря

Содержит примеры, показывающие, как термины в словаре используются в контексте. Эта операция используется в тандеме с поиском словаря.

URL-адрес запроса

Отправьте запрос в POST :

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

См. раздел поддержки виртуальной сети для выбранной сети и конфигурации частной конечной точки Переводчика.

Параметры запроса

Параметры запроса, передаваемые в строке запроса:

Параметр запроса Description
версия API Обязательный параметр.
Версия API, запрошенная клиентом. Необходимое значение: 3.0.
от / из / с (context-dependent) Обязательный параметр.
Задает язык входного текста. Исходный язык должен быть одним из поддерживаемых языков , dictionary включенных в область.
до Обязательный параметр.
Задает язык выходного текста. Целевой язык должен быть одним из поддерживаемых языков , dictionary включенных в область.

К заголовкам запроса относятся:

Headers Description
Заголовки проверки подлинности Обязательный заголовок запроса.
См. сведения о доступных вариантах проверки подлинности>.
Тип контента Обязательный заголовок запроса.
Указывает тип контента полезных данных. Возможные значения: 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: строка, равная фактическому термину. Строка добавляется и sourcePrefixsourceSuffix формирует полный пример. Его значение отделяется, чтобы его можно было пометить в пользовательском интерфейсе, например полужирным шрифтом.

    • 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
            //
        ]
    }
]
  • Last updated on