google-cloud-video_intelligence-v1 0.2.4 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7baec20e67f25a529ca8d44ca865a673f579e1cd0a780c7a698c39dfbfa672e1
-  data.tar.gz: 0bd6f3bb7056ff4a03a953d6f916396a84b739a8b2cd893e81efd05dc66e37da
+  metadata.gz: 794ea562013784154c24fe9d9d47380b2da61ae5f78eb30831e206ae650a9e41
+  data.tar.gz: db1c1e87a0ee9c873ca4752678b8f4751d8e917588c316a9b765bc2fa235fcb6
 SHA512:
-  metadata.gz: b198a664b58146d287a053eab790de1d3eea1d5373c80d7774862d3638ad8c3c1536c5eb3b1b8992653d8777a256ba7027bc114b84d771d7569e7069648544b3
-  data.tar.gz: 882ecef0cfe8e86bbb61ee46503925dc049cc856770478739b8c9ffcaec9221aa22a33b8e3b3671cec20a44d2a2ce629875df47cb1de50227045d7f1453af29f
+  metadata.gz: e0f7fd09455493b8f4f4f87f303755ab5c62cb5da0fce0812ca894687869f78baa41c7ba4001a05ae337121fb2fe2b10d455836ccdc5933cf7787d9819cac26a
+  data.tar.gz: e856c79f30d4461e77852d009ef611d464e1b90141d6b2e9aa1977d1ca1edc6ba8a35c79655092ed88935214fa0d40498048a8c8163bbde4e57f82abd832401f

data/README.md

@@ -6,6 +6,12 @@ Detects objects, explicit content, and scene changes in videos. It also specifie
 
 https://github.com/googleapis/google-cloud-ruby
 
+This gem is a _versioned_ client. It provides basic client classes for a
+specific version of the Cloud Video Intelligence V1 API. Most users should consider using
+the main client gem,
+[google-cloud-video_intelligence](https://rubygems.org/gems/google-cloud-video_intelligence).
+See the section below titled *Which client should I use?* for more information.
+
 ## Installation
 
 ```
@@ -73,3 +79,61 @@ in security maintenance, and not end of life. Currently, this means Ruby 2.4
 and later. Older versions of Ruby _may_ still work, but are unsupported and not
 recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
 about the Ruby support schedule.
+
+## Which client should I use?
+
+Most modern Ruby client libraries for Google APIs come in two flavors: the main
+client library with a name such as `google-cloud-video_intelligence`,
+and lower-level _versioned_ client libraries with names such as
+`google-cloud-video_intelligence-v1`.
+_In most cases, you should install the main client._
+
+### What's the difference between the main client and a versioned client?
+
+A _versioned client_ provides a basic set of data types and client classes for
+a _single version_ of a specific service. (That is, for a service with multiple
+versions, there might be a separate versioned client for each service version.)
+Most versioned clients are written and maintained by a code generator.
+
+The _main client_ is designed to provide you with the _recommended_ client
+interfaces for the service. There will be only one main client for any given
+service, even a service with multiple versions. The main client includes
+factory methods for constructing the client objects we recommend for most
+users. In some cases, those will be classes provided by an underlying versioned
+client; in other cases, they will be handwritten higher-level client objects
+with additional capabilities, convenience methods, or best practices built in.
+Generally, the main client will default to a recommended service version,
+although in some cases you can override this if you need to talk to a specific
+service version.
+
+### Why would I want to use the main client?
+
+We recommend that most users install the main client gem for a service. You can
+identify this gem as the one _without_ a version in its name, e.g.
+`google-cloud-video_intelligence`.
+The main client is recommended because it will embody the best practices for
+accessing the service, and may also provide more convenient interfaces or
+tighter integration into frameworks and third-party libraries. In addition, the
+documentation and samples published by Google will generally demonstrate use of
+the main client.
+
+### Why would I want to use a versioned client?
+
+You can use a versioned client if you are content with a possibly lower-level
+class interface, you explicitly want to avoid features provided by the main
+client, or you want to access a specific service version not be covered by the
+main client. You can identify versioned client gems because the service version
+is part of the name, e.g. `google-cloud-video_intelligence-v1`.
+
+### What about the google-apis-<name> clients?
+
+Client library gems with names that begin with `google-apis-` are based on an
+older code generation technology. They talk to a REST/JSON backend (whereas
+most modern clients talk to a [gRPC](https://grpc.io/) backend) and they may
+not offer the same performance, features, and ease of use provided by more
+modern clients.
+
+The `google-apis-` clients have wide coverage across Google services, so you
+might need to use one if there is no modern client available for the service.
+However, if a modern client is available, we generally recommend it over the
+older `google-apis-` clients.

data/lib/google/cloud/video_intelligence/v1.rb

@@ -33,3 +33,6 @@ module Google
     end
   end
 end
+
+helper_path = ::File.join __dir__, "v1", "_helpers.rb"
+require "google/cloud/video_intelligence/v1/_helpers" if ::File.file? helper_path

data/lib/google/cloud/video_intelligence/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module VideoIntelligence
       module V1
-        VERSION = "0.2.4"
+        VERSION = "0.5.0"
       end
     end
   end

data/lib/google/cloud/video_intelligence/v1/video_intelligence_service.rb

@@ -31,7 +31,7 @@ module Google
     module VideoIntelligence
       module V1
         ##
-        # Service that implements Google Cloud Video Intelligence API.
+        # Service that implements the Video Intelligence API.
         #
         # To load this service and instantiate a client:
         #

data/lib/google/cloud/video_intelligence/v1/video_intelligence_service/client.rb

@@ -27,7 +27,7 @@ module Google
           ##
           # Client for the VideoIntelligenceService service.
           #
-          # Service that implements Google Cloud Video Intelligence API.
+          # Service that implements the Video Intelligence API.
           #
           class Client
             # @private
@@ -132,7 +132,13 @@ module Google
 
               # Create credentials
               credentials = @config.credentials
-              credentials ||= Credentials.default scope: @config.scope
+              # Use self-signed JWT if the scope and endpoint are unchanged from default,
+              # but only if the default endpoint does not have a region prefix.
+              enable_self_signed_jwt = @config.scope == Client.configure.scope &&
+                                       @config.endpoint == Client.configure.endpoint &&
+                                       !@config.endpoint.split(".").first.include?("-")
+              credentials ||= Credentials.default scope:                  @config.scope,
+                                                  enable_self_signed_jwt: enable_self_signed_jwt
               if credentials.is_a?(String) || credentials.is_a?(Hash)
                 credentials = Credentials.new credentials, scope: @config.scope
               end
@@ -185,34 +191,37 @@ module Google
             #
             #   @param input_uri [::String]
             #     Input video location. Currently, only
-            #     [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-            #     supported, which must be specified in the following format:
+            #     [Cloud Storage](https://cloud.google.com/storage/) URIs are
+            #     supported. URIs must be specified in the following format:
             #     `gs://bucket-id/object-id` (other URI formats return
-            #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-            #     [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
-            #     A video URI may include wildcards in `object-id`, and thus identify
-            #     multiple videos. Supported wildcards: '*' to match 0 or more characters;
+            #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+            #     more information, see [Request
+            #     URIs](https://cloud.google.com/storage/docs/request-endpoints). To identify
+            #     multiple videos, a video URI may include wildcards in the `object-id`.
+            #     Supported wildcards: '*' to match 0 or more characters;
             #     '?' to match 1 character. If unset, the input video should be embedded
-            #     in the request as `input_content`. If set, `input_content` should be unset.
+            #     in the request as `input_content`. If set, `input_content` must be unset.
             #   @param input_content [::String]
             #     The video data bytes.
-            #     If unset, the input video(s) should be specified via `input_uri`.
-            #     If set, `input_uri` should be unset.
+            #     If unset, the input video(s) should be specified via the `input_uri`.
+            #     If set, `input_uri` must be unset.
             #   @param features [::Array<::Google::Cloud::VideoIntelligence::V1::Feature>]
             #     Required. Requested video annotation features.
             #   @param video_context [::Google::Cloud::VideoIntelligence::V1::VideoContext, ::Hash]
             #     Additional video context and/or feature-specific parameters.
             #   @param output_uri [::String]
             #     Optional. Location where the output (in JSON format) should be stored.
-            #     Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-            #     URIs are supported, which must be specified in the following format:
+            #     Currently, only [Cloud Storage](https://cloud.google.com/storage/)
+            #     URIs are supported. These must be specified in the following format:
             #     `gs://bucket-id/object-id` (other URI formats return
-            #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-            #     [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+            #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+            #     more information, see [Request
+            #     URIs](https://cloud.google.com/storage/docs/request-endpoints).
             #   @param location_id [::String]
             #     Optional. Cloud region where annotation should take place. Supported cloud
-            #     regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-            #     is specified, a region will be determined based on video file location.
+            #     regions are: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no
+            #     region is specified, the region will be determined based on video file
+            #     location.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -339,7 +348,7 @@ module Google
 
               config_attr :endpoint,      "videointelligence.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
@@ -379,7 +388,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:

data/lib/google/cloud/video_intelligence/v1/video_intelligence_service/operations.rb

@@ -103,8 +103,13 @@ module Google
             # Lists operations that match the specified filter in the request. If the
             # server doesn't support this method, it returns `UNIMPLEMENTED`.
             #
-            # NOTE: the `name` binding below allows API services to override the binding
-            # to use different resource name schemes, such as `users/*/operations`.
+            # NOTE: the `name` binding allows API services to override the binding
+            # to use different resource name schemes, such as `users/*/operations`. To
+            # override the binding, API services can add a binding such as
+            # `"/v1/{name=users/*}/operations"` to their service configuration.
+            # For backwards compatibility, the default name includes the operations
+            # collection id, however overriding users must ensure the name binding
+            # is the parent resource, without the operations collection id.
             #
             # @overload list_operations(request, options = nil)
             #   Pass arguments to `list_operations` via a request object, either of type
@@ -122,7 +127,7 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     The name of the operation collection.
+            #     The name of the operation's parent resource.
             #   @param filter [::String]
             #     The standard list filter.
             #   @param page_size [::Integer]
@@ -390,6 +395,79 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Waits for the specified long-running operation until it is done or reaches
+            # at most a specified timeout, returning the latest state.  If the operation
+            # is already done, the latest state is immediately returned.  If the timeout
+            # specified is greater than the default HTTP/RPC timeout, the HTTP/RPC
+            # timeout is used.  If the server does not support this method, it returns
+            # `google.rpc.Code.UNIMPLEMENTED`.
+            # Note that this method is on a best-effort basis.  It may return the latest
+            # state before the specified timeout (including immediately), meaning even an
+            # immediate response is no guarantee that the operation is done.
+            #
+            # @overload wait_operation(request, options = nil)
+            #   Pass arguments to `wait_operation` via a request object, either of type
+            #   {::Google::Longrunning::WaitOperationRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Longrunning::WaitOperationRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload wait_operation(name: nil, timeout: nil)
+            #   Pass arguments to `wait_operation` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param name [::String]
+            #     The name of the operation resource to wait on.
+            #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+            #     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.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Gapic::Operation]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Gapic::Operation]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            def wait_operation request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Longrunning::WaitOperationRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.wait_operation.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::VideoIntelligence::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              options.apply_defaults timeout:      @config.rpcs.wait_operation.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.wait_operation.retry_policy
+              options.apply_defaults metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
+                response = ::Gapic::Operation.new response, @operations_client, options: options
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Configuration class for the Operations API.
             #
@@ -475,7 +553,7 @@ module Google
 
               config_attr :endpoint,      "videointelligence.googleapis.com", ::String
               config_attr :credentials,   nil do |value|
-                allowed = [::String, ::Hash, ::Proc, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
+                allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
                 allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
                 allowed.any? { |klass| klass === value }
               end
@@ -515,7 +593,7 @@ module Google
               # Each configuration object is of type `Gapic::Config::Method` and includes
               # the following configuration fields:
               #
-              #  *  `timeout` (*type:* `Numeric`) - The call timeout in milliseconds
+              #  *  `timeout` (*type:* `Numeric`) - The call timeout in seconds
               #  *  `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
               #  *  `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
               #     include the following keys:
@@ -546,6 +624,11 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :cancel_operation
+                ##
+                # RPC-specific configuration for `wait_operation`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :wait_operation
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -557,6 +640,8 @@ module Google
                   @delete_operation = ::Gapic::Config::Method.new delete_operation_config
                   cancel_operation_config = parent_rpcs&.cancel_operation if parent_rpcs&.respond_to? :cancel_operation
                   @cancel_operation = ::Gapic::Config::Method.new cancel_operation_config
+                  wait_operation_config = parent_rpcs&.wait_operation if parent_rpcs&.respond_to? :wait_operation
+                  @wait_operation = ::Gapic::Config::Method.new wait_operation_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/videointelligence/v1/video_intelligence_pb.rb

@@ -28,6 +28,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :face_detection_config, :message, 5, "google.cloud.videointelligence.v1.FaceDetectionConfig"
       optional :speech_transcription_config, :message, 6, "google.cloud.videointelligence.v1.SpeechTranscriptionConfig"
       optional :text_detection_config, :message, 8, "google.cloud.videointelligence.v1.TextDetectionConfig"
+      optional :person_detection_config, :message, 11, "google.cloud.videointelligence.v1.PersonDetectionConfig"
       optional :object_tracking_config, :message, 13, "google.cloud.videointelligence.v1.ObjectTrackingConfig"
     end
     add_message "google.cloud.videointelligence.v1.LabelDetectionConfig" do
@@ -46,6 +47,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.videointelligence.v1.FaceDetectionConfig" do
       optional :model, :string, 1
       optional :include_bounding_boxes, :bool, 2
+      optional :include_attributes, :bool, 5
+    end
+    add_message "google.cloud.videointelligence.v1.PersonDetectionConfig" do
+      optional :include_bounding_boxes, :bool, 1
+      optional :include_pose_landmarks, :bool, 2
+      optional :include_attributes, :bool, 3
     end
     add_message "google.cloud.videointelligence.v1.ExplicitContentDetectionConfig" do
       optional :model, :string, 1
@@ -76,6 +83,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :category_entities, :message, 2, "google.cloud.videointelligence.v1.Entity"
       repeated :segments, :message, 3, "google.cloud.videointelligence.v1.LabelSegment"
       repeated :frames, :message, 4, "google.cloud.videointelligence.v1.LabelFrame"
+      optional :version, :string, 5
     end
     add_message "google.cloud.videointelligence.v1.ExplicitContentFrame" do
       optional :time_offset, :message, 1, "google.protobuf.Duration"
@@ -83,6 +91,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.videointelligence.v1.ExplicitContentAnnotation" do
       repeated :frames, :message, 1, "google.cloud.videointelligence.v1.ExplicitContentFrame"
+      optional :version, :string, 2
     end
     add_message "google.cloud.videointelligence.v1.NormalizedBoundingBox" do
       optional :left, :float, 1
@@ -90,6 +99,15 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :right, :float, 3
       optional :bottom, :float, 4
     end
+    add_message "google.cloud.videointelligence.v1.FaceDetectionAnnotation" do
+      repeated :tracks, :message, 3, "google.cloud.videointelligence.v1.Track"
+      optional :thumbnail, :bytes, 4
+      optional :version, :string, 5
+    end
+    add_message "google.cloud.videointelligence.v1.PersonDetectionAnnotation" do
+      repeated :tracks, :message, 1, "google.cloud.videointelligence.v1.Track"
+      optional :version, :string, 2
+    end
     add_message "google.cloud.videointelligence.v1.FaceSegment" do
       optional :segment, :message, 1, "google.cloud.videointelligence.v1.VideoSegment"
     end
@@ -133,12 +151,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :shot_presence_label_annotations, :message, 24, "google.cloud.videointelligence.v1.LabelAnnotation"
       repeated :frame_label_annotations, :message, 4, "google.cloud.videointelligence.v1.LabelAnnotation"
       repeated :face_annotations, :message, 5, "google.cloud.videointelligence.v1.FaceAnnotation"
+      repeated :face_detection_annotations, :message, 13, "google.cloud.videointelligence.v1.FaceDetectionAnnotation"
       repeated :shot_annotations, :message, 6, "google.cloud.videointelligence.v1.VideoSegment"
       optional :explicit_annotation, :message, 7, "google.cloud.videointelligence.v1.ExplicitContentAnnotation"
       repeated :speech_transcriptions, :message, 11, "google.cloud.videointelligence.v1.SpeechTranscription"
       repeated :text_annotations, :message, 12, "google.cloud.videointelligence.v1.TextAnnotation"
       repeated :object_annotations, :message, 14, "google.cloud.videointelligence.v1.ObjectTrackingAnnotation"
       repeated :logo_recognition_annotations, :message, 19, "google.cloud.videointelligence.v1.LogoRecognitionAnnotation"
+      repeated :person_detection_annotations, :message, 20, "google.cloud.videointelligence.v1.PersonDetectionAnnotation"
       optional :error, :message, 9, "google.rpc.Status"
     end
     add_message "google.cloud.videointelligence.v1.AnnotateVideoResponse" do
@@ -204,6 +224,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.videointelligence.v1.TextAnnotation" do
       optional :text, :string, 1
       repeated :segments, :message, 2, "google.cloud.videointelligence.v1.TextSegment"
+      optional :version, :string, 3
     end
     add_message "google.cloud.videointelligence.v1.ObjectTrackingFrame" do
       optional :normalized_bounding_box, :message, 1, "google.cloud.videointelligence.v1.NormalizedBoundingBox"
@@ -213,6 +234,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :entity, :message, 1, "google.cloud.videointelligence.v1.Entity"
       optional :confidence, :float, 4
       repeated :frames, :message, 2, "google.cloud.videointelligence.v1.ObjectTrackingFrame"
+      optional :version, :string, 6
       oneof :track_info do
         optional :segment, :message, 3, "google.cloud.videointelligence.v1.VideoSegment"
         optional :track_id, :int64, 5
@@ -233,6 +255,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :TEXT_DETECTION, 7
       value :OBJECT_TRACKING, 9
       value :LOGO_RECOGNITION, 12
+      value :PERSON_DETECTION, 14
     end
     add_enum "google.cloud.videointelligence.v1.LabelDetectionMode" do
       value :LABEL_DETECTION_MODE_UNSPECIFIED, 0
@@ -261,6 +284,7 @@ module Google
         ShotChangeDetectionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.ShotChangeDetectionConfig").msgclass
         ObjectTrackingConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.ObjectTrackingConfig").msgclass
         FaceDetectionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.FaceDetectionConfig").msgclass
+        PersonDetectionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.PersonDetectionConfig").msgclass
         ExplicitContentDetectionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.ExplicitContentDetectionConfig").msgclass
         TextDetectionConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.TextDetectionConfig").msgclass
         VideoSegment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.VideoSegment").msgclass
@@ -271,6 +295,8 @@ module Google
         ExplicitContentFrame = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.ExplicitContentFrame").msgclass
         ExplicitContentAnnotation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.ExplicitContentAnnotation").msgclass
         NormalizedBoundingBox = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.NormalizedBoundingBox").msgclass
+        FaceDetectionAnnotation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.FaceDetectionAnnotation").msgclass
+        PersonDetectionAnnotation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.PersonDetectionAnnotation").msgclass
         FaceSegment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.FaceSegment").msgclass
         FaceFrame = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.FaceFrame").msgclass
         FaceAnnotation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.videointelligence.v1.FaceAnnotation").msgclass

data/lib/google/cloud/videointelligence/v1/video_intelligence_services_pb.rb

@@ -24,7 +24,7 @@ module Google
     module VideoIntelligence
       module V1
         module VideoIntelligenceService
-          # Service that implements Google Cloud Video Intelligence API.
+          # Service that implements the Video Intelligence API.
           class Service
 
             include GRPC::GenericService
@@ -37,7 +37,7 @@ module Google
             # retrieved through the `google.longrunning.Operations` interface.
             # `Operation.metadata` contains `AnnotateVideoProgress` (progress).
             # `Operation.response` contains `AnnotateVideoResponse` (results).
-            rpc :AnnotateVideo, Google::Cloud::VideoIntelligence::V1::AnnotateVideoRequest, Google::Longrunning::Operation
+            rpc :AnnotateVideo, ::Google::Cloud::VideoIntelligence::V1::AnnotateVideoRequest, ::Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

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/videointelligence/v1/video_intelligence.rb

@@ -25,20 +25,21 @@ module Google
         # @!attribute [rw] input_uri
         #   @return [::String]
         #     Input video location. Currently, only
-        #     [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
-        #     supported, which must be specified in the following format:
+        #     [Cloud Storage](https://cloud.google.com/storage/) URIs are
+        #     supported. URIs must be specified in the following format:
         #     `gs://bucket-id/object-id` (other URI formats return
-        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-        #     [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
-        #     A video URI may include wildcards in `object-id`, and thus identify
-        #     multiple videos. Supported wildcards: '*' to match 0 or more characters;
+        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+        #     more information, see [Request
+        #     URIs](https://cloud.google.com/storage/docs/request-endpoints). To identify
+        #     multiple videos, a video URI may include wildcards in the `object-id`.
+        #     Supported wildcards: '*' to match 0 or more characters;
         #     '?' to match 1 character. If unset, the input video should be embedded
-        #     in the request as `input_content`. If set, `input_content` should be unset.
+        #     in the request as `input_content`. If set, `input_content` must be unset.
         # @!attribute [rw] input_content
         #   @return [::String]
         #     The video data bytes.
-        #     If unset, the input video(s) should be specified via `input_uri`.
-        #     If set, `input_uri` should be unset.
+        #     If unset, the input video(s) should be specified via the `input_uri`.
+        #     If set, `input_uri` must be unset.
         # @!attribute [rw] features
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::Feature>]
         #     Required. Requested video annotation features.
@@ -48,16 +49,18 @@ module Google
         # @!attribute [rw] output_uri
         #   @return [::String]
         #     Optional. Location where the output (in JSON format) should be stored.
-        #     Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
-        #     URIs are supported, which must be specified in the following format:
+        #     Currently, only [Cloud Storage](https://cloud.google.com/storage/)
+        #     URIs are supported. These must be specified in the following format:
         #     `gs://bucket-id/object-id` (other URI formats return
-        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For more information, see
-        #     [Request URIs](https://cloud.google.com/storage/docs/request-endpoints).
+        #     [google.rpc.Code.INVALID_ARGUMENT][google.rpc.Code.INVALID_ARGUMENT]). For
+        #     more information, see [Request
+        #     URIs](https://cloud.google.com/storage/docs/request-endpoints).
         # @!attribute [rw] location_id
         #   @return [::String]
         #     Optional. Cloud region where annotation should take place. Supported cloud
-        #     regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
-        #     is specified, a region will be determined based on video file location.
+        #     regions are: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no
+        #     region is specified, the region will be determined based on video file
+        #     location.
         class AnnotateVideoRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -87,6 +90,9 @@ module Google
         # @!attribute [rw] text_detection_config
         #   @return [::Google::Cloud::VideoIntelligence::V1::TextDetectionConfig]
         #     Config for TEXT_DETECTION.
+        # @!attribute [rw] person_detection_config
+        #   @return [::Google::Cloud::VideoIntelligence::V1::PersonDetectionConfig]
+        #     Config for PERSON_DETECTION.
         # @!attribute [rw] object_tracking_config
         #   @return [::Google::Cloud::VideoIntelligence::V1::ObjectTrackingConfig]
         #     Config for OBJECT_TRACKING.
@@ -103,9 +109,9 @@ module Google
         #     If unspecified, defaults to `SHOT_MODE`.
         # @!attribute [rw] stationary_camera
         #   @return [::Boolean]
-        #     Whether the video has been shot from a stationary (i.e. non-moving) camera.
-        #     When set to true, might improve detection accuracy for moving objects.
-        #     Should be used with `SHOT_AND_FRAME_MODE` enabled.
+        #     Whether the video has been shot from a stationary (i.e., non-moving)
+        #     camera. When set to true, might improve detection accuracy for moving
+        #     objects. Should be used with `SHOT_AND_FRAME_MODE` enabled.
         # @!attribute [rw] model
         #   @return [::String]
         #     Model to use for label detection.
@@ -117,15 +123,15 @@ module Google
         #     frame-level detection. If not set, it is set to 0.4 by default. The valid
         #     range for this threshold is [0.1, 0.9]. Any value set outside of this
         #     range will be clipped.
-        #     Note: for best results please follow the default threshold. We will update
+        #     Note: For best results, follow the default threshold. We will update
         #     the default threshold everytime when we release a new model.
         # @!attribute [rw] video_confidence_threshold
         #   @return [::Float]
         #     The confidence threshold we perform filtering on the labels from
-        #     video-level and shot-level detections. If not set, it is set to 0.3 by
+        #     video-level and shot-level detections. If not set, it's set to 0.3 by
         #     default. The valid range for this threshold is [0.1, 0.9]. Any value set
         #     outside of this range will be clipped.
-        #     Note: for best results please follow the default threshold. We will update
+        #     Note: For best results, follow the default threshold. We will update
         #     the default threshold everytime when we release a new model.
         class LabelDetectionConfig
           include ::Google::Protobuf::MessageExts
@@ -162,12 +168,36 @@ module Google
         #     "builtin/latest".
         # @!attribute [rw] include_bounding_boxes
         #   @return [::Boolean]
-        #     Whether bounding boxes be included in the face annotation output.
+        #     Whether bounding boxes are included in the face annotation output.
+        # @!attribute [rw] include_attributes
+        #   @return [::Boolean]
+        #     Whether to enable face attributes detection, such as glasses, dark_glasses,
+        #     mouth_open etc. Ignored if 'include_bounding_boxes' is set to false.
         class FaceDetectionConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Config for PERSON_DETECTION.
+        # @!attribute [rw] include_bounding_boxes
+        #   @return [::Boolean]
+        #     Whether bounding boxes are included in the person detection annotation
+        #     output.
+        # @!attribute [rw] include_pose_landmarks
+        #   @return [::Boolean]
+        #     Whether to enable pose landmarks detection. Ignored if
+        #     'include_bounding_boxes' is set to false.
+        # @!attribute [rw] include_attributes
+        #   @return [::Boolean]
+        #     Whether to enable person attributes detection, such as cloth color (black,
+        #     blue, etc), type (coat, dress, etc), pattern (plain, floral, etc), hair,
+        #     etc.
+        #     Ignored if 'include_bounding_boxes' is set to false.
+        class PersonDetectionConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Config for EXPLICIT_CONTENT_DETECTION.
         # @!attribute [rw] model
         #   @return [::String]
@@ -244,7 +274,7 @@ module Google
         #     API](https://developers.google.com/knowledge-graph/).
         # @!attribute [rw] description
         #   @return [::String]
-        #     Textual description, e.g. `Fixed-gear bicycle`.
+        #     Textual description, e.g., `Fixed-gear bicycle`.
         # @!attribute [rw] language_code
         #   @return [::String]
         #     Language code for `description` in BCP-47 format.
@@ -260,15 +290,18 @@ module Google
         # @!attribute [rw] category_entities
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::Entity>]
         #     Common categories for the detected entity.
