Traduire des documents Word ou Excel avec l'API REST

Aujourd’hui, nous nous penchons sur l’API REST de traduction qui peut traduire des documents Word et Excel dans d’autres langues. Avec GroupDocs.Translation Cloud, n’importe quel document peut être traduit de l’anglais vers le chinois, le français, l’allemand, l’italien, le russe ou l’espagnol et vice versa. Voici donc les paires de langues dans lesquelles la traduction peut se faire.

• Anglais vers chinois et chinois vers anglais
• Anglais vers français et français vers anglais
• Anglais vers allemand et allemand vers anglais
• Anglais vers italien et italien vers anglais
• Anglais vers russe et russe vers anglais
• Anglais vers espagnol et espagnol vers anglais

Lors de la traduction, l’API s’occupe des paragraphes, des tableaux, des en-têtes. les pieds de page, les notes de bas de page, les notes de fin et même les légendes d’image de vos documents de traitement de texte. Pour les feuilles de calcul Excel, il prend en charge les cellules, les graphiques, les tableaux, ainsi que les tableaux croisés dynamiques.

Comment traduire un document Word ou Excel avec l’API REST

Cet article vous guidera vers le flux de traduction des documents Word ou Excel à l’aide de l’API REST. Voici les étapes à suivre :

1. Télécharger le document à traduire
2. Traduire le document dans différentes langues
3. Télécharger le document traduit

Télécharger le document à traduire

Téléchargez votre fichier sur le stockage cloud à l’aide du tableau de bord ou de l’interface utilisateur Swagger pour l’API. Je vais vous montrer comment télécharger sur le Cloud en utilisant les deux options.

Téléchargez votre fichier à l’aide du tableau de bord

Vous pouvez télécharger directement votre document sur le Cloud à l’aide du tableau de bord. Tout ce dont vous avez besoin est de créer un compte sur le serveur. Cliquez simplement sur le bouton Télécharger un fichier et sélectionnez votre document à télécharger.

Téléchargez votre fichier à l’aide de l’interface utilisateur Swagger

L’autre option consiste à utiliser l’interface utilisateur Swagger pour télécharger votre document à traduire à partir de ce lien.

Voici la réponse du serveur après le téléchargement réussi.

{
  "uploaded": \[
    "document.docx"
  \],
  "errors": \[\]
}

Traduire des documents Word ou Excel dans différentes langues avec l’API REST

Une simple commande cURL vous permettra de traduire votre document téléchargé. Ici, je traduis le document Word de l’anglais vers le français. Le fichier document.docx a été téléchargé plus tôt dans myFolder sous MyStorage. J’ai l’intention d’enregistrer le document traduit en tant que translateDoc.docx dans le même dossier, c’est-à-dire myFolder.

curl -X POST "https://api.groupdocs.cloud/v1.0/translation/runTranslationTask" \\
-H "accept: application/json" \\
-H "authorization: Bearer TOKEN" \\
-H "Content-Type: application/json" \\
-H "x-aspose-client: Containerize.Swagger" \\
-d "'\[ { \\"format\\":\\"docx\\", \\"pair\\":\\"en-fr\\", \\"name\\":\\"document.docx\\", \\"folder\\":\\"myFolder\\", \\"savepath\\":\\"myFolder\\", \\"savefile\\":\\"translatedDoc.docx\\", \\"storage\\":\\"MyStorage\\" }\]'"

Je voulais traduire un document de l’anglais vers le français, j’ai donc utilisé la paire comme “en-fr”. Vous pouvez utiliser la paire appropriée en fonction de votre besoin parmi les suivantes :

J’ai utilisé “docx” pour le format de fichier du document. Vous pouvez utiliser selon votre document Word source ou votre feuille de calcul Excel parmi les éléments suivants :

Si vous souhaitez utiliser l’interface utilisateur Swagger de la référence API à translate, vous pouvez simplement fournir les valeurs requises dans la demande de traduction et exécuter la commande.

Que vous ayez exécuté la commande cURL de n’importe où ou que vous utilisiez l’interface utilisateur Swagger, dans les deux cas, voici la réponse du serveur après une traduction réussie. Le fichier traduit sera stocké dans le dossier mentionné en tant que sortie.

{
    "error": "",
    "status": "ok",
    "message": "word file saved successfully"
}

Télécharger le document traduit

Le document traduit peut être facilement téléchargé à partir du stockage Cloud. Vous pouvez utiliser la commande cURL suivante, Swagger UI, ou utiliser le tableau de bord pour télécharger le fichier.

Télécharger avec cURL

curl -X GET "https://api.groupdocs.cloud/v1.0/translation/storage/file/myFolder%5CtranslatedDoc.docx?storageName=MyStorage&versionId=VsBZptoyKpehpqmUCsjuoA6jVBGsXk4B" \\
-H "accept: multipart/form-data" \\
-H "authorization: Bearer TOKEN" \\
-H "x-aspose-client: Containerize.Swagger"

Télécharger à l’aide de l’interface utilisateur Swagger

Swagger UI for download vous fournira le lien de téléchargement du téléchargement traduit. Vous pouvez cliquer sur le lien et enregistrer le fichier à l’emplacement de votre choix.

Télécharger à l’aide du tableau de bord

Le tableau de bord vous permet de sélectionner le ou les fichiers, puis vous pouvez les télécharger à l’aide du bouton Télécharger.

Vous pouvez en savoir plus sur l’API à partir de la documentation ou Parlons plus @ Forum d’assistance gratuit.