Translator 3.0: Jazyky

Získá sadu jazyků, které jsou aktuálně podporovány jinými operacemi služby Translator.

Adresa URL požadavku

Odešlete požadavek GET do:

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

Pro virtuální sítě použijte vlastní koncový bod domény:

https://<your-custom-domain>.cognitiveservices.azure.com/languages?api-version=3.0

Další informace najdete v tématu Podpora virtuální sítě pro vybranou síťovou a privátní konfiguraci koncového bodu a podporu služby Translator.

Parametry požadavku

Parametry požadavku předané v řetězci dotazu jsou:

Viz text odpovědi.

Hlavičky požadavku jsou:

K získání jazykových prostředků není vyžadováno ověřování.

Text odpovědi

Klient pomocí parametru scope dotazu definuje, které skupiny jazyků se mají vypsat.

• scope=translation poskytuje jazyky podporované pro překlad textu z jednoho jazyka do jiného jazyka;

• scope=transliteration poskytuje možnosti pro převod textu v jednom jazyce z jednoho skriptu do jiného skriptu;

• scope=dictionary poskytuje páry jazyka, pro které Dictionary operace vracejí data.

Klient může současně načíst několik skupin zadáním seznamu názvů oddělených čárkami. Například scope=translation,transliteration,dictionary by se vrátily podporované jazyky pro všechny skupiny.

Úspěšná odpověď je objekt JSON s jednou vlastností pro každou požadovanou skupinu:

{
    "translation": {
        //... set of languages supported to translate text (scope=translation)
    },
    "transliteration": {
        //... set of languages supported to convert between scripts (scope=transliteration)
    },
    "dictionary": {
        //... set of languages supported for alternative translations and examples (scope=dictionary)
    }
}

Hodnota každé vlastnosti je následující.

• translation vlastnost

  Hodnota translation vlastnosti je slovník párů (klíč, hodnota). Každý klíč je značka jazyka BCP 47. Klíč identifikuje jazyk, ze kterého lze text přeložit nebo z něho přeložit. Hodnota přidružená ke klíči je objekt JSON s vlastnostmi, které popisují jazyk:

  • name: Zobrazovaný název jazyka v národním prostředí požadovaném prostřednictvím Accept-Language hlavičky.

  • nativeName: Zobrazovaný název jazyka v nativním národním prostředí pro tento jazyk.

  • dir: Směrovost, která je rtl určená pro jazyky se zápisem zprava doleva nebo ltr pro jazyky se zápisem zleva doprava.

  Příkladem je:

  {
    "translation": {
      ...
      "fr": {
        "name": "French",
        "nativeName": "Français",
        "dir": "ltr"
      },
      ...
    }
  }
  

• transliteration vlastnost

  Hodnota transliteration vlastnosti je slovník párů (klíč, hodnota). Každý klíč je značka jazyka BCP 47. Klíč identifikuje jazyk, pro který lze text převést z jednoho skriptu do jiného skriptu. Hodnota přidružená ke klíči je objekt JSON s vlastnostmi, které popisují jazyk a jeho podporované skripty:

  • name: Zobrazovaný název jazyka v národním prostředí požadovaném prostřednictvím Accept-Language hlavičky.

  • nativeName: Zobrazovaný název jazyka v nativním národním prostředí pro tento jazyk.

  • scripts: Seznam skriptů, ze které se mají převést. Každý prvek scripts seznamu má vlastnosti:

    • code: Kód identifikující skript.

    • name: Zobrazovaný název skriptu v národním prostředí požadovaném prostřednictvím Accept-Language hlavičky.

    • nativeName: Zobrazovaný název jazyka v nativním národním prostředí pro jazyk.

    • dir: Směrovost, která je rtl určená pro jazyky se zápisem zprava doleva nebo ltr pro jazyky se zápisem zleva doprava.

    • toScripts: Seznam skriptů, na které lze převést text. Každý prvek toScripts seznamu má vlastnosti code, name, nativeNamea dir jak je popsáno výše.

  Příkladem je:

  {
    "transliteration": {
      ...
      "ja": {
        "name": "Japanese",
        "nativeName": "日本語",
        "scripts": [
          {
            "code": "Jpan",
            "name": "Japanese",
            "nativeName": "日本語",
            "dir": "ltr",
            "toScripts": [
              {
                "code": "Latn",
                "name": "Latin",
                "nativeName": "ラテン語",
                "dir": "ltr"
              }
            ]
          },
          {
            "code": "Latn",
            "name": "Latin",
            "nativeName": "ラテン語",
            "dir": "ltr",
            "toScripts": [
              {
                "code": "Jpan",
                "name": "Japanese",
                "nativeName": "日本語",
                "dir": "ltr"
              }
            ]
          }
        ]
      },
      ...
    }
  }
  