-        #     E.g. when the label is `Terrier` the category is likely `dog`. And in some
-        #     cases there might be more than one categories e.g. `Terrier` could also be
-        #     a `pet`.
+        #     For example, when the label is `Terrier`, the category is likely `dog`. And
+        #     in some cases there might be more than one categories e.g., `Terrier` could
+        #     also be a `pet`.
         # @!attribute [rw] segments
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::LabelSegment>]
         #     All video segments where a label was detected.
         # @!attribute [rw] frames
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::LabelFrame>]
         #     All video frames where a label was detected.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
         class LabelAnnotation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -293,6 +326,9 @@ module Google
         # @!attribute [rw] frames
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::ExplicitContentFrame>]
         #     All video frames where explicit content was detected.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
         class ExplicitContentAnnotation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -318,6 +354,33 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Face detection annotation.
+        # @!attribute [rw] tracks
+        #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::Track>]
+        #     The face tracks with attributes.
+        # @!attribute [rw] thumbnail
+        #   @return [::String]
+        #     The thumbnail of a person's face.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
+        class FaceDetectionAnnotation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Person detection annotation per video.
+        # @!attribute [rw] tracks
+        #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::Track>]
+        #     The detected tracks of a person.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
+        class PersonDetectionAnnotation
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Video segment level annotation results for face detection.
         # @!attribute [rw] segment
         #   @return [::Google::Cloud::VideoIntelligence::V1::VideoSegment]
