Tradutor 3.0: Exemplos de Dicionário

  • Artigo

Fornece exemplos que mostram como os termos no dicionário são utilizados no contexto. Esta operação é utilizada em conjunto com a pesquisa do Dicionário.

URL do Pedido

Envie um pedido POST para:

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

ConsulteRede Virtual Suporte para o suporte e configuração de pontos finais privados e de rede selecionados do serviço Translator.

Parâmetros do pedido

Os parâmetros de pedido transmitidos na cadeia de consulta são:

Parâmetro de Consulta Description
versão da API Parâmetro obrigatório.
Versão da API pedida pelo cliente. O valor tem de ser 3.0.
de Parâmetro obrigatório.
Especifica o idioma do texto de entrada. O idioma de origem tem de ser um dos idiomas suportados incluídos no dictionary âmbito.
para Parâmetro obrigatório.
Especifica o idioma do texto de saída. O idioma de destino tem de ser um dos idiomas suportados incluídos no dictionary âmbito.

Os cabeçalhos do pedido incluem:

Cabeçalhos Description
Cabeçalhos de autenticação Cabeçalho de pedido obrigatório.
Veja Opções de autenticação>disponíveis para autenticação.
Content-Type Cabeçalho de pedido obrigatório.
Especifica o tipo de conteúdo do payload. Os valores possíveis são: application/json.
Comprimento do Conteúdo Cabeçalho de pedido obrigatório.
O comprimento do corpo do pedido.
X-ClientTraceId Opcional.
Um GUID gerado pelo cliente para identificar exclusivamente o pedido. Pode omitir este cabeçalho se incluir o ID de rastreio na cadeia de consulta com um parâmetro de consulta com o nome ClientTraceId.

Corpo do pedido

O corpo do pedido é uma matriz JSON. Cada elemento de matriz é um objeto JSON com as seguintes propriedades:

  • Text: uma cadeia que especifica o termo a procurar. Esta propriedade deve ser o valor de um normalizedText campo das traduções anteriores de um pedido de pesquisa do Dicionário anterior. Também pode ser o valor do normalizedSource campo.

  • Translation: uma cadeia que especifica o texto traduzido anteriormente devolvido pela operação de pesquisa do Dicionário . Esta propriedade deve ser o valor do normalizedTarget campo na translations lista da resposta de pesquisa do Dicionário . O serviço devolve exemplos para o par de palavras de destino de origem específico.

Um exemplo é:

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

Aplicam-se as seguintes limitações:

  • A matriz pode ter, no máximo, 10 elementos.
  • O valor de texto de um elemento de matriz não pode exceder os 100 carateres, incluindo espaços.

Corpo da resposta

Uma resposta bem-sucedida é uma matriz JSON com um resultado para cada cadeia na matriz de entrada. Um objeto de resultado inclui as seguintes propriedades:

  • normalizedSource: uma cadeia que dá a forma normalizada do termo de origem. Geralmente, esta propriedade deve ser idêntica ao valor do Text campo no índice de lista correspondente no corpo do pedido.

  • normalizedTarget: uma cadeia que dá a forma normalizada do termo de destino. Geralmente, esta propriedade deve ser idêntica ao valor do Translation campo no índice de lista correspondente no corpo do pedido.

  • examples: uma lista de exemplos para o par (termo de origem, termo de destino). Cada elemento da lista é um objeto com as seguintes propriedades:

  • sourcePrefix: a cadeia a concatenar antes do valor de sourceTerm para formar um exemplo completo. Não adicione um caráter de espaço, uma vez que já existe quando deveria estar. Este valor pode ser uma cadeia vazia.

  • sourceTerm: uma cadeia igual ao termo real pesquisado. A cadeia é adicionada com sourcePrefix e sourceSuffix para formar o exemplo completo. O respetivo valor é separado para que possa ser marcado numa interface de utilizador, por exemplo, ao negrito.

    • sourceSuffix: a cadeia a concatenar após o valor de sourceTerm para formar um exemplo completo. Não adicione um caráter de espaço, uma vez que já existe quando deveria estar. Este valor pode ser uma cadeia vazia.

    • targetPrefix: uma cadeia semelhante a sourcePrefix mas para o destino.

    • targetTerm: uma cadeia semelhante a sourceTerm mas para o destino.

    • targetSuffix: uma cadeia semelhante a sourceSuffix mas para o destino.

      Nota

      Se não existirem exemplos no dicionário, a resposta é 200 (OK), mas a examples lista é uma lista vazia.

Exemplos

Este exemplo mostra como procurar exemplos para o par composto pelo termo fly inglês e a respetiva tradução volarem espanhol.

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

O corpo da resposta (abreviado para clareza) é:

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