Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)



Translate API Getting Started

Google Translate API is a paid service . For website translations, we encourage you to use the Google Website Translator gadget .

This document details the background knowledge that you need to use the Google Translate API v2.

Contents

  1. Introduction
  2. Learn about identifying your application
  3. Translate API background
    1. Translate concepts
    2. Translate API operations
  4. Calling style
    1. REST
  5. Data format
    1. JSON

Introduction

This document is intended for developers who want to write applications that can interact with the Google Translate API. Google Translate is a tool that automatically translates text from one language to another language (e.g. French to English). You can use the Google Translate API to programmatically translate text in your webpages or apps.

Setup

If you haven't already registered your application with the Google Developers Console, then set up a project and application in the Developers Console . The system guides you through the process of choosing or creating a project and registering a new application, and it automatically activates the API for you.

If you've already registered your application with the Developers Console, then follow this procedure instead:

  1. Go to the Google Developers Console .
  2. Select a project.
  3. In the sidebar on the left, select APIs & auth . In the list of APIs, make sure the status is ON for the Google Translate API.
  4. In the sidebar on the left, select Credentials .

In either case, you end up on the application's credentials page.

Important: Google Translate API v2 requires billing information for all accounts before you can start using the service. See instructions below on how to enable billing.

To enable billing for your project, do the following:

  1. Go to the Google Developers Console .
  2. Select a project.
  3. In the sidebar on the left, select Settings .
  4. In the Billing section, select Enable billing .
  5. Select your location and then fill in the form.

Learn about identifying your application

Every request your application sends to the Google Translate API must identify your application to Google, using an API key.

For information about how to use API keys, see Identifying your application to Google in the Using REST document.

Translate API background

Translate concepts

Google Translate is a tool that automatically translates text from one language to another language.

The source text is the text to be translated. The source language is the language that the source text is written in. The target language is language that the source text is translated into.

Translate API operations

There are three methods to invoke in the Google Translate API:

Operation Description REST HTTP mapping
translate Translates source text from source language to target language GET
languages List the source and target languages supported by the translate methods GET
detect Detect language of source text GET

Calling styles

There are several ways to invoke the API:

REST

REST, or Representational State Transfer , in the Google Translate API is somewhat different from traditional REST. Instead of providing access to resources, the API provides access to a service. As a result, the API provides a single URI that acts as the service endpoint.

You access the Google Translate API service endpoint using the GET REST HTTP verb, as described in API operations . You pass in the details of all service requests as query parameters.

Translate

The specific format for the single Google Translate API URI is:

https://www.googleapis.com/language/translate/v2?parameters

where parameters are any parameters to apply to the query. For details, see Working with results and Query parameter reference in the Using REST document.

Here is an example of how this works in the Translate API.

https://www.googleapis.com/language/translate/v2?key=INSERT-YOUR-KEY&q=hello%20world&source;=en⌖=de

Discover supported languages

The specific format to return the list of languages codes is:

https://www.googleapis.com/language/translate/v2/languages?parameters

where parameters are any parameters to apply to the query. For details, see Working with results and Query parameter reference in the Using REST document.

Here is an example of how languages method works in the Translate API.

https://www.googleapis.com/language/translate/v2/languages?key=INSERT-YOUR-KEY&target=zh-TW

Detect source language

The specific format to detect the language of a text is:

https://www.googleapis.com/language/translate/v2/detect?parameters

where parameters are any parameters to apply to the query. For details, see Working with results and Query parameter reference in the Using REST document.

Here is an example of how detect method works in the Translate API.

https://www.googleapis.com/language/translate/v2/detect?key=INSERT-YOUR-KEY&q=google+translate+is+fast

REST from JavaScript

You can invoke the Translate API using REST from JavaScript, using the callback query parameter and a callback function. However, be aware that your API key will be viewable in the HTML source for your page. By default a key can be used on any site. We strongly recommend that you restrict use of your key only to domains you administer, to prevent use on unauthorized sites.

You can specify which domains are allowed to use your API key by doing the following:

  1. Go to the Google Developers Console .
  2. Select a project.
  3. In the sidebar on the left, select APIs & auth , then select an API.
  4. On the API's info page, select the Quota link near the API name.
  5. In the sidebar on the left, select API Access .
  6. Click the Edit allowed referers link in the Simple API Access section of the page.

The following example uses this approach to translate some text and put it below the source text:

<html>
  <head>
    <title>Translate API Example</title>
  </head>
  <body>
    <div id="sourceText">Hello world</div>
    <div id="translation"></div>
    <script>
      function translateText(response) {
        document.getElementById("translation").innerHTML += "<br>" + response.data.translations[0].translatedText;
      }
    </script>
    <script>
      var newScript = document.createElement('script');
      newScript.type = 'text/javascript';
      var sourceText = escape(document.getElementById("sourceText").innerHTML);
      // WARNING: be aware that YOUR-API-KEY inside html is viewable by all your users.
      // Restrict your key to designated domains or use a proxy to hide your key
      // to avoid misuage by other party.
      var source = 'https://www.googleapis.com/language/translate/v2?key=YOUR-API-KEY&source=en&target=de&callback=translateText&q=' + sourceText;
      newScript.src = source;

      // When we add this script to the head, the request is sent off.
      document.getElementsByTagName('head')[0].appendChild(newScript);
    </script>
  </body>
</html>

Data format

JSON

JSON (JavaScript Object Notation) is a common, language-independent data format that provides a simple text representation of arbitrary data structures. For more information, see json.org .

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.