Obtenir les formats de glossaire pris en charge

Service
de référence : Traduction de documentation Azure AI
Version de l’API : v1.1

La méthode Get (pour les formats de glossaire pris en charge) retourne une liste des formats de glossaires pris en charge par le service Traduction de documentation. La liste comprend l’extension de fichier commune utilisée.

URL de la demande

Envoyez une demande GET à :

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

Découvrez comment déterminer votre nom de domaine personnalisé.

Important

• Toutes les requêtes d’API adressées au service Traduction de documentation nécessitent un point de terminaison de domaine personnalisé.
• Vous ne pouvez pas utiliser le point de terminaison qui se trouve dans la page Clés et point de terminaison de votre ressource du portail Azure, ni le point de terminaison du traducteur global (api.cognitive.microsofttranslator.com) pour soumettre des requêtes HTTP au service Traduction de documentation.

En-têtes de requête

Les en-têtes de requête sont les suivants :

headers	Description
Ocp-Apim-Subscription-Key	En-tête de requête obligatoire

Codes d’état de réponse

Voici les codes d’état HTTP qu’une demande peut retourner.

Code d’état	Description
200	OK. Retourne la liste des formats de fichiers de glossaires pris en charge.
500	Erreur interne du serveur.
Autres codes d’état	• Trop de demandes • Serveur temporaire indisponible

Réponse de get supported glossary formats

Type de base pour le retour de l’API get supported glossary formats.

Réponse positive de get supported glossary formats

Type de base pour le retour de l’API get supported glossary formats.

Nom	Type	Description
value	FileFormat []	FileFormat[] contient les détails listés ci-dessous.
value.contentTypes	string []	Content-Types pris en charge pour ce format.
value.defaultVersion	string	Version par défaut si aucune n’est spécifiée.
value.fileExtensions	string []	Extension de fichier prise en charge pour ce format.
value.format	string	Nom du format.
value.versions	string []	Version prise en charge.

Réponse d’erreur

Nom	Type	Description
code	string	Enums contenant des codes d’erreur généraux. Valeurs possibles : • InternalServerError • InvalidArgument • InvalidRequest • RequestRateTooHigh • ResourceNotFound • ServiceUnavailable •Non autorisée
message	string	Obtient un message d’erreur général.
innerError	InnerTranslationError	Nouveau format d’erreur interne conforme aux instructions de l’API Azure AI services. Ce message d’erreur contient les propriétés requises ErrorCode, message et cible de propriétés facultatives, détails(paire clé valeur), erreur interne(il peut être imbriqué).
innerError.code	string	Obtient la chaîne d’erreur de code.
innerError.message	string	Obtient un message d’erreur général.
innerError.target	string	Obtient la source de l’erreur. Par exemple, ce serait documents ou document id s’il y avait un document non valide.

Exemples

Exemple de réponse positive

L’objet JSON suivant est un exemple de réponse positive.

{
    "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"
            ]
        }
    ]
}

Exemple de réponse d’erreur

L’objet JSON suivant est un exemple de réponse d’erreur. Le schéma des autres codes d’erreur est le même.

Code d’état : 500

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

Étapes suivantes

Suivez notre guide de démarrage rapide pour en savoir plus sur l’utilisation du service Traduction de document et de la bibliothèque de client.

Bien démarrer avec la traduction de documentation