Tradutor 3.0: Exemplos de dicionário

Artigo
09/02/2024

Fornece exemplos que mostram como os termos no dicionário são usados no contexto. Esta operação é usada em conjunto com a Pesquisa no dicionário.

URL da solicitação

Envie uma solicitação POST para:

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

Consulte Suporte de Rede Virtual para configuração e suporte de rede e ponto de extremidade privado selecionados do serviço Translator.

Parâmetros da solicitação

Os parâmetros de solicitação passados na cadeia de caracteres de consulta são:

Parâmetro de consulta	Descrição
api-version	Parâmetro obrigatório. Versão da API solicitada pelo cliente. O valor precisa ser `3.0`.
de	Parâmetro obrigatório. Especifica o idioma do texto de entrada. O idioma de origem deve ser um dos idiomas compatíveis incluídos no escopo de `dictionary`.
como	Parâmetro obrigatório. Especifica o idioma do texto de saída. O idioma de destino deve ser um dos idiomas com suporte incluídos no escopo `dictionary`.

Os cabeçalhos de solicitação incluem:

Cabeçalhos	Descrição
Cabeçalhos de autenticação	Cabeçalho de solicitação obrigatório. Confira Autenticação>opções disponíveis para autenticação.
Tipo de conteúdo	Cabeçalho de solicitação obrigatório. Especifica o tipo de conteúdo da carga. Os valores possíveis são: `application/json`.
Content-Length	Opcional. O tamanho do corpo da solicitação.
X-ClientTraceId	Opcional. Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. É possível omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta nomeado `ClientTraceId`.

Corpo da solicitação

O corpo da solicitação é uma matriz JSON. Cada elemento da matriz é um objeto JSON com as seguintes propriedades:

Text: uma cadeia de caracteres que especifica o termo da pesquisa. Essa propriedade deve ser o valor de um campo normalizedText das traduções reversas de uma solicitação anterior de Pesquisa no dicionário. Também pode ser o valor do campo normalizedSource.
Translation: uma cadeia de caracteres especificando o texto traduzido retornado anteriormente pela operação Pesquisa no dicionário. Essa propriedade deve ser o valor do campo normalizedTarget na lista translations da resposta de Pesquisa no dicionário. O serviço retorna exemplos do par de palavras de origem-destino específico.

Um exemplo é:

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

As seguintes limitações se aplicam:

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

Corpo da resposta

Uma resposta com êxito é uma matriz JSON com um resultado para cada cadeia de caracteres na matriz de entrada. Um objeto de resultado inclui as seguintes propriedades:

normalizedSource: uma cadeia de caracteres fornecendo o formulário normalizado do termo de origem. Em geral, essa propriedade deve ser idêntica ao valor do campo Text no índice da lista correspondente no corpo da solicitação.
normalizedTarget: uma cadeia de caracteres fornecendo o formulário normalizado do termo de destino. Em geral, essa propriedade deve ser idêntica ao valor do campo Translation no índice da lista correspondente no corpo da solicitação.
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 de caracteres para concatenar antes do valor de sourceTerm para formar um exemplo completo. Não adicione um caractere de espaço, pois ele já estará no lugar certo quando necessário. Esse valor pode ser uma cadeia de caracteres vazia.
sourceTerm: uma cadeia de caracteres igual ao termo real é pesquisada. A cadeia de caracteres é adicionada com sourcePrefix e sourceSuffix para formar o exemplo completo. O valor dele é separado, de modo que ele possa ser marcado em uma interface do usuário, por exemplo, colocando-o em negrito.
- sourceSuffix: a cadeia de caracteres para concatenar após o valor de sourceTerm para formar um exemplo completo. Não adicione um caractere de espaço, pois ele já estará no lugar certo quando necessário. Esse valor pode ser uma cadeia de caracteres vazia.
- targetPrefix: uma cadeia de caracteres semelhante a sourcePrefix, mas para o destino.
- targetTerm: uma cadeia de caracteres semelhante a sourceTerm, mas para o destino.
- targetSuffix: uma cadeia de caracteres semelhante a sourceSuffix, mas para o destino.
  
  Observação
  
  Se não houver nenhum exemplo no dicionário, a resposta será 200 (OK), mas a lista examples será uma lista vazia.

Exemplos

Este exemplo mostra como pesquisar exemplos para o par composto pelo termo em inglês fly e a tradução em espanhol 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'}]"

O corpo da resposta (abreviado para maior 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
            //
        ]
    }
]

Compartilhar via