Add README and package-info for Translate, update main README

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

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());
+  }
+}

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/).
+
+[![Build Status](https://travis-ci.org/GoogleCloudPlatform/gcloud-java.svg?branch=master)](https://travis-ci.org/GoogleCloudPlatform/gcloud-java)
+[![Coverage Status](https://coveralls.io/repos/GoogleCloudPlatform/gcloud-java/badge.svg?branch=master)](https://coveralls.io/r/GoogleCloudPlatform/gcloud-java?branch=master)
+[![Maven](https://img.shields.io/maven-central/v/com.google.cloud/gcloud-java-translate.svg)]( https://img.shields.io/maven-central/v/com.google.cloud/gcloud-java-translate.svg)
+[![Codacy Badge](https://api.codacy.com/project/badge/grade/9da006ad7c3a4fe1abd142e77c003917)](https://www.codacy.com/app/mziccard/gcloud-java)
+[![Dependency Status](https://www.versioneye.com/user/projects/56bd8ee72a29ed002d2b0969/badge.svg?style=flat)](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
+<dependency>
+  <groupId>com.google.cloud</groupId>
+  <artifactId>gcloud-java-translate</artifactId>
+  <version>0.2.7</version>
+</dependency>
+```
+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

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.
+ *
+ * <p>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
+ * <a href="https://github.com/GoogleCloudPlatform/gcloud-java/tree/master/gcloud-java-examples/src/main/java/com/google/cloud/examples/translate/snippets/DetectLanguageAndTranslate.java">
+ * DetectLanguageAndTranslate.java</a>.
+ * <pre> {@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());
+ * }</pre>
+ */
+package com.google.cloud.translate;

pom.xml

@@ -402,15 +402,15 @@
                   </group>
                   <group>
                     <title>Test helpers packages</title>
-                    <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</packages>
+                    <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.translate.testing</packages>
                   </group>
                   <group>
                     <title>Example packages</title>
                     <packages>com.google.cloud.examples.*:com.google.cloud.nio.examples</packages>
                   </group>
                   <group>
                     <title>SPI packages</title>
-                    <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</packages>
+                    <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.translate.spi</packages>
                   </group>
                 </groups>
               </configuration>