Skip to content

Commit 5a0e352

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
feat: add result_end_time to SpeechRecognitionResult (#291)
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 413728495 Source-Link: googleapis/googleapis@10f96cb Source-Link: googleapis/googleapis-gen@f464864 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZjQ2NDg2NDI5MmViNmIwNTVmMWUxZDg0MDhhZmY4NzgxN2NjYTY0YyJ9 docs: add clarification for global and regional endpoints
1 parent 5a92e0a commit 5a0e352

File tree

5 files changed

+258
-49
lines changed

5 files changed

+258
-49
lines changed

‎packages/google-cloud-python-speech/google/cloud/speech_v1p1beta1/services/adaptation/async_client.py‎

Lines changed: 78 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,15 @@ async def create_phrase_set(
187187
parent (:class:`str`):
188188
Required. The parent resource where this phrase set will
189189
be created. Format:
190-
{api_version}/projects/{project}/locations/{location}/phraseSets
190+
191+
``projects/{project}/locations/{location}/phraseSets``
192+
193+
Speech-to-Text supports three locations: ``global``,
194+
``us`` (US North America), and ``eu`` (Europe). If you
195+
are calling the ``speech.googleapis.com`` endpoint, use
196+
the ``global`` location. To specify a region, use a
197+
`regional endpoint </speech-to-text/docs/endpoints>`__
198+
with matching ``us`` or ``eu`` location value.
191199
192200
This corresponds to the ``parent`` field
193201
on the ``request`` instance; if ``request`` is provided, this
@@ -280,7 +288,15 @@ async def get_phrase_set(
280288
name (:class:`str`):
281289
Required. The name of the phrase set to retrieve.
282290
Format:
283-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
291+
292+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
293+
294+
Speech-to-Text supports three locations: ``global``,
295+
``us`` (US North America), and ``eu`` (Europe). If you
296+
are calling the ``speech.googleapis.com`` endpoint, use
297+
the ``global`` location. To specify a region, use a
298+
`regional endpoint </speech-to-text/docs/endpoints>`__
299+
with matching ``us`` or ``eu`` location value.
284300
285301
This corresponds to the ``name`` field
286302
on the ``request`` instance; if ``request`` is provided, this
@@ -351,9 +367,17 @@ async def list_phrase_set(
351367
The request object. Message sent by the client for the
352368
`ListPhraseSet` method.
353369
parent (:class:`str`):
354-
Required. The parent, which owns this
355-
collection of phrase set. Format:
356-
projects/{project}/locations/{location}
370+
Required. The parent, which owns this collection of
371+
phrase set. Format:
372+
373+
``projects/{project}/locations/{location}``
374+
375+
Speech-to-Text supports three locations: ``global``,
376+
``us`` (US North America), and ``eu`` (Europe). If you
377+
are calling the ``speech.googleapis.com`` endpoint, use
378+
the ``global`` location. To specify a region, use a
379+
`regional endpoint </speech-to-text/docs/endpoints>`__
380+
with matching ``us`` or ``eu`` location value.
357381
358382
This corresponds to the ``parent`` field
359383
on the ``request`` instance; if ``request`` is provided, this
@@ -437,7 +461,15 @@ async def update_phrase_set(
437461
438462
The phrase set's ``name`` field is used to identify the
439463
set to be updated. Format:
440-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
464+
465+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
466+
467+
Speech-to-Text supports three locations: ``global``,
468+
``us`` (US North America), and ``eu`` (Europe). If you
469+
are calling the ``speech.googleapis.com`` endpoint, use
470+
the ``global`` location. To specify a region, use a
471+
`regional endpoint </speech-to-text/docs/endpoints>`__
472+
with matching ``us`` or ``eu`` location value.
441473
442474
This corresponds to the ``phrase_set`` field
443475
on the ``request`` instance; if ``request`` is provided, this
@@ -518,7 +550,8 @@ async def delete_phrase_set(
518550
`DeletePhraseSet` method.
519551
name (:class:`str`):
520552
Required. The name of the phrase set to delete. Format:
521-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
553+
554+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
522555
523556
This corresponds to the ``name`` field
524557
on the ``request`` instance; if ``request`` is provided, this
@@ -585,7 +618,15 @@ async def create_custom_class(
585618
parent (:class:`str`):
586619
Required. The parent resource where this custom class
587620
will be created. Format:
588-
{api_version}/projects/{project}/locations/{location}/customClasses
621+
622+
``projects/{project}/locations/{location}/customClasses``
623+
624+
Speech-to-Text supports three locations: ``global``,
625+
``us`` (US North America), and ``eu`` (Europe). If you
626+
are calling the ``speech.googleapis.com`` endpoint, use
627+
the ``global`` location. To specify a region, use a
628+
`regional endpoint </speech-to-text/docs/endpoints>`__
629+
with matching ``us`` or ``eu`` location value.
589630
590631
This corresponds to the ``parent`` field
591632
on the ``request`` instance; if ``request`` is provided, this
@@ -682,7 +723,8 @@ async def get_custom_class(
682723
name (:class:`str`):
683724
Required. The name of the custom class to retrieve.
684725
Format:
685-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
726+
727+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
686728
687729
This corresponds to the ``name`` field
688730
on the ``request`` instance; if ``request`` is provided, this
@@ -759,7 +801,15 @@ async def list_custom_classes(
759801
parent (:class:`str`):
760802
Required. The parent, which owns this collection of
761803
custom classes. Format:
762-
{api_version}/projects/{project}/locations/{location}/customClasses
804+
805+
``projects/{project}/locations/{location}/customClasses``
806+
807+
Speech-to-Text supports three locations: ``global``,
808+
``us`` (US North America), and ``eu`` (Europe). If you
809+
are calling the ``speech.googleapis.com`` endpoint, use
810+
the ``global`` location. To specify a region, use a
811+
`regional endpoint </speech-to-text/docs/endpoints>`__
812+
with matching ``us`` or ``eu`` location value.
763813
764814
This corresponds to the ``parent`` field
765815
on the ``request`` instance; if ``request`` is provided, this
@@ -843,7 +893,15 @@ async def update_custom_class(
843893
844894
The custom class's ``name`` field is used to identify
845895
the custom class to be updated. Format:
846-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
896+
897+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
898+
899+
Speech-to-Text supports three locations: ``global``,
900+
``us`` (US North America), and ``eu`` (Europe). If you
901+
are calling the ``speech.googleapis.com`` endpoint, use
902+
the ``global`` location. To specify a region, use a
903+
`regional endpoint </speech-to-text/docs/endpoints>`__
904+
with matching ``us`` or ``eu`` location value.
847905
848906
This corresponds to the ``custom_class`` field
849907
on the ``request`` instance; if ``request`` is provided, this
@@ -929,7 +987,15 @@ async def delete_custom_class(
929987
name (:class:`str`):
930988
Required. The name of the custom class to delete.
931989
Format:
932-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
990+
991+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
992+
993+
Speech-to-Text supports three locations: ``global``,
994+
``us`` (US North America), and ``eu`` (Europe). If you
995+
are calling the ``speech.googleapis.com`` endpoint, use
996+
the ``global`` location. To specify a region, use a
997+
`regional endpoint </speech-to-text/docs/endpoints>`__
998+
with matching ``us`` or ``eu`` location value.
933999
9341000
This corresponds to the ``name`` field
9351001
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-python-speech/google/cloud/speech_v1p1beta1/services/adaptation/client.py‎

Lines changed: 78 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -397,7 +397,15 @@ def create_phrase_set(
397397
parent (str):
398398
Required. The parent resource where this phrase set will
399399
be created. Format:
400-
{api_version}/projects/{project}/locations/{location}/phraseSets
400+
401+
``projects/{project}/locations/{location}/phraseSets``
402+
403+
Speech-to-Text supports three locations: ``global``,
404+
``us`` (US North America), and ``eu`` (Europe). If you
405+
are calling the ``speech.googleapis.com`` endpoint, use
406+
the ``global`` location. To specify a region, use a
407+
`regional endpoint </speech-to-text/docs/endpoints>`__
408+
with matching ``us`` or ``eu`` location value.
401409
402410
This corresponds to the ``parent`` field
403411
on the ``request`` instance; if ``request`` is provided, this
@@ -490,7 +498,15 @@ def get_phrase_set(
490498
name (str):
491499
Required. The name of the phrase set to retrieve.
492500
Format:
493-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
501+
502+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
503+
504+
Speech-to-Text supports three locations: ``global``,
505+
``us`` (US North America), and ``eu`` (Europe). If you
506+
are calling the ``speech.googleapis.com`` endpoint, use
507+
the ``global`` location. To specify a region, use a
508+
`regional endpoint </speech-to-text/docs/endpoints>`__
509+
with matching ``us`` or ``eu`` location value.
494510
495511
This corresponds to the ``name`` field
496512
on the ``request`` instance; if ``request`` is provided, this
@@ -561,9 +577,17 @@ def list_phrase_set(
561577
The request object. Message sent by the client for the
562578
`ListPhraseSet` method.
563579
parent (str):
564-
Required. The parent, which owns this
565-
collection of phrase set. Format:
566-
projects/{project}/locations/{location}
580+
Required. The parent, which owns this collection of
581+
phrase set. Format:
582+
583+
``projects/{project}/locations/{location}``
584+
585+
Speech-to-Text supports three locations: ``global``,
586+
``us`` (US North America), and ``eu`` (Europe). If you
587+
are calling the ``speech.googleapis.com`` endpoint, use
588+
the ``global`` location. To specify a region, use a
589+
`regional endpoint </speech-to-text/docs/endpoints>`__
590+
with matching ``us`` or ``eu`` location value.
567591
568592
This corresponds to the ``parent`` field
569593
on the ``request`` instance; if ``request`` is provided, this
@@ -647,7 +671,15 @@ def update_phrase_set(
647671
648672
The phrase set's ``name`` field is used to identify the
649673
set to be updated. Format:
650-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
674+
675+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
676+
677+
Speech-to-Text supports three locations: ``global``,
678+
``us`` (US North America), and ``eu`` (Europe). If you
679+
are calling the ``speech.googleapis.com`` endpoint, use
680+
the ``global`` location. To specify a region, use a
681+
`regional endpoint </speech-to-text/docs/endpoints>`__
682+
with matching ``us`` or ``eu`` location value.
651683
652684
This corresponds to the ``phrase_set`` field
653685
on the ``request`` instance; if ``request`` is provided, this
@@ -728,7 +760,8 @@ def delete_phrase_set(
728760
`DeletePhraseSet` method.
729761
name (str):
730762
Required. The name of the phrase set to delete. Format:
731-
{api_version}/projects/{project}/locations/{location}/phraseSets/{phrase_set}
763+
764+
``projects/{project}/locations/{location}/phraseSets/{phrase_set}``
732765
733766
This corresponds to the ``name`` field
734767
on the ``request`` instance; if ``request`` is provided, this
@@ -795,7 +828,15 @@ def create_custom_class(
795828
parent (str):
796829
Required. The parent resource where this custom class
797830
will be created. Format:
798-
{api_version}/projects/{project}/locations/{location}/customClasses
831+
832+
``projects/{project}/locations/{location}/customClasses``
833+
834+
Speech-to-Text supports three locations: ``global``,
835+
``us`` (US North America), and ``eu`` (Europe). If you
836+
are calling the ``speech.googleapis.com`` endpoint, use
837+
the ``global`` location. To specify a region, use a
838+
`regional endpoint </speech-to-text/docs/endpoints>`__
839+
with matching ``us`` or ``eu`` location value.
799840
800841
This corresponds to the ``parent`` field
801842
on the ``request`` instance; if ``request`` is provided, this
@@ -892,7 +933,8 @@ def get_custom_class(
892933
name (str):
893934
Required. The name of the custom class to retrieve.
894935
Format:
895-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
936+
937+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
896938
897939
This corresponds to the ``name`` field
898940
on the ``request`` instance; if ``request`` is provided, this
@@ -969,7 +1011,15 @@ def list_custom_classes(
9691011
parent (str):
9701012
Required. The parent, which owns this collection of
9711013
custom classes. Format:
972-
{api_version}/projects/{project}/locations/{location}/customClasses
1014+
1015+
``projects/{project}/locations/{location}/customClasses``
1016+
1017+
Speech-to-Text supports three locations: ``global``,
1018+
``us`` (US North America), and ``eu`` (Europe). If you
1019+
are calling the ``speech.googleapis.com`` endpoint, use
1020+
the ``global`` location. To specify a region, use a
1021+
`regional endpoint </speech-to-text/docs/endpoints>`__
1022+
with matching ``us`` or ``eu`` location value.
9731023
9741024
This corresponds to the ``parent`` field
9751025
on the ``request`` instance; if ``request`` is provided, this
@@ -1053,7 +1103,15 @@ def update_custom_class(
10531103
10541104
The custom class's ``name`` field is used to identify
10551105
the custom class to be updated. Format:
1056-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
1106+
1107+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
1108+
1109+
Speech-to-Text supports three locations: ``global``,
1110+
``us`` (US North America), and ``eu`` (Europe). If you
1111+
are calling the ``speech.googleapis.com`` endpoint, use
1112+
the ``global`` location. To specify a region, use a
1113+
`regional endpoint </speech-to-text/docs/endpoints>`__
1114+
with matching ``us`` or ``eu`` location value.
10571115
10581116
This corresponds to the ``custom_class`` field
10591117
on the ``request`` instance; if ``request`` is provided, this
@@ -1139,7 +1197,15 @@ def delete_custom_class(
11391197
name (str):
11401198
Required. The name of the custom class to delete.
11411199
Format:
1142-
{api_version}/projects/{project}/locations/{location}/customClasses/{custom_class}
1200+
1201+
``projects/{project}/locations/{location}/customClasses/{custom_class}``
1202+
1203+
Speech-to-Text supports three locations: ``global``,
1204+
``us`` (US North America), and ``eu`` (Europe). If you
1205+
are calling the ``speech.googleapis.com`` endpoint, use
1206+
the ``global`` location. To specify a region, use a
1207+
`regional endpoint </speech-to-text/docs/endpoints>`__
1208+
with matching ``us`` or ``eu`` location value.
11431209
11441210
This corresponds to the ``name`` field
11451211
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-python-speech/google/cloud/speech_v1p1beta1/types/cloud_speech.py‎

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -276,11 +276,10 @@ class RecognitionConfig(proto.Message):
276276
``false`` or omitted, profanities won't be filtered out.
277277
adaptation (google.cloud.speech_v1p1beta1.types.SpeechAdaptation):
278278
Speech adaptation configuration improves the accuracy of
279-
speech recognition. When speech adaptation is set it
280-
supersedes the ``speech_contexts`` field. For more
281-
information, see the `speech
279+
speech recognition. For more information, see the `speech
282280
adaptation <https://cloud.google.com/speech-to-text/docs/adaptation>`__
283-
documentation.
281+
documentation. When speech adaptation is set it supersedes
282+
the ``speech_contexts`` field.
284283
transcript_normalization (google.cloud.speech_v1p1beta1.types.TranscriptNormalization):
285284
Use transcription normalization to
286285
automatically replace parts of the transcript
@@ -414,7 +413,7 @@ class AudioEncoding(proto.Enum):
414413
codecs are used to capture or transmit audio, particularly if
415414
background noise is present. Lossy codecs include ``MULAW``,
416415
``AMR``, ``AMR_WB``, ``OGG_OPUS``, ``SPEEX_WITH_HEADER_BYTE``,
417-
``MP3``.
416+
``MP3``, and ``WEBM_OPUS``.
418417
419418
The ``FLAC`` and ``WAV`` audio file formats include a header that
420419
describes the included audio content. You can request recognition
@@ -926,6 +925,9 @@ class SpeechRecognitionResult(proto.Message):
926925
corresponding to the recognized result for the audio from
927926
that channel. For audio_channel_count = N, its output values
928927
can range from '1' to 'N'.
928+
result_end_time (google.protobuf.duration_pb2.Duration):
929+
Time offset of the end of this result
930+
relative to the beginning of the audio.
929931
language_code (str):
930932
Output only. The
931933
`BCP-47 <https://www.rfc-editor.org/rfc/bcp/bcp47.txt>`__
@@ -938,6 +940,9 @@ class SpeechRecognitionResult(proto.Message):
938940
proto.MESSAGE, number=1, message="SpeechRecognitionAlternative",
939941
)
940942
channel_tag = proto.Field(proto.INT32, number=2,)
943+
result_end_time = proto.Field(
944+
proto.MESSAGE, number=4, message=duration_pb2.Duration,
945+
)
941946
language_code = proto.Field(proto.STRING, number=5,)
942947

943948

0 commit comments

Comments
 (0)