Method: projects.locations.translateDocument

Traduit des documents en mode synchrone.

Requête HTTP

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

Paramètres de chemin

Paramètres
parent

string

Obligatoire. Emplacement pour effectuer un appel régional.

Format: projects/{project-number-or-id}/locations/{location-id}.

Pour les appels globaux, utilisez projects/{project-number-or-id}/locations/global ou projects/{project-number-or-id}.

Un emplacement non global est requis pour les requêtes utilisant des modèles AutoML ou des glossaires personnalisés.

Les modèles et les glossaires doivent se trouver dans la même région (avoir le même ID d'emplacement). 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,
  "targetLanguageCode": string,
  "documentInputConfig": {
    object (DocumentInputConfig)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Champs
sourceLanguageCode

string

Facultatif. Code de langue ISO-639 du document d'entrée, si connu, par exemple "en-US" ou "sr-Latn". Les codes de langue compatibles sont listés dans la section Compatibilité linguistique. Si la langue source n'est pas spécifiée, l'API tente de l'identifier automatiquement et la renvoie dans la réponse. La langue source doit être spécifiée si la requête contient un glossaire ou un modèle personnalisé.
targetLanguageCode

string

Obligatoire. Code de langue ISO-639 à utiliser pour la traduction du document d'entrée, défini sur l'un des codes de langue listés dans la section Compatibilité linguistique.
documentInputConfig

object (DocumentInputConfig)

Obligatoire. Configurations d'entrée.
glossaryConfig

object (TranslateTextGlossaryConfig)

Facultatif. Glossaire à appliquer. Le glossaire doit se trouver dans la même région (avoir le même ID d'emplacement) que le modèle. Sinon, une erreur INVALID_ARGUMENT (400) est renvoyée.

L'autorisation IAM suivante est requise pour la ressource indiquée glossaryConfig :

  • cloudtranslate.glossaries.docPredict

Corps de la réponse

Message de réponse du document traduit.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "documentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryDocumentTranslation": {
    object (DocumentTranslation)
  },
  "glossaryConfig": {
    object (TranslateTextGlossaryConfig)
  }
}
Champs
documentTranslation

object (DocumentTranslation)

Document traduit.
glossaryDocumentTranslation

object (DocumentTranslation)

Résultat de la traduction du document si un glossaire est fourni dans la requête. Il peut être identique à [TranslateDocumentResponse.document_translation] si aucun terme de glossaire ne s'applique.
glossaryConfig

object (TranslateTextGlossaryConfig)

Le glossaryConfig utilisé pour cette traduction.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

DocumentInputConfig

Configuration d'entrée d'une requête de traduction de document.

Représentation JSON 
{
  "mimeType": string,
  "content": string,
  "S3Source": {
    object (S3Source)
  }
}
Champs
mimeType

string

Spécifie le type MIME du document d'entrée.

S'il n'est pas spécifié, il est déterminé à l'aide de l'extension de fichier pour les fichiers S3Source fournis. Pour un fichier fourni via un contenu d'octets, le type MIME doit être fourni.

Les types MIME actuellement compatibles sont les suivants :

  • application/pdf
  • application/msword
  • application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • application/vnd.ms-powerpoint
  • application/vnd.openxmlformats-officedocument.presentationml.presentation
  • application/vnd.ms-excel
  • application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Supported file formats are:

  • PDF
  • DOC
  • DOCX
  • PPT
  • PPTX
  • XLS
  • XLSX
content

string (bytes format)

Contenu du document représenté sous forme de flux d'octets.

Chaîne encodée en base64.
S3Source

object (S3Source)

Emplacement de stockage du contenu d'entrée.

DocumentTranslation

Message de document traduit.

Représentation JSON 
{
  "byteStreamOutputs": [
    string
  ],
  "mimeType": string,
  "detectedLanguageCode": string
}
Champs
byteStreamOutputs[]

string (bytes format)

Tableau de documents traduits. Pour le moment, sa taille devrait être de 1. À l'avenir, nous pourrons générer plusieurs documents traduits pour d'autres types de formats de fichiers.

Chaîne encodée en base64.
mimeType

string

Type MIME du document traduit.
detectedLanguageCode

string

Langue détectée pour le document d'entrée. Si l'utilisateur n'a pas fourni la langue source pour le document d'entrée, ce champ contient le code de langue détecté automatiquement. Si la langue source a été transmise, la détection automatique de la langue n'a pas lieu et ce champ est vide.