From ff25b07911525bab1631ad1b4b38eb646fd1d08e Mon Sep 17 00:00:00 2001
From: Amy Unruh <amyu@google.com>
Date: Sun, 20 Mar 2016 12:28:11 -0700
Subject: [PATCH 1/3] initial checkin of java grpc speech API examples.

Change-Id: Ifc48ab25bfea7ff5ce9ae11caf5c6c483febe705
---
 speech/README.md                              |   8 +
 speech/grpc/README.md                         | 100 +++++++
 speech/grpc/bin/speech-sample-nonstreaming.sh |  18 ++
 speech/grpc/bin/speech-sample-streaming.sh    |  18 ++
 speech/grpc/pom.xml                           | 243 +++++++++++++++++
 speech/grpc/resources/audio.raw               | Bin 0 -> 57958 bytes
 .../demos/NonStreamingRecognizeClient.java    | 209 +++++++++++++++
 .../speech/grpc/demos/RecognizeClient.java    | 243 +++++++++++++++++
 speech/grpc/src/main/proto/.gitignore         |   4 +
 .../main/proto/google/api/annotations.proto   |  29 +++
 .../grpc/src/main/proto/google/api/http.proto | 245 ++++++++++++++++++
 .../src/main/proto/google/api/label.proto     |  46 ++++
 .../proto/google/api/monitored_resource.proto |  64 +++++
 .../src/main/proto/google/logging/README.md   |   2 +
 .../google/logging/type/http_request.proto    |  69 +++++
 .../google/logging/type/log_severity.proto    |  62 +++++
 .../proto/google/logging/v2/log_entry.proto   | 114 ++++++++
 .../proto/google/logging/v2/logging.proto     | 167 ++++++++++++
 .../google/logging/v2/logging_config.proto    | 171 ++++++++++++
 .../google/logging/v2/logging_metrics.proto   | 146 +++++++++++
 .../grpc/src/main/proto/google/rpc/README.md  |   5 +
 .../grpc/src/main/proto/google/rpc/code.proto | 190 ++++++++++++++
 .../main/proto/google/rpc/error_details.proto | 157 +++++++++++
 .../src/main/proto/google/rpc/status.proto    |  90 +++++++
 .../proto/google/speech/v1/cloud-speech.proto | 238 +++++++++++++++++
 .../grpc/src/main/proto/google/type/README.md |  10 +
 .../src/main/proto/google/type/color.proto    | 163 ++++++++++++
 .../src/main/proto/google/type/date.proto     |  43 +++
 .../main/proto/google/type/dayofweek.proto    |  50 ++++
 .../src/main/proto/google/type/latlng.proto   |  36 +++
 .../src/main/proto/google/type/money.proto    |  40 +++
 .../main/proto/google/type/timeofday.proto    |  42 +++
 32 files changed, 3022 insertions(+)
 create mode 100644 speech/README.md
 create mode 100644 speech/grpc/README.md
 create mode 100755 speech/grpc/bin/speech-sample-nonstreaming.sh
 create mode 100755 speech/grpc/bin/speech-sample-streaming.sh
 create mode 100644 speech/grpc/pom.xml
 create mode 100644 speech/grpc/resources/audio.raw
 create mode 100644 speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
 create mode 100644 speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
 create mode 100644 speech/grpc/src/main/proto/.gitignore
 create mode 100644 speech/grpc/src/main/proto/google/api/annotations.proto
 create mode 100644 speech/grpc/src/main/proto/google/api/http.proto
 create mode 100644 speech/grpc/src/main/proto/google/api/label.proto
 create mode 100644 speech/grpc/src/main/proto/google/api/monitored_resource.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/README.md
 create mode 100644 speech/grpc/src/main/proto/google/logging/type/http_request.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/type/log_severity.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/v2/log_entry.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/v2/logging.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/v2/logging_config.proto
 create mode 100644 speech/grpc/src/main/proto/google/logging/v2/logging_metrics.proto
 create mode 100644 speech/grpc/src/main/proto/google/rpc/README.md
 create mode 100644 speech/grpc/src/main/proto/google/rpc/code.proto
 create mode 100644 speech/grpc/src/main/proto/google/rpc/error_details.proto
 create mode 100644 speech/grpc/src/main/proto/google/rpc/status.proto
 create mode 100644 speech/grpc/src/main/proto/google/speech/v1/cloud-speech.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/README.md
 create mode 100644 speech/grpc/src/main/proto/google/type/color.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/date.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/dayofweek.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/latlng.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/money.proto
 create mode 100644 speech/grpc/src/main/proto/google/type/timeofday.proto

