Google Translate API Python Samples

This directory contains samples for Google Translate API. With Google Translate API, you can dynamically translate text between thousands of language pairs.

Setup

Authentication

Authentication for this service is done via an API Key. To obtain an API Key:

1. Open the `Cloud Platform Console`_
2. Make sure that billing is enabled for your project.
3. From the Credentials page, create a new API Key or use an existing one for your project.

Install Dependencies

1. Install pip and virtualenv if you do not already have them.

2. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+.

   $ virtualenv env
   $ source env/bin/activate

3. Install the dependencies needed to run the samples.

   $ pip install -r requirements.txt

Samples

Quickstart

To run this sample:

$ python quickstart.py

Snippets

To run this sample:

$ python snippets.py

usage: snippets.py [-h]
                   api_key
                   {detect-language,list-languages,list-languages-with-target,translate-text}
                   ...

This application demonstrates how to perform basic operations with the
Google Cloud Translate API

For more information, the documentation at
https://cloud.google.com/translate/docs.

positional arguments:
  api_key               Your API key.
  {detect-language,list-languages,list-languages-with-target,translate-text}
    detect-language     Detects the text's language.
    list-languages      Lists all available languages.
    list-languages-with-target
                        Lists all available languages and localizes them to
                        the target language. Target must be an ISO 639-1
                        language code. See https://g.co/cloud/translate/v2
                        /translate-reference#supported_languages
    translate-text      Translates text into the target language. Target must
                        be an ISO 639-1 language code. See
                        https://g.co/cloud/translate/v2/translate-
                        reference#supported_languages

optional arguments:
  -h, --help            show this help message and exit

The client library

This sample uses the `Google Cloud Client Library for Python`_. You can read the documentation for more details on API usage and use GitHub to `browse the source`_ and `report issues`_.