Translation#

With Google Cloud Translation, you can dynamically translate text between thousands of language pairs. The Google Cloud Translation API lets websites and programs integrate with Google Cloud Translation programmatically. Google Cloud Translation is available as a paid service. See the Pricing and FAQ pages for details.

Authentication / Configuration#

  • Use Client objects to configure your applications.
  • Client objects hold a connection to the Cloud Translation service.

Methods#

To create a client:

>>> from google.cloud import translate
>>> client = translate.Client()

By default, the client targets English when doing detections and translations, but a non-default value can be used as well:

>>> from google.cloud import translate
>>> client = translate.Client(target_language='es')

The Google Cloud Translation API has three supported methods, and they map to three methods on a client: get_languages(), detect_language() and translate().

To get a list of languages supported by the Google Cloud Translation API

>>> from google.cloud import translate
>>> client = translate.Client()
>>> client.get_languages()
[
    {
        'language': 'af',
        'name': 'Afrikaans',
    },
     ...
]

To detect the language that some given text is written in:

>>> from google.cloud import translate
>>> client = translate.Client()
>>> client.detect_language(['Me llamo', 'I am'])
[
    {
        'confidence': 0.25830904,
        'input': 'Me llamo',
        'language': 'es',
    }, {
        'confidence': 0.17112699,
        'input': 'I am',
        'language': 'en',
    },
]

The confidence value is an optional floating point value between 0 and 1. The closer this value is to 1, the higher the confidence level for the language detection. This member is not always available.

To translate text:

>>> from google.cloud import translate
>>> client = translate.Client()
>>> client.translate('koszula')
{
    'translatedText': 'shirt',
    'detectedSourceLanguage': 'pl',
    'input': 'koszula',
}

or to use a non-default target language:

>>> from google.cloud import translate
>>> client = translate.Client()
>>> client.translate(['Me llamo Jeff', 'My name is Jeff'],
...                  target_language='de')
[
    {
        'translatedText': 'Mein Name ist Jeff',
        'detectedSourceLanguage': 'es',
        'input': 'Me llamo Jeff',
    }, {
        'translatedText': 'Mein Name ist Jeff',
        'detectedSourceLanguage': 'en',
        'input': 'My name is Jeff',
    },
]