diff --git a/speech/README.md b/speech/README.md
new file mode 100644
index 00000000000..b18c66d1909
--- /dev/null
+++ b/speech/README.md
@@ -0,0 +1,8 @@
+# Cloud Pub/Sub samples for Java
+
+This directory contains several samples for the [Cloud Speech API](https://cloud.google.com/speech/)
+with Java.
+
+- [grpc](grpc)
+
+  A sample for accessing Cloud Speech streaming and non streaming apis with [gRPC](http://www.grpc.io/).
diff --git a/speech/grpc/README.md b/speech/grpc/README.md
new file mode 100644
index 00000000000..68c66975fa4
--- /dev/null
+++ b/speech/grpc/README.md
@@ -0,0 +1,100 @@
+# Cloud Speech API gRPC samples for Java
+
+This is a sample repo for accessing the [Google Cloud Speech API](http://cloud.google.com/speech) with
+[gRPC](http://www.grpc.io/) client library.
+
+
+## Prerequisites
+
+### Enable the Speech API
+
+If you have not already done so, [enable the Google Cloud Speech API for your project](https://console.developers.google.com/apis/api/speech.googleapis.com/overview).
+You must be whitelisted to do this.
+
+
+### Download and install Java and Maven
+
+Install [Java7 or
+higher](http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-1880261.html).
+
+This sample uses the [Apache Maven][maven] build system. Before getting started, be
+sure to [download][maven-download] and [install][maven-install] it. When you use
+Maven as described here, it will automatically download the needed client
+libraries.
+
+[maven]: https://maven.apache.org
+[maven-download]: https://maven.apache.org/download.cgi
+[maven-install]: https://maven.apache.org/install.html
+
+
+### Set Up to Authenticate With Your Project's Credentials
+
+The example uses a service account for OAuth2 authentication.
+So next, set up to authenticate with the Speech API using your project's
+service account credentials.
+
+Visit the [Cloud Console](https://console.developers.google.com), and navigate to:
+`API Manager > Credentials > Create credentials >
+Service account key > New service account`.
+Create a new service account, and download the json credentials file.
+
+Then, set
+the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to point to your
+downloaded service account credentials before running this example:
+
+    export GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/credentials-key.json
+
+If you do not do this, you will see an error that looks something like this when
+you run the example scripts:
+`WARNING: RPC failed: Status{code=PERMISSION_DENIED, description=Request had insufficient authentication scopes., cause=null}`.
+See the
+[Cloud Platform Auth Guide](https://cloud.google.com/docs/authentication#developer_workflow)
+for more information.
+
+## Build the application
+
+Then, build the program:
+
+```sh
+$ mvn package
+```
+
+or
+
+```sh
+$ mvn compile
+$ mvn assembly:single
+```
+
+## Run the clients
+
+These programs return the transcription of the audio file you provided.  Please
+note that the audio file must be in RAW format.  You can use `sox`
+(available, e.g. via [http://sox.sourceforge.net/](http://sox.sourceforge.net/)
+or [homebrew](http://brew.sh/)) to convert audio files to raw format.
+
+### Run the non-streaming client
+
+You can run the batch client like this:
+
+```sh
+$ bin/speech-sample-nonstreaming.sh --host=speech.googleapis.com --port=443 \
+--file=<audio file path> --sampling=<sample rate>
+```
+
+Try a streaming rate of 16000 and the included sample audio file, as follows:
+
+```sh
+$ bin/speech-sample-nonstreaming.sh --host=speech.googleapis.com --port=443 \
+--file=resources/audio.raw --sampling=16000
+```
+
+### Run the streaming client
+
+You can run the streaming client as follows:
+
+```sh
+$ bin/speech-sample-streaming.sh --host=speech.googleapis.com --port=443 \
+--file=resources/audio.raw --sampling=16000
+```
+
diff --git a/speech/grpc/bin/speech-sample-nonstreaming.sh b/speech/grpc/bin/speech-sample-nonstreaming.sh
new file mode 100755
index 00000000000..1b2d632ee8f
--- /dev/null
+++ b/speech/grpc/bin/speech-sample-nonstreaming.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+# 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.
+
+export SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
+java -cp ${SRC_DIR}/target/grpc-sample-1.0-jar-with-dependencies.jar \
+    com.google.cloud.speech.grpc.demos.NonStreamingRecognizeClient "$@"
diff --git a/speech/grpc/bin/speech-sample-streaming.sh b/speech/grpc/bin/speech-sample-streaming.sh
new file mode 100755
index 00000000000..f327c19ed4a
--- /dev/null
+++ b/speech/grpc/bin/speech-sample-streaming.sh
@@ -0,0 +1,18 @@
+#!/bin/bash
+# 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.
+
+export SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
+java -cp ${SRC_DIR}/target/grpc-sample-1.0-jar-with-dependencies.jar \
+    com.google.cloud.speech.grpc.demos.RecognizeClient "$@"
diff --git a/speech/grpc/pom.xml b/speech/grpc/pom.xml
new file mode 100644
index 00000000000..ba6c328abed
--- /dev/null
+++ b/speech/grpc/pom.xml
@@ -0,0 +1,243 @@
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>com.google.cloud.speech</groupId>
+  <artifactId>grpc-sample</artifactId>
+  <version>1.0</version>
+  <packaging>jar</packaging>
+
+  <name>speech-grpc-sample</name>
+  <url>https://cloud.google.com/speech/</url>
+  <inceptionYear>2016</inceptionYear>
+
+  <licenses>
+    <license>
+      <name>Apache 2</name>
+      <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+      <distribution>repo</distribution>
+    </license>
+  </licenses>
+
+  <organization>
+    <name>Google</name>
+    <url>http://www.google.com</url>
+  </organization>
+
+  <developers>
+    <developer>
+      <id>ejonte@google.com</id>
+      <name>Erik Jonte</name>
+      <email>ejonte@google.com</email>
+      <url>http://www.google.com</url>
+      <organization>Google</organization>
+      <organizationUrl>http://www.google.com</organizationUrl>
+      <roles>
+        <role>developer</role>
+      </roles>
+      <timezone>-8</timezone>
+    </developer>
+  </developers>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <profiles>
+    <profile>
+      <id>staged</id>
+      <repositories>
+        <repository>
+          <id>snapshots-repo</id>
+          <url>https://oss.sonatype.org/content/repositories/snapshots</url>
+          <releases>
+            <enabled>false</enabled>
+          </releases>
+          <snapshots>
+            <enabled>true</enabled>
+          </snapshots>
+        </repository>
+      </repositories>
+    </profile>
+    <profile>
+      <id>jdk7</id>
+      <activation>
+        <jdk>1.7</jdk>
+      </activation>
+      <properties>
+        <jdk.version>1.7</jdk.version>
+      </properties>
+    </profile>
+    <profile>
+      <id>jdk8</id>
+      <activation>
+        <jdk>1.8</jdk>
+      </activation>
+      <properties>
+        <jdk.version>1.8</jdk.version>
+      </properties>
+    </profile>
+    <profile>
+      <id>fedora</id>
+      <activation>
+        <property>
+          <name>os.detected.classifier</name>
+          <value>os.detected.release.fedora</value>
+        </property>
+      </activation>
+      <properties>
+        <tcnative.classifier>${os.detected.classifier}-fedora</tcnative.classifier>
+      </properties>
+    </profile>
+    <profile>
+      <id>non-fedora</id>
+      <activation>
+        <property>
+          <name>os.detected.classifier</name>
+          <value>!os.detected.release.fedora</value>
+        </property>
+      </activation>
+      <properties>
+        <tcnative.classifier>${os.detected.classifier}</tcnative.classifier>
+      </properties>
+    </profile>
+  </profiles>
+
+  <!-- // [START dependency] -->
+  <dependencies>
+    <dependency>
+      <groupId>commons-cli</groupId>
+      <artifactId>commons-cli</artifactId>
+      <version>1.3.1</version>
+    </dependency>
+    <dependency>
+      <groupId>com.google.guava</groupId>
+      <artifactId>guava</artifactId>
+      <version>19.0</version>
+    </dependency>
+    <dependency>
+      <groupId>io.grpc</groupId>
+      <artifactId>grpc-all</artifactId>
+      <version>0.13.2</version>
+    </dependency>
+    <dependency>
+      <groupId>com.google.oauth-client</groupId>
+      <artifactId>google-oauth-client</artifactId>
+      <version>1.21.0</version>
+    </dependency>
+    <dependency>
+      <!--
+        It is recommended to use OpenSSL: Statically Linked Netty
+        for transport security.  These steps do not use the TLS that
+        comes with JDK (Jetty APLN/NPN), which is not
+        recommended. See
+        https://github.com/grpc/grpc-java/blob/master/SECURITY.md
+        for details.
+      -->
+      <groupId>io.netty</groupId>
+      <artifactId>netty-tcnative-boringssl-static</artifactId>
+      <version>1.1.33.Fork14</version>
+      <classifier>${tcnative.classifier}</classifier>
+    </dependency>
+  </dependencies>
+  <!-- // [END dependency] -->
+
+  <pluginRepositories>
+    <pluginRepository>
+      <releases>
+        <updatePolicy>never</updatePolicy>
+      </releases>
+      <snapshots>
+        <enabled>false</enabled>
+      </snapshots>
+      <id>central</id>
+      <name>Central Repository</name>
+      <url>https://repo.maven.apache.org/maven2</url>
+    </pluginRepository>
+    <pluginRepository>
+      <id>protoc-plugin</id>
+      <url>https://dl.bintray.com/sergei-ivanov/maven/</url>
+    </pluginRepository>
+  </pluginRepositories>
+  <!-- // [START os-maven-plugin] -->
+  <build>
+    <extensions>
+      <extension>
+        <groupId>kr.motd.maven</groupId>
+        <artifactId>os-maven-plugin</artifactId>
+        <version>1.4.1.Final</version>
+      </extension>
+    </extensions>
+    <!-- // [END os-maven-plugin] -->
+    <plugins>
+      <plugin>
+        <groupId>org.xolstice.maven.plugins</groupId>
+        <artifactId>protobuf-maven-plugin</artifactId>
+        <version>0.5.0</version>
+        <configuration>
+          <!--
+            The version of protoc must match protobuf-java. If you
+            don't depend on protobuf-java directly, you will be
+            transitively depending on the protobuf-java version that
+            grpc depends on.
+          -->
+          <protocArtifact>com.google.protobuf:protoc:3.0.0-beta-2:exe:${os.detected.classifier}</protocArtifact>
+          <pluginId>grpc-java</pluginId>
+          <pluginArtifact>io.grpc:protoc-gen-grpc-java:0.13.2:exe:${os.detected.classifier}</pluginArtifact>
+        </configuration>
+        <executions>
+          <execution>
+            <goals>
+              <goal>compile</goal>
+              <goal>compile-custom</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <groupId>org.codehaus.mojo</groupId>
+        <artifactId>versions-maven-plugin</artifactId>
+        <version>2.1</version>
+        <executions>
+          <execution>
+            <phase>compile</phase>
+            <goals>
+              <goal>display-dependency-updates</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.1</version>
+        <configuration>
+          <source>${jdk.version}</source>
+          <target>${jdk.version}</target>
+          <showWarnings>true</showWarnings>
+          <showDeprecation>false</showDeprecation>
+          <compilerArgument>-Xlint:-options</compilerArgument>
+        </configuration>
+      </plugin>
+      <plugin>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <configuration>
+          <descriptorRefs>
+            <descriptorRef>jar-with-dependencies</descriptorRef>
+          </descriptorRefs>
+        </configuration>
+        <executions>
+          <execution>
+            <id>simple-command</id>
+            <phase>package</phase>
+            <goals>
+              <goal>attached</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+    <!-- // [START footer] -->
+  </build>
+</project>
+<!-- // [END footer] -->
diff --git a/speech/grpc/resources/audio.raw b/speech/grpc/resources/audio.raw
new file mode 100644
index 0000000000000000000000000000000000000000..5ebf79d3c9c548f3d08c36e790059f3c2915af37
GIT binary patch
literal 57958
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

literal 0
HcmV?d00001

diff --git a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
new file mode 100644
index 00000000000..04823c92256
--- /dev/null
+++ b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
@@ -0,0 +1,209 @@
+/*
+ * 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.
+ */
+
+// Client that sends audio to Speech.NonStreamingRecognize via gRPC and returns transcription.
+//
+// Uses a service account for OAuth2 authentication, which you may obtain at
+// https://console.developers.google.com
+// API Manager > Google Cloud Speech API > Enable
+// API Manager > Credentials > Create credentials > Service account key > New service account.
+//
+// Then set environment variable GOOGLE_APPLICATION_CREDENTIALS to the full path of that file.
+
+package com.google.cloud.speech.grpc.demos;
+
+import com.google.auth.oauth2.GoogleCredentials;
+import com.google.cloud.speech.v1.AudioRequest;
+import com.google.cloud.speech.v1.InitialRecognizeRequest;
+import com.google.cloud.speech.v1.InitialRecognizeRequest.AudioEncoding;
+import com.google.cloud.speech.v1.NonStreamingRecognizeResponse;
+import com.google.cloud.speech.v1.RecognizeRequest;
+import com.google.cloud.speech.v1.SpeechGrpc;
+import com.google.protobuf.ByteString;
+import com.google.protobuf.TextFormat;
+import io.grpc.ManagedChannel;
+import io.grpc.StatusRuntimeException;
+import io.grpc.auth.ClientAuthInterceptor;
+import io.grpc.netty.NegotiationType;
+import io.grpc.netty.NettyChannelBuilder;
+import java.io.IOException;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.Arrays;
+import java.util.List;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.Executors;
+import java.util.concurrent.TimeUnit;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import org.apache.commons.cli.CommandLine;
+import org.apache.commons.cli.CommandLineParser;
+import org.apache.commons.cli.DefaultParser;
+import org.apache.commons.cli.Options;
+import org.apache.commons.cli.OptionBuilder;
+import org.apache.commons.cli.ParseException;
+
+/**
+ * Client that sends audio to Speech.NonStreamingRecognize and returns transcript.
+ */
+public class NonStreamingRecognizeClient {
+
+  private static final Logger logger =
+        Logger.getLogger(NonStreamingRecognizeClient.class.getName());
+
+   private static final List<String> OAUTH2_SCOPES =
+             Arrays.asList("https://www.googleapis.com/auth/xapi.zoo");
+
+  private final String host;
+  private final int port;
+  private final String file;
+  private final int samplingRate;
+
+  private final ManagedChannel channel;
+  private final SpeechGrpc.SpeechBlockingStub blockingStub;
+
+  /** Construct client connecting to Cloud Speech server at {@code host:port}. */
+  public NonStreamingRecognizeClient(String host, int port, String file, int samplingRate) throws IOException {
+    this.host = host;
+    this.port = port;
+    this.file = file;
+    this.samplingRate = samplingRate;
+
+    GoogleCredentials creds = GoogleCredentials.getApplicationDefault();
+    creds = creds.createScoped(OAUTH2_SCOPES);
+    channel = NettyChannelBuilder.forAddress(host, port)
+        .negotiationType(NegotiationType.TLS)
+        .intercept(new ClientAuthInterceptor(creds, Executors.newSingleThreadExecutor()))
+        .build();
+    blockingStub = SpeechGrpc.newBlockingStub(channel);
+    logger.info("Created blockingStub for " + host + ":" + port);
+  }
+
+  private AudioRequest createAudioRequest() throws IOException {
+    Path path = Paths.get(file);
+    return AudioRequest.newBuilder()
+        .setContent(ByteString.copyFrom(Files.readAllBytes(path)))
+        .build();
+  }
+
+  public void shutdown() throws InterruptedException {
+    channel.shutdown().awaitTermination(5, TimeUnit.SECONDS);
+  }
+
+  /** Send a non-streaming-recognize request to server. */
+  public void recognize() {
+    AudioRequest audio;
+    try {
+      audio = createAudioRequest();
+    } catch (IOException e) {
+      logger.log(Level.WARNING, "Failed to read audio file: " + file);
+      return;
+    }
+    logger.info("Sending " + audio.getContent().size() + " bytes from audio file: " + file);
+    InitialRecognizeRequest initial = InitialRecognizeRequest.newBuilder()
+        .setEncoding(AudioEncoding.LINEAR16)
+        .setSampleRate(samplingRate)
+        .build();
+    RecognizeRequest request = RecognizeRequest.newBuilder()
+        .setInitialRequest(initial)
+        .setAudioRequest(audio)
+        .build();
+    NonStreamingRecognizeResponse response;
+    try {
+      response = blockingStub.nonStreamingRecognize(request);
+    } catch (StatusRuntimeException e) {
+      logger.log(Level.WARNING, "RPC failed: {0}", e.getStatus());
+      return;
+    }
+    logger.info("Received response: " +  TextFormat.printToString(response));
+  }
+
+  public static void main(String[] args) throws Exception {
+
+    String audio_file = "";
+    String host = "speech.googleapis.com";
+    Integer port = 443;
+    Integer sampling = 16000;
+
+    CommandLineParser parser = new DefaultParser();
+
+    Options options = new Options();
+    options.addOption(OptionBuilder.withLongOpt("file")
+        .withDescription("path to audio file")
+        .hasArg()
+        .withArgName("FILE_PATH")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("host")
+        .withDescription("endpoint for api, e.g. speech.googleapis.com")
+        .hasArg()
+        .withArgName("ENDPOINT")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("port")
+        .withDescription("SSL port, usually 443")
+        .hasArg()
+        .withArgName("PORT")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("sampling")
+        .withDescription("Sampling Rate, i.e. 16000")
+        .hasArg()
+        .withArgName("RATE")
+        .create());
+
+    try {
+      CommandLine line = parser.parse(options, args);
+      if (line.hasOption("file")) {
+        audio_file = line.getOptionValue("file");
+      } else {
+        System.err.println("An Audio file path must be specified (e.g. /foo/baz.raw).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("host")) {
+        host = line.getOptionValue("host");
+      } else {
+        System.err.println("An API enpoint must be specified (typically speech.googleapis.com).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("port")) {
+        port = Integer.parseInt(line.getOptionValue("port"));
+      } else {
+        System.err.println("An SSL port must be specified (typically 443).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("sampling")) {
+        sampling = Integer.parseInt(line.getOptionValue("sampling"));
+      } else {
+        System.err.println("An Audio sampling rate must be specified.");
+        System.exit(1);
+      }
+    }
+    catch (ParseException exp) {
+      System.err.println("Unexpected exception:" + exp.getMessage());
+      System.exit(1);
+    }
+
+    NonStreamingRecognizeClient client =
+        new NonStreamingRecognizeClient(host, port, audio_file, sampling);
+    try {
+      client.recognize();
+    } finally {
+      client.shutdown();
+    }
+  }
+}
diff --git a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
new file mode 100644
index 00000000000..223db38bba6
--- /dev/null
+++ b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
@@ -0,0 +1,243 @@
+/*
+ * 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.
+ */
+
+// Client sends streaming audio to Speech.Recognize via gRPC and returns streaming transcription.
+//
+// Uses a service account for OAuth2 authentication, which you may obtain at
+// https://console.developers.google.com
+// API Manager > Google Cloud Speech API > Enable
+// API Manager > Credentials > Create credentials > Service account key > New service account.
+//
+// Then set environment variable GOOGLE_APPLICATION_CREDENTIALS to the full path of that file.
+
+package com.google.cloud.speech.grpc.demos;
+
+import com.google.auth.oauth2.GoogleCredentials;
+import com.google.cloud.speech.v1.AudioRequest;
+import com.google.cloud.speech.v1.InitialRecognizeRequest;
+import com.google.cloud.speech.v1.InitialRecognizeRequest.AudioEncoding;
+import com.google.cloud.speech.v1.RecognizeRequest;
+import com.google.cloud.speech.v1.RecognizeResponse;
+import com.google.cloud.speech.v1.SpeechGrpc;
+import com.google.protobuf.ByteString;
+import com.google.protobuf.TextFormat;
+import io.grpc.ManagedChannel;
+import io.grpc.Status;
+import io.grpc.auth.ClientAuthInterceptor;
+import io.grpc.netty.NegotiationType;
+import io.grpc.netty.NettyChannelBuilder;
+import io.grpc.stub.StreamObserver;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.Executors;
+import java.util.concurrent.TimeUnit;
+import java.util.logging.Level;
+import java.util.logging.Logger;
+import org.apache.commons.cli.CommandLine;
+import org.apache.commons.cli.CommandLineParser;
+import org.apache.commons.cli.DefaultParser;
+import org.apache.commons.cli.Options;
+import org.apache.commons.cli.OptionBuilder;
+import org.apache.commons.cli.ParseException;
+
+
+/**
+ * Client that sends streaming audio to Speech.Recognize and returns streaming transcript.
+ */
+public class RecognizeClient {
+
+  private final String host;
+  private final int port;
+  private final String file;
+  private final int samplingRate;
+
+  private static final Logger logger =
+        Logger.getLogger(RecognizeClient.class.getName());
+
+  private final ManagedChannel channel;
+
+  private final SpeechGrpc.SpeechStub stub;
+
+  private static final List<String> OAUTH2_SCOPES =
+      Arrays.asList("https://www.googleapis.com/auth/xapi.zoo");
+
+  /** Construct client connecting to Cloud Speech server at {@code host:port}. */
+  public RecognizeClient(String host, int port, String file, int samplingRate) throws IOException {
+    this.host = host;
+    this.port = port;
+    this.file = file;
+    this.samplingRate = samplingRate;
+
+    GoogleCredentials creds = GoogleCredentials.getApplicationDefault();
+    creds = creds.createScoped(OAUTH2_SCOPES);
+    channel = NettyChannelBuilder.forAddress(host, port)
+        .negotiationType(NegotiationType.TLS)
+        .intercept(new ClientAuthInterceptor(creds, Executors.newSingleThreadExecutor()))
+        .build();
+    stub = SpeechGrpc.newStub(channel);
+    logger.info("Created stub for " + host + ":" + port);
+  }
+
+  public void shutdown() throws InterruptedException {
+    channel.shutdown().awaitTermination(5, TimeUnit.SECONDS);
+  }
+
+  /** Send streaming recognize requests to server. */
+  public void recognize() throws InterruptedException, IOException {
+    final CountDownLatch finishLatch = new CountDownLatch(1);
+    StreamObserver<RecognizeResponse> responseObserver = new StreamObserver<RecognizeResponse>() {
+      @Override
+      public void onNext(RecognizeResponse response) {
+        logger.info("Received response: " +  TextFormat.printToString(response));
+      }
+
+      @Override
+      public void onError(Throwable t) {
+        Status status = Status.fromThrowable(t);
+        logger.log(Level.WARNING, "recognize failed: {0}", status);
+        finishLatch.countDown();
+      }
+
+      @Override
+      public void onCompleted() {
+        logger.info("recognize completed.");
+        finishLatch.countDown();
+      }
+    };
+
+    StreamObserver<RecognizeRequest> requestObserver = stub.recognize(responseObserver);
+    try {
+      // Build and send a RecognizeRequest containing the parameters for processing the audio.
+      InitialRecognizeRequest initial = InitialRecognizeRequest.newBuilder()
+          .setEncoding(AudioEncoding.LINEAR16)
+          .setSampleRate(samplingRate)
+          .setInterimResults(true)
+          .build();
+      RecognizeRequest firstRequest = RecognizeRequest.newBuilder()
+          .setInitialRequest(initial)
+          .build();
+      requestObserver.onNext(firstRequest);
+
+      // Open audio file. Read and send sequential buffers of audio as additional RecognizeRequests.
+      FileInputStream in = new FileInputStream(new File(file));
+      // For LINEAR16 at 16000 Hz sample rate, 3200 bytes corresponds to 100 milliseconds of audio.
+      byte[] buffer = new byte[3200];
+      int bytesRead;
+      int totalBytes = 0;
+      while ((bytesRead = in.read(buffer)) != -1) {
+        totalBytes += bytesRead;
+        AudioRequest audio = AudioRequest.newBuilder()
+            .setContent(ByteString.copyFrom(buffer, 0, bytesRead))
+            .build();
+        RecognizeRequest request = RecognizeRequest.newBuilder()
+            .setAudioRequest(audio)
+            .build();
+        requestObserver.onNext(request);
+        // To simulate real-time audio, sleep after sending each audio buffer.
+        // For 16000 Hz sample rate, sleep 100 milliseconds.
+        Thread.sleep(samplingRate / 160);
+      }
+      logger.info("Sent " + totalBytes + " bytes from audio file: " + file);
+    } catch (RuntimeException e) {
+      // Cancel RPC.
+      requestObserver.onError(e);
+      throw e;
+    }
+    // Mark the end of requests.
+    requestObserver.onCompleted();
+
+    // Receiving happens asynchronously.
+    finishLatch.await(1, TimeUnit.MINUTES);
+  }
+
+  public static void main(String[] args) throws Exception {
+
+    String audio_file = "";
+    String host = "speech.googleapis.com";
+    Integer port = 443;
+    Integer sampling = 16000;
+
+    CommandLineParser parser = new DefaultParser();
+
+    Options options = new Options();
+    options.addOption(OptionBuilder.withLongOpt("file")
+        .withDescription("path to audio file")
+        .hasArg()
+        .withArgName("FILE_PATH")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("host")
+        .withDescription("endpoint for api, e.g. speech.googleapis.com")
+        .hasArg()
+        .withArgName("ENDPOINT")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("port")
+        .withDescription("SSL port, usually 443")
+        .hasArg()
+        .withArgName("PORT")
+        .create());
+    options.addOption(OptionBuilder.withLongOpt("sampling")
+        .withDescription("Sampling Rate, i.e. 16000")
+        .hasArg()
+        .withArgName("RATE")
+        .create());
+
+    try {
+      CommandLine line = parser.parse(options, args);
+      if (line.hasOption("file")) {
+        audio_file = line.getOptionValue("file");
+      } else {
+        System.err.println("An Audio file must be specified (e.g. /foo/baz.raw).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("host")) {
+        host = line.getOptionValue("host");
+      } else {
+        System.err.println("An API enpoint must be specified (typically speech.googleapis.com).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("port")) {
+        port = Integer.parseInt(line.getOptionValue("port"));
+      } else {
+        System.err.println("An SSL port must be specified (typically 443).");
+        System.exit(1);
+      }
+
+      if (line.hasOption("sampling")) {
+        sampling = Integer.parseInt(line.getOptionValue("sampling"));
+      } else {
+        System.err.println("An Audio sampling rate must be specified.");
+        System.exit(1);
+      }
+    } catch (ParseException exp) {
+      System.err.println("Unexpected exception:" + exp.getMessage());
+      System.exit(1);
+    }
+
+    RecognizeClient client =
+        new RecognizeClient(host, port, audio_file, sampling);
+    try {
+      client.recognize();
+    } finally {
+      client.shutdown();
+    }
+  }
+}
diff --git a/speech/grpc/src/main/proto/.gitignore b/speech/grpc/src/main/proto/.gitignore
new file mode 100644
index 00000000000..65267c8e5d7
--- /dev/null
+++ b/speech/grpc/src/main/proto/.gitignore
@@ -0,0 +1,4 @@
+OWNERS
+README.google
+google/internal
+google/protobuf
diff --git a/speech/grpc/src/main/proto/google/api/annotations.proto b/speech/grpc/src/main/proto/google/api/annotations.proto
new file mode 100644
index 00000000000..cbd18b847f3
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/api/annotations.proto
@@ -0,0 +1,29 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.api;
+
+import "google/api/http.proto";
+import "google/protobuf/descriptor.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "AnnotationsProto";
+option java_package = "com.google.api";
+
+extend google.protobuf.MethodOptions {
+  // See `HttpRule`.
+  HttpRule http = 72295728;
+}
diff --git a/speech/grpc/src/main/proto/google/api/http.proto b/speech/grpc/src/main/proto/google/api/http.proto
new file mode 100644
index 00000000000..4bbadbb76d0
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/api/http.proto
@@ -0,0 +1,245 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.api;
+
+option java_multiple_files = true;
+option java_outer_classname = "HttpProto";
+option java_package = "com.google.api";
+
+
+// `HttpRule` defines the mapping of an RPC method to one or more HTTP
+// REST APIs.  The mapping determines what portions of the request
+// message are populated from the path, query parameters, or body of
+// the HTTP request.  The mapping is typically specified as an
+// `google.api.http` annotation, see "google/api/annotations.proto"
+// for details.
+//
+// The mapping consists of a field specifying the path template and
+// method kind.  The path template can refer to fields in the request
+// message, as in the example below which describes a REST GET
+// operation on a resource collection of messages:
+//
+// ```proto
+// service Messaging {
+//   rpc GetMessage(GetMessageRequest) returns (Message) {
+//     option (google.api.http).get = "/v1/messages/{message_id}";
+//   }
+// }
+// message GetMessageRequest {
+//   string message_id = 1; // mapped to the URL
+// }
+// message Message {
+//   string text = 1; // content of the resource
+// }
+// ```
+//
+// This definition enables an automatic, bidrectional mapping of HTTP
+// JSON to RPC. Example:
+//
+// HTTP | RPC
+// -----|-----
+// `GET /v1/messages/123456`  | `GetMessage(message_id: "123456")`
+//
+// In general, not only fields but also field paths can be referenced
+// from a path pattern. Fields mapped to the path pattern cannot be
+// repeated and must have a primitive (non-message) type.
+//
+// Any fields in the request message which are not bound by the path
+// pattern automatically become (optional) HTTP query
+// parameters. Assume the following definition of the request message:
+//
+// ```proto
+// message GetMessageRequest {
+//   string message_id = 1; // mapped to the URL
+//   int64 revision = 2;    // becomes a parameter
+// }
+// ```
+//
+// This enables a HTTP JSON to RPC mapping as below:
+//
+// HTTP | RPC
+// -----|-----
+// `GET /v1/messages/123456?revision=2` | `GetMessage(message_id: "123456" revision: 2)`
+//
+// Note that fields which are mapped to HTTP parameters must have a
+// primitive type or a repeated primitive type. Message types are not
+// allowed. In the case of a repeated type, the parameter can be
+// repeated in the URL, as in `...?param=A&param=B`.
+//
+// For HTTP method kinds which allow a request body, the `body` field
+// specifies the mapping. Consider a REST update method on the
+// message resource collection:
+//
+// ```proto
+// service Messaging {
+//   rpc UpdateMessage(UpdateMessageRequest) returns (Message) {
+//     option (google.api.http) = {
+//       put: "/v1/messages/{message_id}"
+//       body: "message"
+//   }
+// }
+// message UpdateMessageRequest {
+//   string message_id = 1; // mapped to the URL
+//   Message message = 2;   // mapped to the body
+// }
+// ```
+//
+// The following HTTP JSON to RPC mapping is enabled, where the
+// representation of the JSON in the request body is determined by
+// protos JSON encoding:
+//
+// HTTP | RPC
+// -----|-----
+// `PUT /v1/messages/123456 { "text": "Hi!" }` | `UpdateMessage(message_id: "123456" message { text: "Hi!" })`
+//
+// The special name `*` can be used in the body mapping to define that
+// every field not bound by the path template should be mapped to the
+// request body.  This enables the following alternative definition of
+// the update method:
+//
+// ```proto
+// service Messaging {
+//   rpc UpdateMessage(Message) returns (Message) {
+//     option (google.api.http) = {
+//       put: "/v1/messages/{message_id}"
+//       body: "*"
+//   }
+// }
+// message Message {
+//   string message_id = 2;
+//   string text = 2;
+// }
+// ```
+//
+// The following HTTP JSON to RPC mapping is enabled:
+//
+// HTTP | RPC
+// -----|-----
+// `PUT /v1/messages/123456 { "text": "Hi!" }` | `UpdateMessage(message_id: "123456" text: "Hi!")`
+//
+// Note that when using `*` in the body mapping, it is not possible to
+// have HTTP parameters, as all fields not bound by the path end in
+// the body. This makes this option more rarely used in practice of
+// defining REST APIs. The common usage of `*` is in custom methods
+// which don't use the URL at all for transferring data.
+//
+// It is possible to define multiple HTTP methods for one RPC by using
+// the `additional_bindings` option. Example:
+//
+// ```proto
+// service Messaging {
+//   rpc GetMessage(GetMessageRequest) returns (Message) {
+//     option (google.api.http) = {
+//       get: "/v1/messages/{message_id}"
+//       additional_bindings {
+//         get: "/v1/users/{user_id}/messages/{message_id}"
+//       }
+//   }
+// }
+// message GetMessageRequest {
+//   string message_id = 1;
+//   string user_id = 2;
+// }
+// ```
+//
+// This enables the following two alternative HTTP JSON to RPC
+// mappings:
+//
+// HTTP | RPC
+// -----|-----
+// `GET /v1/messages/123456` | `GetMessage(message_id: "123456")`
+// `GET /v1/users/me/messages/123456` | `GetMessage(user_id: "me" message_id: "123456")`
+//
+// # Rules for HTTP mapping
+// The rules for mapping HTTP path, query parameters, and body fields
+// to the request message are as follows:
+//
+// 1. The `body` field specifies either `*` or a field path, or is
+//    omitted. If omitted, it assumes there is no HTTP body.
+// 2. Leaf fields (recursive expansion of nested messages in the
+//    request) can be classified into three types:
+//     (a) Matched in the URL template.
+//     (b) Covered by body (if body is `*`, everything except (a) fields;
+//         else everything under the body field)
+//     (c) All other fields.
+// 3. URL query parameters found in the HTTP request are mapped to (c) fields.
+// 4. Any body sent with an HTTP request can contain only (b) fields.
+//
+// The syntax of the path template is as follows:
+//
+//     Template = "/" Segments [ Verb ] ;
+//     Segments = Segment { "/" Segment } ;
+//     Segment  = "*" | "**" | LITERAL | Variable ;
+//     Variable = "{" FieldPath [ "=" Segments ] "}" ;
+//     FieldPath = IDENT { "." IDENT } ;
+//     Verb     = ":" LITERAL ;
+//
+// `*` matches a single path component, `**` zero or more path components, and
+// `LITERAL` a constant.  A `Variable` can match an entire path as specified
+// again by a template; this nested template must not contain further variables.
+// If no template is given with a variable, it matches a single path component.
+// The notation `{var}` is henceforth equivalent to `{var=*}`. NOTE: the field
+// paths in variables and in the `body` must not refer to repeated fields.
+//
+// Use CustomHttpPattern to specify any HTTP method that is not included in the
+// pattern field, such as HEAD, or "*" to leave the HTTP method unspecified for
+// a given URL path rule. The wild-card rule is useful for services that provide
+// content to Web (HTML) clients.
+message HttpRule {
+
+  // Determines the URL pattern is matched by this rules. This pattern can be
+  // used with any of the {get|put|post|delete|patch} methods. A custom method
+  // can be defined using the 'custom' field.
+  oneof pattern {
+    // Used for listing and getting information about resources.
+    string get = 2;
+
+    // Used for updating a resource.
+    string put = 3;
+
+    // Used for creating a resource.
+    string post = 4;
+
+    // Used for deleting a resource.
+    string delete = 5;
+
+    // Used for updating a resource.
+    string patch = 6;
+
+    // Custom pattern is used for defining custom verbs.
+    CustomHttpPattern custom = 8;
+  }
+
+  // The name of the request field whose value is mapped to the HTTP body, or
+  // `*` for mapping all fields not captured by the path pattern to the HTTP
+  // body. NOTE: the referred field must not be a repeated field.
+  string body = 7;
+
+  // Additional HTTP bindings for the selector. Nested bindings must
+  // not contain an `additional_bindings` field themselves (that is,
+  // the nesting may only be one level deep).
+  repeated HttpRule additional_bindings = 11;
+}
+
+// A custom pattern is used for defining custom HTTP verb.
+message CustomHttpPattern {
+  // The name of this custom HTTP verb.
+  string kind = 1;
+
+  // The path matched by this custom verb.
+  string path = 2;
+}
diff --git a/speech/grpc/src/main/proto/google/api/label.proto b/speech/grpc/src/main/proto/google/api/label.proto
new file mode 100644
index 00000000000..680bf119423
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/api/label.proto
@@ -0,0 +1,46 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.api;
+
+option java_multiple_files = true;
+option java_outer_classname = "LabelProto";
+option java_package = "com.google.api";
+
+
+// A description of a label.
+message LabelDescriptor {
+  // Value types that can be used as label values.
+  enum ValueType {
+    // A variable-length string. This is the default.
+    STRING = 0;
+
+    // Boolean; true or false.
+    BOOL = 1;
+
+    // A 64-bit signed integer.
+    INT64 = 2;
+  }
+
+  // The label key.
+  string key = 1;
+
+  // The type of data that can be assigned to the label.
+  ValueType value_type = 2;
+
+  // A human-readable description for the label.
+  string description = 3;
+}
diff --git a/speech/grpc/src/main/proto/google/api/monitored_resource.proto b/speech/grpc/src/main/proto/google/api/monitored_resource.proto
new file mode 100644
index 00000000000..16ac9fad3c0
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/api/monitored_resource.proto
@@ -0,0 +1,64 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.api;
+
+import "google/api/label.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "MonitoredResourceProto";
+option java_package = "com.google.api";
+
+
+// A descriptor that describes the schema of [MonitoredResource][google.api.MonitoredResource].
+message MonitoredResourceDescriptor {
+  // The monitored resource type. For example, the type `"cloudsql_database"`
+  // represents databases in Google Cloud SQL.
+  string type = 1;
+
+  // A concise name for the monitored resource type that can be displayed in
+  // user interfaces. For example, `"Google Cloud SQL Database"`.
+  string display_name = 2;
+
+  // A detailed description of the monitored resource type that can be used in
+  // documentation.
+  string description = 3;
+
+  // A set of labels that can be used to describe instances of this monitored
+  // resource type. For example, Google Cloud SQL databases can be labeled with
+  // their `"database_id"` and their `"zone"`.
+  repeated LabelDescriptor labels = 4;
+}
+
+// A monitored resource describes a resource that can be used for monitoring
+// purpose. It can also be used for logging, billing, and other purposes. Each
+// resource has a `type` and a set of `labels`. The labels contain information
+// that identifies the resource and describes attributes of it. For example,
+// you can use monitored resource to describe a normal file, where the resource
+// has `type` as `"file"`, the label `path` identifies the file, and the label
+// `size` describes the file size. The monitoring system can use a set of
+// monitored resources of files to generate file size distribution.
+message MonitoredResource {
+  // The monitored resource type. This field must match the corresponding
+  // [MonitoredResourceDescriptor.type][google.api.MonitoredResourceDescriptor.type] to this resource..  For example,
+  // `"cloudsql_database"` represents Cloud SQL databases.
+  string type = 1;
+
+  // Values for some or all of the labels listed in the associated monitored
+  // resource descriptor. For example, you specify a specific Cloud SQL database
+  // by supplying values for both the `"database_id"` and `"zone"` labels.
+  map<string, string> labels = 2;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/README.md b/speech/grpc/src/main/proto/google/logging/README.md
new file mode 100644
index 00000000000..6a414eb07b7
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/README.md
@@ -0,0 +1,2 @@
+# Introduction
+The Google logging service.
diff --git a/speech/grpc/src/main/proto/google/logging/type/http_request.proto b/speech/grpc/src/main/proto/google/logging/type/http_request.proto
new file mode 100644
index 00000000000..bd28a36057c
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/type/http_request.proto
@@ -0,0 +1,69 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.type;
+
+import "google/api/annotations.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "HttpRequestProto";
+option java_package = "com.google.logging.type";
+
+
+// A common proto for logging HTTP requests.
+//
+message HttpRequest {
+  // The request method. Examples: `"GET"`, `"HEAD"`, `"PUT"`, `"POST"`.
+  string request_method = 1;
+
+  // The scheme (http, https), the host name, the path and the query
+  // portion of the URL that was requested.
+  // Example: `"http://example.com/some/info?color=red"`.
+  string request_url = 2;
+
+  // The size of the HTTP request message in bytes, including the request
+  // headers and the request body.
+  int64 request_size = 3;
+
+  // The response code indicating the status of response.
+  // Examples: 200, 404.
+  int32 status = 4;
+
+  // The size of the HTTP response message sent back to the client, in bytes,
+  // including the response headers and the response body.
+  int64 response_size = 5;
+
+  // The user agent sent by the client. Example:
+  // `"Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)"`.
+  string user_agent = 6;
+
+  // The IP address (IPv4 or IPv6) of the client that issued the HTTP
+  // request. Examples: `"192.168.1.1"`, `"FE80::0202:B3FF:FE1E:8329"`.
+  string remote_ip = 7;
+
+  // The referer URL of the request, as defined in
+  // [HTTP/1.1 Header Field Definitions](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
+  string referer = 8;
+
+  // Whether or not an entity was served from cache
+  // (with or without validation).
+  bool cache_hit = 9;
+
+  // Whether or not the response was validated with the origin server before
+  // being served from cache. This field is only meaningful if `cache_hit` is
+  // True.
+  bool validated_with_origin_server = 10;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/type/log_severity.proto b/speech/grpc/src/main/proto/google/logging/type/log_severity.proto
new file mode 100644
index 00000000000..77bdeeac981
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/type/log_severity.proto
@@ -0,0 +1,62 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.type;
+
+import "google/api/annotations.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "LogSeverityProto";
+option java_package = "com.google.logging.type";
+
+
+// The severity of the event described in a log entry.  These guideline severity
+// levels are ordered, with numerically smaller levels treated as less severe
+// than numerically larger levels. If the source of the log entries uses a
+// different set of severity levels, the client should select the closest
+// corresponding `LogSeverity` value. For example, Java's FINE, FINER, and
+// FINEST levels might all map to `LogSeverity.DEBUG`. If the original severity
+// code must be preserved, it can be stored in the payload.
+//
+enum LogSeverity {
+  // The log entry has no assigned severity level.
+  DEFAULT = 0;
+
+  // Debug or trace information.
+  DEBUG = 100;
+
+  // Routine information, such as ongoing status or performance.
+  INFO = 200;
+
+  // Normal but significant events, such as start up, shut down, or
+  // configuration.
+  NOTICE = 300;
+
+  // Warning events might cause problems.
+  WARNING = 400;
+
+  // Error events are likely to cause problems.
+  ERROR = 500;
+
+  // Critical events cause more severe problems or brief outages.
+  CRITICAL = 600;
+
+  // A person must take an action immediately.
+  ALERT = 700;
+
+  // One or more systems are unusable.
+  EMERGENCY = 800;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/v2/log_entry.proto b/speech/grpc/src/main/proto/google/logging/v2/log_entry.proto
new file mode 100644
index 00000000000..5fb8e8e2783
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/v2/log_entry.proto
@@ -0,0 +1,114 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_resource.proto";
+import "google/logging/type/http_request.proto";
+import "google/logging/type/log_severity.proto";
+import "google/protobuf/any.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "LogEntryProto";
+option java_package = "com.google.logging.v2";
+
+
+// An individual entry in a log.
+message LogEntry {
+  // Required. The resource name of the log to which this log entry
+  // belongs. The format of the name is
+  // `projects/&lt;project-id&gt;/logs/&lt;log-id%gt;`.  Examples:
+  // `"projects/my-projectid/logs/syslog"`,
+  // `"projects/1234567890/logs/library.googleapis.com%2Fbook_log"`.
+  //
+  // The log ID part of resource name must be less than 512 characters
+  // long and can only include the following characters: upper and
+  // lower case alphanumeric characters: [A-Za-z0-9]; and punctuation
+  // characters: forward-slash, underscore, hyphen, and period.
+  // Forward-slash (`/`) characters in the log ID must be URL-encoded.
+  string log_name = 12;
+
+  // Required. The monitored resource associated with this log entry.
+  // Example: a log entry that reports a database error would be
+  // associated with the monitored resource designating the particular
+  // database that reported the error.
+  google.api.MonitoredResource resource = 8;
+
+  // Required. The log entry payload, which can be one of multiple types.
+  oneof payload {
+    // The log entry payload, represented as a protocol buffer.
+    // You can only use `protoPayload` values that belong to a set of approved
+    // types.
+    google.protobuf.Any proto_payload = 2;
+
+    // The log entry payload, represented as a Unicode string (UTF-8).
+    string text_payload = 3;
+
+    // The log entry payload, represented as a structure that
+    // is expressed as a JSON object.
+    google.protobuf.Struct json_payload = 6;
+  }
+
+  // Optional. The time the event described by the log entry occurred.  If
+  // omitted, Cloud Logging will use the time the log entry is written.
+  google.protobuf.Timestamp timestamp = 9;
+
+  // Optional. The severity of the log entry. The default value is
+  // `LogSeverity.DEFAULT`.
+  google.logging.type.LogSeverity severity = 10;
+
+  // Optional. A unique ID for the log entry. If you provide this field, the
+  // logging service considers other log entries in the same log with the same
+  // ID as duplicates which can be removed.
+  // If omitted, Cloud Logging will generate a unique ID for this log entry.
+  string insert_id = 4;
+
+  // Optional. Information about the HTTP request associated with this log entry,
+  // if applicable.
+  google.logging.type.HttpRequest http_request = 7;
+
+  // Optional. A set of user-defined (key, value) data that provides additional
+  // information about the log entry.
+  map<string, string> labels = 11;
+
+  // Optional. Information about an operation associated with the log entry, if
+  // applicable.
+  LogEntryOperation operation = 15;
+}
+
+// Additional information about a potentially long-running operation with which
+// a log entry is associated.
+message LogEntryOperation {
+  // Required. An arbitrary operation identifier. Log entries with the
+  // same identifier are assumed to be part of the same operation.
+  //
+  string id = 1;
+
+  // Required. An arbitrary producer identifier. The combination of
+  // `id` and `producer` must be globally unique.  Examples for `producer`:
+  // `"MyDivision.MyBigCompany.com"`, "github.com/MyProject/MyApplication"`.
+  //
+  string producer = 2;
+
+  // Optional. Set this to True if this is the first log entry in the operation.
+  bool first = 3;
+
+  // Optional. Set this to True if this is the last log entry in the operation.
+  bool last = 4;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/v2/logging.proto b/speech/grpc/src/main/proto/google/logging/v2/logging.proto
new file mode 100644
index 00000000000..44230fcde70
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/v2/logging.proto
@@ -0,0 +1,167 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/api/monitored_resource.proto";
+import "google/logging/v2/log_entry.proto";
+import "google/protobuf/empty.proto";
+import "google/rpc/status.proto";
+
+option cc_enable_arenas = true;
+option java_multiple_files = true;
+option java_outer_classname = "LoggingProto";
+option java_package = "com.google.logging.v2";
+
+
+// Service for ingesting and querying logs.
+service LoggingServiceV2 {
+  // Deletes a log and all its log entries.
+  // The log will reappear if it receives new entries.
+  //
+  rpc DeleteLog(DeleteLogRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v2beta1/{log_name=projects/*/logs/*}" };
+  }
+
+  // Writes log entries to Cloud Logging.
+  // All log entries in Cloud Logging are written by this method.
+  //
+  rpc WriteLogEntries(WriteLogEntriesRequest) returns (WriteLogEntriesResponse) {
+    option (google.api.http) = { post: "/v2beta1/entries:write" body: "*" };
+  }
+
+  // Lists log entries.  Use this method to retrieve log entries from Cloud
+  // Logging.  For ways to export log entries, see
+  // [Exporting Logs](/logging/docs/export).
+  //
+  rpc ListLogEntries(ListLogEntriesRequest) returns (ListLogEntriesResponse) {
+    option (google.api.http) = { post: "/v2beta1/entries:list" body: "*" };
+  }
+
+  // Lists monitored resource descriptors that are used by Cloud Logging.
+  rpc ListMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest) returns (ListMonitoredResourceDescriptorsResponse) {
+    option (google.api.http) = { get: "/v2beta1/monitoredResourceDescriptors" };
+  }
+}
+
+// The parameters to DeleteLog.
+message DeleteLogRequest {
+  // Required. The resource name of the log to delete.  Example:
+  // `"projects/my-project/logs/syslog"`.
+  string log_name = 1;
+}
+
+// The parameters to WriteLogEntries.
+message WriteLogEntriesRequest {
+  // Optional. A default log resource name for those log entries in `entries`
+  // that do not specify their own `logName`.  Example:
+  // `"projects/my-project/logs/syslog"`.  See
+  // [LogEntry][google.logging.v2.LogEntry].
+  string log_name = 1;
+
+  // Optional. A default monitored resource for those log entries in `entries`
+  // that do not specify their own `resource`.
+  google.api.MonitoredResource resource = 2;
+
+  // Optional. User-defined `key:value` items that are added to
+  // the `labels` field of each log entry in `entries`, except when a log
+  // entry specifies its own `key:value` item with the same key.
+  // Example: `{ "size": "large", "color":"red" }`
+  map<string, string> labels = 3;
+
+  // Required. The log entries to write. The log entries must have values for
+  // all required fields.
+  repeated LogEntry entries = 4;
+}
+
+// Result returned from WriteLogEntries.
+message WriteLogEntriesResponse {
+
+}
+
+// The parameters to `ListLogEntries`.
+message ListLogEntriesRequest {
+  // Required. One or more project IDs or project numbers from which to retrieve
+  // log entries.  Examples of a project ID: `"my-project-1A"`, `"1234567890"`.
+  repeated string project_ids = 1;
+
+  // Optional. An [advanced logs filter](/logging/docs/view/advanced_filters).
+  // The filter is compared against all log entries in the projects specified by
+  // `projectIds`.  Only entries that match the filter are retrieved.  An empty
+  // filter matches all log entries.
+  string filter = 2;
+
+  // Optional. How the results should be sorted.  Presently, the only permitted
+  // values are `"timestamp"` (default) and `"timestamp desc"`.  The first
+  // option returns entries in order of increasing values of
+  // `LogEntry.timestamp` (oldest first), and the second option returns entries
+  // in order of decreasing timestamps (newest first).  Entries with equal
+  // timestamps are returned in order of `LogEntry.insertId`.
+  string order_by = 3;
+
+  // Optional. The maximum number of results to return from this request.  Fewer
+  // results might be returned. You must check for the `nextPageToken` result to
+  // determine if additional results are available, which you can retrieve by
+  // passing the `nextPageToken` value in the `pageToken` parameter to the next
+  // request.
+  int32 page_size = 4;
+
+  // Optional. If the `pageToken` request parameter is supplied, then the next
+  // page of results in the set are retrieved.  The `pageToken` parameter must
+  // be set with the value of the `nextPageToken` result parameter from the
+  // previous request.  The values of `projectIds`, `filter`, and `orderBy` must
+  // be the same as in the previous request.
+  string page_token = 5;
+}
+
+// Result returned from `ListLogEntries`.
+message ListLogEntriesResponse {
+  // A list of log entries.
+  repeated LogEntry entries = 1;
+
+  // If there are more results than were returned, then `nextPageToken` is
+  // given a value in the response.  To get the next batch of results, call
+  // this method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
+
+// The parameters to ListMonitoredResourceDescriptors
+message ListMonitoredResourceDescriptorsRequest {
+  // Optional. The maximum number of results to return from this request.  Fewer
+  // results might be returned. You must check for the `nextPageToken` result to
+  // determine if additional results are available, which you can retrieve by
+  // passing the `nextPageToken` value in the `pageToken` parameter to the next
+  // request.
+  int32 page_size = 1;
+
+  // Optional. If the `pageToken` request parameter is supplied, then the next
+  // page of results in the set are retrieved.  The `pageToken` parameter must
+  // be set with the value of the `nextPageToken` result parameter from the
+  // previous request.
+  string page_token = 2;
+}
+
+// Result returned from ListMonitoredResourceDescriptors.
+message ListMonitoredResourceDescriptorsResponse {
+  // A list of resource descriptors.
+  repeated google.api.MonitoredResourceDescriptor resource_descriptors = 1;
+
+  // If there are more results than were returned, then `nextPageToken` is
+  // returned in the response.  To get the next batch of results, call this
+  // method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/v2/logging_config.proto b/speech/grpc/src/main/proto/google/logging/v2/logging_config.proto
new file mode 100644
index 00000000000..5fdc407af84
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/v2/logging_config.proto
@@ -0,0 +1,171 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/timestamp.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "LoggingConfig";
+option java_package = "com.google.logging.v2";
+
+
+service ConfigServiceV2 {
+  // Lists sinks.
+  rpc ListSinks(ListSinksRequest) returns (ListSinksResponse) {
+    option (google.api.http) = { get: "/v2beta1/{project_name=projects/*}/sinks" };
+  }
+
+  // Gets a sink.
+  rpc GetSink(GetSinkRequest) returns (LogSink) {
+    option (google.api.http) = { get: "/v2beta1/{sink_name=projects/*/sinks/*}" };
+  }
+
+  // Creates a sink.
+  rpc CreateSink(CreateSinkRequest) returns (LogSink) {
+    option (google.api.http) = { post: "/v2beta1/{project_name=projects/*}/sinks" body: "sink" };
+  }
+
+  // Creates or updates a sink.
+  rpc UpdateSink(UpdateSinkRequest) returns (LogSink) {
+    option (google.api.http) = { put: "/v2beta1/{sink_name=projects/*/sinks/*}" body: "sink" };
+  }
+
+  // Deletes a sink.
+  rpc DeleteSink(DeleteSinkRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v2beta1/{sink_name=projects/*/sinks/*}" };
+  }
+}
+
+// Describes a sink used to export log entries outside Cloud Logging.
+message LogSink {
+  // Available log entry formats. Log entries can be written to Cloud
+  // Logging in either format and can be exported in either format.
+  // Version 2 is the preferred format.
+  enum VersionFormat {
+    // An unspecified version format will default to V2.
+    VERSION_FORMAT_UNSPECIFIED = 0;
+
+    // `LogEntry` version 2 format.
+    V2 = 1;
+
+    // `LogEntry` version 1 format.
+    V1 = 2;
+  }
+
+  // Required. The client-assigned sink identifier. Example:
+  // `"my-severe-errors-to-pubsub"`.
+  // Sink identifiers are limited to 1000 characters
+  // and can include only the following characters: `A-Z`, `a-z`,
+  // `0-9`, and the special characters `_-.`.
+  string name = 1;
+
+  // The export destination. See
+  // [Exporting Logs With Sinks](/logging/docs/api/tasks/exporting-logs).
+  // Examples: `"storage.googleapis.com/a-bucket"`,
+  // `"bigquery.googleapis.com/projects/a-project-id/datasets/a-dataset"`.
+  string destination = 3;
+
+  // An [advanced logs filter](/logging/docs/view/advanced_filters)
+  // that defines the log entries to be exported.  The filter must be
+  // consistent with the log entry format designed by the
+  // `outputVersionFormat` parameter, regardless of the format of the
+  // log entry that was originally written to Cloud Logging.
+  // Example: `"logName:syslog AND severity>=ERROR"`.
+  string filter = 5;
+
+  // The log entry version used when exporting log entries from this
+  // sink.  This version does not have to correspond to the version of
+  // the log entry when it was written to Cloud Logging.
+  VersionFormat output_version_format = 6;
+}
+
+// The parameters to `ListSinks`.
+message ListSinksRequest {
+  // Required. The resource name of the project containing the sinks.
+  // Example: `"projects/my-logging-project"`, `"projects/01234567890"`.
+  string project_name = 1;
+
+  // Optional. If the `pageToken` request parameter is supplied, then the next
+  // page of results in the set are retrieved.  The `pageToken` parameter must
+  // be set with the value of the `nextPageToken` result parameter from the
+  // previous request. The value of `projectName` must be the same as in the
+  // previous request.
+  string page_token = 2;
+
+  // Optional. The maximum number of results to return from this request.  Fewer
+  // results might be returned. You must check for the `nextPageToken` result to
+  // determine if additional results are available, which you can retrieve by
+  // passing the `nextPageToken` value in the `pageToken` parameter to the next
+  // request.
+  int32 page_size = 3;
+}
+
+// Result returned from `ListSinks`.
+message ListSinksResponse {
+  // A list of sinks.
+  repeated LogSink sinks = 1;
+
+  // If there are more results than were returned, then `nextPageToken` is
+  // given a value in the response.  To get the next batch of results, call this
+  // method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
+
+// The parameters to `GetSink`.
+message GetSinkRequest {
+  // The resource name of the sink to return.
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  string sink_name = 1;
+}
+
+// The parameters to `CreateSink`.
+message CreateSinkRequest {
+  // The resource name of the project in which to create the sink.
+  // Example: `"projects/my-project-id"`.
+  //
+  // The new sink must be provided in the request.
+  string project_name = 1;
+
+  // The new sink, which must not have an identifier that already
+  // exists.
+  LogSink sink = 2;
+}
+
+// The parameters to `UpdateSink`.
+message UpdateSinkRequest {
+  // The resource name of the sink to update.
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  //
+  // The updated sink must be provided in the request and have the
+  // same name that is specified in `sinkName`.  If the sink does not
+  // exist, it is created.
+  string sink_name = 1;
+
+  // The updated sink, whose name must be the same as the sink
+  // identifier in `sinkName`.  If `sinkName` does not exist, then
+  // this method creates a new sink.
+  LogSink sink = 2;
+}
+
+// The parameters to `DeleteSink`.
+message DeleteSinkRequest {
+  // The resource name of the sink to delete.
+  // Example: `"projects/my-project-id/sinks/my-sink-id"`.
+  string sink_name = 1;
+}
diff --git a/speech/grpc/src/main/proto/google/logging/v2/logging_metrics.proto b/speech/grpc/src/main/proto/google/logging/v2/logging_metrics.proto
new file mode 100644
index 00000000000..638cbc377ab
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/logging/v2/logging_metrics.proto
@@ -0,0 +1,146 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.logging.v2;
+
+import "google/api/annotations.proto";
+import "google/protobuf/empty.proto";
+
+option java_multiple_files = true;
+option java_package = "com.google.logging.v2";
+
+
+service MetricsServiceV2 {
+  // Lists logs-based metrics.
+  rpc ListLogMetrics(ListLogMetricsRequest) returns (ListLogMetricsResponse) {
+    option (google.api.http) = { get: "/v2beta1/{project_name=projects/*}/metrics" };
+  }
+
+  // Gets a logs-based metric.
+  rpc GetLogMetric(GetLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = { get: "/v2beta1/{metric_name=projects/*/metrics/*}" };
+  }
+
+  // Creates a logs-based metric.
+  rpc CreateLogMetric(CreateLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = { post: "/v2beta1/{project_name=projects/*}/metrics" body: "metric" };
+  }
+
+  // Creates or updates a logs-based metric.
+  rpc UpdateLogMetric(UpdateLogMetricRequest) returns (LogMetric) {
+    option (google.api.http) = { put: "/v2beta1/{metric_name=projects/*/metrics/*}" body: "metric" };
+  }
+
+  // Deletes a logs-based metric.
+  rpc DeleteLogMetric(DeleteLogMetricRequest) returns (google.protobuf.Empty) {
+    option (google.api.http) = { delete: "/v2beta1/{metric_name=projects/*/metrics/*}" };
+  }
+}
+
+// Describes a logs-based metric.  The value of the metric is the
+// number of log entries that match a logs filter.
+message LogMetric {
+  // Required. The client-assigned metric identifier. Example:
+  // `"severe_errors"`.  Metric identifiers are limited to 1000
+  // characters and can include only the following characters: `A-Z`,
+  // `a-z`, `0-9`, and the special characters `_-.,+!*',()%/\`.  The
+  // forward-slash character (`/`) denotes a hierarchy of name pieces,
+  // and it cannot be the first character of the name.
+  string name = 1;
+
+  // A description of this metric, which is used in documentation.
+  string description = 2;
+
+  // An [advanced logs filter](/logging/docs/view/advanced_filters).
+  // Example: `"logName:syslog AND severity>=ERROR"`.
+  string filter = 3;
+}
+
+// The parameters to ListLogMetrics.
+message ListLogMetricsRequest {
+  // Required. The resource name of the project containing the metrics.
+  // Example: `"projects/my-project-id"`.
+  string project_name = 1;
+
+  // Optional. If the `pageToken` request parameter is supplied, then the next
+  // page of results in the set are retrieved.  The `pageToken` parameter must
+  // be set with the value of the `nextPageToken` result parameter from the
+  // previous request.  The value of `projectName` must
+  // be the same as in the previous request.
+  string page_token = 2;
+
+  // Optional. The maximum number of results to return from this request.  Fewer
+  // results might be returned. You must check for the `nextPageToken` result to
+  // determine if additional results are available, which you can retrieve by
+  // passing the `nextPageToken` value in the `pageToken` parameter to the next
+  // request.
+  int32 page_size = 3;
+}
+
+// Result returned from ListLogMetrics.
+message ListLogMetricsResponse {
+  // A list of logs-based metrics.
+  repeated LogMetric metrics = 1;
+
+  // If there are more results than were returned, then `nextPageToken` is given
+  // a value in the response.  To get the next batch of results, call this
+  // method again using the value of `nextPageToken` as `pageToken`.
+  string next_page_token = 2;
+}
+
+// The parameters to GetLogMetric.
+message GetLogMetricRequest {
+  // The resource name of the desired metric.
+  // Example: `"projects/my-project-id/metrics/my-metric-id"`.
+  string metric_name = 1;
+}
+
+// The parameters to CreateLogMetric.
+message CreateLogMetricRequest {
+  // The resource name of the project in which to create the metric.
+  // Example: `"projects/my-project-id"`.
+  //
+  // The new metric must be provided in the request.
+  string project_name = 1;
+
+  // The new logs-based metric, which must not have an identifier that
+  // already exists.
+  LogMetric metric = 2;
+}
+
+// The parameters to UpdateLogMetric.
+//
+message UpdateLogMetricRequest {
+  // The resource name of the metric to update.
+  // Example: `"projects/my-project-id/metrics/my-metric-id"`.
+  //
+  // The updated metric must be provided in the request and have the
+  // same identifier that is specified in `metricName`.
+  // If the metric does not exist, it is created.
+  string metric_name = 1;
+
+  // The updated metric, whose name must be the same as the
+  // metric identifier in `metricName`. If `metricName` does not
+  // exist, then a new metric is created.
+  LogMetric metric = 2;
+}
+
+// The parameters to DeleteLogMetric.
+message DeleteLogMetricRequest {
+  // The resource name of the metric to delete.
+  // Example: `"projects/my-project-id/metrics/my-metric-id"`.
+  string metric_name = 1;
+}
diff --git a/speech/grpc/src/main/proto/google/rpc/README.md b/speech/grpc/src/main/proto/google/rpc/README.md
new file mode 100644
index 00000000000..aa8877db842
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/rpc/README.md
@@ -0,0 +1,5 @@
+# Google RPC
+
+This package contains type definitions for general RPC systems. While
+[gRPC](https://github.com/grpc) is using these defintions, but they
+are not designed specifically to support gRPC.
diff --git a/speech/grpc/src/main/proto/google/rpc/code.proto b/speech/grpc/src/main/proto/google/rpc/code.proto
new file mode 100644
index 00000000000..f9ceddcbc10
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/rpc/code.proto
@@ -0,0 +1,190 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.rpc;
+
+option java_multiple_files = true;
+option java_outer_classname = "CodeProto";
+option java_package = "com.google.rpc";
+
+
+// The canonical error codes for Google APIs.
+// Warnings:
+//
+// -   Do not change any numeric assignments.
+// -   Changes to this list should be made only if there is a compelling
+//     need that can't be satisfied in another way.
+//
+// Sometimes multiple error codes may apply.  Services should return
+// the most specific error code that applies.  For example, prefer
+// `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+// Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+enum Code {
+  // Not an error; returned on success
+  //
+  // HTTP Mapping: 200 OK
+  OK = 0;
+
+  // The operation was cancelled, typically by the caller.
+  //
+  // HTTP Mapping: 499 Client Closed Request
+  CANCELLED = 1;
+
+  // Unknown error.  For example, this error may be returned when
+  // a `Status` value received from another address space belongs to
+  // an error space that is not known in this address space.  Also
+  // errors raised by APIs that do not return enough error information
+  // may be converted to this error.
+  //
+  // HTTP Mapping: 500 Internal Server Error
+  UNKNOWN = 2;
+
+  // The client specified an invalid argument.  Note that this differs
+  // from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+  // that are problematic regardless of the state of the system
+  // (e.g., a malformed file name).
+  //
+  // HTTP Mapping: 400 Bad Request
+  INVALID_ARGUMENT = 3;
+
+  // The deadline expired before the operation could complete. For operations
+  // that change the state of the system, this error may be returned
+  // even if the operation has completed successfully.  For example, a
+  // successful response from a server could have been delayed long
+  // enough for the deadline to expire.
+  //
+  // HTTP Mapping: 504 Gateway Timeout
+  DEADLINE_EXCEEDED = 4;
+
+  // Some requested entity (e.g., file or directory) was not found.
+  // For privacy reasons, this code *might* be returned when the client
+  // does not have the access rights to the entity.
+  //
+  // HTTP Mapping: 404 Not Found
+  NOT_FOUND = 5;
+
+  // The entity that a client attempted to create (e.g., file or directory)
+  // already exists.
+  //
+  // HTTP Mapping: 409 Conflict
+  ALREADY_EXISTS = 6;
+
+  // The caller does not have permission to execute the specified
+  // operation. `PERMISSION_DENIED` must not be used for rejections
+  // caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+  // instead for those errors). `PERMISSION_DENIED` must not be
+  // used if the caller can not be identified (use `UNAUTHENTICATED`
+  // instead for those errors).
+  //
+  // HTTP Mapping: 403 Forbidden
+  PERMISSION_DENIED = 7;
+
+  // The request does not have valid authentication credentials for the
+  // operation.
+  //
+  // HTTP Mapping: 401 Unauthorized
+  UNAUTHENTICATED = 16;
+
+  // Some resource has been exhausted, perhaps a per-user quota, or
+  // perhaps the entire file system is out of space.
+  //
+  // HTTP Mapping: 429 Too Many Requests
+  RESOURCE_EXHAUSTED = 8;
+
+  // The operation was rejected because the system is not in a state
+  // required for the operation's execution.  For example, the directory
+  // to be deleted is non-empty, an rmdir operation is applied to
+  // a non-directory, etc.
+  //
+  // Service implementors can use the following guidelines to decide
+  // between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+  //  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+  //  (b) Use `ABORTED` if the client should retry at a higher level
+  //      (e.g., restarting a read-modify-write sequence).
+  //  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+  //      the system state has been explicitly fixed.  E.g., if an "rmdir"
+  //      fails because the directory is non-empty, `FAILED_PRECONDITION`
+  //      should be returned since the client should not retry unless
+  //      the files are deleted from the directory.
+  //  (d) Use `FAILED_PRECONDITION` if the client performs conditional
+  //      REST Get/Update/Delete on a resource and the resource on the
+  //      server does not match the condition. E.g., conflicting
+  //      read-modify-write on the same resource.
+  //
+  // HTTP Mapping: 400 Bad Request
+  //
+  // NOTE: HTTP spec says `412 Precondition Failed` should be used only if
+  // the request contains Etag-related headers. So if the server does see
+  // Etag-related headers in the request, it may choose to return 412
+  // instead of 400 for this error code.
+  FAILED_PRECONDITION = 9;
+
+  // The operation was aborted, typically due to a concurrency issue such as
+  // a sequencer check failure or transaction abort.
+  //
+  // See the guidelines above for deciding between `FAILED_PRECONDITION`,
+  // `ABORTED`, and `UNAVAILABLE`.
+  //
+  // HTTP Mapping: 409 Conflict
+  ABORTED = 10;
+
+  // The operation was attempted past the valid range.  E.g., seeking or
+  // reading past end-of-file.
+  //
+  // Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+  // be fixed if the system state changes. For example, a 32-bit file
+  // system will generate `INVALID_ARGUMENT` if asked to read at an
+  // offset that is not in the range [0,2^32-1], but it will generate
+  // `OUT_OF_RANGE` if asked to read from an offset past the current
+  // file size.
+  //
+  // There is a fair bit of overlap between `FAILED_PRECONDITION` and
+  // `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+  // error) when it applies so that callers who are iterating through
+  // a space can easily look for an `OUT_OF_RANGE` error to detect when
+  // they are done.
+  //
+  // HTTP Mapping: 400 Bad Request
+  OUT_OF_RANGE = 11;
+
+  // The operation is not implemented or is not supported/enabled in this
+  // service.
+  //
+  // HTTP Mapping: 501 Not Implemented
+  UNIMPLEMENTED = 12;
+
+  // Internal errors.  This means that some invariants expected by the
+  // underlying system have been broken.  This error code is reserved
+  // for serious errors.
+  //
+  // HTTP Mapping: 500 Internal Server Error
+  INTERNAL = 13;
+
+  // The service is currently unavailable.  This is most likely a
+  // transient condition, which can be corrected by retrying with
+  // a backoff.
+  //
+  // See the guidelines above for deciding between `FAILED_PRECONDITION`,
+  // `ABORTED`, and `UNAVAILABLE`.
+  //
+  // HTTP Mapping: 503 Service Unavailable
+  UNAVAILABLE = 14;
+
+  // Unrecoverable data loss or corruption.
+  //
+  // HTTP Mapping: 500 Internal Server Error
+  DATA_LOSS = 15;
+}
diff --git a/speech/grpc/src/main/proto/google/rpc/error_details.proto b/speech/grpc/src/main/proto/google/rpc/error_details.proto
new file mode 100644
index 00000000000..82472b8b2e6
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/rpc/error_details.proto
@@ -0,0 +1,157 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.rpc;
+
+import "google/protobuf/duration.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "ErrorDetailsProto";
+option java_package = "com.google.rpc";
+
+
+// Describes when the clients can retry a failed request. Clients could ignore
+// the recommendation here or retry when this information is missing from error
+// responses.
+//
+// It's always recommended that clients should use exponential backoff when
+// retrying.
+//
+// Clients should wait until `retry_delay` amount of time has passed since
+// receiving the error response before retrying.  If retrying requests also
+// fail, clients should use an exponential backoff scheme to gradually increase
+// the delay between retries based on `retry_delay`, until either a maximum
+// number of retires have been reached or a maximum retry delay cap has been
+// reached.
+message RetryInfo {
+  // Clients should wait at least this long between retrying the same request.
+  google.protobuf.Duration retry_delay = 1;
+}
+
+// Describes additional debugging info.
+message DebugInfo {
+  // The stack trace entries indicating where the error occurred.
+  repeated string stack_entries = 1;
+
+  // Additional debugging information provided by the server.
+  string detail = 2;
+}
+
+// Describes how a quota check failed.
+//
+// For example if a daily limit was exceeded for the calling project,
+// a service could respond with a QuotaFailure detail containing the project
+// id and the description of the quota limit that was exceeded.  If the
+// calling project hasn't enabled the service in the developer console, then
+// a service could respond with the project id and set `service_disabled`
+// to true.
+//
+// Also see RetryDetail and Help types for other details about handling a
+// quota failure.
+message QuotaFailure {
+  // A message type used to describe a single quota violation.  For example, a
+  // daily quota or a custom quota that was exceeded.
+  message Violation {
+    // The subject on which the quota check failed.
+    // For example, "clientip:<ip address of client>" or "project:<Google
+    // developer project id>".
+    string subject = 1;
+
+    // A description of how the quota check failed. Clients can use this
+    // description to find more about the quota configuration in the service's
+    // public documentation, or find the relevant quota limit to adjust through
+    // developer console.
+    //
+    // For example: "Service disabled" or "Daily Limit for read operations
+    // exceeded".
+    string description = 2;
+  }
+
+  // Describes all quota violations.
+  repeated Violation violations = 1;
+}
+
+// Describes violations in a client request. This error type focuses on the
+// syntactic aspects of the request.
+message BadRequest {
+  // A message type used to describe a single bad request field.
+  message FieldViolation {
+    // A path leading to a field in the request body. The value will be a
+    // sequence of dot-separated identifiers that identify a protocol buffer
+    // field. E.g., "violations.field" would identify this field.
+    string field = 1;
+
+    // A description of why the request element is bad.
+    string description = 2;
+  }
+
+  // Describes all violations in a client request.
+  repeated FieldViolation field_violations = 1;
+}
+
+// Contains metadata about the request that clients can attach when filing a bug
+// or providing other forms of feedback.
+message RequestInfo {
+  // An opaque string that should only be interpreted by the service generating
+  // it. For example, it can be used to identify requests in the service's logs.
+  string request_id = 1;
+
+  // Any data that was used to serve this request. For example, an encrypted
+  // stack trace that can be sent back to the service provider for debugging.
+  string serving_data = 2;
+}
+
+// Describes the resource that is being accessed.
+message ResourceInfo {
+  // A name for the type of resource being accessed, e.g. "sql table",
+  // "cloud storage bucket", "file", "Google calendar"; or the type URL
+  // of the resource: e.g. "type.googleapis.com/google.pubsub.v1.Topic".
+  string resource_type = 1;
+
+  // The name of the resource being accessed.  For example, a shared calendar
+  // name: "example.com_4fghdhgsrgh@group.calendar.google.com", if the current
+  // error is [google.rpc.Code.PERMISSION_DENIED][google.rpc.Code.PERMISSION_DENIED].
+  string resource_name = 2;
+
+  // The owner of the resource (optional).
+  // For example, "user:<owner email>" or "project:<Google developer project
+  // id>".
+  string owner = 3;
+
+  // Describes what error is encountered when accessing this resource.
+  // For example, updating a cloud project may require the `writer` permission
+  // on the developer console project.
+  string description = 4;
+}
+
+// Provides links to documentation or for performing an out of band action.
+//
+// For example, if a quota check failed with an error indicating the calling
+// project hasn't enabled the accessed service, this can contain a URL pointing
+// directly to the right place in the developer console to flip the bit.
+message Help {
+  // Describes a URL link.
+  message Link {
+    // Describes what the link offers.
+    string description = 1;
+
+    // The URL of the link.
+    string url = 2;
+  }
+
+  // URL(s) pointing to additional information on handling the current error.
+  repeated Link links = 1;
+}
diff --git a/speech/grpc/src/main/proto/google/rpc/status.proto b/speech/grpc/src/main/proto/google/rpc/status.proto
new file mode 100644
index 00000000000..8fca6ab22d9
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/rpc/status.proto
@@ -0,0 +1,90 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.rpc;
+
+import "google/protobuf/any.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "StatusProto";
+option java_package = "com.google.rpc";
+
+
+// The `Status` type defines a logical error model that is suitable for different
+// programming environments, including REST APIs and RPC APIs. It is used by
+// [gRPC](https://github.com/grpc). The error model is designed to be:
+//
+// - Simple to use and understand for most users
+// - Flexible enough to meet unexpected needs
+//
+// # Overview
+//
+// The `Status` message contains three pieces of data: error code, error message,
+// and error details. The error code should be an enum value of
+// [google.rpc.Code][google.rpc.Code], but it may accept additional error codes if needed.  The
+// error message should be a developer-facing English message that helps
+// developers *understand* and *resolve* the error. If a localized user-facing
+// error message is needed, put the localized message in the error details or
+// localize it in the client. The optional error details may contain arbitrary
+// information about the error. There is a predefined set of error detail types
+// in the package `google.rpc` which can be used for common error conditions.
+//
+// # Language mapping
+//
+// The `Status` message is the logical representation of the error model, but it
+// is not necessarily the actual wire format. When the `Status` message is
+// exposed in different client libraries and different wire protocols, it can be
+// mapped differently. For example, it will likely be mapped to some exceptions
+// in Java, but more likely mapped to some error codes in C.
+//
+// # Other uses
+//
+// The error model and the `Status` message can be used in a variety of
+// environments, either with or without APIs, to provide a
+// consistent developer experience across different environments.
+//
+// Example uses of this error model include:
+//
+// - Partial errors. If a service needs to return partial errors to the client,
+//     it may embed the `Status` in the normal response to indicate the partial
+//     errors.
+//
+// - Workflow errors. A typical workflow has multiple steps. Each step may
+//     have a `Status` message for error reporting purpose.
+//
+// - Batch operations. If a client uses batch request and batch response, the
+//     `Status` message should be used directly inside batch response, one for
+//     each error sub-response.
+//
+// - Asynchronous operations. If an API call embeds asynchronous operation
+//     results in its response, the status of those operations should be
+//     represented directly using the `Status` message.
+//
+// - Logging. If some API errors are stored in logs, the message `Status` could
+//     be used directly after any stripping needed for security/privacy reasons.
+message Status {
+  // The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+  int32 code = 1;
+
+  // A developer-facing error message, which should be in English. Any
+  // user-facing error message should be localized and sent in the
+  // [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.
+  string message = 2;
+
+  // A list of messages that carry the error details.  There will be a
+  // common set of message types for APIs to use.
+  repeated google.protobuf.Any details = 3;
+}
diff --git a/speech/grpc/src/main/proto/google/speech/v1/cloud-speech.proto b/speech/grpc/src/main/proto/google/speech/v1/cloud-speech.proto
new file mode 100644
index 00000000000..6ee3b031552
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/speech/v1/cloud-speech.proto
@@ -0,0 +1,238 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.cloud.speech.v1;
+
+import "google/api/annotations.proto";
+import "google/rpc/status.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "SpeechProto";
+option java_package = "com.google.cloud.speech.v1";
+
+// Service that implements Google Cloud Speech API.
+service Speech {
+  // Perform bidirectional streaming speech recognition on audio using gRPC.
+  rpc Recognize(stream RecognizeRequest) returns (stream RecognizeResponse);
+
+  // Perform non-streaming speech recognition on audio using HTTPS.
+  rpc NonStreamingRecognize(RecognizeRequest) returns (NonStreamingRecognizeResponse) {
+    option (.google.api.http) = { post: "/v1/speech:recognize" body: "*" };
+  }
+}
+
+// `RecognizeRequest` is the only message type sent by the client.
+//
+// `NonStreamingRecognize` sends only one `RecognizeRequest` message and it
+// must contain both an `initial_request` and an 'audio_request`.
+//
+// Streaming `Recognize` sends one or more `RecognizeRequest` messages. The
+// first message must contain an `initial_request` and may contain an
+// 'audio_request`. Any subsequent messages must not contain an
+// `initial_request` and must contain an 'audio_request`.
+message RecognizeRequest {
+  // The `initial_request` message provides information to the recognizer
+  // that specifies how to process the request.
+  //
+  // The first `RecognizeRequest` message must contain an `initial_request`.
+  // Any subsequent `RecognizeRequest` messages must not contain an
+  // `initial_request`.
+  InitialRecognizeRequest initial_request = 1;
+
+  // The audio data to be recognized. For `NonStreamingRecognize`, all the
+  // audio data must be contained in the first (and only) `RecognizeRequest`
+  //  message. For streaming `Recognize`, sequential chunks of audio data are
+  // sent in sequential `RecognizeRequest` messages.
+  AudioRequest audio_request = 2;
+}
+
+// The `InitialRecognizeRequest` message provides information to the recognizer
+// that specifies how to process the request.
+message InitialRecognizeRequest {
+  // Audio encoding of the data sent in the audio message.
+  enum AudioEncoding {
+    // Not specified. Will return result `INVALID_ARGUMENT`.
+    ENCODING_UNSPECIFIED = 0;
+
+    // Uncompressed 16-bit signed little-endian samples.
+    // This is the simplest encoding format, useful for getting started.
+    // However, because it is uncompressed, it is not recommended for deployed
+    // clients.
+    LINEAR16 = 1;
+
+    // This is the recommended encoding format because it uses lossless
+    // compression; therefore recognition accuracy is not compromised by a lossy
+    // codec.
+    //
+    // The stream FLAC format is specified at:
+    // http://flac.sourceforge.net/documentation.html.
+    // Only 16-bit samples are supported.
+    // Not all fields in STREAMINFO are supported.
+    FLAC = 2;
+
+    // 8-bit samples that compand 14-bit audio samples using PCMU/mu-law.
+    MULAW = 3;
+
+    // Adaptive Multi-Rate Narrowband codec. `sample_rate` must be 8000 Hz.
+    AMR = 4;
+
+    // Adaptive Multi-Rate Wideband codec. `sample_rate` must be 16000 Hz.
+    AMR_WB = 5;
+  }
+
+  // [Required] Encoding of audio data sent in all `AudioRequest` messages.
+  AudioEncoding encoding = 1;
+
+  // [Required] Sample rate in Hertz of the audio data sent in all
+  // AudioRequest messages.
+  // 16000 is optimal. Valid values are: 8000-48000.
+  int32 sample_rate = 2;
+
+  // [Optional] The language of the supplied audio as a BCP-47 language tag.
+  // Example: "en-GB"  https://www.rfc-editor.org/rfc/bcp/bcp47.txt
+  // If omitted, defaults to "en-US".
+  string language_code = 3;
+
+  // [Optional] Maximum number of recognition hypotheses to be returned.
+  // Specifically, the maximum number of `SpeechRecognitionAlternative` messages
+  // within each `SpeechRecognitionResult`.
+  // The server may return fewer than `max_alternatives`.
+  // Valid values are `0`-`30`. A value of `0` or `1` will return a maximum of
+  // `1`. If omitted, defaults to `1`.
+  int32 max_alternatives = 4;
+
+  // [Optional] If set to `true`, the server will attempt to filter out
+  // profanities, replacing all but the initial character in each filtered word
+  // with asterisks, e.g. "f***". If set to `false` or omitted, profanities
+  // won't be filtered out.
+  // Note that profanity filtering is not implemented for all languages.
+  // If the language is not supported, this setting has no effect.
+  bool profanity_filter = 5;
+
+  // [Optional] If `false` or omitted, the recognizer will detect a single
+  // spoken utterance, and it will cease recognition when the user stops
+  // speaking. If `enable_endpointer_events` is `true`, it will return
+  // `END_OF_UTTERANCE` when it detects that the user has stopped speaking.
+  // In all cases, it will return no more than one `SpeechRecognitionResult`,
+  // and set the `is_final` flag to `true`.
+  //
+  // If `true`, the recognizer will continue recognition (even if the user
+  // pauses speaking) until the client sends an `end_of_data` message or when
+  // the maximum time limit has been reached. Multiple
+  // `SpeechRecognitionResult`s with the `is_final` flag set to `true` may be
+  // returned to indicate that the recognizer will not return any further
+  // hypotheses for this portion of the transcript.
+  bool continuous = 6;
+
+  // [Optional] If this parameter is `true`, interim results may be returned as
+  // they become available.
+  // If `false` or omitted, only `is_final=true` result(s) are returned.
+  bool interim_results = 7;
+
+  // [Optional] If this parameter is `true`, `EndpointerEvents` may be returned
+  // as they become available.
+  // If `false` or omitted, no `EndpointerEvents` are returned.
+  bool enable_endpointer_events = 8;
+}
+
+// Contains audio data in the format specified in the `InitialRecognizeRequest`.
+message AudioRequest {
+  // [Required] The audio data bytes encoded as specified in
+  // `InitialRecognizeRequest`.
+  bytes content = 1;
+}
+
+// `NonStreamingRecognizeResponse` is the only message returned to the client by
+// `NonStreamingRecognize`. It contains the result as zero or more sequential
+// `RecognizeResponse` messages.
+//
+// Note that streaming `Recognize` will also return multiple `RecognizeResponse`
+// messages, but each message is individually streamed.
+message NonStreamingRecognizeResponse {
+  // [Output-only] Sequential list of messages returned by the recognizer.
+  repeated RecognizeResponse responses = 1;
+}
+
+// `RecognizeResponse` is the only message type returned to the client.
+message RecognizeResponse {
+  // Indicates the type of endpointer event.
+  enum EndpointerEvent {
+    // No endpointer event specified.
+    ENDPOINTER_EVENT_UNSPECIFIED = 0;
+
+    // Speech has been detected in the audio stream.
+    START_OF_SPEECH = 1;
+
+    // Speech has ceased to be detected in the audio stream.
+    END_OF_SPEECH = 2;
+
+    // The end of the audio stream has been reached. and it is being processed.
+    END_OF_AUDIO = 3;
+
+    // This event is only sent when continuous is `false`. It indicates that the
+    // server has detected the end of the user's speech utterance and expects no
+    // additional speech. Therefore, the server will not process additional
+    // audio. The client should stop sending additional audio data.
+    END_OF_UTTERANCE = 4;
+  }
+
+  // [Output-only] If set, returns a [google.rpc.Status][] message that
+  // specifies the error for the operation.
+  .google.rpc.Status error = 1;
+
+  // [Output-only] May contain zero or one `is_final=true` result (the newly
+  // settled portion). May also contain zero or more `is_final=false` results.
+  repeated SpeechRecognitionResult results = 2;
+
+  // [Output-only] Indicates the lowest index in the `results` array that has
+  // changed. The repeated `SpeechRecognitionResult` results overwrite past
+  // results at this index and higher.
+  int32 result_index = 3;
+
+  // [Output-only] Indicates the type of endpointer event.
+  EndpointerEvent endpoint = 4;
+}
+
+message SpeechRecognitionResult {
+  repeated SpeechRecognitionAlternative alternatives = 1;
+
+  // [Output-only] Set `true` if this is the final time the speech service will
+  // return this particular `SpeechRecognitionResult`. If `false`, this
+  // represents an interim result that may change.
+  bool is_final = 2;
+
+  // [Output-only] An estimate of the probability that the recognizer will not
+  // change its guess about this interim result. Values range from 0.0
+  // (completely unstable) to 1.0 (completely stable). Note that this is not the
+  // same as `confidence`, which estimates the probability that a recognition
+  // result is correct.
+  // This field is only provided for interim results (`is_final=false`).
+  // The default of 0.0 is a sentinel value indicating stability was not set.
+  float stability = 3;
+}
+
+// Alternative hypotheses (a.k.a. n-best list).
+message SpeechRecognitionAlternative {
+  // [Output-only] Transcript text representing the words that the user spoke.
+  string transcript = 1;
+
+  // [Output-only] The confidence estimate between 0.0 and 1.0. A higher number
+  // means the system is more confident that the recognition is correct.
+  // This field is typically provided only for the top hypothesis. and only for
+  // `is_final=true` results.
+  // The default of 0.0 is a sentinel value indicating confidence was not set.
+  float confidence = 2;
+}
diff --git a/speech/grpc/src/main/proto/google/type/README.md b/speech/grpc/src/main/proto/google/type/README.md
new file mode 100644
index 00000000000..f8079ab1ea6
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/README.md
@@ -0,0 +1,10 @@
+# Google Common Types
+This package contains definitions of common types for Google APIs.
+All types defined in this package are suitable for different APIs to
+exchange data, and will never break binary compatibility. They should
+have design quality comparable to major programming languages like
+Java and C#.
+
+NOTE: Some common types are defined in the package `google.protobuf`
+as they are directly supported by Protocol Buffers compiler and
+runtime. Those types are called Well-Known Types.
diff --git a/speech/grpc/src/main/proto/google/type/color.proto b/speech/grpc/src/main/proto/google/type/color.proto
new file mode 100644
index 00000000000..3e200230d82
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/color.proto
@@ -0,0 +1,163 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+import "google/protobuf/wrappers.proto";
+
+option java_multiple_files = true;
+option java_outer_classname = "ColorProto";
+option java_package = "com.google.type";
+
+
+// Represents a color in the RGBA color space. This representation is designed
+// for simplicity of conversion to/from color representations in various
+// languages over compactness; for example, the fields of this representation
+// can be trivially provided to the constructor of "java.awt.Color" in Java; it
+// can also be trivially provided to UIColor's "+colorWithRed:green:blue:alpha"
+// method in iOS; and, with just a little work, it can be easily formatted into
+// a CSS "rgba()" string in JavaScript, as well. Here are some examples:
+//
+// Example (Java):
+//
+//      import com.google.type.Color;
+//
+//      // ...
+//      public static java.awt.Color fromProto(Color protocolor) {
+//        float alpha = protocolor.hasAlpha()
+//            ? protocolor.getAlpha().getValue()
+//            : 1.0;
+//
+//        return new java.awt.Color(
+//            protocolor.getRed(),
+//            protocolor.getGreen(),
+//            protocolor.getBlue(),
+//            alpha);
+//      }
+//
+//      public static Color toProto(java.awt.Color color) {
+//        float red = (float) color.getRed();
+//        float green = (float) color.getGreen();
+//        float blue = (float) color.getBlue();
+//        float denominator = 255.0;
+//        Color.Builder resultBuilder =
+//            Color
+//                .newBuilder()
+//                .setRed(red / denominator)
+//                .setGreen(green / denominator)
+//                .setBlue(blue / denominator);
+//        int alpha = color.getAlpha();
+//        if (alpha != 255) {
+//          result.setAlpha(
+//              FloatValue
+//                  .newBuilder()
+//                  .setValue(((float) alpha) / denominator)
+//                  .build());
+//        }
+//        return resultBuilder.build();
+//      }
+//      // ...
+//
+// Example (iOS / Obj-C):
+//
+//      // ...
+//      static UIColor* fromProto(Color* protocolor) {
+//         float red = [protocolor red];
+//         float green = [protocolor green];
+//         float blue = [protocolor blue];
+//         FloatValue* alpha_wrapper = [protocolor alpha];
+//         float alpha = 1.0;
+//         if (alpha_wrapper != nil) {
+//           alpha = [alpha_wrapper value];
+//         }
+//         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+//      }
+//
+//      static Color* toProto(UIColor* color) {
+//          CGFloat red, green, blue, alpha;
+//          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+//            return nil;
+//          }
+//          Color* result = [Color alloc] init];
+//          [result setRed:red];
+//          [result setGreen:green];
+//          [result setBlue:blue];
+//          if (alpha <= 0.9999) {
+//            [result setAlpha:floatWrapperWithValue(alpha)];
+//          }
+//          [result autorelease];
+//          return result;
+//     }
+//     // ...
+//
+//  Example (JavaScript):
+//
+//     // ...
+//
+//     var protoToCssColor = function(rgb_color) {
+//        var redFrac = rgb_color.red || 0.0;
+//        var greenFrac = rgb_color.green || 0.0;
+//        var blueFrac = rgb_color.blue || 0.0;
+//        var red = Math.floor(redFrac * 255);
+//        var green = Math.floor(greenFrac * 255);
+//        var blue = Math.floor(blueFrac * 255);
+//
+//        if (!('alpha' in rgb_color)) {
+//           return rgbToCssColor_(red, green, blue);
+//        }
+//
+//        var alphaFrac = rgb_color.alpha.value || 0.0;
+//        var rgbParams = [red, green, blue].join(',');
+//        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+//     };
+//
+//     var rgbToCssColor_ = function(red, green, blue) {
+//       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+//       var hexString = rgbNumber.toString(16);
+//       var missingZeros = 6 - hexString.length;
+//       var resultBuilder = ['#'];
+//       for (var i = 0; i < missingZeros; i++) {
+//          resultBuilder.push('0');
+//       }
+//       resultBuilder.push(hexString);
+//       return resultBuilder.join('');
+//     };
+//
+//     // ...
+//
+message Color {
+  // The amount of red in the color as a value in the interval [0, 1].
+  float red = 1;
+
+  // The amount of green in the color as a value in the interval [0, 1].
+  float green = 2;
+
+  // The amount of blue in the color as a value in the interval [0, 1].
+  float blue = 3;
+
+  // The fraction of this color that should be applied to the pixel. That is,
+  // the final pixel color is defined by the equation:
+  //
+  //   pixel color = alpha * (this color) + (1.0 - alpha) * (background color)
+  //
+  // This means that a value of 1.0 corresponds to a solid color, whereas
+  // a value of 0.0 corresponds to a completely transparent color. This
+  // uses a wrapper message rather than a simple float scalar so that it is
+  // possible to distinguish between a default value and the value being unset.
+  // If omitted, this color object is to be rendered as a solid color
+  // (as if the alpha value had been explicitly given with a value of 1.0).
+  google.protobuf.FloatValue alpha = 4;
+}
diff --git a/speech/grpc/src/main/proto/google/type/date.proto b/speech/grpc/src/main/proto/google/type/date.proto
new file mode 100644
index 00000000000..a12090b8a4e
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/date.proto
@@ -0,0 +1,43 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+option java_generate_equals_and_hash = true;
+option java_multiple_files = true;
+option java_outer_classname = "DateProto";
+option java_package = "com.google.type";
+
+
+// Represents a whole calendar date, e.g. date of birth. The time of day and
+// time zone are either specified elsewhere or are not significant. The date
+// is relative to the Proleptic Gregorian Calendar. The day may be 0 to
+// represent a year and month where the day is not significant, e.g. credit card
+// expiration date. The year may be 0 to represent a month and day independent
+// of year, e.g. anniversary date. Related types are [google.type.TimeOfDay][google.type.TimeOfDay]
+// and [google.protobuf.Timestamp][google.protobuf.Timestamp].
+message Date {
+  // Year of date. Must be from 1 to 9,999, or 0 if specifying a date without
+  // a year.
+  int32 year = 1;
+
+  // Month of year of date. Must be from 1 to 12.
+  int32 month = 2;
+
+  // Day of month. Must be from 1 to 31 and valid for the year and month, or 0
+  // if specifying a year/month where the day is not sigificant.
+  int32 day = 3;
+}
diff --git a/speech/grpc/src/main/proto/google/type/dayofweek.proto b/speech/grpc/src/main/proto/google/type/dayofweek.proto
new file mode 100644
index 00000000000..df09f69912b
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/dayofweek.proto
@@ -0,0 +1,50 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+option java_generate_equals_and_hash = true;
+option java_multiple_files = true;
+option java_outer_classname = "DayOfWeekProto";
+option java_package = "com.google.type";
+
+
+// Represents a day of week.
+enum DayOfWeek {
+  // The unspecified day-of-week.
+  DAY_OF_WEEK_UNSPECIFIED = 0;
+
+  // The day-of-week of Monday.
+  MONDAY = 1;
+
+  // The day-of-week of Tuesday.
+  TUESDAY = 2;
+
+  // The day-of-week of Wednesday.
+  WEDNESDAY = 3;
+
+  // The day-of-week of Thursday.
+  THURSDAY = 4;
+
+  // The day-of-week of Friday.
+  FRIDAY = 5;
+
+  // The day-of-week of Saturday.
+  SATURDAY = 6;
+
+  // The day-of-week of Sunday.
+  SUNDAY = 7;
+}
diff --git a/speech/grpc/src/main/proto/google/type/latlng.proto b/speech/grpc/src/main/proto/google/type/latlng.proto
new file mode 100644
index 00000000000..198decc0e76
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/latlng.proto
@@ -0,0 +1,36 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+option java_generate_equals_and_hash = true;
+option java_multiple_files = true;
+option java_outer_classname = "LatLngProto";
+option java_package = "com.google.type";
+
+
+// An object representing a latitude/longitude pair. This is expressed as a pair
+// of doubles representing degrees latitude and degrees longitude. Unless
+// specified otherwise, this must conform to the
+// <a href="http://www.unoosa.org/pdf/icg/2012/template/WGS_84.pdf">WGS84
+// standard</a>. Values must be within normalized ranges.
+message LatLng {
+  // The latitude in degrees. It must be in the range [-90.0, +90.0].
+  double latitude = 1;
+
+  // The longitude in degrees. It must be in the range [-180.0, +180.0].
+  double longitude = 2;
+}
diff --git a/speech/grpc/src/main/proto/google/type/money.proto b/speech/grpc/src/main/proto/google/type/money.proto
new file mode 100644
index 00000000000..041454a23a7
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/money.proto
@@ -0,0 +1,40 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+option java_multiple_files = true;
+option java_outer_classname = "MoneyProto";
+option java_package = "com.google.type";
+
+
+// Represents an amount of money with its currency type.
+message Money {
+  // The 3-letter currency code defined in ISO 4217.
+  string currency_code = 1;
+
+  // The whole units of the amount.
+  // For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+  int64 units = 2;
+
+  // Number of nano (10^-9) units of the amount.
+  // The value must be between -999,999,999 and +999,999,999 inclusive.
+  // If `units` is positive, `nanos` must be positive or zero.
+  // If `units` is zero, `nanos` can be positive, zero, or negative.
+  // If `units` is negative, `nanos` must be negative or zero.
+  // For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+  int32 nanos = 3;
+}
diff --git a/speech/grpc/src/main/proto/google/type/timeofday.proto b/speech/grpc/src/main/proto/google/type/timeofday.proto
new file mode 100644
index 00000000000..f39266e00cf
--- /dev/null
+++ b/speech/grpc/src/main/proto/google/type/timeofday.proto
@@ -0,0 +1,42 @@
+// Copyright (c) 2015, Google Inc.
+//
+// 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.
+
+syntax = "proto3";
+
+package google.type;
+
+option java_generate_equals_and_hash = true;
+option java_multiple_files = true;
+option java_outer_classname = "TimeOfDayProto";
+option java_package = "com.google.type";
+
+
+// Represents a time of day. The date and time zone are either not significant
+// or are specified elsewhere. An API may chose to allow leap seconds. Related
+// types are [google.type.Date][google.type.Date] and [google.protobuf.Timestamp][google.protobuf.Timestamp].
+message TimeOfDay {
+  // Hours of day in 24 hour format. Should be from 0 to 23. An API may choose
+  // to allow the value "24:00:00" for scenarios like business closing time.
+  int32 hours = 1;
+
+  // Minutes of hour of day. Must be from 0 to 59.
+  int32 minutes = 2;
+
+  // Seconds of minutes of the time. Must normally be from 0 to 59. An API may
+  // allow the value 60 if it allows leap-seconds.
+  int32 seconds = 3;
+
+  // Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+  int32 nanos = 4;
+}

From 69172d228114a3901fbea067bdbb44b336f265c8 Mon Sep 17 00:00:00 2001
From: Amy Unruh <amyu@google.com>
Date: Mon, 21 Mar 2016 17:02:49 -0700
Subject: [PATCH 2/3] cleanup: pom file edits, remove unnecessary exports

Change-Id: Ifc5237822f654561ab65f9cc7409278971ef7e2c
---
 pom.xml                                       |  1 +
 speech/grpc/bin/speech-sample-nonstreaming.sh |  2 +-
 speech/grpc/bin/speech-sample-streaming.sh    |  2 +-
 speech/grpc/pom.xml                           | 15 ---------------
 4 files changed, 3 insertions(+), 17 deletions(-)

diff --git a/pom.xml b/pom.xml
index 21c270794d4..f8c1c03c096 100644
--- a/pom.xml
+++ b/pom.xml
@@ -69,6 +69,7 @@
         <module>managed_vms/twilio</module>
         <module>monitoring/v2</module>
         <module>monitoring/v3</module>
+        <module>speech/grpc</module>
         <module>storage/json-api</module>
         <module>storage/storage-transfer</module>
         <module>storage/xml-api/cmdline-sample</module>
diff --git a/speech/grpc/bin/speech-sample-nonstreaming.sh b/speech/grpc/bin/speech-sample-nonstreaming.sh
index 1b2d632ee8f..8ee85a008f5 100755
--- a/speech/grpc/bin/speech-sample-nonstreaming.sh
+++ b/speech/grpc/bin/speech-sample-nonstreaming.sh
@@ -13,6 +13,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-export SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
+SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
 java -cp ${SRC_DIR}/target/grpc-sample-1.0-jar-with-dependencies.jar \
     com.google.cloud.speech.grpc.demos.NonStreamingRecognizeClient "$@"
diff --git a/speech/grpc/bin/speech-sample-streaming.sh b/speech/grpc/bin/speech-sample-streaming.sh
index f327c19ed4a..351c17e6cd5 100755
--- a/speech/grpc/bin/speech-sample-streaming.sh
+++ b/speech/grpc/bin/speech-sample-streaming.sh
@@ -13,6 +13,6 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-export SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
+SRC_DIR=$(cd "$(dirname "$0")/.."; pwd)
 java -cp ${SRC_DIR}/target/grpc-sample-1.0-jar-with-dependencies.jar \
     com.google.cloud.speech.grpc.demos.RecognizeClient "$@"
diff --git a/speech/grpc/pom.xml b/speech/grpc/pom.xml
index ba6c328abed..607a68a8ad5 100644
--- a/speech/grpc/pom.xml
+++ b/speech/grpc/pom.xml
@@ -25,21 +25,6 @@
     <url>http://www.google.com</url>
   </organization>
 
-  <developers>
-    <developer>
-      <id>ejonte@google.com</id>
-      <name>Erik Jonte</name>
-      <email>ejonte@google.com</email>
-      <url>http://www.google.com</url>
-      <organization>Google</organization>
-      <organizationUrl>http://www.google.com</organizationUrl>
-      <roles>
-        <role>developer</role>
-      </roles>
-      <timezone>-8</timezone>
-    </developer>
-  </developers>
-
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   </properties>

From e747f5ec29e360a2ef9f0f3bec4cecd1e51258db Mon Sep 17 00:00:00 2001
From: Tim Swast <swast@google.com>
Date: Mon, 21 Mar 2016 17:33:42 -0700
Subject: [PATCH 3/3] speech: use shared checkstyle plugin.

I change the Speech API sample pom.xml to use the common parent, this
means we now inherit the shared checkstyle configuration. I also fix the
checkstyle errors in the Java code.

Change-Id: I577f0489cb6c235223ae4428b590ae86820e1ec1
---
 speech/grpc/pom.xml                           | 26 +++++++++++--
 .../demos/NonStreamingRecognizeClient.java    | 38 ++++++++++---------
 .../speech/grpc/demos/RecognizeClient.java    | 30 ++++++++-------
 3 files changed, 61 insertions(+), 33 deletions(-)

diff --git a/speech/grpc/pom.xml b/speech/grpc/pom.xml
index 607a68a8ad5..c1853902515 100644
--- a/speech/grpc/pom.xml
+++ b/speech/grpc/pom.xml
@@ -1,6 +1,19 @@
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+<!--
+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.
+-->
+<project>
   <modelVersion>4.0.0</modelVersion>
 
   <groupId>com.google.cloud.speech</groupId>
@@ -25,6 +38,13 @@
     <url>http://www.google.com</url>
   </organization>
 
+  <parent>
+    <groupId>com.google.cloud</groupId>
+    <artifactId>doc-samples</artifactId>
+    <version>1.0.0</version>
+    <relativePath>../..</relativePath>
+  </parent>
+
   <properties>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   </properties>
diff --git a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
index 04823c92256..3e413a71fa3 100644
--- a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
+++ b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/NonStreamingRecognizeClient.java
@@ -34,28 +34,30 @@
 import com.google.cloud.speech.v1.SpeechGrpc;
 import com.google.protobuf.ByteString;
 import com.google.protobuf.TextFormat;
+
 import io.grpc.ManagedChannel;
 import io.grpc.StatusRuntimeException;
 import io.grpc.auth.ClientAuthInterceptor;
 import io.grpc.netty.NegotiationType;
 import io.grpc.netty.NettyChannelBuilder;
+
+import org.apache.commons.cli.CommandLine;
+import org.apache.commons.cli.CommandLineParser;
+import org.apache.commons.cli.DefaultParser;
+import org.apache.commons.cli.OptionBuilder;
+import org.apache.commons.cli.Options;
+import org.apache.commons.cli.ParseException;
+
 import java.io.IOException;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.util.Arrays;
 import java.util.List;
-import java.util.concurrent.CountDownLatch;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 import java.util.logging.Level;
 import java.util.logging.Logger;
-import org.apache.commons.cli.CommandLine;
-import org.apache.commons.cli.CommandLineParser;
-import org.apache.commons.cli.DefaultParser;
-import org.apache.commons.cli.Options;
-import org.apache.commons.cli.OptionBuilder;
-import org.apache.commons.cli.ParseException;
 
 /**
  * Client that sends audio to Speech.NonStreamingRecognize and returns transcript.
@@ -63,10 +65,10 @@
 public class NonStreamingRecognizeClient {
 
   private static final Logger logger =
-        Logger.getLogger(NonStreamingRecognizeClient.class.getName());
+      Logger.getLogger(NonStreamingRecognizeClient.class.getName());
 
-   private static final List<String> OAUTH2_SCOPES =
-             Arrays.asList("https://www.googleapis.com/auth/xapi.zoo");
+  private static final List<String> OAUTH2_SCOPES =
+      Arrays.asList("https://www.googleapis.com/auth/xapi.zoo");
 
   private final String host;
   private final int port;
@@ -76,8 +78,11 @@ public class NonStreamingRecognizeClient {
   private final ManagedChannel channel;
   private final SpeechGrpc.SpeechBlockingStub blockingStub;
 
-  /** Construct client connecting to Cloud Speech server at {@code host:port}. */
-  public NonStreamingRecognizeClient(String host, int port, String file, int samplingRate) throws IOException {
+  /**
+   * Construct client connecting to Cloud Speech server at {@code host:port}.
+   */
+  public NonStreamingRecognizeClient(String host, int port, String file, int samplingRate)
+      throws IOException {
     this.host = host;
     this.port = port;
     this.file = file;
@@ -134,7 +139,7 @@ public void recognize() {
 
   public static void main(String[] args) throws Exception {
 
-    String audio_file = "";
+    String audioFile = "";
     String host = "speech.googleapis.com";
     Integer port = 443;
     Integer sampling = 16000;
@@ -166,7 +171,7 @@ public static void main(String[] args) throws Exception {
     try {
       CommandLine line = parser.parse(options, args);
       if (line.hasOption("file")) {
-        audio_file = line.getOptionValue("file");
+        audioFile = line.getOptionValue("file");
       } else {
         System.err.println("An Audio file path must be specified (e.g. /foo/baz.raw).");
         System.exit(1);
@@ -192,14 +197,13 @@ public static void main(String[] args) throws Exception {
         System.err.println("An Audio sampling rate must be specified.");
         System.exit(1);
       }
-    }
-    catch (ParseException exp) {
+    } catch (ParseException exp) {
       System.err.println("Unexpected exception:" + exp.getMessage());
       System.exit(1);
     }
 
     NonStreamingRecognizeClient client =
-        new NonStreamingRecognizeClient(host, port, audio_file, sampling);
+        new NonStreamingRecognizeClient(host, port, audioFile, sampling);
     try {
       client.recognize();
     } finally {
diff --git a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
index 223db38bba6..e6cd8dd737b 100644
--- a/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
+++ b/speech/grpc/src/main/java/com/google/cloud/speech/grpc/demos/RecognizeClient.java
@@ -34,12 +34,21 @@
 import com.google.cloud.speech.v1.SpeechGrpc;
 import com.google.protobuf.ByteString;
 import com.google.protobuf.TextFormat;
+
 import io.grpc.ManagedChannel;
 import io.grpc.Status;
 import io.grpc.auth.ClientAuthInterceptor;
 import io.grpc.netty.NegotiationType;
 import io.grpc.netty.NettyChannelBuilder;
 import io.grpc.stub.StreamObserver;
+
+import org.apache.commons.cli.CommandLine;
+import org.apache.commons.cli.CommandLineParser;
+import org.apache.commons.cli.DefaultParser;
+import org.apache.commons.cli.OptionBuilder;
+import org.apache.commons.cli.Options;
+import org.apache.commons.cli.ParseException;
+
 import java.io.File;
 import java.io.FileInputStream;
 import java.io.IOException;
@@ -50,13 +59,6 @@
 import java.util.concurrent.TimeUnit;
 import java.util.logging.Level;
 import java.util.logging.Logger;
-import org.apache.commons.cli.CommandLine;
-import org.apache.commons.cli.CommandLineParser;
-import org.apache.commons.cli.DefaultParser;
-import org.apache.commons.cli.Options;
-import org.apache.commons.cli.OptionBuilder;
-import org.apache.commons.cli.ParseException;
-
 
 /**
  * Client that sends streaming audio to Speech.Recognize and returns streaming transcript.
@@ -78,7 +80,9 @@ public class RecognizeClient {
   private static final List<String> OAUTH2_SCOPES =
       Arrays.asList("https://www.googleapis.com/auth/xapi.zoo");
 
-  /** Construct client connecting to Cloud Speech server at {@code host:port}. */
+  /**
+   * Construct client connecting to Cloud Speech server at {@code host:port}.
+   */
   public RecognizeClient(String host, int port, String file, int samplingRate) throws IOException {
     this.host = host;
     this.port = port;
@@ -109,8 +113,8 @@ public void onNext(RecognizeResponse response) {
       }
 
       @Override
-      public void onError(Throwable t) {
-        Status status = Status.fromThrowable(t);
+      public void onError(Throwable error) {
+        Status status = Status.fromThrowable(error);
         logger.log(Level.WARNING, "recognize failed: {0}", status);
         finishLatch.countDown();
       }
@@ -169,7 +173,7 @@ public void onCompleted() {
 
   public static void main(String[] args) throws Exception {
 
-    String audio_file = "";
+    String audioFile = "";
     String host = "speech.googleapis.com";
     Integer port = 443;
     Integer sampling = 16000;
@@ -201,7 +205,7 @@ public static void main(String[] args) throws Exception {
     try {
       CommandLine line = parser.parse(options, args);
       if (line.hasOption("file")) {
-        audio_file = line.getOptionValue("file");
+        audioFile = line.getOptionValue("file");
       } else {
         System.err.println("An Audio file must be specified (e.g. /foo/baz.raw).");
         System.exit(1);
@@ -233,7 +237,7 @@ public static void main(String[] args) throws Exception {
     }
 
     RecognizeClient client =
-        new RecognizeClient(host, port, audio_file, sampling);
+        new RecognizeClient(host, port, audioFile, sampling);
     try {
       client.recognize();
     } finally {