google-cloud-speech-v1p1beta1 0.3.3 → 0.5.0

data/lib/google/cloud/speech/v1p1beta1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Speech
       module V1p1beta1
-        VERSION = "0.3.3"
+        VERSION = "0.5.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -54,6 +54,12 @@ module Google
       # This indicates that the field may be set once in a request to create a
       # resource, but may not be changed thereafter.
       IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
     end
   end
 end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/speech/v1p1beta1/cloud_speech.rb

@@ -92,6 +92,16 @@ module Google
         #     `END_OF_SINGLE_UTTERANCE` event and cease recognition. It will return no
         #     more than one `StreamingRecognitionResult` with the `is_final` flag set to
         #     `true`.
+        #
+        #     The `single_utterance` field can only be used with specified models,
+        #     otherwise an error is thrown. The `model` field in [`RecognitionConfig`][]
+        #     must be set to:
+        #
+        #     * `command_and_search`
+        #     * `phone_call` AND additional field `useEnhanced`=`true`
+        #     * The `model` field is left undefined. In this case the API auto-selects
+        #       a model based on any other parameters that you set in
+        #       `RecognitionConfig`.
         # @!attribute [rw] interim_results
         #   @return [::Boolean]
         #     If `true`, interim results (tentative hypotheses) may be
@@ -346,7 +356,8 @@ module Google
             # wideband is supported. `sample_rate_hertz` must be 16000.
             SPEEX_WITH_HEADER_BYTE = 7
 
-            # MP3 audio. Support all standard MP3 bitrates (which range from 32-320
+            # MP3 audio. MP3 encoding is a Beta feature and only available in
+            # v1p1beta1. Support all standard MP3 bitrates (which range from 32-320
             # kbps). When using this encoding, `sample_rate_hertz` has to match the
             # sample rate of the file being used.
             MP3 = 8
@@ -607,8 +618,8 @@ module Google
         #     Time of the most recent processing update.
         # @!attribute [r] uri
         #   @return [::String]
-        #     The URI of the audio file being transcribed. Empty if the audio was sent
-        #     as byte content.
+        #     Output only. The URI of the audio file being transcribed. Empty if the
+        #     audio was sent as byte content.
         class LongRunningRecognizeMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/speech/v1p1beta1/cloud_speech_adaptation.rb

@@ -0,0 +1,218 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Speech
+      module V1p1beta1
+        # Message sent by the client for the `CreatePhraseSet` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this phrase set will be created.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets
+        # @!attribute [rw] phrase_set_id
+        #   @return [::String]
+        #     The ID to use for the phrase set, which will become the final
+        #     component of the phrase set's resource name.
+        #
+        #     This value should be 4-63 characters, and valid characters
+        #     are /[a-z][0-9]-/.
+        # @!attribute [rw] phrase_set
+        #   @return [::Google::Cloud::Speech::V1p1beta1::PhraseSet]
+        #     Required. The phrase set to create.
+        class CreatePhraseSetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `UpdatePhraseSet` method.
+        # @!attribute [rw] phrase_set
+        #   @return [::Google::Cloud::Speech::V1p1beta1::PhraseSet]
+        #     Required. The phrase set to update.
+        #
+        #     The phrase set's `name` field is used to identify the set to be
+        #     updated. Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of fields to be updated.
+        class UpdatePhraseSetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `GetPhraseSet` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the phrase set to retrieve.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+        class GetPhraseSetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `ListPhraseSet` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of phrase set.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of phrase sets to return. The service may return
+        #     fewer than this value. If unspecified, at most 50 phrase sets will be
+        #     returned. The maximum value is 1000; values above 1000 will be coerced to
+        #     1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `ListPhraseSet` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListPhraseSet` must
+        #     match the call that provided the page token.
+        class ListPhraseSetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message returned to the client by the `ListPhraseSet` method.
+        # @!attribute [rw] phrase_sets
+        #   @return [::Array<::Google::Cloud::Speech::V1p1beta1::PhraseSet>]
+        #     The phrase set.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class ListPhraseSetResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `DeletePhraseSet` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the phrase set to delete.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/phraseSets/\\{phrase_set}
+        class DeletePhraseSetRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `CreateCustomClass` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this custom class will be created.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses
+        # @!attribute [rw] custom_class_id
+        #   @return [::String]
+        #     The ID to use for the custom class, which will become the final
+        #     component of the custom class' resource name.
+        #
+        #     This value should be 4-63 characters, and valid characters
+        #     are /[a-z][0-9]-/.
+        # @!attribute [rw] custom_class
+        #   @return [::Google::Cloud::Speech::V1p1beta1::CustomClass]
+        #     Required. The custom class to create.
+        class CreateCustomClassRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `UpdateCustomClass` method.
+        # @!attribute [rw] custom_class
+        #   @return [::Google::Cloud::Speech::V1p1beta1::CustomClass]
+        #     Required. The custom class to update.
+        #
+        #     The custom class's `name` field is used to identify the custom class to be
+        #     updated. Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The list of fields to be updated.
+        class UpdateCustomClassRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `GetCustomClass` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the custom class to retrieve.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+        class GetCustomClassRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `ListCustomClasses` method.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent, which owns this collection of custom classes.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of custom classes to return. The service may return
+        #     fewer than this value. If unspecified, at most 50 custom classes will be
+        #     returned. The maximum value is 1000; values above 1000 will be coerced to
+        #     1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     A page token, received from a previous `ListCustomClass` call.
+        #     Provide this to retrieve the subsequent page.
+        #
+        #     When paginating, all other parameters provided to `ListCustomClass` must
+        #     match the call that provided the page token.
+        class ListCustomClassesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message returned to the client by the `ListCustomClasses` method.
+        # @!attribute [rw] custom_classes
+        #   @return [::Array<::Google::Cloud::Speech::V1p1beta1::CustomClass>]
+        #     The custom classes.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token, which can be sent as `page_token` to retrieve the next page.
+        #     If this field is omitted, there are no subsequent pages.
+        class ListCustomClassesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Message sent by the client for the `DeleteCustomClass` method.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the custom class to delete.
+        #     Format:
+        #     \\{api_version}/projects/\\{project}/locations/\\{location}/customClasses/\\{custom_class}
+        class DeleteCustomClassRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/speech/v1p1beta1/resource.rb

