Traduire des fichiers au moyen de l’API globalese by memoQ

Pages utiles

Documentation détaillée des points d’accès de l’API : API v3globalese by memoQ

La documentation pertinente destinée aux utilisateurs finaux expliquant le flux de travail : Traduction de document

Exigences générales

  1. Toutes les demandes doivent être authentifiées.

  2. Les en-têtes Content-Type et Content-Length appropriés doivent toujours être définis lors de l’envoi de charges utiles dans les requêtes POST/PUT/PATCH.

Définitions

globalese by memoQ instance

Le système de l’utilisateur globalese by memoQ, accessible au moyen d’une URL telle que https://acme.globalese.ai ou d’une URL similaire.

Moteur

Un modèle de traduction automatique capable de traduire d’une langue à une autre.

Groupe

Plusieurs groupes peuvent être créés et utilisés dans globalese by memoQ. Un moteur appartient toujours à un groupe précis. Les utilisateurs peuvent être membres de plusieurs groupes et bénéficier de droits d’accès différents dans chacun d’eux.

Projet

Un ensemble de fichiers à traduire au moyen des mêmes paramètres, c’est-à-dire les langues, le groupe et le moteur

Les projets de traduction faisant intervenir plusieurs langues sources ou langues cibles nécessiteront plusieurs projets dans globalese by memoQ.

Ce dont vous aurez besoin pour commencer

URL de base de l’instanceglobalese by memoQ

L’URL de votre instance globalese by memoQ, p. ex. https://acme.globalese.ai. Les demandes doivent être envoyées à cette URL de base + /api/v3 + le point de terminaison.

Nom d’utilisateur et clé d’API

Les deux peuvent être trouvés sur la page de profil d’un utilisateur. Tous les appels effectués vers les points d’accès API décrits ci-dessous doivent être authentifiés au moyen d’un nom d’utilisateur globalese by memoQ valide et d’une clé API valide.

Procédure suggérée

Résumé:

  1. Créer un projet

  2. Téléverser des fichiers

  3. Créer des projets de traduction

  4. Vérifier les états du projet et des fichiers

  5. Télécharger les fichiers traduits

  6. Nettoyer

1. Créer un projet

Consultez GET /groups pour afficher la liste des groupes et GET /engines pour afficher la liste des moteurs.

Notes :

  1. Le fait d’être membre d’un groupe ne signifie pas nécessairement que l’on dispose des droits d’accès requis pour traduire des fichiers. Pour les étapes décrites ici, l’utilisateur authentifié doit détenir les droits d’accès MANAGE_PROJECTS au sein du groupe choisi.

  2. Le projet doit être créé dans le même groupe auquel appartient le moteur choisi.

  3. L’état du moteur sélectionné est important. Les moteurs sont prêts à être traduits uniquement si la propriété actions.translate dans la réponse GET /engines est true.

    Selon la propriété published, certains utilisateurs peuvent ou non être en mesure d’utiliser un moteur pour les traductions. Voir Moteurs de publication

  4. Un projet ne peut se voir attribuer qu’un seul moteur. Le moteur peut être modifié pour un projet existant, bien que cela ne devrait pas être nécessaire.

Demandes :

GET /moteurs
GET /groupes
POST /projets

2. Téléverser des fichiers

Les fichiers doivent être téléversés un à la fois.

Nous vous recommandons de regrouper les fichiers d’un même projet dans un seul projet globalese by memoQ correspondant. Le projet globalese by memoQ devrait idéalement exister pendant toute la durée de vie du projet source (ou du projet dans l’outil de TAO), afin de permettre le traitement de tout fichier nouvellement ajouté ou réimporté dans le même projet globalese by memoQ.

Nous ne recommandons pas de créer un projet par fichier envoyé à globalese by memoQ si les fichiers se trouvent dans le même projet à la source, car cela entraîne une surcharge inutile et des appels d’API supplémentaires.

Si un fichier est réimporté dans le projet, il est recommandé de supprimer l’ancienne version du fichier dans le projet globalese by memoQ et de téléverser de nouveau le fichier.

Consultez la liste des formats de fichiers pris en charge ici : Intégration

Demandes :

POST /projets/{projectId}/fichiers

3. Créer des projets de traduction

Nous recommandons de déclencher la traduction des fichiers d’un projet en un seul lot, c’est-à-dire de créer les tâches de traduction pour chaque fichier l’une après l’autre, une à la fois, immédiatement après avoir reçu une réponse à la demande précédente.

Demandes :

POST /emplois/traduction

4. Vérifier les états du projet et des fichiers

Ce comportement devrait changer à l’avenir.

Pour l’instant, il est impossible de suivre l’état des travaux de traduction, mais de nouveaux points d’accès sont prévus pour permettre cette fonctionnalité. À l’avenir, au lieu de suivre les états des fichiers, il faudra suivre les états des tâches.

Suivre l’état de l’ensemble du projet ou l’état des fichiers individuels. Nous ne recommandons pas d’envoyer plus d’une demande d’interrogation par minute.

Demandes :

GET /projects/{projectId}/files/{fileId}
GET /projects/{projectId}/files
GET /projects/{projectId}

5. Télécharger les fichiers traduits

Un fichier peut être téléchargé lorsque son état passe à translated. Si vous effectuez le suivi au niveau du projet, tous les fichiers du projet sont prêts à être téléchargés lorsque l’état du projet passe à translated.

Demandes :

GET /projects/{projectId}/files/{fileId}/translated-file
GET /projects/{projectId}/translated-files

6. Nettoyer

Une fois les fichiers traduits téléchargés, nous vous recommandons de supprimer tous les fichiers et projets de globalese by memoQ afin d’éviter qu’ils y demeurent (c’est-à-dire qu’ils occupent inutilement de l’espace) indéfiniment dans globalese by memoQ.

Demandes :

SUPPRIMER /projects/{projectId}/files/{fileId}
SUPPRIMER /projects/{projectId}