Compartilhar via


Document Translation - Get Supported Glossary Formats

Retorna a lista de formatos de glossário suportados
A lista de formatos de glossário compatíveis com o serviço de Tradução de Documentos. A lista inclui a extensão de arquivo comum usada.

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

Parâmetros de URI

Nome Em Obrigatório Tipo Description
endpoint
path True

string

Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).

Cabeçalho da solicitação

Nome Obrigatório Tipo Description
Ocp-Apim-Subscription-Key True

string

Forneça a chave de assinatura dos serviços cognitivos aqui.

Respostas

Nome Tipo Description
200 OK

SupportedFileFormats

Retorna a lista de formatos de arquivo de glossário suportados

Cabeçalhos

Retry-After: integer

429 Too Many Requests

TranslationErrorResponse

Muitas solicitações

500 Internal Server Error

TranslationErrorResponse

Erro interno do servidor

Other Status Codes

TranslationErrorResponse

Servidor temporário indisponível

Segurança

Ocp-Apim-Subscription-Key

Forneça a chave de assinatura dos serviços cognitivos aqui.

Tipo: apiKey
Em: header

Exemplos

Get Glossary Formats

Solicitação de exemplo

GET {endpoint}/translator/text/batch/v1.0/glossaries/formats

Resposta de exemplo

{
  "error": {
    "code": "RequestRateTooHigh",
    "message": "User's request rate is too high",
    "innerError": {
      "code": "RateTooHigh",
      "message": "Request rate is too high"
    }
  }
}
{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}
{
  "error": {
    "code": "ServiceUnavailable",
    "message": "Service is temporary unavailable",
    "innerError": {
      "code": "ServiceTemporaryUnavailable",
      "message": "Service is currently unavailable.  Please try again later"
    }
  }
}
retry-after: 30
ETag: 686897696a7c876b7e
{
  "value": [
    {
      "format": "XLIFF",
      "fileExtensions": [
        ".xlf"
      ],
      "contentTypes": [
        "application/xliff+xml"
      ],
      "defaultVersion": "1.2",
      "versions": [
        "1.0",
        "1.1",
        "1.2"
      ]
    },
    {
      "format": "TMX",
      "fileExtensions": [
        ".tmx"
      ],
      "contentTypes": [],
      "versions": [
        "1.0",
        "1.1",
        "1.2",
        "1.3",
        "1.4"
      ]
    }
  ]
}

Definições

Nome Description
FileFormat
InnerTranslationError

Novo formato de Erro Interno que está em conformidade com as Diretrizes de API dos Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, destino de mensagens e propriedades opcionais, detalhes (par de valor de chave), erro interno(isso pode ser aninhado).

SupportedFileFormats

Tipo base para retorno de lista em nossa api

TranslationError

Isso contém um erro externo com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

TranslationErrorCode

Enumerações que contêm códigos de erro de alto nível.

TranslationErrorResponse

Contém informações de erro unificadas usadas para respostas HTTP em qualquer Serviço Cognitivo. As instâncias podem ser criadas por meio de Microsoft.CloudAI.Containers.HttpStatusExceptionV2 ou retornando-a diretamente de um controlador.

FileFormat

Nome Tipo Description
contentTypes

string[]

Tipos de conteúdo com suporte para este formato

defaultVersion

string

Versão padrão se nenhuma for especificada

fileExtensions

string[]

Extensão de arquivo com suporte para este formato

format

string

Nome do formato

versions

string[]

Versão com suporte

InnerTranslationError

Novo formato de Erro Interno que está em conformidade com as Diretrizes de API dos Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, destino de mensagens e propriedades opcionais, detalhes (par de valor de chave), erro interno(isso pode ser aninhado).

Nome Tipo Description
code

string

Obtém a cadeia de caracteres de erro de código.

innerError

InnerTranslationError

Novo formato de Erro Interno que está em conformidade com as Diretrizes de API dos Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, destino de mensagens e propriedades opcionais, detalhes (par de valor de chave), erro interno(isso pode ser aninhado).

message

string

Obtém uma mensagem de erro de alto nível.

target

string

Obtém a origem do erro. Por exemplo, seriam "documentos" ou "id de documento" em caso de documento inválido.

SupportedFileFormats

Tipo base para retorno de lista em nossa api

Nome Tipo Description
value

FileFormat[]

lista de objetos

TranslationError

Isso contém um erro externo com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.

Nome Tipo Description
code

TranslationErrorCode

Enumerações que contêm códigos de erro de alto nível.

innerError

InnerTranslationError

Novo formato de Erro Interno que está em conformidade com as Diretrizes de API dos Serviços Cognitivos que está disponível em https://microsoft.sharepoint.com/%3Aw%3A/t/CognitiveServicesPMO/EUoytcrjuJdKpeOKIK_QRC8BPtUYQpKBi8JsWyeDMRsWlQ?e=CPq8ow. Isso contém as propriedades necessárias ErrorCode, destino de mensagens e propriedades opcionais, detalhes (par de valor de chave), erro interno(isso pode ser aninhado).

message

string

Obtém uma mensagem de erro de alto nível.

target

string

Obtém a origem do erro. Por exemplo, seriam "documentos" ou "id de documento" em caso de documento inválido.

TranslationErrorCode

Enumerações que contêm códigos de erro de alto nível.

Valor Description
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable
ResourceNotFound
Unauthorized
RequestRateTooHigh

TranslationErrorResponse

Contém informações de erro unificadas usadas para respostas HTTP em qualquer Serviço Cognitivo. As instâncias podem ser criadas por meio de Microsoft.CloudAI.Containers.HttpStatusExceptionV2 ou retornando-a diretamente de um controlador.

Nome Tipo Description
error

TranslationError

Isso contém um erro externo com código de erro, mensagem, detalhes, destino e um erro interno com detalhes mais descritivos.