google-cloud-video_intelligence-v1 0.2.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26d3866df9815328d1fb8dc342e9b99e1d2327eaf9a4b0a1caa4cd3651bc3adb
-  data.tar.gz: f1500bc9790fd1dea9ba6807d07f51ec4b6ba4af44a54264fabe8577404d258e
+  metadata.gz: 361b6d8d213fc0984ebd3f4df7a01a213a7bfc8655e449ec0531413198219785
+  data.tar.gz: eeadbbfdae9a1a1b4027a4b16c2a287529e7c0362f180b9c4228139f81470adb
 SHA512:
-  metadata.gz: 9cab9687f551352429025b6c0a9cd963f90254802cd0086bef9554b067242e70288fd71712bea57313fa8a2dcf912e7eb23138544895fbfcbaa759963fe803bc
-  data.tar.gz: 93aed5448353fbf9801ca386344b83bc2948a07036d167bbe661f4c5987d5610f61d29dedfba0b82a1df1ef2f9c27036a65ead5d12a26bdb78fd228c1ca5ffca
+  metadata.gz: c51a92191d80d777f9e62d8bd65fbfff49cdbf2f233b35d84e098bbd5e208ea8a942eccddd1f8dbdb7fe1243aefb27f8056c78633628601cbd6d31849f6e1964
+  data.tar.gz: b7a956274dfe8b5b31e6706f073ffdc3e52f32003ec8ca272a95ebd937f3acca8b960c62b734b74321030bd96c99d04395c60e2461e35002d0c21a10cd35a7eb

data/README.md

@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
 
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. [Enable the API.](https://console.cloud.google.com/apis/library/videointelligence.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
 ## Quick Start
@@ -33,6 +34,9 @@ response = client.annotate_video request
 View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-video_intelligence-v1/latest)
 for class and method documentation.
 
+See also the [Product Documentation](https://cloud.google.com/video-intelligence)
+for general usage information.
+
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.

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.2"
+        VERSION = "0.4.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
@@ -68,7 +68,7 @@ module Google
                   initial_delay: 1.0,
                   max_delay:     120.0,
                   multiplier:    2.5,
-                  retry_codes:   ["UNAVAILABLE", "DEADLINE_EXCEEDED"]
+                  retry_codes:   [14, 4]
                 }
 
                 default_config
@@ -185,34 +185,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 +342,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

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

@@ -475,7 +475,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

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/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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-video_intelligence-v1
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-05 00:00:00.000000000 Z
+date: 2020-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -200,7 +200,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Video Intelligence V1 API