@@ -327,7 +390,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Video frame level annotation results for face detection.
+        # Deprecated. No effect.
         # @!attribute [rw] normalized_bounding_boxes
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::NormalizedBoundingBox>]
         #     Normalized Bounding boxes in a frame.
@@ -342,7 +405,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Face annotation.
+        # Deprecated. No effect.
         # @!attribute [rw] thumbnail
         #   @return [::String]
         #     Thumbnail of a representative face view (in JPEG format).
@@ -399,7 +462,7 @@ module Google
         # A generic detected attribute represented by name in string format.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The name of the attribute, i.e. glasses, dark_glasses, mouth_open etc.
+        #     The name of the attribute, for example, glasses, dark_glasses, mouth_open.
         #     A full list of supported type names will be provided in the document.
         # @!attribute [rw] confidence
         #   @return [::Float]
@@ -417,7 +480,7 @@ module Google
         # location.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The name of this landmark, i.e. left_hand, right_shoulder.
+        #     The name of this landmark, for example, left_hand, right_shoulder.
         # @!attribute [rw] point
         #   @return [::Google::Cloud::VideoIntelligence::V1::NormalizedVertex]
         #     The 2D point of the detected landmark using the normalized image
@@ -434,17 +497,17 @@ module Google
         # @!attribute [rw] input_uri
         #   @return [::String]
         #     Video file location in
