diff --git a/README.md b/README.md
index 018ce7eee1db..611552a34d74 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,7 @@ This client supports the following Google Cloud Platform services:
- [Google Cloud Pub/Sub] (#google-cloud-pubsub-alpha) (Alpha - Not working on App Engine Standard)
- [Google Cloud Resource Manager] (#google-cloud-resource-manager-alpha) (Alpha)
- [Google Cloud Storage] (#google-cloud-storage)
+- [Google Cloud Translate] (#google-translate) (Alpha)
> Note: This client is a work-in-progress, and may occasionally
> make backwards-incompatible changes.
@@ -569,6 +570,40 @@ if (blob != null) {
}
```
+Google Translate
+----------------
+
+- [API Documentation][translate-api]
+- [Official Documentation][translate-docs]
+
+#### Preview
+
+Here's a snippet showing a simple usage example. The example shows how to detect the language of
+some text and how to translate some text. The example assumes that the `GOOGLE_API_KEY` is set and
+contains a valid API key. Alternatively, you can use the `apiKey(String)` setter in
+`TranslateOptions.Builder` to set the API key. Complete source code can be found at
+[DetectLanguageAndTranslate.java](./gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java).
+
+```java
+import com.google.cloud.translate.Detection;
+import com.google.cloud.translate.Translate;
+import com.google.cloud.translate.Translate.TranslateOption;
+import com.google.cloud.translate.TranslateOptions;
+import com.google.cloud.translate.Translation;
+
+Translate translate = TranslateOptions.defaultInstance().service();
+
+Detection detection = translate.detect("Hola");
+String detectedLanguage = detection.language();
+
+Translation translation = translate.translate(
+ "World",
+ TranslateOption.sourceLanguage("en"),
+ TranslateOption.targetLanguage(detectedLanguage));
+
+System.out.printf("Hola %s%n", translation.translatedText());
+```
+
Troubleshooting
---------------
@@ -648,3 +683,6 @@ Apache 2.0 - See [LICENSE] for more information.
[cloud-compute]: https://cloud.google.com/compute/
[cloud-compute-docs]: https://cloud.google.com/compute/docs/overview
[compute-api]: http://googlecloudplatform.github.io/gcloud-java/apidocs/index.html?com/google/cloud/compute/package-summary.html
+
+[translate-docs]: https://cloud.google.com/translate/docs/
+[translate-api]: http://googlecloudplatform.github.io/gcloud-java/apidocs/index.html?com/google/cloud/translate/package-summary.html
diff --git a/gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java b/gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java
new file mode 100644
index 000000000000..994ff40852fe
--- /dev/null
+++ b/gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java
@@ -0,0 +1,54 @@
+/*
+ * Copyright 2016 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/*
+ * EDITING INSTRUCTIONS
+ * This file is referenced in READMEs and javadoc. Any change to this file should be reflected in
+ * the project's READMEs and package-info.java.
+ */
+
+package com.google.cloud.examples.translate.snippets;
+
+import com.google.cloud.translate.Detection;
+import com.google.cloud.translate.Translate;
+import com.google.cloud.translate.Translate.TranslateOption;
+import com.google.cloud.translate.TranslateOptions;
+import com.google.cloud.translate.Translation;
+
+/**
+ * A snippet for Google Translate showing how to detect the language of some text and translate
+ * some other text.
+ */
+public class DetectLanguageAndTranslate {
+
+ public static void main(String... args) {
+ // Create a service object
+ // API key is read from the GOOGLE_API_KEY environment variable
+ Translate translate = TranslateOptions.defaultInstance().service();
+
+ // Detect the language of some text
+ Detection detection = translate.detect("Hola");
+ String detectedLanguage = detection.language();
+
+ // Translate some text
+ Translation translation = translate.translate(
+ "World",
+ TranslateOption.sourceLanguage("en"),
+ TranslateOption.targetLanguage(detectedLanguage));
+
+ System.out.printf("Hola %s%n", translation.translatedText());
+ }
+}
diff --git a/gcloud-java-translate/README.md b/gcloud-java-translate/README.md
new file mode 100644
index 000000000000..592f80fbb30c
--- /dev/null
+++ b/gcloud-java-translate/README.md
@@ -0,0 +1,185 @@
+Google Cloud Java Client for Translate
+====================================
+
+Java idiomatic client for [Google Translate](https://cloud.google.com/translate/).
+
+[](https://travis-ci.org/GoogleCloudPlatform/gcloud-java)
+[](https://coveralls.io/r/GoogleCloudPlatform/gcloud-java?branch=master)
+[]( https://img.shields.io/maven-central/v/com.google.cloud/gcloud-java-translate.svg)
+[](https://www.codacy.com/app/mziccard/gcloud-java)
+[](https://www.versioneye.com/user/projects/56bd8ee72a29ed002d2b0969)
+
+- [Homepage](https://googlecloudplatform.github.io/gcloud-java/)
+- [API Documentation](http://googlecloudplatform.github.io/gcloud-java/apidocs/index.html?com/google/cloud/translate/package-summary.html)
+
+> Note: This client is a work-in-progress, and may occasionally
+> make backwards-incompatible changes.
+
+Quickstart
+----------
+If you are using Maven, add this to your pom.xml file
+```xml
+
+ com.google.cloud
+ gcloud-java-translate
+ 0.2.7
+
+```
+If you are using Gradle, add this to your dependencies
+```Groovy
+compile 'com.google.cloud:gcloud-java-translate:0.2.7'
+```
+If you are using SBT, add this to your dependencies
+```Scala
+libraryDependencies += "com.google.cloud" % "gcloud-java-translate" % "0.2.7"
+```
+
+Example Application
+-------------------
+
+[`TranslateExample`](../gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/TranslateExample.java) is a simple command line interface that provides some of Google Translate's functionality. Read more about using the application on the [`TranslateExample` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/cloud/examples/translate/TranslateExample.html).
+
+Authentication
+--------------
+
+Google Translate requires an API key to be passed with every request. For instructions on how to
+get an API key follow the [Translate quickstart](https://cloud.google.com/translate/v2/quickstart).
+
+About Google Translate
+--------------------
+
+[Google Translate][google-translate] provides a simple programmatic interface for translating an
+arbitrary string into any supported language. Translate is highly responsive, so websites and
+applications can integrate with Translate API for fast, dynamic translation of source text from the
+source language to a target language (e.g., French to English). Language detection is also
+available In cases where the source language is unknown.
+
+See the [Translate quickstart](https://cloud.google.com/translate/v2/quickstart) for more details
+on how to activate Google Translate for your project.
+
+See the ``gcloud-java`` API [Translate documentation][translate-api] to learn how to interact with
+the Google Translate using this Client Library.
+
+Getting Started
+---------------
+#### Prerequisites
+For this tutorial, you need a [Google Developers Console](https://console.developers.google.com/)
+project with "Translate API" enabled via the console's API Manager. You will also need a to enable
+billing via the [Google Developers Console](https://console.developers.google.com/) project and to
+retrieve an API key. See [Translate quickstart](https://cloud.google.com/translate/v2/quickstart)
+for more details.
+
+#### Installation and setup
+You'll need to obtain the `gcloud-java-translate` library. See the [Quickstart](#quickstart)
+section to add `gcloud-java-translate` as a dependency in your code.
+
+#### Creating an authorized service object
+To make authenticated requests to Google Translates, you must create a service object with an API
+key. By default, API key is looked for in the `GOOGLE_API_KEY` environment variable. Once the API
+key is set, you can make API calls by invoking methods on the Translate service object. To create a
+service object, given that `GOOGLE_API_KEY` is set, use the following code:
+
+```java
+import com.google.cloud.translate.Translate;
+import com.google.cloud.translate.TranslateOptions;
+
+Translate translate = TranslateOptions.defaultInstance().service();
+```
+
+Or you can explicitly set the API key as follows:
+```java
+Translate translate = TranslateOptions.builder().apiKey("myKey").service();
+```
+
+#### Detecting language
+With Google Translate you can detect the language of some text. The service will provide you with
+the code of the detected language and a level of confidence.
+
+Add the following import at the top of your file:
+
+```java
+import com.google.cloud.translate.Detection;
+```
+
+Then add the following code to detect the text's language:
+
+```java
+String detectedLanguage = detection.language();
+```
+#### Translating text
+
+Google translate allows you to translate some text. When translating one or more texts you can
+either provide the source language or let the service detect it for you.
+
+Add the following imports at the top of your file:
+
+```java
+import com.google.cloud.translate.Translate.TranslateOption;
+import com.google.cloud.translate.Translation;
+```
+
+Then add the following code to translate a text (specifying its source language):
+
+```java
+Translation translation = translate.translate(
+ "World",
+ TranslateOption.sourceLanguage("en"),
+ TranslateOption.targetLanguage(detectedLanguage));
+```
+
+#### Complete source code
+
+In
+[DetectLanguageAndTranslate.java](../gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java)
+we put together all the code shown above into one program. The program assumes that a valid api key
+is available.
+
+Troubleshooting
+---------------
+
+To get help, follow the `gcloud-java` links in the `gcloud-*` [shared Troubleshooting document](https://github.com/GoogleCloudPlatform/gcloud-common/blob/master/troubleshooting/readme.md#troubleshooting).
+
+Java Versions
+-------------
+
+Java 7 or above is required for using this client.
+
+Testing
+-------
+
+This library has tools to help make tests for code using Cloud Translate.
+
+See [TESTING] to read more about testing.
+
+Versioning
+----------
+
+This library follows [Semantic Versioning](http://semver.org/).
+
+It is currently in major version zero (``0.y.z``), which means that anything
+may change at any time and the public API should not be considered
+stable.
+
+Contributing
+------------
+
+Contributions to this library are always welcome and highly encouraged.
+
+See `gcloud-java`'s [CONTRIBUTING] documentation and the `gcloud-*` [shared documentation](https://github.com/GoogleCloudPlatform/gcloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started.
+
+Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information.
+
+License
+-------
+
+Apache 2.0 - See [LICENSE] for more information.
+
+[CONTRIBUTING]:https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/CONTRIBUTING.md
+[code-of-conduct]:https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
+[LICENSE]: https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/LICENSE
+[TESTING]: https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/TESTING.md#testing-code-that-uses-translate
+[cloud-platform]: https://cloud.google.com/
+
+[google-translate]: https://cloud.google.com/translate/
+[google-translate-docs]: https://cloud.google.com/translate/docs/
+[translate-api]: http://googlecloudplatform.github.io/gcloud-java/apidocs/index.html?com/google/cloud/translate/package-summary.html
diff --git a/gcloud-java-translate/src/main/java/com/google/cloud/translate/package-info.java b/gcloud-java-translate/src/main/java/com/google/cloud/translate/package-info.java
new file mode 100644
index 000000000000..80a4732a53de
--- /dev/null
+++ b/gcloud-java-translate/src/main/java/com/google/cloud/translate/package-info.java
@@ -0,0 +1,41 @@
+/*
+ * Copyright 2016 Google Inc. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * A client to Google Translate.
+ *
+ * Here's a simple usage example for using gcloud-java. This example shows how to detect the
+ * language of some text and how to translate some text. The example assumes that the
+ * {@code GOOGLE_API_KEY} is set and contains a valid API key. Alternatively, you can use
+ * {@link com.google.cloud.translate.TranslateOptions.Builder#apiKey(java.lang.String)} to set the
+ * API key. For the complete source code see
+ *
+ * DetectLanguageAndTranslate.java.
+ *
{@code
+ * Translate translate = TranslateOptions.defaultInstance().service();
+ *
+ * Detection detection = translate.detect("Hola");
+ * String detectedLanguage = detection.language();
+ *
+ * Translation translation = translate.translate(
+ * "World",
+ * TranslateOption.sourceLanguage("en"),
+ * TranslateOption.targetLanguage(detectedLanguage));
+ *
+ * System.out.printf("Hola %s%n", translation.translatedText());
+ * }
+ */
+package com.google.cloud.translate;
diff --git a/pom.xml b/pom.xml
index 9c8895096d03..d83d7398e6a1 100644
--- a/pom.xml
+++ b/pom.xml
@@ -402,7 +402,7 @@
Test helpers packages
- com.google.cloud.bigquery.testing:com.google.cloud.compute.testing:com.google.cloud.datastore.testing:com.google.cloud.dns.testing:com.google.cloud.logging.testing:com.google.cloud.pubsub.testing:com.google.cloud.resourcemanager.testing:com.google.cloud.storage.testing
+ com.google.cloud.bigquery.testing:com.google.cloud.compute.testing:com.google.cloud.datastore.testing:com.google.cloud.dns.testing:com.google.cloud.logging.testing:com.google.cloud.pubsub.testing:com.google.cloud.resourcemanager.testing:com.google.cloud.storage.testing:com.google.cloud.translate.testing
Example packages
@@ -410,7 +410,7 @@
SPI packages
- com.google.cloud.spi:com.google.cloud.bigquery.spi:com.google.cloud.compute.spi:com.google.cloud.datastore.spi:com.google.cloud.dns.spi:com.google.cloud.logging.spi:com.google.cloud.logging.spi.*:com.google.cloud.pubsub.spi:com.google.cloud.pubsub.spi.*:com.google.cloud.resourcemanager.spi:com.google.cloud.storage.spi
+ com.google.cloud.spi:com.google.cloud.bigquery.spi:com.google.cloud.compute.spi:com.google.cloud.datastore.spi:com.google.cloud.dns.spi:com.google.cloud.logging.spi:com.google.cloud.logging.spi.*:com.google.cloud.pubsub.spi:com.google.cloud.pubsub.spi.*:com.google.cloud.resourcemanager.spi:com.google.cloud.storage.spi:com.google.cloud.translate.spi