Method: projects.locations.batchTranslateDocument

Traduit un grand volume de documents en mode de traitement par lot asynchrone. Cette fonction fournit une sortie en temps réel, au fur et à mesure du traitement des entrées. Si l'appelant annule une requête, les résultats partiels (pour un fichier d'entrée, c'est tout ou rien) peuvent toujours être disponibles à l'emplacement de sortie spécifié.

Cet appel renvoie immédiatement une réponse. Vous pouvez utiliser google.longrunning.Operation.name pour interroger l'état de l'appel.

Requête HTTP

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{parent}:batchTranslateDocument

Paramètres de chemin

Paramètres
parent

string

Obligatoire. Emplacement pour passer un appel.

Format : projects/{project-id}.

L'emplacement global n'est pas compatible avec la traduction par lots.

Seuls les glossaires d'une même région (avec le même ID de localisation) peuvent être utilisés. Sinon, une erreur INVALID_ARGUMENT (400) est renvoyée.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "sourceLanguageCode": string,
  "targetLanguageCodes": [
    string
  ],
  "inputConfigs": [
    {
      object (BatchDocumentInputConfig)
    }
  ],
  "outputConfig": {
    object (BatchDocumentOutputConfig)
  },
  "glossaries": {
    string: {
      object (TranslateTextGlossaryConfig)
    },
    ...
  },
  "formatConversions": {
    string: string,
    ...
  },
  "customizedAttribution": string,
  "enableShadowRemovalNativePdf": boolean,
  "enableRotationCorrection": boolean
}
Champs
sourceLanguageCode

string

Obligatoire. Code de langue ISO-639 du document d'entrée, si connu (par exemple, "en-US" ou "sr-Latn"). Les codes de langue acceptés sont listés dans Langues acceptées.
targetLanguageCodes[]

string

Obligatoire. Code de langue ISO-639 à utiliser pour la traduction du document d'entrée. Indiquez jusqu'à 10 codes de langue.
inputConfigs[]

object (BatchDocumentInputConfig)

Obligatoire. Configurations d'entrée. Le nombre total de fichiers correspondants doit être inférieur ou égal à 100. La taille totale du contenu à traduire doit être inférieure ou égale à 100 millions de points de code Unicode. Les fichiers doivent utiliser l'encodage UTF-8.
outputConfig

object (BatchDocumentOutputConfig)

Obligatoire. Configuration de sortie. Si deux configurations d'entrée correspondent au même fichier (c'est-à-dire au même chemin d'entrée), nous ne générons pas de sortie pour les entrées en double.
glossaries

map (key: string, value: object (TranslateTextGlossaryConfig))

Facultatif. Glossaires à appliquer. Elle est indexée par code de langue cible.
formatConversions

map (key: string, value: string)

Facultatif. Table de conversion du format de fichier appliquée à tous les fichiers d'entrée. La clé du mappage est le type MIME d'origine. La valeur de mappage correspond au type MIME cible des documents traduits.

La conversion des formats de fichiers suivants est possible : application/pdf vers application/vnd.openxmlformats-officedocument.wordprocessingml.document.

Si vous ne spécifiez rien, les fichiers de sortie seront au même format que le fichier d'origine.
customizedAttribution

string

Facultatif. Cet indicateur permet de prendre en charge l'attribution personnalisée par l'utilisateur. Si aucune valeur n'est spécifiée, la valeur par défaut est Machine Translated by Google. L'attribution personnalisée doit respecter les règles définies sur la page https://cloud.google.com/translate/attribution#attribution_and_logos.
enableShadowRemovalNativePdf

boolean

Facultatif. Si la valeur est "true", le serveur de suppression de texte est utilisé pour supprimer le texte en ombre de l'image de fond pour la traduction native de PDF. La fonctionnalité de suppression des ombres ne peut être activée que lorsque isTranslateNativePdfOnly: false && pdfNativeOnly: false
enableRotationCorrection

boolean

Facultatif. Si la valeur est "true", active la correction de la rotation automatique dans DVS.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

BatchDocumentInputConfig

Configuration d'entrée pour la requête locations.batchTranslateDocument.

Représentation JSON 
{

  // Union field source can be only one of the following:
  "s3_source": {
    object (s3Source)
  }
  // End of list of possible types for union field source.
}
Champs
Champ d'union source. Spécifiez l'entrée. source ne peut être qu'un des éléments suivants :
s3_source

object (s3Source)

Emplacement du bucket S3 pour l'entrée source. Il peut s'agir d'un seul fichier ou d'un caractère générique.

Le type MIME du fichier est déterminé en fonction de son extension. Voici les types MIME acceptés :

  • pdf : application/pdf
  • docx : application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • pptx: application/vnd.openxmlformats-officedocument.presentationml.presentation
  • xlsx : application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

La taille maximale des fichiers acceptée pour .docx, .pptx et .xlsx est de 100 Mo. La taille de fichier maximale acceptée pour .pdf est de 1 Go et la limite de pages est de 1 000. La taille maximale des fichiers d'entrée est de 1 Go.

BatchDocumentOutputConfig

Configuration de sortie pour la requête locations.batchTranslateDocument.

Représentation JSON 
{

  // Union field destination can be only one of the following:
  "s3_destination": {
    object (s3Destination)
  }
  // End of list of possible types for union field destination.
}
Champs
Champ d'union destination. Destination de la sortie. Le répertoire de destination fourni doit exister et être vide. destination ne peut être qu'un des éléments suivants :
s3_destination

object (s3Destination)

Bucket S3 de destination pour le contenu généré. Pour chaque document d'entrée, nous générons au maximum 2 * n fichiers de sortie. (n correspond au nombre de codes de langue cible dans BatchTranslateDocumentRequest).

targetLanguageCode est fourni dans la requête.