• dictionary vlastnost

  Hodnota dictionary vlastnosti je slovník párů (klíč, hodnota). Každý klíč je značka jazyka BCP 47. Klíč identifikuje jazyk, pro který jsou k dispozici alternativní překlady a back-translationy. Hodnota je objekt JSON, který popisuje zdrojový jazyk a cílové jazyky s dostupnými překlady:

  • name: Zobrazovaný název zdrojového jazyka v národním prostředí požadovaném prostřednictvím Accept-Language hlavičky.

  • nativeName: Zobrazovaný název jazyka v nativním národním prostředí pro tento jazyk.

  • dir: Směrovost, která je rtl určená pro jazyky se zápisem zprava doleva nebo ltr pro jazyky se zápisem zleva doprava.

  • translations: Seznam jazyků s alterativními překlady a příklady pro dotaz vyjádřený ve zdrojovém jazyce. Každý prvek translations seznamu má vlastnosti:

    • name: Zobrazovaný název cílového jazyka v národním prostředí požadovaném prostřednictvím Accept-Language hlavičky.

    • nativeName: Zobrazovaný název cílového jazyka v nativním národním prostředí pro cílový jazyk.

    • dir: Směrovost, která je rtl určená pro jazyky se zápisem zprava doleva nebo ltr pro jazyky se zápisem zleva doprava.

    • code: Kód jazyka identifikující cílový jazyk.

  Příkladem je:

  "es": {
    "name": "Spanish",
    "nativeName": "Español",
    "dir": "ltr",
    "translations": [
      {
        "name": "English",
        "nativeName": "English",
        "dir": "ltr",
        "code": "en"
      }
    ]
  },
  

Struktura objektu odpovědi se nezmění bez změny ve verzi rozhraní API. U stejné verze rozhraní API se seznam dostupných jazyků může v průběhu času měnit, protože Microsoft Translator neustále rozšiřuje seznam jazyků podporovaných jeho službami.

Seznam podporovaných jazyků se často nemění. Aby se ušetřila šířka pásma sítě a zlepšila rychlost odezvy, měla by klientská aplikace zvážit ukládání prostředků jazyka do mezipaměti a odpovídající značku entity (ETag). Potom může klientská aplikace pravidelně (například jednou za 24 hodin) dotazovat službu, aby načítá nejnovější sadu podporovaných jazyků. Předání aktuální ETag hodnoty v If-None-Match poli záhlaví umožňuje službě optimalizovat odpověď. Pokud se prostředek nezmění, vrátí služba stavový kód 304 a prázdný text odpovědi.

Hlavičky odpovědi

Stavové kódy odpovědí

Níže jsou uvedené možné stavové kódy HTTP, které požadavek vrátí.

Pokud dojde k chybě, požadavek vrátí také chybovou odpověď JSON. Kód chyby je 6místné číslo, které kombinuje 3místný stavový kód HTTP následovaný 3místným číslem, aby se chyba dále kategorizovala. Běžné kódy chyb najdete na referenční stránce služby Translator v3.

Příklady

Následující příklad ukazuje, jak načíst jazyky podporované pro překlad textu.

curl "https://api.cognitive.microsofttranslator.com/languages?api-version=3.0&scope=translation"