-        #     [Google Cloud Storage](https://cloud.google.com/storage/).
+        #     [Cloud Storage](https://cloud.google.com/storage/).
         # @!attribute [rw] segment
         #   @return [::Google::Cloud::VideoIntelligence::V1::VideoSegment]
         #     Video segment on which the annotation is run.
         # @!attribute [rw] segment_label_annotations
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::LabelAnnotation>]
-        #     Topical label annotations on video level or user specified segment level.
+        #     Topical label annotations on video level or user-specified segment level.
         #     There is exactly one element for each unique label.
         # @!attribute [rw] segment_presence_label_annotations
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::LabelAnnotation>]
-        #     Presence label annotations on video level or user specified segment level.
+        #     Presence label annotations on video level or user-specified segment level.
         #     There is exactly one element for each unique label. Compared to the
         #     existing topical `segment_label_annotations`, this field presents more
         #     fine-grained, segment-level labels detected in video content and is made
@@ -467,7 +530,10 @@ module Google
         #     There is exactly one element for each unique label.
         # @!attribute [rw] face_annotations
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::FaceAnnotation>]
-        #     Face annotations. There is exactly one element for each unique face.
+        #     Deprecated. Please use `face_detection_annotations` instead.
+        # @!attribute [rw] face_detection_annotations
+        #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::FaceDetectionAnnotation>]
+        #     Face detection annotations.
         # @!attribute [rw] shot_annotations
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::VideoSegment>]
         #     Shot annotations. Each shot is represented as a video segment.
