Python Client for Google Cloud 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.
Quick Start¶
In order to use this library, you first need to go through the following steps:
Installation¶
Install this library in a virtualenv using pip. virtualenv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.
With virtualenv, it’s possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.
Supported Python Versions¶
Python >= 3.6
Deprecated Python Versions¶
Python == 2.7. The last version of this library compatible with Python 2.7 is google-cloud-translate==2.0.1.
Mac/Linux¶
pip install virtualenv
virtualenv <your-env>
source <your-env>/bin/activate
<your-env>/bin/pip install google-cloud-translate
Windows¶
pip install virtualenv
virtualenv <your-env>
<your-env>\Scripts\activate
<your-env>\Scripts\pip.exe install google-cloud-translate
Samples¶
The samples folder contains all of the Cloud Translation API code snippets found in its documentation as well as complete sample apps:
Mini Google Translate “MVP” app
Shows how to use the API in a Python/Flask web app
Deployable locally or any on-prem or cloud host supporting Flask apps
Also deployable to Google Cloud serverless hosting platforms (App Engine, Cloud Functions, or Cloud Run) with only minor configuration changes
Note
Because this client uses grpc library, it is safe to
share instances across threads. In multiprocessing scenarios, the best
practice is to create client instances after the invocation of
os.fork() by multiprocessing.pool.Pool or
multiprocessing.Process.
API Reference¶
An API and type reference is provided for v3, v3beta1, and v2.
By default, you will get v3. A beta release, spelled v3beta1 is
provided for preview of upcoming features. In order to use this, you will
want to import from google.cloud.translate_v3beta1 in lieu of
google.cloud.translate. The previous release v2 is also available.
Import from google.cloud.translate_v2 to use this release.
v3 API Reference¶
v3beta1 API Reference¶
v2 API Reference¶
Migration Guide¶
See the guide below for instructions on migrating to the 3.x release of this library.
Changelog¶
For a list of all google-cloud-translate releases:
