enqueueFiles
API-Referenz zur Methode enqueueFiles zum Einreihen von Übersetzungsaufträgen für Dateien
Überblick
Die Methode enqueueFiles stellt Übersetzungsaufträge für zuvor hochgeladene Dateien in der General Translation API in die Warteschlange.
Diese Methode nimmt Dateireferenzen entgegen und erstellt Übersetzungsaufträge für die angegebenen Ziel-Locales.
const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });
const result = await gt.enqueueFiles(fileRefs, {
  sourceLocale: 'en',
  targetLocales: ['es', 'fr', 'de']
});Sie können Dateien erst zur Übersetzung in die Warteschlange stellen, nachdem sie hochgeladen wurden.
Referenzen
Parameter
| Name | Typ | Beschreibung | 
|---|---|---|
| files | FileUploadRef[] | Array von Dateiverweisen aus zuvor hochgeladenen Dateien | 
| options | EnqueueOptions | Konfigurationsoptionen für den Übersetzungsauftrag | 
EnqueueOptions
| Name | Type | Beschreibung | 
|---|---|---|
| sourceLocale? | string | Quell-Locale für die Übersetzung (standardmäßig die Instanz-sourceLocale) | 
| targetLocales? | string[] | Array der Ziel-Locales für die Übersetzung (standardmäßig die Instanz-targetLocale) | 
| publish? | boolean | Ob Übersetzungen nach Abschluss automatisch veröffentlicht werden sollen | 
| requireApproval? | boolean | Ob Übersetzungen vor der Veröffentlichung eine Freigabe erfordern | 
| modelProvider? | string | Konkreter KI-Modellanbieter für die Übersetzung | 
| force? | boolean | Neuübersetzung erzwingen, selbst wenn bereits Übersetzungen vorhanden sind | 
| timeout? | number | Zeitüberschreitung für Anfragen in Millisekunden | 
Rückgabe
Promise<EnqueueFilesResult> – Enthält Auftragsinformationen und Verarbeitungsdetails.
type EnqueueFilesResult = {
  translations: CompletedFileTranslationData[];
  data: Record<string, { fileName: string; versionId: string }>;
  locales: string[];
  message: string;
}| Eigenschaft | Typ | Beschreibung | 
|---|---|---|
| translations | CompletedFileTranslationData[] | Array mit Daten zu Übersetzungsaufträgen | 
| data | Record<string, { fileName: string; versionId: string }> | Zuordnung von Datei-IDs zu Dateimetadaten | 
| locales | string[] | Liste der Ziel-Locales für die Übersetzungsaufträge | 
| message | string | Statusmeldung der API | 
Beispiel
// (1) Eine GT-Instanz erstellen
const targetLocales = ['es', 'fr', 'de'];
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key',
});
// (2) Datei hochladen
const fileUpload = {
  content: fileContents,
  fileName: filePath,
  fileFormat: 'JSON',
  locale: 'en',
};
const files = [ { source: fileUpload } ];
const { uploadedFiles } = await gt.uploadSourceFiles(
  files,
  { sourceLocale: 'en' }
);
// (3) Übersetzungsauftrag für die Datei einreihen
const enqueueResult = await gt.enqueueFiles(
  uploadedFiles,
  {
  sourceLocale: 'en',
  targetLocales: targetLocales,
});
// (4) Warten, bis alle Übersetzungen fertig sind
let translationIds = [];
const statusQuery = Object.values(enqueueResult.data).flatMap(({fileName, versionId}) => {
  return targetLocales.map((locale) => ({locale, fileName, versionId}));
});
while (true) {
  const status = await gt.checkFileTranslations(statusQuery);
  if (status.translations.length === statusQuery.length) {
    translationIds = status.translations.map(translation => translation.id);
    break;
  }
  await new Promise(resolve => setTimeout(resolve, 1000));
}
// (5) Datei herunterladen
const result = await gt.downloadFileBatch(translationIds);Hinweise
- Der Dateiinhalt muss zuerst mit uploadSourceFileshochgeladen werden
- Übersetzungsjobs laufen asynchron – verwenden Sie checkFileTranslations, um den Fortschritt zu verfolgen
Nächste Schritte
- Siehe uploadSourceFiles, um Dateien vor dem Einreihen hochzuladen
- Siehe checkFileTranslations, um den Übersetzungsfortschritt zu überwachen
- Siehe downloadTranslatedFile, um abgeschlossene Übersetzungen herunterzuladen
Wie ist dieser Leitfaden?