@@ -488,6 +554,9 @@ module Google
         # @!attribute [rw] logo_recognition_annotations
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::LogoRecognitionAnnotation>]
         #     Annotations for list of logos detected, tracked and recognized in video.
+        # @!attribute [rw] person_detection_annotations
+        #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::PersonDetectionAnnotation>]
+        #     Person detection annotations.
         # @!attribute [rw] error
         #   @return [::Google::Rpc::Status]
         #     If set, indicates an error. Note that for a single `AnnotateVideoRequest`
@@ -512,7 +581,7 @@ module Google
         # @!attribute [rw] input_uri
         #   @return [::String]
         #     Video file location in
-        #     [Google Cloud Storage](https://cloud.google.com/storage/).
+        #     [Cloud Storage](https://cloud.google.com/storage/).
         # @!attribute [rw] progress_percent
         #   @return [::Integer]
         #     Approximate percentage processed thus far. Guaranteed to be
@@ -526,11 +595,11 @@ module Google
         # @!attribute [rw] feature
         #   @return [::Google::Cloud::VideoIntelligence::V1::Feature]
         #     Specifies which feature is being tracked if the request contains more than
-        #     one features.
+        #     one feature.
         # @!attribute [rw] segment
         #   @return [::Google::Cloud::VideoIntelligence::V1::VideoSegment]
         #     Specifies which segment is being tracked if the request contains more than
