Partilhar via

Azure Translator no Foundry Tools 3.0: Exemplos de Dicionário

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 da solicitação

Envie um POST pedido para:

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

ConsulteSuporte de Rede Virtual para Tradutores, configuração e suporte de rede selecionada e endpoint privado.

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:

Headers 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.
Content-Length 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 de solicitação

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.

      Observação

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

Examples

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