@@ -30,7 +30,7 @@ module Google
         # @!attribute [rw] custom_class_id
         #   @return [::String]
         #     If this custom class is a resource, the custom_class_id is the resource id
-        #     of the CustomClass.
+        #     of the CustomClass. Case sensitive.
         # @!attribute [rw] items
         #   @return [::Array<::Google::Cloud::Speech::V1p1beta1::CustomClass::ClassItem>]
         #     A collection of class items.
@@ -117,6 +117,9 @@ module Google
         #     A collection of phrase sets. To specify the hints inline, leave the
         #     phrase set's `name` blank and fill in the rest of its fields. Any
         #     phrase set can use any custom class.
+        # @!attribute [rw] phrase_set_references
+        #   @return [::Array<::String>]
+        #     A collection of phrase set resource names to use.
         # @!attribute [rw] custom_classes
         #   @return [::Array<::Google::Cloud::Speech::V1p1beta1::CustomClass>]
         #     A collection of custom classes. To specify the classes inline, leave the

data/proto_docs/google/longrunning/operations.rb

@@ -25,7 +25,7 @@ module Google
     #   @return [::String]
     #     The server-assigned name, which is only unique within the same service that
     #     originally returns it. If you use the default HTTP mapping, the
-    #     `name` should have the format of `operations/some/unique/name`.
+    #     `name` should be a resource name ending with `operations/{unique_id}`.
     # @!attribute [rw] metadata
     #   @return [::Google::Protobuf::Any]
     #     Service-specific metadata associated with the operation.  It typically
@@ -35,7 +35,7 @@ module Google
     # @!attribute [rw] done
     #   @return [::Boolean]
     #     If the value is `false`, it means the operation is still in progress.
-    #     If true, the operation is completed, and either `error` or `response` is
+    #     If `true`, the operation is completed, and either `error` or `response` is
     #     available.
     # @!attribute [rw] error
     #   @return [::Google::Rpc::Status]
@@ -67,7 +67,7 @@ module Google
     # The request message for Operations.ListOperations.
     # @!attribute [rw] name
     #   @return [::String]
-    #     The name of the operation collection.
+    #     The name of the operation's parent resource.
     # @!attribute [rw] filter
     #   @return [::String]
     #     The standard list filter.
@@ -112,6 +112,20 @@ module Google
       extend ::Google::Protobuf::MessageExts::ClassMethods
     end
 
+    # The request message for Operations.WaitOperation.
+    # @!attribute [rw] name
+    #   @return [::String]
+    #     The name of the operation resource to wait on.
+    # @!attribute [rw] timeout
+    #   @return [::Google::Protobuf::Duration]
+    #     The maximum duration to wait before timing out. If left blank, the wait
+    #     will be at most the time permitted by the underlying HTTP/RPC protocol.
+    #     If RPC context deadline is also specified, the shorter one will be used.
+    class WaitOperationRequest
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # A message representing the message types used by a long-running operation.
     #
     # Example: