A Flatfile Listener plugin for field translation using the Google Translate API
npm i @flatfile/plugin-convert-translate
The @flatfile/plugin-convert-translate
plugin enables field translation using the Google Translate API. It supports batch translation, configurable options, and both automatic and manual translation workflows. The plugin creates new fields for translated text and includes error handling.
Event Type:
record:*
Event Type: listener.on('commit:created')
Supported Field Types: string
The convertTranslatePlugin
function accepts a configuration object with the following properties:
sourceLanguage
(string): The source language code (e.g., 'en' for English)targetLanguage
(string): The target language code (e.g., 'es' for Spanish)sheetSlug
(string): The slug of the sheet where translation should be appliedfieldsToTranslate
(string[]): An array of field names to be translatedprojectId
(string): Your Google Cloud project IDkeyFilename
(string): The path to your Google Cloud service account key fileTo install the plugin, run the following command in your project directory:
npm install @flatfile/plugin-convert-translate
import { FlatfileListener } from '@flatfile/listener';
import { translatePlugin } from '@flatfile/plugin-convert-translate';
export default function (listener: FlatfileListener) {
listener.use(translatePlugin({
sourceLanguage: 'en',
targetLanguage: 'es',
sheetSlug: 'products',
fieldsToTranslate: ['name', 'description'],
projectId: 'your-google-cloud-project-id',
keyFilename: '/path/to/your/google-cloud-key.json'
}))
}