Translate text with Cloud Translation Basic
This page shows you how to translate a sample text by using Cloud Translation Basic.
Before you begin
Before you can start using the Cloud Translation API, you must have a project that has the Cloud Translation API enabled, and you must have a private key with the appropriate credentials. You can also install client libraries for common programming languages to help you make calls to the API. For more information, see the Setup page.
Translate text example
The following example demonstrates how to use Cloud Translation - Basic to translate text to a given target language.
REST
Make a Cloud Translation - Basic request using a REST method call to the Basictranslate
method. You identify your source and target languages by using their
ISO-639
codes.
The following shows an example of a POST
request using
curl
or PowerShell.
Before using any of the request data, make the following replacements:
HTTP method and URL:
POST https://translation.googleapis.com/language/translate/v2
Request JSON body:
{ "q": "The Great Pyramid of Giza (also known as the Pyramid of Khufu or the Pyramid of Cheops) is the oldest and largest of the three pyramids in the Giza pyramid complex.", "source": "en", "target": "es", "format": "text" }
To send your request, expand one of these options:
You should receive a JSON response similar to the following:
{ "data": { "translations": [{ "translatedText": "La Gran Pirámide de Giza (también conocida como la Pirámide de Khufu o la Pirámide de Keops) es la más antigua y más grande de las tres pirámides en el complejo de la pirámide de Giza." }] } }
Go
Before trying this sample, follow the Go setup instructions in the Translation quickstart using client libraries. For more information, see the Translation Go API reference documentation.
Node.js
Before trying this sample, follow the Node.js setup instructions in the Translation quickstart using client libraries. For more information, see the Translation Node.js API reference documentation.
Python
Before trying this sample, follow the Python setup instructions in the Translation quickstart using client libraries. For more information, see the Translation Python API reference documentation.
Additional languages
C#: Please follow the C# setup instructions on the client libraries page and then visit the Translation reference documentation for .NET.
PHP: Please follow the PHP setup instructions on the client libraries page and then visit the Translation reference documentation for PHP.
Ruby: Please follow the Ruby setup instructions on the client libraries page and then visit the Translation reference documentation for Ruby.
Additional resources
- For more information about translating text, see the Translating text (Basic) how-to guide.
- For help on resolving common issues or errors, see the Troubleshooting page.
- For answers to general questions about Cloud Translation, see the General FAQ page.
- Translation is available in two editions. For more information about each edition, see Comparing Basic and Advanced.