Получение сведений о поддерживаемых форматах глоссария

Справочная
служба: версия API перевода
документов ВИ Azure:
версия 1.1

Метод получения поддерживаемых форматов глоссария возвращает список форматов глоссария, которые поддерживает служба перевода документов. Список включает стандартное используемое расширение файлов.

Запросить URL-адрес

Отправьте запрос GET на следующий адрес.

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.1/glossaries/formats

Узнайте, как найти свое личное доменное имя.

Внимание

  • Конечную точку личного домена необходимо указывать во всех запросах API к службе перевода документов.
  • Вы не можете использовать конечную точку, найденную на странице ключей и конечной точки ресурса портала Azure, или глобальную конечную точку переводчика—api.cognitive.microsofttranslator.com—для выполнения HTTP-запросов к переводу документов.

Заголовки запросов

Заголовки запроса.

Заголовки Description
Ocp-Apim-Subscription-Key Обязательный заголовок запроса

Коды состояния ответа

Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.

Код состояния Description
200 ОК. Возвращает список поддерживаемых форматов файлов глоссария.
500 Внутренняя ошибка сервера.
Другие коды состояния • Слишком много запросов
• Временный сервер недоступен

Получить ответ о поддерживаемых форматах глоссария

Базовый тип для возврата списка в API получения поддерживаемых форматов глоссария.

Успешный ответ на получение поддерживаемых форматов глоссария

Базовый тип для возврата списка в API получения поддерживаемых форматов глоссария.

Имя. Тип Описание
значение FileFormat [] FileFormat[] содержит перечисленные сведения.
value.contentTypes строка [] Поддерживаемые типы содержимого для данного формата.
value.defaultVersion строка Версия по умолчанию, если значение не указано.
value.fileExtensions строка [] Поддерживаемое расширение файла для данного формата.
value.format строка Название формата.
value.versions строка [] Поддерживаемая версия.

Отклик в случае ошибки

Имя. Тип Описание
кодом строка Перечисления, содержащие коды ошибок высокого уровня. Возможные значения:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Несанкционированного
message строка Получает сообщение об ошибке высокого уровня.
innerError InnerTranslationError Новый формат внутренней ошибки, соответствующий рекомендациям ПО API служб искусственного интеллекта Azure. Это сообщение об ошибке содержит обязательные свойства ErrorCode, message и необязательные свойства, сведения (пара "значение ключа"), внутреннюю ошибку (ее можно вложить).
innerError.code строка Получает строку с ошибкой кода.
innerError.message строка Получает сообщение об ошибке высокого уровня.
innerError.target строка Получает источник ошибки. Например, это будет documents или document id , если был недопустимый документ.

Примеры

Пример успешного ответа

Следующий объект JSON является примером успешного ответа.

{
    "value": [
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "defaultVersion": "1.2",
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ]
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ]
        }
    ]
}

Пример ответа с ошибкой

Следующий объект JSON является примером ответа с ошибкой. Схема для других кодов ошибок такая же.

Код состояния: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Следующие шаги

Воспользуйтесь информацией, приведенной в данном кратком руководстве, чтобы узнать больше об использовании перевода документов и клиентской библиотеки.