Google Translate Connector

reshuffle-google-translate-connector

Code | npm | Code sample

npm install reshuffle-google-connectors

This connector uses Official Node Google Translate Client package.

Reshuffle Google Translate Connector

ES6 import: import { GoogleTranslateConnector } from 'reshuffle-google-connectors'

This is a Reshuffle connector that provides an Interface to the Google Translate Client.

Setup

You need a project in Google Cloud that has the Cloud Translation API enabled and credentials to make authenticated calls. See more details here

Configuration Options:

interface GoogleTranslateConnectorConfigOptions {
  credentials: string
}

Table of Contents

Translate text - translateText

Translate text array - translateTexts

SDK

Connector events

N/A

Connector actions

translateText

Returns the translated text response from source to target language

translateText(
    text: string,
    source: string,    // e.g. 'en',
    target: string,    // e.g. 'fr',    
    location: string,  // Project's location like 'global' or 'us-central1'
    mimeType: string,  // mime types: text/plain, text/html
  ): Promise<string | undefined | null>

Example

  const connector = new GoogleTranslateConnector(app, { credentials: credentials, location: 'global' })
  const result = await connector.translateText(['Hello world', 'Text to translate'], 'en', 'fr', 'global', 'text/plain' )
  console.log(`Translation: ${result}`)
  

translateTexts

Returns the translated array text response from source to target language

translateTexts(
    text: string[],
    source: string,    // e.g. 'en',
    target: string,    // e.g. 'fr',    
    location: string,  // Project's location like 'global' or 'us-central1'
    mimeType: string,  // mime types: text/plain, text/html
  ): Promise<google.cloud.translation.v3.TranslateTextResponse>

Example

  const connector = new GoogleTranslateConnector(app, { credentials: credentials, location: 'global' })
  const result = await connector.translateTexts(['Hello world', 'Text to translate'], 'en', 'fr', 'global', 'text/plain' )
  for (const translation of result.translations) {
    console.log(`Translation: ${translation.translatedText}`)
  }

sdk

Returns the Google Translate Service Client

// See: https://googleapis.dev/nodejs/translate/latest/v3.TranslationServiceClient.html
sdk(): v3.TranslationServiceClient

Example

  const [result] = await connector.sdk().translateText({
      parent: `projects/<project-id>/locations/<location>`,
      contents: ['Hello world', 'Text to translate'],
      mimeType: 'text/plain',
      sourceLanguageCode: 'en',
      targetLanguageCode: 'fr',
  })
  for (const translation of result.translations) {
      console.log(`Translation: ${translation.translatedText}`)
  }

<project-id> - Google Cloud Project Id, see https://cloud.google.com/resource-manager/docs/creating-managing-projects

<location> - Project's location like 'global' or 'us-central1'