google-cloud-video_intelligence 1.1.1 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +5 -5
- data/lib/google/cloud/video_intelligence.rb +4 -4
- data/lib/google/cloud/video_intelligence/v1.rb +4 -4
- data/lib/google/cloud/video_intelligence/v1/doc/google/cloud/videointelligence/v1/video_intelligence.rb +23 -23
- data/lib/google/cloud/video_intelligence/v1/doc/google/longrunning/operations.rb +9 -9
- data/lib/google/cloud/video_intelligence/v1/doc/google/protobuf/any.rb +8 -8
- data/lib/google/cloud/video_intelligence/v1/doc/google/protobuf/duration.rb +3 -3
- data/lib/google/cloud/video_intelligence/v1/doc/google/rpc/status.rb +11 -11
- data/lib/google/cloud/video_intelligence/v1/video_intelligence_service_client.rb +10 -10
- data/lib/google/cloud/video_intelligence/v1beta1.rb +4 -4
- data/lib/google/cloud/video_intelligence/v1beta1/doc/google/cloud/videointelligence/v1beta1/video_intelligence.rb +21 -21
- data/lib/google/cloud/video_intelligence/v1beta1/doc/google/longrunning/operations.rb +9 -9
- data/lib/google/cloud/video_intelligence/v1beta1/doc/google/protobuf/any.rb +8 -8
- data/lib/google/cloud/video_intelligence/v1beta1/doc/google/rpc/status.rb +11 -11
- data/lib/google/cloud/video_intelligence/v1beta1/video_intelligence_service_client.rb +9 -9
- data/lib/google/cloud/video_intelligence/v1beta2.rb +4 -4
- data/lib/google/cloud/video_intelligence/v1beta2/doc/google/cloud/videointelligence/v1beta2/video_intelligence.rb +23 -23
- data/lib/google/cloud/video_intelligence/v1beta2/doc/google/longrunning/operations.rb +9 -9
- data/lib/google/cloud/video_intelligence/v1beta2/doc/google/protobuf/any.rb +8 -8
- data/lib/google/cloud/video_intelligence/v1beta2/doc/google/protobuf/duration.rb +3 -3
- data/lib/google/cloud/video_intelligence/v1beta2/doc/google/rpc/status.rb +11 -11
- data/lib/google/cloud/video_intelligence/v1beta2/video_intelligence_service_client.rb +10 -10
- metadata +3 -6
- data/lib/google/cloud/video_intelligence/v1/doc/overview.rb +0 -118
- data/lib/google/cloud/video_intelligence/v1beta1/doc/overview.rb +0 -80
- data/lib/google/cloud/video_intelligence/v1beta2/doc/overview.rb +0 -80
@@ -23,7 +23,7 @@ module Google
|
|
23
23
|
# rubocop:disable LineLength
|
24
24
|
|
25
25
|
##
|
26
|
-
# # Ruby Client for Google Cloud Video Intelligence API ([GA](https://github.com/
|
26
|
+
# # Ruby Client for Google Cloud Video Intelligence API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
|
27
27
|
#
|
28
28
|
# [Google Cloud Video Intelligence API][Product Documentation]:
|
29
29
|
# Google Cloud Video Intelligence API.
|
@@ -36,7 +36,7 @@ module Google
|
|
36
36
|
# 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
|
37
37
|
# 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
|
38
38
|
# 3. [Enable the Google Cloud Video Intelligence API.](https://console.cloud.google.com/apis/library/videointelligence.googleapis.com)
|
39
|
-
# 4. [Setup Authentication.](https://
|
39
|
+
# 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
|
40
40
|
#
|
41
41
|
# ### Installation
|
42
42
|
# ```
|
@@ -46,7 +46,7 @@ module Google
|
|
46
46
|
# ### Next Steps
|
47
47
|
# - Read the [Google Cloud Video Intelligence API Product documentation][Product Documentation]
|
48
48
|
# to learn more about the product and see How-to Guides.
|
49
|
-
# - View this [repository's main README](https://github.com/
|
49
|
+
# - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
|
50
50
|
# to see the full list of Cloud APIs that we cover.
|
51
51
|
#
|
52
52
|
# [Product Documentation]: https://cloud.google.com/video-intelligence
|
@@ -55,7 +55,7 @@ module Google
|
|
55
55
|
#
|
56
56
|
# To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
57
57
|
# The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
|
58
|
-
# or a [`Google::Cloud::Logging::Logger`](https://
|
58
|
+
# or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
|
59
59
|
# that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
60
60
|
# and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
61
61
|
#
|
@@ -23,17 +23,17 @@ module Google
|
|
23
23
|
# Input video location. Currently, only
|
24
24
|
# [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
|
25
25
|
# supported, which must be specified in the following format:
|
26
|
-
#
|
26
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
27
27
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
28
28
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
29
|
-
# A video URI may include wildcards in
|
29
|
+
# A video URI may include wildcards in `object-id`, and thus identify
|
30
30
|
# multiple videos. Supported wildcards: '*' to match 0 or more characters;
|
31
31
|
# '?' to match 1 character. If unset, the input video should be embedded
|
32
|
-
# in the request as
|
32
|
+
# in the request as `input_content`. If set, `input_content` should be unset.
|
33
33
|
# @!attribute [rw] input_content
|
34
34
|
# @return [String]
|
35
35
|
# The video data bytes. Encoding: base64. If unset, the input video(s)
|
36
|
-
# should be specified via
|
36
|
+
# should be specified via `input_uri`. If set, `input_uri` should be unset.
|
37
37
|
# @!attribute [rw] features
|
38
38
|
# @return [Array<Google::Cloud::Videointelligence::V1beta1::Feature>]
|
39
39
|
# Requested video annotation features.
|
@@ -45,13 +45,13 @@ module Google
|
|
45
45
|
# Optional location where the output (in JSON format) should be stored.
|
46
46
|
# Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
|
47
47
|
# URIs are supported, which must be specified in the following format:
|
48
|
-
#
|
48
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
49
49
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
50
50
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
51
51
|
# @!attribute [rw] location_id
|
52
52
|
# @return [String]
|
53
53
|
# Optional cloud region where annotation should take place. Supported cloud
|
54
|
-
# regions:
|
54
|
+
# regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
|
55
55
|
# is specified, a region will be determined based on video file location.
|
56
56
|
class AnnotateVideoRequest; end
|
57
57
|
|
@@ -65,7 +65,7 @@ module Google
|
|
65
65
|
# @return [Google::Cloud::Videointelligence::V1beta1::LabelDetectionMode]
|
66
66
|
# If label detection has been requested, what labels should be detected
|
67
67
|
# in addition to video-level labels or segment-level labels. If unspecified,
|
68
|
-
# defaults to
|
68
|
+
# defaults to `SHOT_MODE`.
|
69
69
|
# @!attribute [rw] stationary_camera
|
70
70
|
# @return [true, false]
|
71
71
|
# Whether the video has been shot from a stationary (i.e. non-moving) camera.
|
@@ -102,7 +102,7 @@ module Google
|
|
102
102
|
# @return [Google::Cloud::Videointelligence::V1beta1::VideoSegment]
|
103
103
|
# Video segment. Set to [-1, -1] for video-level labels.
|
104
104
|
# Set to [timestamp, timestamp] for frame-level labels.
|
105
|
-
# Otherwise, corresponds to one of
|
105
|
+
# Otherwise, corresponds to one of `AnnotateSpec.segments`
|
106
106
|
# (if specified) or to shot boundaries (if requested).
|
107
107
|
# @!attribute [rw] confidence
|
108
108
|
# @return [Float]
|
@@ -115,10 +115,10 @@ module Google
|
|
115
115
|
# Label annotation.
|
116
116
|
# @!attribute [rw] description
|
117
117
|
# @return [String]
|
118
|
-
# Textual description, e.g.
|
118
|
+
# Textual description, e.g. `Fixed-gear bicycle`.
|
119
119
|
# @!attribute [rw] language_code
|
120
120
|
# @return [String]
|
121
|
-
# Language code for
|
121
|
+
# Language code for `description` in BCP-47 format.
|
122
122
|
# @!attribute [rw] locations
|
123
123
|
# @return [Array<Google::Cloud::Videointelligence::V1beta1::LabelLocation>]
|
124
124
|
# Where the label was detected and with what confidence.
|
@@ -127,7 +127,7 @@ module Google
|
|
127
127
|
# Safe search annotation (based on per-frame visual signals only).
|
128
128
|
# If no unsafe content has been detected in a frame, no annotations
|
129
129
|
# are present for that frame. If only some types of unsafe content
|
130
|
-
# have been detected in a frame, the likelihood is set to
|
130
|
+
# have been detected in a frame, the likelihood is set to `UNKNOWN`
|
131
131
|
# for all other types of unsafe content.
|
132
132
|
# @!attribute [rw] adult
|
133
133
|
# @return [Google::Cloud::Videointelligence::V1beta1::Likelihood]
|
@@ -207,16 +207,16 @@ module Google
|
|
207
207
|
# Safe search annotations.
|
208
208
|
# @!attribute [rw] error
|
209
209
|
# @return [Google::Rpc::Status]
|
210
|
-
# If set, indicates an error. Note that for a single
|
210
|
+
# If set, indicates an error. Note that for a single `AnnotateVideoRequest`
|
211
211
|
# some videos may succeed and some may fail.
|
212
212
|
class VideoAnnotationResults; end
|
213
213
|
|
214
|
-
# Video annotation response. Included in the
|
215
|
-
# field of the
|
216
|
-
# call of the
|
214
|
+
# Video annotation response. Included in the `response`
|
215
|
+
# field of the `Operation` returned by the `GetOperation`
|
216
|
+
# call of the `google::longrunning::Operations` service.
|
217
217
|
# @!attribute [rw] annotation_results
|
218
218
|
# @return [Array<Google::Cloud::Videointelligence::V1beta1::VideoAnnotationResults>]
|
219
|
-
# Annotation results for all videos specified in
|
219
|
+
# Annotation results for all videos specified in `AnnotateVideoRequest`.
|
220
220
|
class AnnotateVideoResponse; end
|
221
221
|
|
222
222
|
# Annotation progress for a single video.
|
@@ -236,12 +236,12 @@ module Google
|
|
236
236
|
# Time of the most recent update.
|
237
237
|
class VideoAnnotationProgress; end
|
238
238
|
|
239
|
-
# Video annotation progress. Included in the
|
240
|
-
# field of the
|
241
|
-
# call of the
|
239
|
+
# Video annotation progress. Included in the `metadata`
|
240
|
+
# field of the `Operation` returned by the `GetOperation`
|
241
|
+
# call of the `google::longrunning::Operations` service.
|
242
242
|
# @!attribute [rw] annotation_progress
|
243
243
|
# @return [Array<Google::Cloud::Videointelligence::V1beta1::VideoAnnotationProgress>]
|
244
|
-
# Progress metadata for all videos specified in
|
244
|
+
# Progress metadata for all videos specified in `AnnotateVideoRequest`.
|
245
245
|
class AnnotateVideoProgress; end
|
246
246
|
|
247
247
|
# Video annotation feature.
|
@@ -270,7 +270,7 @@ module Google
|
|
270
270
|
# Video-level. Corresponds to the whole video.
|
271
271
|
VIDEO_LEVEL = 1
|
272
272
|
|
273
|
-
# Segment-level. Corresponds to one of
|
273
|
+
# Segment-level. Corresponds to one of `AnnotateSpec.segments`.
|
274
274
|
SEGMENT_LEVEL = 2
|
275
275
|
|
276
276
|
# Shot-level. Corresponds to a single shot (i.e. a series of frames
|
@@ -21,7 +21,7 @@ module Google
|
|
21
21
|
# @return [String]
|
22
22
|
# The server-assigned name, which is only unique within the same service that
|
23
23
|
# originally returns it. If you use the default HTTP mapping, the
|
24
|
-
#
|
24
|
+
# `name` should have the format of `operations/some/unique/name`.
|
25
25
|
# @!attribute [rw] metadata
|
26
26
|
# @return [Google::Protobuf::Any]
|
27
27
|
# Service-specific metadata associated with the operation. It typically
|
@@ -30,8 +30,8 @@ module Google
|
|
30
30
|
# long-running operation should document the metadata type, if any.
|
31
31
|
# @!attribute [rw] done
|
32
32
|
# @return [true, false]
|
33
|
-
# If the value is
|
34
|
-
# If true, the operation is completed, and either
|
33
|
+
# If the value is `false`, it means the operation is still in progress.
|
34
|
+
# If true, the operation is completed, and either `error` or `response` is
|
35
35
|
# available.
|
36
36
|
# @!attribute [rw] error
|
37
37
|
# @return [Google::Rpc::Status]
|
@@ -39,13 +39,13 @@ module Google
|
|
39
39
|
# @!attribute [rw] response
|
40
40
|
# @return [Google::Protobuf::Any]
|
41
41
|
# The normal response of the operation in case of success. If the original
|
42
|
-
# method returns no data on success, such as
|
43
|
-
#
|
44
|
-
#
|
45
|
-
# methods, the response should have the type
|
42
|
+
# method returns no data on success, such as `Delete`, the response is
|
43
|
+
# `google.protobuf.Empty`. If the original method is standard
|
44
|
+
# `Get`/`Create`/`Update`, the response should be the resource. For other
|
45
|
+
# methods, the response should have the type `XxxResponse`, where `Xxx`
|
46
46
|
# is the original method name. For example, if the original method name
|
47
|
-
# is
|
48
|
-
#
|
47
|
+
# is `TakeSnapshot()`, the inferred response type is
|
48
|
+
# `TakeSnapshotResponse`.
|
49
49
|
class Operation; end
|
50
50
|
|
51
51
|
# The request message for {Google::Longrunning::Operations::GetOperation Operations::GetOperation}.
|
@@ -15,7 +15,7 @@
|
|
15
15
|
|
16
16
|
module Google
|
17
17
|
module Protobuf
|
18
|
-
#
|
18
|
+
# `Any` contains an arbitrary serialized protocol buffer message along with a
|
19
19
|
# URL that describes the type of the serialized message.
|
20
20
|
#
|
21
21
|
# Protobuf library provides support to pack/unpack Any values in the form
|
@@ -69,9 +69,9 @@ module Google
|
|
69
69
|
#
|
70
70
|
# = JSON
|
71
71
|
#
|
72
|
-
# The JSON representation of an
|
72
|
+
# The JSON representation of an `Any` value uses the regular
|
73
73
|
# representation of the deserialized, embedded message, with an
|
74
|
-
# additional field
|
74
|
+
# additional field `@type` which contains the type URL. Example:
|
75
75
|
#
|
76
76
|
# package google.profile;
|
77
77
|
# message Person {
|
@@ -87,7 +87,7 @@ module Google
|
|
87
87
|
#
|
88
88
|
# If the embedded message type is well-known and has a custom JSON
|
89
89
|
# representation, that representation will be embedded adding a field
|
90
|
-
#
|
90
|
+
# `value` which holds the custom JSON in addition to the `@type`
|
91
91
|
# field. Example (for message {Google::Protobuf::Duration}):
|
92
92
|
#
|
93
93
|
# {
|
@@ -99,15 +99,15 @@ module Google
|
|
99
99
|
# A URL/resource name that uniquely identifies the type of the serialized
|
100
100
|
# protocol buffer message. The last segment of the URL's path must represent
|
101
101
|
# the fully qualified name of the type (as in
|
102
|
-
#
|
102
|
+
# `path/google.protobuf.Duration`). The name should be in a canonical form
|
103
103
|
# (e.g., leading "." is not accepted).
|
104
104
|
#
|
105
105
|
# In practice, teams usually precompile into the binary all types that they
|
106
106
|
# expect it to use in the context of Any. However, for URLs which use the
|
107
|
-
# scheme
|
107
|
+
# scheme `http`, `https`, or no scheme, one can optionally set up a type
|
108
108
|
# server that maps type URLs to message definitions as follows:
|
109
109
|
#
|
110
|
-
# * If no scheme is provided,
|
110
|
+
# * If no scheme is provided, `https` is assumed.
|
111
111
|
# * An HTTP GET on the URL must yield a {Google::Protobuf::Type}
|
112
112
|
# value in binary format, or produce an error.
|
113
113
|
# * Applications are allowed to cache lookup results based on the
|
@@ -120,7 +120,7 @@ module Google
|
|
120
120
|
# protobuf release, and it is not used for type URLs beginning with
|
121
121
|
# type.googleapis.com.
|
122
122
|
#
|
123
|
-
# Schemes other than
|
123
|
+
# Schemes other than `http`, `https` (or the empty scheme) might be
|
124
124
|
# used with implementation specific semantics.
|
125
125
|
# @!attribute [rw] value
|
126
126
|
# @return [String]
|
@@ -15,7 +15,7 @@
|
|
15
15
|
|
16
16
|
module Google
|
17
17
|
module Rpc
|
18
|
-
# The
|
18
|
+
# The `Status` type defines a logical error model that is suitable for different
|
19
19
|
# programming environments, including REST APIs and RPC APIs. It is used by
|
20
20
|
# [gRPC](https://github.com/grpc). The error model is designed to be:
|
21
21
|
#
|
@@ -24,7 +24,7 @@ module Google
|
|
24
24
|
#
|
25
25
|
# = Overview
|
26
26
|
#
|
27
|
-
# The
|
27
|
+
# The `Status` message contains three pieces of data: error code, error message,
|
28
28
|
# and error details. The error code should be an enum value of
|
29
29
|
# {Google::Rpc::Code}, but it may accept additional error codes if needed. The
|
30
30
|
# error message should be a developer-facing English message that helps
|
@@ -32,40 +32,40 @@ module Google
|
|
32
32
|
# error message is needed, put the localized message in the error details or
|
33
33
|
# localize it in the client. The optional error details may contain arbitrary
|
34
34
|
# information about the error. There is a predefined set of error detail types
|
35
|
-
# in the package
|
35
|
+
# in the package `google.rpc` that can be used for common error conditions.
|
36
36
|
#
|
37
37
|
# = Language mapping
|
38
38
|
#
|
39
|
-
# The
|
40
|
-
# is not necessarily the actual wire format. When the
|
39
|
+
# The `Status` message is the logical representation of the error model, but it
|
40
|
+
# is not necessarily the actual wire format. When the `Status` message is
|
41
41
|
# exposed in different client libraries and different wire protocols, it can be
|
42
42
|
# mapped differently. For example, it will likely be mapped to some exceptions
|
43
43
|
# in Java, but more likely mapped to some error codes in C.
|
44
44
|
#
|
45
45
|
# = Other uses
|
46
46
|
#
|
47
|
-
# The error model and the
|
47
|
+
# The error model and the `Status` message can be used in a variety of
|
48
48
|
# environments, either with or without APIs, to provide a
|
49
49
|
# consistent developer experience across different environments.
|
50
50
|
#
|
51
51
|
# Example uses of this error model include:
|
52
52
|
#
|
53
53
|
# * Partial errors. If a service needs to return partial errors to the client,
|
54
|
-
# it may embed the
|
54
|
+
# it may embed the `Status` in the normal response to indicate the partial
|
55
55
|
# errors.
|
56
56
|
#
|
57
57
|
# * Workflow errors. A typical workflow has multiple steps. Each step may
|
58
|
-
# have a
|
58
|
+
# have a `Status` message for error reporting.
|
59
59
|
#
|
60
60
|
# * Batch operations. If a client uses batch request and batch response, the
|
61
|
-
#
|
61
|
+
# `Status` message should be used directly inside batch response, one for
|
62
62
|
# each error sub-response.
|
63
63
|
#
|
64
64
|
# * Asynchronous operations. If an API call embeds asynchronous operation
|
65
65
|
# results in its response, the status of those operations should be
|
66
|
-
# represented directly using the
|
66
|
+
# represented directly using the `Status` message.
|
67
67
|
#
|
68
|
-
# * Logging. If some API errors are stored in logs, the message
|
68
|
+
# * Logging. If some API errors are stored in logs, the message `Status` could
|
69
69
|
# be used directly after any stripping needed for security/privacy reasons.
|
70
70
|
# @!attribute [rw] code
|
71
71
|
# @return [Integer]
|
@@ -186,26 +186,26 @@ module Google
|
|
186
186
|
# Service calls
|
187
187
|
|
188
188
|
# Performs asynchronous video annotation. Progress and results can be
|
189
|
-
# retrieved through the
|
190
|
-
#
|
191
|
-
#
|
189
|
+
# retrieved through the `google.longrunning.Operations` interface.
|
190
|
+
# `Operation.metadata` contains `AnnotateVideoProgress` (progress).
|
191
|
+
# `Operation.response` contains `AnnotateVideoResponse` (results).
|
192
192
|
#
|
193
193
|
# @param input_uri [String]
|
194
194
|
# Input video location. Currently, only
|
195
195
|
# [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
|
196
196
|
# supported, which must be specified in the following format:
|
197
|
-
#
|
197
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
198
198
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
199
199
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
200
|
-
# A video URI may include wildcards in
|
200
|
+
# A video URI may include wildcards in `object-id`, and thus identify
|
201
201
|
# multiple videos. Supported wildcards: '*' to match 0 or more characters;
|
202
202
|
# '?' to match 1 character. If unset, the input video should be embedded
|
203
|
-
# in the request as
|
203
|
+
# in the request as `input_content`. If set, `input_content` should be unset.
|
204
204
|
# @param features [Array<Google::Cloud::Videointelligence::V1beta1::Feature>]
|
205
205
|
# Requested video annotation features.
|
206
206
|
# @param input_content [String]
|
207
207
|
# The video data bytes. Encoding: base64. If unset, the input video(s)
|
208
|
-
# should be specified via
|
208
|
+
# should be specified via `input_uri`. If set, `input_uri` should be unset.
|
209
209
|
# @param video_context [Google::Cloud::Videointelligence::V1beta1::VideoContext | Hash]
|
210
210
|
# Additional video context and/or feature-specific parameters.
|
211
211
|
# A hash of the same form as `Google::Cloud::Videointelligence::V1beta1::VideoContext`
|
@@ -214,12 +214,12 @@ module Google
|
|
214
214
|
# Optional location where the output (in JSON format) should be stored.
|
215
215
|
# Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
|
216
216
|
# URIs are supported, which must be specified in the following format:
|
217
|
-
#
|
217
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
218
218
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
219
219
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
220
220
|
# @param location_id [String]
|
221
221
|
# Optional cloud region where annotation should take place. Supported cloud
|
222
|
-
# regions:
|
222
|
+
# regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
|
223
223
|
# is specified, a region will be determined based on video file location.
|
224
224
|
# @param options [Google::Gax::CallOptions]
|
225
225
|
# Overrides the default settings for this call, e.g, timeout,
|
@@ -23,7 +23,7 @@ module Google
|
|
23
23
|
# rubocop:disable LineLength
|
24
24
|
|
25
25
|
##
|
26
|
-
# # Ruby Client for Google Cloud Video Intelligence API ([GA](https://github.com/
|
26
|
+
# # Ruby Client for Google Cloud Video Intelligence API ([GA](https://github.com/googleapis/google-cloud-ruby#versioning))
|
27
27
|
#
|
28
28
|
# [Google Cloud Video Intelligence API][Product Documentation]:
|
29
29
|
# Google Cloud Video Intelligence API.
|
@@ -36,7 +36,7 @@ module Google
|
|
36
36
|
# 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
|
37
37
|
# 2. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
|
38
38
|
# 3. [Enable the Google Cloud Video Intelligence API.](https://console.cloud.google.com/apis/library/videointelligence.googleapis.com)
|
39
|
-
# 4. [Setup Authentication.](https://
|
39
|
+
# 4. [Setup Authentication.](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud/master/guides/authentication)
|
40
40
|
#
|
41
41
|
# ### Installation
|
42
42
|
# ```
|
@@ -46,7 +46,7 @@ module Google
|
|
46
46
|
# ### Next Steps
|
47
47
|
# - Read the [Google Cloud Video Intelligence API Product documentation][Product Documentation]
|
48
48
|
# to learn more about the product and see How-to Guides.
|
49
|
-
# - View this [repository's main README](https://github.com/
|
49
|
+
# - View this [repository's main README](https://github.com/googleapis/google-cloud-ruby/blob/master/README.md)
|
50
50
|
# to see the full list of Cloud APIs that we cover.
|
51
51
|
#
|
52
52
|
# [Product Documentation]: https://cloud.google.com/video-intelligence
|
@@ -55,7 +55,7 @@ module Google
|
|
55
55
|
#
|
56
56
|
# To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
57
57
|
# The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib-2.5.0/libdoc/logger/rdoc/Logger.html) as shown below,
|
58
|
-
# or a [`Google::Cloud::Logging::Logger`](https://
|
58
|
+
# or a [`Google::Cloud::Logging::Logger`](https://googleapis.github.io/google-cloud-ruby/#/docs/google-cloud-logging/latest/google/cloud/logging/logger)
|
59
59
|
# that will write logs to [Stackdriver Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
60
60
|
# and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
61
61
|
#
|
@@ -23,18 +23,18 @@ module Google
|
|
23
23
|
# Input video location. Currently, only
|
24
24
|
# [Google Cloud Storage](https://cloud.google.com/storage/) URIs are
|
25
25
|
# supported, which must be specified in the following format:
|
26
|
-
#
|
26
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
27
27
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
28
28
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
29
|
-
# A video URI may include wildcards in
|
29
|
+
# A video URI may include wildcards in `object-id`, and thus identify
|
30
30
|
# multiple videos. Supported wildcards: '*' to match 0 or more characters;
|
31
31
|
# '?' to match 1 character. If unset, the input video should be embedded
|
32
|
-
# in the request as
|
32
|
+
# in the request as `input_content`. If set, `input_content` should be unset.
|
33
33
|
# @!attribute [rw] input_content
|
34
34
|
# @return [String]
|
35
35
|
# The video data bytes.
|
36
|
-
# If unset, the input video(s) should be specified via
|
37
|
-
# If set,
|
36
|
+
# If unset, the input video(s) should be specified via `input_uri`.
|
37
|
+
# If set, `input_uri` should be unset.
|
38
38
|
# @!attribute [rw] features
|
39
39
|
# @return [Array<Google::Cloud::Videointelligence::V1beta2::Feature>]
|
40
40
|
# Requested video annotation features.
|
@@ -46,13 +46,13 @@ module Google
|
|
46
46
|
# Optional location where the output (in JSON format) should be stored.
|
47
47
|
# Currently, only [Google Cloud Storage](https://cloud.google.com/storage/)
|
48
48
|
# URIs are supported, which must be specified in the following format:
|
49
|
-
#
|
49
|
+
# `gs://bucket-id/object-id` (other URI formats return
|
50
50
|
# {Google::Rpc::Code::INVALID_ARGUMENT}). For more information, see
|
51
51
|
# [Request URIs](https://cloud.google.com/storage/docs/reference-uris).
|
52
52
|
# @!attribute [rw] location_id
|
53
53
|
# @return [String]
|
54
54
|
# Optional cloud region where annotation should take place. Supported cloud
|
55
|
-
# regions:
|
55
|
+
# regions: `us-east1`, `us-west1`, `europe-west1`, `asia-east1`. If no region
|
56
56
|
# is specified, a region will be determined based on video file location.
|
57
57
|
class AnnotateVideoRequest; end
|
58
58
|
|
@@ -81,12 +81,12 @@ module Google
|
|
81
81
|
# @return [Google::Cloud::Videointelligence::V1beta2::LabelDetectionMode]
|
82
82
|
# What labels should be detected with LABEL_DETECTION, in addition to
|
83
83
|
# video-level labels or segment-level labels.
|
84
|
-
# If unspecified, defaults to
|
84
|
+
# If unspecified, defaults to `SHOT_MODE`.
|
85
85
|
# @!attribute [rw] stationary_camera
|
86
86
|
# @return [true, false]
|
87
87
|
# Whether the video has been shot from a stationary (i.e. non-moving) camera.
|
88
88
|
# When set to true, might improve detection accuracy for moving objects.
|
89
|
-
# Should be used with
|
89
|
+
# Should be used with `SHOT_AND_FRAME_MODE` enabled.
|
90
90
|
# @!attribute [rw] model
|
91
91
|
# @return [String]
|
92
92
|
# Model to use for label detection.
|
@@ -159,10 +159,10 @@ module Google
|
|
159
159
|
# API](https://developers.google.com/knowledge-graph/).
|
160
160
|
# @!attribute [rw] description
|
161
161
|
# @return [String]
|
162
|
-
# Textual description, e.g.
|
162
|
+
# Textual description, e.g. `Fixed-gear bicycle`.
|
163
163
|
# @!attribute [rw] language_code
|
164
164
|
# @return [String]
|
165
|
-
# Language code for
|
165
|
+
# Language code for `description` in BCP-47 format.
|
166
166
|
class Entity; end
|
167
167
|
|
168
168
|
# Label annotation.
|
@@ -172,9 +172,9 @@ module Google
|
|
172
172
|
# @!attribute [rw] category_entities
|
173
173
|
# @return [Array<Google::Cloud::Videointelligence::V1beta2::Entity>]
|
174
174
|
# Common categories for the detected entity.
|
175
|
-
# E.g. when the label is
|
176
|
-
# cases there might be more than one categories e.g.
|
177
|
-
# a
|
175
|
+
# E.g. when the label is `Terrier` the category is likely `dog`. And in some
|
176
|
+
# cases there might be more than one categories e.g. `Terrier` could also be
|
177
|
+
# a `pet`.
|
178
178
|
# @!attribute [rw] segments
|
179
179
|
# @return [Array<Google::Cloud::Videointelligence::V1beta2::LabelSegment>]
|
180
180
|
# All video segments where a label was detected.
|
@@ -276,16 +276,16 @@ module Google
|
|
276
276
|
# Explicit content annotation.
|
277
277
|
# @!attribute [rw] error
|
278
278
|
# @return [Google::Rpc::Status]
|
279
|
-
# If set, indicates an error. Note that for a single
|
279
|
+
# If set, indicates an error. Note that for a single `AnnotateVideoRequest`
|
280
280
|
# some videos may succeed and some may fail.
|
281
281
|
class VideoAnnotationResults; end
|
282
282
|
|
283
|
-
# Video annotation response. Included in the
|
284
|
-
# field of the
|
285
|
-
# call of the
|
283
|
+
# Video annotation response. Included in the `response`
|
284
|
+
# field of the `Operation` returned by the `GetOperation`
|
285
|
+
# call of the `google::longrunning::Operations` service.
|
286
286
|
# @!attribute [rw] annotation_results
|
287
287
|
# @return [Array<Google::Cloud::Videointelligence::V1beta2::VideoAnnotationResults>]
|
288
|
-
# Annotation results for all videos specified in
|
288
|
+
# Annotation results for all videos specified in `AnnotateVideoRequest`.
|
289
289
|
class AnnotateVideoResponse; end
|
290
290
|
|
291
291
|
# Annotation progress for a single video.
|
@@ -305,12 +305,12 @@ module Google
|
|
305
305
|
# Time of the most recent update.
|
306
306
|
class VideoAnnotationProgress; end
|
307
307
|
|
308
|
-
# Video annotation progress. Included in the
|
309
|
-
# field of the
|
310
|
-
# call of the
|
308
|
+
# Video annotation progress. Included in the `metadata`
|
309
|
+
# field of the `Operation` returned by the `GetOperation`
|
310
|
+
# call of the `google::longrunning::Operations` service.
|
311
311
|
# @!attribute [rw] annotation_progress
|
312
312
|
# @return [Array<Google::Cloud::Videointelligence::V1beta2::VideoAnnotationProgress>]
|
313
|
-
# Progress metadata for all videos specified in
|
313
|
+
# Progress metadata for all videos specified in `AnnotateVideoRequest`.
|
314
314
|
class AnnotateVideoProgress; end
|
315
315
|
|
316
316
|
# Video annotation feature.
|