Translator 3.0: Exemplos de dicionários

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 de dicionário.

URL do Pedido

Envie um pedido 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 selecionada e ponto final privado e de rede selecionada.

Parâmetros de solicitação

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

Parâmetro de consulta	Description
API-versão	Parâmetro necessário. Versão da API solicitada pelo cliente. O valor deve ser `3.0`.
de	Parâmetro necessário. Especifica o idioma do texto de entrada. O idioma de origem deve ser um dos idiomas suportados incluídos no `dictionary` escopo.
para	Parâmetro necessário. Especifica o idioma do texto de saída. O idioma de destino deve ser um dos idiomas suportados incluídos no `dictionary` escopo.

Os cabeçalhos de solicitação incluem:

Cabeçalhos	Description
Cabeçalhos de autenticação	Cabeçalho de solicitação obrigatório. Consulte Opções de autenticação>disponíveis para autenticação.
Tipo de Conteúdo	Cabeçalho de solicitação obrigatório. Especifica o tipo de conteúdo da carga útil. Os valores possíveis são: `application/json`.
Comprimento do conteúdo	Opcional. O comprimento do corpo do pedido.
X-ClientTraceId	Opcional. Um GUID gerado pelo cliente para identificar exclusivamente a solicitação. Você pode omitir esse cabeçalho se incluir a ID de rastreamento na cadeia de caracteres de consulta usando um parâmetro de consulta chamado `ClientTraceId`.

Corpo do pedido

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

Text: Uma cadeia de caracteres que especifica o termo a ser pesquisado. Essa propriedade deve ser o valor de um normalizedText campo das retrotraduções de uma solicitação de pesquisa de dicionário anterior. Também pode ser o valor do normalizedSource campo.
Translation: Uma cadeia de caracteres que especifica o texto traduzido retornado anteriormente pela operação de pesquisa Dicionário. Esta propriedade deve ser o normalizedTarget valor do campo na translations lista da resposta de pesquisa de dicionário. O serviço retorna exemplos para o par de palavras de origem-destino 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 100 caracteres, incluindo espaços.

Corpo da resposta

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

normalizedSource: Uma cadeia de caracteres que dá a forma normalizada do termo de origem. Geralmente, essa propriedade deve ser idêntica ao valor do campo no índice da Text lista correspondente no corpo da solicitação.
normalizedTarget: Uma cadeia de caracteres que dá a forma normalizada do termo de destino. Geralmente, essa propriedade deve ser idêntica ao valor do campo no índice da Translation 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 a ser concatenada antes do valor de sourceTerm para formar um exemplo completo. Não adicione um caractere de espaço, pois ele já está lá quando deveria estar. Esse valor pode ser uma cadeia de caracteres vazia.
sourceTerm: Uma cadeia de caracteres igual ao termo real pesquisado. A cadeia de caracteres é adicionada com sourcePrefix e sourceSuffix para formar o exemplo completo. Seu valor é separado para que possa ser marcado em uma interface do usuário, por exemplo, negritando-o.
- sourceSuffix: A cadeia de caracteres a ser concatenada após o valor de sourceTerm para formar um exemplo completo. Não adicione um caractere de espaço, pois ele já está lá quando deveria estar. 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.
  
  Nota
  
  Se não houver 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 em inglês e sua 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 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
            //
        ]
    }
]

Partilhar via