-        #     one segments.
+        #     one segment.
         class VideoAnnotationProgress
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -589,14 +658,14 @@ module Google
         #     the top alternative of the recognition result using a speaker_tag provided
         #     in the WordInfo.
         #     Note: When this is true, we send all the words from the beginning of the
-        #     audio for the top alternative in every consecutive responses.
+        #     audio for the top alternative in every consecutive response.
         #     This is done in order to improve our speaker tags as our models learn to
         #     identify the speakers in the conversation over time.
         # @!attribute [rw] diarization_speaker_count
         #   @return [::Integer]
-        #     Optional. If set, specifies the estimated number of speakers in the conversation.
-        #     If not set, defaults to '2'.
-        #     Ignored unless enable_speaker_diarization is set to true.
+        #     Optional. If set, specifies the estimated number of speakers in the
+        #     conversation. If not set, defaults to '2'. Ignored unless
+        #     enable_speaker_diarization is set to true.
         # @!attribute [rw] enable_word_confidence
         #   @return [::Boolean]
         #     Optional. If `true`, the top result includes a list of words and the
@@ -631,9 +700,9 @@ module Google
         #     ranked by the recognizer.
         # @!attribute [r] language_code
         #   @return [::String]
-        #     Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag of
-        #     the language in this result. This language code was detected to have the
-        #     most likelihood of being spoken in the audio.
+        #     Output only. The [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt)
+        #     language tag of the language in this result. This language code was
+        #     detected to have the most likelihood of being spoken in the audio.
         class SpeechTranscription
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -654,8 +723,8 @@ module Google
         # @!attribute [r] words
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::WordInfo>]
         #     Output only. A list of word-specific information for each recognized word.
