Tâche Traduction – Document

La tâche Traduire – Document vous permet de traduire un seul fichier de document en temps réel (de manière synchrone) à l'aide de Cloud Translation. Vous pouvez traduire directement des documents formatés tels que PDF et DOCX tout en conservant leur mise en forme et leur mise en page d'origine. Pour en savoir plus sur les formats de fichiers compatibles avec la traduction de documents, consultez la page Formats de fichiers compatibles.

Cloud Translation est un service Google Cloud qui vous permet de traduire du texte pour plus de 100 combinaisons linguistiques grâce à la détection automatique de la langue. Consultez la page Langues acceptées pour accéder à la liste.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Traduire – Document :

  1. Activer l'API Cloud Translation (translate.googleapis.com).

    Activer l'API Cloud Translation

  2. Créer un profil d'authentification L'intégration Apigee utilise un profil d'authentification pour se connecter à un point de terminaison d'authentification pour la tâche Traduire – Document.

    Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la page Accorder, modifier et révoquer des accès.

Configurer la tâche Traduire – Document

  1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
  2. Cliquez sur Développer > Intégrations.
  3. Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
    2. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
    3. Cliquez sur Créer.

    La page de conception d'intégration s'affiche.

  4. Dans la barre de navigation de la page de conception d'intégration, cliquez sur +Ajouter une tâche ou un déclencheur > Tâches pour afficher la liste des tâches disponibles.
  5. Cliquez sur l'élément Traduire – Document et placez-le dans le concepteur d'intégration.
  6. Cliquez sur l'élément Traduire – Document dans le concepteur pour afficher le volet de configuration de la tâche Traduire – Document.
  7. Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.

    Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.

  8. Accédez à l'Entrée de la tâche et configurez les champs d'entrée affichés à l'aide du tableau Paramètres d'entrée de la tâche suivant.

    Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.

Paramètres d'entrée des tâches

Le tableau suivant décrit les paramètres d'entrée de la tâche Traduire – Document :

Propriété Type de données Description
Région String Région dans laquelle vous souhaitez exécuter l'opération de traduction. Par exemple, us-central1.
ProjectsId Chaîne L'ID de votre projet Google Cloud.
Demande JSON Consultez la section Structure JSON de requête. Vous devez spécifier le champ mimeType de la requête JSON pour les traductions de documents intégrés.

Résultat de la tâche

La tâche Traduire – Document renvoie le document traduit, semblable à l'exemple de résultat suivant : 

{
    "documentTranslation": {
        "byteStreamOutputs": ["BYTE_STREAM"],
        "mimeType": "MIME_TYPE"
    },
    "model": "projects/[PROJECT_NUMBER]/locations/[LOCATION]/models/general/nmt"
}

Formats de fichiers acceptés

Cloud Translation accepte les types de fichiers d'entrée et les types de fichiers de sortie associés suivants. Pour plus d'informations sur les limites de taille des fichiers des documents, consultez la page Limites de taille des fichiers de document.

Entrées Type MIME du document Sortie
DOC application/msword DOC, DOCX
DOCX application/vnd.openxmlformats-officedocument.wordprocessingml.document DOCX
PDF application/pdf PDF, DOCX
PPT application/vnd.ms-powerpoint PPT, PPTX
PPTX application/vnd.openxmlformats-officedocument.presentationml.presentation PPTX
XLS application/vnd.ms-excel XLS, XLSX
XLSX application/vnd.openxmlformats-officedocument.spreadsheetml.sheet XLSX

Taille maximale des fichiers

Type de fichier Limites de taille
PDF Jusqu'à 20 Mo
PDF natif

(Le champ isTranslateNativePdfOnly doit être défini sur true)

Jusqu'à 20 Mo avec une limite de 300 pages
PDF scanné Jusqu'à 20 Mo avec une limite de 20 pages
Autres types de fichiers Jusqu'à 20 Mo sans limite de page

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.

Étapes suivantes

  1. Ajoutez des arêtes et conditions d'arêtes.
  2. Testez et publiez votre intégration.
  3. Configurez un déclencheur.
  4. Ajoutez une tâche de mappage de données.
  5. Consultez toutes les tâches des services Google Cloud.