Skip to content

Commit 079d5f1

Browse files
author
Jerjou Cheng
committed
Update README to also explain speech_streaming.py
1 parent aa48859 commit 079d5f1

File tree

1 file changed

+11
-6
lines changed

1 file changed

+11
-6
lines changed

speech/api/README.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11

2-
# Google Cloud Speech API Sample (REST API)
2+
# Google Cloud Speech API Samples
33

4-
This example demos accessing the [Google Cloud Speech API](http://cloud.google.com/speech)
5-
via its REST API.
4+
These examples demo accessing the [Google Cloud Speech API](http://cloud.google.com/speech)
5+
in streaming mode (via its gRPC API) and in non-streaming mode (via its REST
6+
API).
67

78
## Prerequisites
89

@@ -30,9 +31,9 @@ downloaded service account credentials before running this example:
3031

3132
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/credentials-key.json
3233

33-
If you do not do this, you will see an error that looks something like this when
34-
you run the example script:
35-
`...<HttpError 403 when requesting https://speech.googleapis.com/v1/speech:recognize?alt=json returned "Request had insufficient authentication scopes.">`.
34+
If you do not do this, the REST api will return a 403. The streaming sample will
35+
just sort of hang silently.
36+
3637
See the
3738
[Cloud Platform Auth Guide](https://cloud.google.com/docs/authentication#developer_workflow)
3839
for more information.
@@ -70,3 +71,7 @@ for more information.
7071
The sample will run in a continuous loop, printing the data and metadata
7172
it receives from the Speech API, which includes alternative transcriptions
7273
of what it hears, and a confidence score. Say "exit" to exit the loop.
74+
75+
Note that the `speech_streaming.py` sample does not yet support python 3, as
76+
the upstream `grpcio` library's support is [not yet
77+
complete](https://github.com/grpc/grpc/issues/282).

0 commit comments

Comments
 (0)