-        #     Note: When `enable_speaker_diarization` is true, you will see all the words
-        #     from the beginning of the audio.
+        #     Note: When `enable_speaker_diarization` is set to true, you will see all
+        #     the words from the beginning of the audio.
         class SpeechRecognitionAlternative
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -776,6 +845,9 @@ module Google
         # @!attribute [rw] segments
         #   @return [::Array<::Google::Cloud::VideoIntelligence::V1::TextSegment>]
         #     All video segments where OCR detected text appears.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
         class TextAnnotation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -819,6 +891,9 @@ module Google
         #     Non-streaming batch mode: it may be one or multiple ObjectTrackingFrame
         #     messages in frames.
         #     Streaming mode: it can only be one ObjectTrackingFrame message in frames.
+        # @!attribute [rw] version
+        #   @return [::String]
+        #     Feature version.
         class ObjectTrackingAnnotation
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -856,7 +931,7 @@ module Google
           # Explicit content detection.
           EXPLICIT_CONTENT_DETECTION = 3
 
-          # Human face detection and tracking.
+          # Human face detection.
           FACE_DETECTION = 4
 
           # Speech transcription.
@@ -870,6 +945,9 @@ module Google
 
           # Logo detection, tracking, and recognition.
           LOGO_RECOGNITION = 12
+
+          # Person detection.
+          PERSON_DETECTION = 14
         end
 
         # Label detection mode.

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:

data/proto_docs/google/protobuf/any.rb

@@ -57,10 +57,13 @@ module Google
     #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
-    #      any, err := ptypes.MarshalAny(foo)
+    #      any, err := anypb.New(foo)
+    #      if err != nil {
+    #        ...
+    #      }
     #      ...
     #      foo := &pb.Foo{}
-    #      if err := ptypes.UnmarshalAny(any, foo); err != nil {
+    #      if err := any.UnmarshalTo(foo); err != nil {
     #        ...
     #      }
     #

data/proto_docs/google/protobuf/timestamp.rb

@@ -70,7 +70,16 @@ module Google
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
     #
-    # Example 5: Compute Timestamp from current time in Python.
+    # Example 5: Compute Timestamp from Java `Instant.now()`.
+    #
+    #     Instant now = Instant.now();
+    #
+    #     Timestamp timestamp =
+    #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
+    #             .setNanos(now.getNano()).build();
+    #
+    #
+    # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
     #     timestamp.GetCurrentTime()

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-video_intelligence-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-08-07 00:00:00.000000000 Z
+date: 2021-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -152,7 +152,10 @@ dependencies:
         version: '0.9'
 description: Detects objects, explicit content, and scene changes in videos. It also
   specifies the region for annotation and transcribes speech to text. Supports both
-  asynchronous API and streaming API.
+  asynchronous API and streaming API. Note that google-cloud-video_intelligence-v1
+  is a version-specific client library. For most uses, we recommend installing the
+  main client library google-cloud-video_intelligence instead. See the readme for
+  more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -200,7 +203,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
+rubygems_version: 3.2.6
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Video Intelligence V1 API