google-cloud-video-transcoder-v1beta1 0.2.0 → 0.3.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (11) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +8 -8
  3. data/README.md +1 -1
  4. data/lib/google/cloud/video/transcoder/v1beta1/resources_pb.rb +20 -2
  5. data/lib/google/cloud/video/transcoder/v1beta1/services_pb.rb +2 -2
  6. data/lib/google/cloud/video/transcoder/v1beta1/services_services_pb.rb +1 -1
  7. data/lib/google/cloud/video/transcoder/v1beta1/transcoder_service/client.rb +228 -72
  8. data/lib/google/cloud/video/transcoder/v1beta1/version.rb +1 -1
  9. data/proto_docs/google/api/field_behavior.rb +7 -1
  10. data/proto_docs/google/cloud/video/transcoder/v1beta1/resources.rb +132 -58
  11. metadata +13 -7
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 118d137f259fd029a7a5bd2b9b5f121de585b0c283ffc079dfe2155907055c4c
4
- data.tar.gz: 6d2a17cfce402b7c6a1570eeb465f60591fbf6c961059a7bc9b027c33e2079c2
3
+ metadata.gz: 423afeb773766f4924a02069f9b931e54baead63aef042f27807e7435aa38585
4
+ data.tar.gz: 45974d2f84a469e3db0d64c988dc686cd66a764a880a4eba1f6a087b02c7ffd4
5
5
  SHA512:
6
- metadata.gz: 28506e7d166e0b7cf2d6813ec07669fdda77cde4f159e7bf8e7acce270f6388351bdf9dd33e4c5318cccb28b3f2de6b350409e6bb734957f6846032103fe8541
7
- data.tar.gz: ed23952bb02e21d6d546c7f1f97e7464843789a93bcd33de89c1236cdc3422075b7183a89364ae7297a205b0cf7349231a12798a25fdc401aaa23a026ecd63bc
6
+ metadata.gz: 3d35a2789f1467224f3dc4e8ceb0e7dc7b171d3255f6c5f1568679f67291a4b43c3f0a2fa86ea482a01cc13cbef9e12a65d6c2d0a2b555525c617486c69c13ca
7
+ data.tar.gz: e5a3b0478984151128a39a9aa3a4f5ebf06921d886e029a115e08491a7474a0c3f367081079ad83fa45fadaec3a2abdaa1350f1b984eea21ca2a8666cacbd629
data/AUTHENTICATION.md CHANGED
@@ -66,11 +66,11 @@ The environment variables that google-cloud-video-transcoder-v1beta1
66
66
  checks for credentials are configured on the service Credentials class (such as
67
67
  {::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Credentials}):
68
68
 
69
- 1. `TRANSCODER_CREDENTIALS` - Path to JSON file, or JSON contents
70
- 2. `TRANSCODER_KEYFILE` - Path to JSON file, or JSON contents
71
- 3. `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
- 4. `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
- 5. `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
69
+ * `TRANSCODER_CREDENTIALS` - Path to JSON file, or JSON contents
70
+ * `TRANSCODER_KEYFILE` - Path to JSON file, or JSON contents
71
+ * `GOOGLE_CLOUD_CREDENTIALS` - Path to JSON file, or JSON contents
72
+ * `GOOGLE_CLOUD_KEYFILE` - Path to JSON file, or JSON contents
73
+ * `GOOGLE_APPLICATION_CREDENTIALS` - Path to JSON file
74
74
 
75
75
  ```ruby
76
76
  require "google/cloud/video/transcoder/v1beta1"
@@ -82,8 +82,8 @@ client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.
82
82
 
83
83
  ### Configuration
84
84
 
85
- The **Credentials JSON** can be configured instead of placing them in
86
- environment variables. Either on an individual client initialization:
85
+ The path to the **Credentials JSON** file can be configured instead of storing
86
+ it in an environment variable. Either on an individual client initialization:
87
87
 
88
88
  ```ruby
89
89
  require "google/cloud/video/transcoder/v1beta1"
@@ -93,7 +93,7 @@ client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.
93
93
  end
94
94
  ```
95
95
 
96
- Or configured globally for all clients:
96
+ Or globally for all clients:
97
97
 
98
98
  ```ruby
99
99
  require "google/cloud/video/transcoder/v1beta1"
data/README.md CHANGED
@@ -33,7 +33,7 @@ In order to use this library, you first need to go through the following steps:
33
33
  require "google/cloud/video/transcoder/v1beta1"
34
34
 
35
35
  client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
36
- request = my_create_request
36
+ request = ::Google::Cloud::Video::Transcoder::V1beta1::CreateJobRequest.new # (request fields as keyword arguments...)
37
37
  response = client.create_job request
38
38
  ```
39
39
 
data/lib/google/cloud/video/transcoder/v1beta1/resources_pb.rb CHANGED
@@ -1,12 +1,12 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/video/transcoder/v1beta1/resources.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/field_behavior_pb'
7
5
  require 'google/api/resource_pb'
8
6
  require 'google/protobuf/duration_pb'
9
7
  require 'google/protobuf/timestamp_pb'
8
+ require 'google/protobuf'
9
+
10
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
11
11
  add_file("google/cloud/video/transcoder/v1beta1/resources.proto", :syntax => :proto3) do
12
12
  add_message "google.cloud.video.transcoder.v1beta1.Job" do
@@ -22,6 +22,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
22
22
  optional :create_time, :message, 12, "google.protobuf.Timestamp"
23
23
  optional :start_time, :message, 13, "google.protobuf.Timestamp"
24
24
  optional :end_time, :message, 14, "google.protobuf.Timestamp"
25
+ optional :ttl_after_completion_days, :int32, 15
25
26
  oneof :job_config do
26
27
  optional :template_id, :string, 4
27
28
  optional :config, :message, 5, "google.cloud.video.transcoder.v1beta1.JobConfig"
@@ -109,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
109
110
  optional :row_count, :int32, 6
110
111
  optional :start_time_offset, :message, 7, "google.protobuf.Duration"
111
112
  optional :end_time_offset, :message, 8, "google.protobuf.Duration"
113
+ optional :quality, :int32, 11
112
114
  oneof :extraction_strategy do
113
115
  optional :total_count, :int32, 9
114
116
  optional :interval, :message, 10, "google.protobuf.Duration"
@@ -157,6 +159,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
157
159
  optional :denoise, :message, 2, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Denoise"
158
160
  optional :deblock, :message, 3, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Deblock"
159
161
  optional :audio, :message, 4, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Audio"
162
+ optional :crop, :message, 5, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop"
163
+ optional :pad, :message, 6, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad"
160
164
  end
161
165
  add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Color" do
162
166
  optional :saturation, :double, 1
@@ -176,6 +180,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
176
180
  optional :high_boost, :bool, 2
177
181
  optional :low_boost, :bool, 3
178
182
  end
183
+ add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop" do
184
+ optional :top_pixels, :int32, 1
185
+ optional :bottom_pixels, :int32, 2
186
+ optional :left_pixels, :int32, 3
187
+ optional :right_pixels, :int32, 4
188
+ end
189
+ add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad" do
190
+ optional :top_pixels, :int32, 1
191
+ optional :bottom_pixels, :int32, 2
192
+ optional :left_pixels, :int32, 3
193
+ optional :right_pixels, :int32, 4
194
+ end
179
195
  add_message "google.cloud.video.transcoder.v1beta1.VideoStream" do
180
196
  optional :codec, :string, 1
181
197
  optional :profile, :string, 2
@@ -303,6 +319,8 @@ module Google
303
319
  PreprocessingConfig::Denoise = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Denoise").msgclass
304
320
  PreprocessingConfig::Deblock = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Deblock").msgclass
305
321
  PreprocessingConfig::Audio = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Audio").msgclass
322
+ PreprocessingConfig::Crop = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop").msgclass
323
+ PreprocessingConfig::Pad = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad").msgclass
306
324
  VideoStream = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.VideoStream").msgclass
307
325
  AudioStream = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.AudioStream").msgclass
308
326
  AudioStream::AudioAtom = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.AudioStream.AudioAtom").msgclass
data/lib/google/cloud/video/transcoder/v1beta1/services_pb.rb CHANGED
@@ -1,14 +1,14 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/video/transcoder/v1beta1/services.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
9
7
  require 'google/api/resource_pb'
10
8
  require 'google/cloud/video/transcoder/v1beta1/resources_pb'
11
9
  require 'google/protobuf/empty_pb'
10
+ require 'google/protobuf'
11
+
12
12
  Google::Protobuf::DescriptorPool.generated_pool.build do
13
13
  add_file("google/cloud/video/transcoder/v1beta1/services.proto", :syntax => :proto3) do
14
14
  add_message "google.cloud.video.transcoder.v1beta1.CreateJobRequest" do
data/lib/google/cloud/video/transcoder/v1beta1/services_services_pb.rb CHANGED
@@ -33,7 +33,7 @@ module Google
33
33
  # concatenation, and digital ad-stitch ready content generation.
34
34
  class Service
35
35
 
36
- include GRPC::GenericService
36
+ include ::GRPC::GenericService
37
37
 
38
38
  self.marshal_class_method = :encode
39
39
  self.unmarshal_class_method = :decode
data/lib/google/cloud/video/transcoder/v1beta1/transcoder_service/client.rb CHANGED
@@ -47,13 +47,14 @@ module Google
47
47
  # See {::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client::Configuration}
48
48
  # for a description of the configuration fields.
49
49
  #
50
- # ## Example
50
+ # @deprecated This service is deprecated and may be removed in the next major version update.
51
51
  #
52
- # To modify the configuration for all TranscoderService clients:
52
+ # @example
53
53
  #
54
- # ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
55
- # config.timeout = 10.0
56
- # end
54
+ # # Modify the configuration for all TranscoderService clients
55
+ # ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
56
+ # config.timeout = 10.0
57
+ # end
57
58
  #
58
59
  # @yield [config] Configure the Client client.
59
60
  # @yieldparam config [Client::Configuration]
@@ -73,10 +74,7 @@ module Google
73
74
 
74
75
  default_config.timeout = 60.0
75
76
  default_config.retry_policy = {
76
- initial_delay: 1.0,
77
- max_delay: 10.0,
78
- multiplier: 1.3,
79
- retry_codes: [14]
77
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
80
78
  }
81
79
 
82
80
  default_config.rpcs.create_job.timeout = 60.0
@@ -124,19 +122,15 @@ module Google
124
122
  ##
125
123
  # Create a new TranscoderService client object.
126
124
  #
127
- # ## Examples
125
+ # @example
128
126
  #
129
- # To create a new TranscoderService client with the default
130
- # configuration:
127
+ # # Create a client using the default configuration
128
+ # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
131
129
  #
132
- # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
133
- #
134
- # To create a new TranscoderService client with a custom
135
- # configuration:
136
- #
137
- # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
138
- # config.timeout = 10.0
139
- # end
130
+ # # Create a client using a custom configuration
131
+ # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
132
+ # config.timeout = 10.0
133
+ # end
140
134
  #
141
135
  # @yield [config] Configure the TranscoderService client.
142
136
  # @yieldparam config [Client::Configuration]
@@ -156,14 +150,13 @@ module Google
156
150
 
157
151
  # Create credentials
158
152
  credentials = @config.credentials
159
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
153
+ # Use self-signed JWT if the endpoint is unchanged from default,
160
154
  # but only if the default endpoint does not have a region prefix.
161
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
162
- @config.endpoint == Client.configure.endpoint &&
155
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
163
156
  !@config.endpoint.split(".").first.include?("-")
164
157
  credentials ||= Credentials.default scope: @config.scope,
165
158
  enable_self_signed_jwt: enable_self_signed_jwt
166
- if credentials.is_a?(String) || credentials.is_a?(Hash)
159
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
167
160
  credentials = Credentials.new credentials, scope: @config.scope
168
161
  end
169
162
  @quota_project_id = @config.quota_project
@@ -212,6 +205,21 @@ module Google
212
205
  #
213
206
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
214
207
  #
208
+ # @example Basic example
209
+ # require "google/cloud/video/transcoder/v1beta1"
210
+ #
211
+ # # Create a client object. The client can be reused for multiple calls.
212
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
213
+ #
214
+ # # Create a request. To set request fields, pass in keyword arguments.
215
+ # request = Google::Cloud::Video::Transcoder::V1beta1::CreateJobRequest.new
216
+ #
217
+ # # Call the create_job method.
218
+ # result = client.create_job request
219
+ #
220
+ # # The returned object is of type Google::Cloud::Video::Transcoder::V1beta1::Job.
221
+ # p result
222
+ #
215
223
  def create_job request, options = nil
216
224
  raise ::ArgumentError, "request must be provided" if request.nil?
217
225
 
@@ -229,16 +237,20 @@ module Google
229
237
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
230
238
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
231
239
 
232
- header_params = {
233
- "parent" => request.parent
234
- }
240
+ header_params = {}
241
+ if request.parent
242
+ header_params["parent"] = request.parent
243
+ end
244
+
235
245
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
236
246
  metadata[:"x-goog-request-params"] ||= request_params_header
237
247
 
238
248
  options.apply_defaults timeout: @config.rpcs.create_job.timeout,
239
249
  metadata: metadata,
240
250
  retry_policy: @config.rpcs.create_job.retry_policy
241
- options.apply_defaults metadata: @config.metadata,
251
+
252
+ options.apply_defaults timeout: @config.timeout,
253
+ metadata: @config.metadata,
242
254
  retry_policy: @config.retry_policy
243
255
 
244
256
  @transcoder_service_stub.call_rpc :create_job, request, options: options do |response, operation|
@@ -283,6 +295,27 @@ module Google
283
295
  #
284
296
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
285
297
  #
298
+ # @example Basic example
299
+ # require "google/cloud/video/transcoder/v1beta1"
300
+ #
301
+ # # Create a client object. The client can be reused for multiple calls.
302
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
303
+ #
304
+ # # Create a request. To set request fields, pass in keyword arguments.
305
+ # request = Google::Cloud::Video::Transcoder::V1beta1::ListJobsRequest.new
306
+ #
307
+ # # Call the list_jobs method.
308
+ # result = client.list_jobs request
309
+ #
310
+ # # The returned object is of type Gapic::PagedEnumerable. You can
311
+ # # iterate over all elements by calling #each, and the enumerable
312
+ # # will lazily make API calls to fetch subsequent pages. Other
313
+ # # methods are also available for managing paging directly.
314
+ # result.each do |response|
315
+ # # Each element is of type ::Google::Cloud::Video::Transcoder::V1beta1::Job.
316
+ # p response
317
+ # end
318
+ #
286
319
  def list_jobs request, options = nil
287
320
  raise ::ArgumentError, "request must be provided" if request.nil?
288
321
 
@@ -300,16 +333,20 @@ module Google
300
333
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
301
334
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
302
335
 
303
- header_params = {
304
- "parent" => request.parent
305
- }
336
+ header_params = {}
337
+ if request.parent
338
+ header_params["parent"] = request.parent
339
+ end
340
+
306
341
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
307
342
  metadata[:"x-goog-request-params"] ||= request_params_header
308
343
 
309
344
  options.apply_defaults timeout: @config.rpcs.list_jobs.timeout,
310
345
  metadata: metadata,
311
346
  retry_policy: @config.rpcs.list_jobs.retry_policy
312
- options.apply_defaults metadata: @config.metadata,
347
+
348
+ options.apply_defaults timeout: @config.timeout,
349
+ metadata: @config.metadata,
313
350
  retry_policy: @config.retry_policy
314
351
 
315
352
  @transcoder_service_stub.call_rpc :list_jobs, request, options: options do |response, operation|
@@ -351,6 +388,21 @@ module Google
351
388
  #
352
389
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
353
390
  #
391
+ # @example Basic example
392
+ # require "google/cloud/video/transcoder/v1beta1"
393
+ #
394
+ # # Create a client object. The client can be reused for multiple calls.
395
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
396
+ #
397
+ # # Create a request. To set request fields, pass in keyword arguments.
398
+ # request = Google::Cloud::Video::Transcoder::V1beta1::GetJobRequest.new
399
+ #
400
+ # # Call the get_job method.
401
+ # result = client.get_job request
402
+ #
403
+ # # The returned object is of type Google::Cloud::Video::Transcoder::V1beta1::Job.
404
+ # p result
405
+ #
354
406
  def get_job request, options = nil
355
407
  raise ::ArgumentError, "request must be provided" if request.nil?
356
408
 
@@ -368,16 +420,20 @@ module Google
368
420
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
369
421
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
370
422
 
371
- header_params = {
372
- "name" => request.name
373
- }
423
+ header_params = {}
424
+ if request.name
425
+ header_params["name"] = request.name
426
+ end
427
+
374
428
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
375
429
  metadata[:"x-goog-request-params"] ||= request_params_header
376
430
 
377
431
  options.apply_defaults timeout: @config.rpcs.get_job.timeout,
378
432
  metadata: metadata,
379
433
  retry_policy: @config.rpcs.get_job.retry_policy
380
- options.apply_defaults metadata: @config.metadata,
434
+
435
+ options.apply_defaults timeout: @config.timeout,
436
+ metadata: @config.metadata,
381
437
  retry_policy: @config.retry_policy
382
438
 
383
439
  @transcoder_service_stub.call_rpc :get_job, request, options: options do |response, operation|
@@ -418,6 +474,21 @@ module Google
418
474
  #
419
475
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
420
476
  #
477
+ # @example Basic example
478
+ # require "google/cloud/video/transcoder/v1beta1"
479
+ #
480
+ # # Create a client object. The client can be reused for multiple calls.
481
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
482
+ #
483
+ # # Create a request. To set request fields, pass in keyword arguments.
484
+ # request = Google::Cloud::Video::Transcoder::V1beta1::DeleteJobRequest.new
485
+ #
486
+ # # Call the delete_job method.
487
+ # result = client.delete_job request
488
+ #
489
+ # # The returned object is of type Google::Protobuf::Empty.
490
+ # p result
491
+ #
421
492
  def delete_job request, options = nil
422
493
  raise ::ArgumentError, "request must be provided" if request.nil?
423
494
 
@@ -435,16 +506,20 @@ module Google
435
506
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
436
507
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
437
508
 
438
- header_params = {
439
- "name" => request.name
440
- }
509
+ header_params = {}
510
+ if request.name
511
+ header_params["name"] = request.name
512
+ end
513
+
441
514
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
442
515
  metadata[:"x-goog-request-params"] ||= request_params_header
443
516
 
444
517
  options.apply_defaults timeout: @config.rpcs.delete_job.timeout,
445
518
  metadata: metadata,
446
519
  retry_policy: @config.rpcs.delete_job.retry_policy
447
- options.apply_defaults metadata: @config.metadata,
520
+
521
+ options.apply_defaults timeout: @config.timeout,
522
+ metadata: @config.metadata,
448
523
  retry_policy: @config.retry_policy
449
524
 
450
525
  @transcoder_service_stub.call_rpc :delete_job, request, options: options do |response, operation|
@@ -493,6 +568,21 @@ module Google
493
568
  #
494
569
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
495
570
  #
571
+ # @example Basic example
572
+ # require "google/cloud/video/transcoder/v1beta1"
573
+ #
574
+ # # Create a client object. The client can be reused for multiple calls.
575
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
576
+ #
577
+ # # Create a request. To set request fields, pass in keyword arguments.
578
+ # request = Google::Cloud::Video::Transcoder::V1beta1::CreateJobTemplateRequest.new
579
+ #
580
+ # # Call the create_job_template method.
581
+ # result = client.create_job_template request
582
+ #
583
+ # # The returned object is of type Google::Cloud::Video::Transcoder::V1beta1::JobTemplate.
584
+ # p result
585
+ #
496
586
  def create_job_template request, options = nil
497
587
  raise ::ArgumentError, "request must be provided" if request.nil?
498
588
 
@@ -510,16 +600,20 @@ module Google
510
600
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
511
601
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
512
602
 
513
- header_params = {
514
- "parent" => request.parent
515
- }
603
+ header_params = {}
604
+ if request.parent
605
+ header_params["parent"] = request.parent
606
+ end
607
+
516
608
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
517
609
  metadata[:"x-goog-request-params"] ||= request_params_header
518
610
 
519
611
  options.apply_defaults timeout: @config.rpcs.create_job_template.timeout,
520
612
  metadata: metadata,
521
613
  retry_policy: @config.rpcs.create_job_template.retry_policy
522
- options.apply_defaults metadata: @config.metadata,
614
+
615
+ options.apply_defaults timeout: @config.timeout,
616
+ metadata: @config.metadata,
523
617
  retry_policy: @config.retry_policy
524
618
 
525
619
  @transcoder_service_stub.call_rpc :create_job_template, request, options: options do |response, operation|
@@ -565,6 +659,27 @@ module Google
565
659
  #
566
660
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
567
661
  #
662
+ # @example Basic example
663
+ # require "google/cloud/video/transcoder/v1beta1"
664
+ #
665
+ # # Create a client object. The client can be reused for multiple calls.
666
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
667
+ #
668
+ # # Create a request. To set request fields, pass in keyword arguments.
669
+ # request = Google::Cloud::Video::Transcoder::V1beta1::ListJobTemplatesRequest.new
670
+ #
671
+ # # Call the list_job_templates method.
672
+ # result = client.list_job_templates request
673
+ #
674
+ # # The returned object is of type Gapic::PagedEnumerable. You can
675
+ # # iterate over all elements by calling #each, and the enumerable
676
+ # # will lazily make API calls to fetch subsequent pages. Other
677
+ # # methods are also available for managing paging directly.
678
+ # result.each do |response|
679
+ # # Each element is of type ::Google::Cloud::Video::Transcoder::V1beta1::JobTemplate.
680
+ # p response
681
+ # end
682
+ #
568
683
  def list_job_templates request, options = nil
569
684
  raise ::ArgumentError, "request must be provided" if request.nil?
570
685
 
@@ -582,16 +697,20 @@ module Google
582
697
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
583
698
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
584
699
 
585
- header_params = {
586
- "parent" => request.parent
587
- }
700
+ header_params = {}
701
+ if request.parent
702
+ header_params["parent"] = request.parent
703
+ end
704
+
588
705
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
589
706
  metadata[:"x-goog-request-params"] ||= request_params_header
590
707
 
591
708
  options.apply_defaults timeout: @config.rpcs.list_job_templates.timeout,
592
709
  metadata: metadata,
593
710
  retry_policy: @config.rpcs.list_job_templates.retry_policy
594
- options.apply_defaults metadata: @config.metadata,
711
+
712
+ options.apply_defaults timeout: @config.timeout,
713
+ metadata: @config.metadata,
595
714
  retry_policy: @config.retry_policy
596
715
 
597
716
  @transcoder_service_stub.call_rpc :list_job_templates, request, options: options do |response, operation|
@@ -634,6 +753,21 @@ module Google
634
753
  #
635
754
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
636
755
  #
756
+ # @example Basic example
757
+ # require "google/cloud/video/transcoder/v1beta1"
758
+ #
759
+ # # Create a client object. The client can be reused for multiple calls.
760
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
761
+ #
762
+ # # Create a request. To set request fields, pass in keyword arguments.
763
+ # request = Google::Cloud::Video::Transcoder::V1beta1::GetJobTemplateRequest.new
764
+ #
765
+ # # Call the get_job_template method.
766
+ # result = client.get_job_template request
767
+ #
768
+ # # The returned object is of type Google::Cloud::Video::Transcoder::V1beta1::JobTemplate.
769
+ # p result
770
+ #
637
771
  def get_job_template request, options = nil
638
772
  raise ::ArgumentError, "request must be provided" if request.nil?
639
773
 
@@ -651,16 +785,20 @@ module Google
651
785
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
652
786
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
653
787
 
654
- header_params = {
655
- "name" => request.name
656
- }
788
+ header_params = {}
789
+ if request.name
790
+ header_params["name"] = request.name
791
+ end
792
+
657
793
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
658
794
  metadata[:"x-goog-request-params"] ||= request_params_header
659
795
 
660
796
  options.apply_defaults timeout: @config.rpcs.get_job_template.timeout,
661
797
  metadata: metadata,
662
798
  retry_policy: @config.rpcs.get_job_template.retry_policy
663
- options.apply_defaults metadata: @config.metadata,
799
+
800
+ options.apply_defaults timeout: @config.timeout,
801
+ metadata: @config.metadata,
664
802
  retry_policy: @config.retry_policy
665
803
 
666
804
  @transcoder_service_stub.call_rpc :get_job_template, request, options: options do |response, operation|
@@ -701,6 +839,21 @@ module Google
701
839
  #
702
840
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
703
841
  #
842
+ # @example Basic example
843
+ # require "google/cloud/video/transcoder/v1beta1"
844
+ #
845
+ # # Create a client object. The client can be reused for multiple calls.
846
+ # client = Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
847
+ #
848
+ # # Create a request. To set request fields, pass in keyword arguments.
849
+ # request = Google::Cloud::Video::Transcoder::V1beta1::DeleteJobTemplateRequest.new
850
+ #
851
+ # # Call the delete_job_template method.
852
+ # result = client.delete_job_template request
853
+ #
854
+ # # The returned object is of type Google::Protobuf::Empty.
855
+ # p result
856
+ #
704
857
  def delete_job_template request, options = nil
705
858
  raise ::ArgumentError, "request must be provided" if request.nil?
706
859
 
@@ -718,16 +871,20 @@ module Google
718
871
  gapic_version: ::Google::Cloud::Video::Transcoder::V1beta1::VERSION
719
872
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
720
873
 
721
- header_params = {
722
- "name" => request.name
723
- }
874
+ header_params = {}
875
+ if request.name
876
+ header_params["name"] = request.name
877
+ end
878
+
724
879
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
725
880
  metadata[:"x-goog-request-params"] ||= request_params_header
726
881
 
727
882
  options.apply_defaults timeout: @config.rpcs.delete_job_template.timeout,
728
883
  metadata: metadata,
729
884
  retry_policy: @config.rpcs.delete_job_template.retry_policy
730
- options.apply_defaults metadata: @config.metadata,
885
+
886
+ options.apply_defaults timeout: @config.timeout,
887
+ metadata: @config.metadata,
731
888
  retry_policy: @config.retry_policy
732
889
 
733
890
  @transcoder_service_stub.call_rpc :delete_job_template, request, options: options do |response, operation|
@@ -751,22 +908,21 @@ module Google
751
908
  # Configuration can be applied globally to all clients, or to a single client
752
909
  # on construction.
753
910
  #
754
- # # Examples
755
- #
756
- # To modify the global config, setting the timeout for create_job
757
- # to 20 seconds, and all remaining timeouts to 10 seconds:
758
- #
759
- # ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
760
- # config.timeout = 10.0
761
- # config.rpcs.create_job.timeout = 20.0
762
- # end
763
- #
764
- # To apply the above configuration only to a new client:
765
- #
766
- # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
767
- # config.timeout = 10.0
768
- # config.rpcs.create_job.timeout = 20.0
769
- # end
911
+ # @example
912
+ #
913
+ # # Modify the global config, setting the timeout for
914
+ # # create_job to 20 seconds,
915
+ # # and all remaining timeouts to 10 seconds.
916
+ # ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
917
+ # config.timeout = 10.0
918
+ # config.rpcs.create_job.timeout = 20.0
919
+ # end
920
+ #
921
+ # # Apply the above configuration only to a new client.
922
+ # client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
923
+ # config.timeout = 10.0
924
+ # config.rpcs.create_job.timeout = 20.0
925
+ # end
770
926
  #
771
927
  # @!attribute [rw] endpoint
772
928
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/video/transcoder/v1beta1/version.rb CHANGED
@@ -22,7 +22,7 @@ module Google
22
22
  module Video
23
23
  module Transcoder
24
24
  module V1beta1
25
- VERSION = "0.2.0"
25
+ VERSION = "0.3.1"
26
26
  end
27
27
  end
28
28
  end
data/proto_docs/google/api/field_behavior.rb CHANGED
@@ -57,9 +57,15 @@ module Google
57
57
 
58
58
  # Denotes that a (repeated) field is an unordered list.
59
59
  # This indicates that the service may provide the elements of the list
60
- # in any arbitrary order, rather than the order the user originally
60
+ # in any arbitrary order, rather than the order the user originally
61
61
  # provided. Additionally, the list's order may or may not be stable.
62
62
  UNORDERED_LIST = 6
63
+
64
+ # Denotes that this field returns a non-empty default value if not set.
65
+ # This indicates that if the user provides the empty value in a request,
66
+ # a non-empty value will be returned. The user will not be aware of what
67
+ # non-empty value to expect.
68
+ NON_EMPTY_DEFAULT = 7
63
69
  end
64
70
  end
65
71
  end
data/proto_docs/google/cloud/video/transcoder/v1beta1/resources.rb CHANGED
@@ -31,8 +31,8 @@ module Google
31
31
  # @return [::String]
32
32
  # Input only. Specify the `input_uri` to populate empty `uri` fields in each element of
33
33
  # `Job.config.inputs` or `JobTemplate.config.inputs` when using template.
34
- # URI of the media. It must be stored in Cloud Storage. For example,
35
- # `gs://bucket/inputs/file.mp4`.
34
+ # URI of the media. Input files must be at least 5 seconds in duration and
35
+ # stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`).
36
36
  # @!attribute [rw] output_uri
37
37
  # @return [::String]
38
38
  # Input only. Specify the `output_uri` to populate an empty `Job.config.output.uri` or
@@ -58,6 +58,7 @@ module Google
58
58
  # @!attribute [r] origin_uri
59
59
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Job::OriginUri]
60
60
  # Output only. The origin URI.
61
+ # <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
61
62
  # @!attribute [r] state
62
63
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Job::ProcessingState]
63
64
  # Output only. The current state of the job.
@@ -65,6 +66,7 @@ module Google
65
66
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Progress]
66
67
  # Output only. Estimated fractional progress, from `0` to `1` for each
67
68
  # step.
69
+ # <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
68
70
  # @!attribute [r] failure_reason
69
71
  # @return [::String]
70
72
  # Output only. A description of the reason for the failure. This property is
@@ -73,6 +75,7 @@ module Google
73
75
  # @return [::Array<::Google::Cloud::Video::Transcoder::V1beta1::FailureDetail>]
74
76
  # Output only. List of failure details. This property may contain additional
75
77
  # information about the failure when `failure_reason` is present.
78
+ # <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
76
79
  # @!attribute [r] create_time
77
80
  # @return [::Google::Protobuf::Timestamp]
78
81
  # Output only. The time the job was created.
@@ -82,6 +85,11 @@ module Google
82
85
  # @!attribute [r] end_time
83
86
  # @return [::Google::Protobuf::Timestamp]
84
87
  # Output only. The time the transcoding finished.
88
+ # @!attribute [rw] ttl_after_completion_days
89
+ # @return [::Integer]
90
+ # Job time to live value in days, which will be effective after job
91
+ # completion. Job should be deleted automatically after the given TTL. Enter
92
+ # a value between 1 and 90. The default is 30.
85
93
  class Job
86
94
  include ::Google::Protobuf::MessageExts
87
95
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,8 +97,8 @@ module Google
89
97
  # The origin URI.
90
98
  # @!attribute [rw] hls
91
99
  # @return [::String]
92
- # HLS master manifest URI. If multiple HLS master manifests are created
93
- # only first one is listed.
100
+ # HLS manifest URI per https://tools.ietf.org/html/rfc8216#section-4.3.4.
101
+ # If multiple HLS manifests are created, only the first one is listed.
94
102
  # @!attribute [rw] dash
95
103
  # @return [::String]
96
104
  # Dash manifest URI. If multiple Dash manifests are created, only the first
@@ -179,9 +187,9 @@ module Google
179
187
  # mapping and edit lists.
180
188
  # @!attribute [rw] uri
181
189
  # @return [::String]
182
- # URI of the media. It must be stored in Cloud Storage. Example
183
- # `gs://bucket/inputs/file.mp4`.
184
- # If empty the value will be populated from `Job.input_uri`.
190
+ # URI of the media. Input files must be at least 5 seconds in duration and
191
+ # stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`).
192
+ # If empty, the value will be populated from `Job.input_uri`.
185
193
  # @!attribute [rw] preprocessing_config
186
194
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig]
187
195
  # Preprocessing configurations.
@@ -345,10 +353,16 @@ module Google
345
353
  # from 0 before the extension, such as `"sprite_sheet0000000123.jpeg"`.
346
354
  # @!attribute [rw] sprite_width_pixels
347
355
  # @return [::Integer]
348
- # Required. The width of sprite in pixels. Must be an even integer.
356
+ # Required. The width of sprite in pixels. Must be an even integer. To preserve the
357
+ # source aspect ratio, set the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_width_pixels SpriteSheet.sprite_width_pixels} field or
358
+ # the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_height_pixels SpriteSheet.sprite_height_pixels} field, but not both (the API will
359
+ # automatically calculate the missing field).
349
360
  # @!attribute [rw] sprite_height_pixels
350
361
  # @return [::Integer]
351
- # Required. The height of sprite in pixels. Must be an even integer.
362
+ # Required. The height of sprite in pixels. Must be an even integer. To preserve the
363
+ # source aspect ratio, set the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_height_pixels SpriteSheet.sprite_height_pixels} field or
364
+ # the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_width_pixels SpriteSheet.sprite_width_pixels} field, but not both (the API will
365
+ # automatically calculate the missing field).
352
366
  # @!attribute [rw] column_count
353
367
  # @return [::Integer]
354
368
  # The maximum number of sprites per row in a sprite sheet. The default is 0,
@@ -376,6 +390,12 @@ module Google
376
390
  # @return [::Google::Protobuf::Duration]
377
391
  # Starting from `0s`, create sprites at regular intervals. Specify the
378
392
  # interval value in seconds.
393
+ # @!attribute [rw] quality
394
+ # @return [::Integer]
395
+ # The quality of the generated sprite sheet. Enter a value between 1
396
+ # and 100, where 1 is the lowest quality and 100 is the highest quality.
397
+ # The default is 100. A high quality value corresponds to a low image data
398
+ # compression ratio.
379
399
  class SpriteSheet
380
400
  include ::Google::Protobuf::MessageExts
381
401
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -408,8 +428,8 @@ module Google
408
428
  # Overlaid jpeg image.
409
429
  # @!attribute [rw] uri
410
430
  # @return [::String]
411
- # Required. URI of the image in Cloud Storage. For example,
412
- # `gs://bucket/inputs/image.jpeg`.
431
+ # Required. URI of the JPEG image in Cloud Storage. For example,
432
+ # `gs://bucket/inputs/image.jpeg`. JPEG is the only supported image type.
413
433
  # @!attribute [rw] resolution
414
434
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
415
435
  # Normalized image resolution, based on output video resolution. Valid
@@ -418,8 +438,8 @@ module Google
418
438
  # both `x` and `y` to `0.0`.
419
439
  # @!attribute [rw] alpha
420
440
  # @return [::Float]
421
- # Target image opacity. Valid values: `1` (solid, default),
422
- # `0` (transparent).
441
+ # Target image opacity. Valid values are from `1.0` (solid, default) to
442
+ # `0.0` (transparent), exclusive. Set this to a value greater than `0.0`.
423
443
  class Image
424
444
  include ::Google::Protobuf::MessageExts
425
445
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -430,7 +450,9 @@ module Google
430
450
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
431
451
  # Normalized coordinates based on output video resolution. Valid
432
452
  # values: `0.0`–`1.0`. `xy` is the upper-left coordinate of the overlay
433
- # object.
453
+ # object. For example, use the x and y coordinates \\{0,0} to position the
454
+ # top-left corner of the overlay animation in the top-left corner of the
455
+ # output video.
434
456
  # @!attribute [rw] start_time_offset
435
457
  # @return [::Google::Protobuf::Duration]
436
458
  # The time to start displaying the overlay object, in seconds. Default: 0
@@ -447,7 +469,9 @@ module Google
447
469
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
448
470
  # Normalized coordinates based on output video resolution. Valid
449
471
  # values: `0.0`–`1.0`. `xy` is the upper-left coordinate of the overlay
450
- # object.
472
+ # object. For example, use the x and y coordinates \\{0,0} to position the
473
+ # top-left corner of the overlay animation in the top-left corner of the
474
+ # output video.
451
475
  # @!attribute [rw] start_time_offset
452
476
  # @return [::Google::Protobuf::Duration]
453
477
  # The time to start the fade animation, in seconds. Default: 0
@@ -512,6 +536,12 @@ module Google
512
536
  # @!attribute [rw] audio
513
537
  # @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Audio]
514
538
  # Audio preprocessing configuration.
539
+ # @!attribute [rw] crop
540
+ # @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Crop]
541
+ # Specify the video cropping configuration.
542
+ # @!attribute [rw] pad
543
+ # @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Pad]
544
+ # Specify the video pad filter configuration.
515
545
  class PreprocessingConfig
516
546
  include ::Google::Protobuf::MessageExts
517
547
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -572,12 +602,16 @@ module Google
572
602
  # @!attribute [rw] lufs
573
603
  # @return [::Float]
574
604
  # Specify audio loudness normalization in loudness units relative to full
575
- # scale (LUFS). Enter a value between -24 and 0, where -24 is the Advanced
576
- # Television Systems Committee (ATSC A/85), -23 is the EU R128 broadcast
577
- # standard, -19 is the prior standard for online mono audio, -18 is the
578
- # ReplayGain standard, -16 is the prior standard for stereo audio, -14 is
579
- # the new online audio standard recommended by Spotify, as well as Amazon
580
- # Echo, and 0 disables normalization. The default is 0.
605
+ # scale (LUFS). Enter a value between -24 and 0 (the default), where:
606
+ #
607
+ # * -24 is the Advanced Television Systems Committee (ATSC A/85) standard
608
+ # * -23 is the EU R128 broadcast standard
609
+ # * -19 is the prior standard for online mono audio
610
+ # * -18 is the ReplayGain standard
611
+ # * -16 is the prior standard for stereo audio
612
+ # * -14 is the new online audio standard recommended by Spotify, as well
613
+ # as Amazon Echo
614
+ # * 0 disables normalization
581
615
  # @!attribute [rw] high_boost
582
616
  # @return [::Boolean]
583
617
  # Enable boosting high frequency components. The default is `false`.
@@ -588,31 +622,82 @@ module Google
588
622
  include ::Google::Protobuf::MessageExts
589
623
  extend ::Google::Protobuf::MessageExts::ClassMethods
590
624
  end
625
+
626
+ # Video cropping configuration for the input video. The cropped input video
627
+ # is scaled to match the output resolution.
628
+ # @!attribute [rw] top_pixels
629
+ # @return [::Integer]
630
+ # The number of pixels to crop from the top. The default is 0.
631
+ # @!attribute [rw] bottom_pixels
632
+ # @return [::Integer]
633
+ # The number of pixels to crop from the bottom. The default is 0.
634
+ # @!attribute [rw] left_pixels
635
+ # @return [::Integer]
636
+ # The number of pixels to crop from the left. The default is 0.
637
+ # @!attribute [rw] right_pixels
638
+ # @return [::Integer]
639
+ # The number of pixels to crop from the right. The default is 0.
640
+ class Crop
641
+ include ::Google::Protobuf::MessageExts
642
+ extend ::Google::Protobuf::MessageExts::ClassMethods
643
+ end
644
+
645
+ # Pad filter configuration for the input video. The padded input video
646
+ # is scaled after padding with black to match the output resolution.
647
+ # @!attribute [rw] top_pixels
648
+ # @return [::Integer]
649
+ # The number of pixels to add to the top. The default is 0.
650
+ # @!attribute [rw] bottom_pixels
651
+ # @return [::Integer]
652
+ # The number of pixels to add to the bottom. The default is 0.
653
+ # @!attribute [rw] left_pixels
654
+ # @return [::Integer]
655
+ # The number of pixels to add to the left. The default is 0.
656
+ # @!attribute [rw] right_pixels
657
+ # @return [::Integer]
658
+ # The number of pixels to add to the right. The default is 0.
659
+ class Pad
660
+ include ::Google::Protobuf::MessageExts
661
+ extend ::Google::Protobuf::MessageExts::ClassMethods
662
+ end
591
663
  end
592
664
 
593
665
  # Video stream resource.
594
666
  # @!attribute [rw] codec
595
667
  # @return [::String]
596
- # Codec type. The default is `"h264"`.
668
+ # Codec type. The following codecs are supported:
597
669
  #
598
- # Supported codecs:
599
- # - 'h264'
600
- # - 'h265'
601
- # - 'vp9'
670
+ # * `h264` (default)
671
+ # * `h265`
672
+ # * `vp9`
602
673
  # @!attribute [rw] profile
603
674
  # @return [::String]
604
- # Enforce specified codec profile. The default is `"high"`.
675
+ # Enforces the specified codec profile. The following profiles are supported:
676
+ #
677
+ # * `baseline`
678
+ # * `main`
679
+ # * `high` (default)
605
680
  #
606
- # Supported codec profiles:
607
- # - 'baseline'
608
- # - 'main'
609
- # - 'high'
681
+ # The available options are
682
+ # <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Profile"
683
+ # class="external">FFmpeg-compatible</a>. Note that certain values for this
684
+ # field may cause the transcoder to override other fields you set in the
685
+ # `VideoStream` message.
610
686
  # @!attribute [rw] tune
611
687
  # @return [::String]
612
- # Enforce specified codec tune.
688
+ # Enforces the specified codec tune. The available options are
689
+ # <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Tune"
690
+ # class="external">FFmpeg-compatible</a>. Note that certain values for this
691
+ # field may cause the transcoder to override other fields you set in the
692
+ # `VideoStream` message.
613
693
  # @!attribute [rw] preset
614
694
  # @return [::String]
615
- # Enforce specified codec preset. The default is `"veryfast"`.
695
+ # Enforces the specified codec preset. The default is `veryfast`. The
696
+ # available options are
697
+ # <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Preset"
698
+ # class="external">FFmpeg-compatible</a>. Note that certain values for this
699
+ # field may cause the transcoder to override other fields you set in the
700
+ # `VideoStream` message.
616
701
  # @!attribute [rw] height_pixels
617
702
  # @return [::Integer]
618
703
  # The height of the video in pixels. Must be an even integer.
@@ -639,7 +724,9 @@ module Google
639
724
  # - 'yuv444p12' 12-bit HDR pixel format.
640
725
  # @!attribute [rw] bitrate_bps
641
726
  # @return [::Integer]
642
- # Required. The video bitrate in bits per second. Must be between 1 and 1,000,000,000.
727
+ # Required. The video bitrate in bits per second. The minimum value is 1,000.
728
+ # The maximum value for H264/H265 is 800,000,000. The maximum value for VP9
729
+ # is 480,000,000.
643
730
  # @!attribute [rw] rate_control_mode
644
731
  # @return [::String]
645
732
  # Specify the `rate_control_mode`. The default is `"vbr"`.
@@ -675,7 +762,9 @@ module Google
675
762
  # @!attribute [rw] gop_duration
676
763
  # @return [::Google::Protobuf::Duration]
677
764
  # Select the GOP size based on the specified duration. The default is
678
- # `"3s"`.
765
+ # `"3s"`. Note that `gopDuration` must be less than or equal to
766
+ # [`segmentDuration`](#SegmentSettings), and
767
+ # [`segmentDuration`](#SegmentSettings) must be divisible by `gopDuration`.
679
768
  # @!attribute [rw] entropy_coder
680
769
  # @return [::String]
681
770
  # The entropy coder to use. The default is `"cabac"`.
@@ -696,28 +785,10 @@ module Google
696
785
  # Required. The target video frame rate in frames per second (FPS). Must be less than
697
786
  # or equal to 120. Will default to the input frame rate if larger than the
698
787
  # input frame rate. The API will generate an output FPS that is divisible by
699
- # the input FPS, and smaller or equal to the target FPS.
700
- #
701
- # The following table shows the computed video FPS given the target FPS (in
702
- # parenthesis) and input FPS (in the first column):
703
- # ```
704
- # | | (30) | (60) | (25) | (50) |
705
- # |--------|--------|--------|------|------|
706
- # | 240 | Fail | Fail | Fail | Fail |
707
- # | 120 | 30 | 60 | 20 | 30 |
708
- # | 100 | 25 | 50 | 20 | 30 |
709
- # | 50 | 25 | 50 | 20 | 30 |
710
- # | 60 | 30 | 60 | 20 | 30 |
711
- # | 59.94 | 29.97 | 59.94 | 20 | 30 |
712
- # | 48 | 24 | 48 | 20 | 30 |
713
- # | 30 | 30 | 30 | 20 | 30 |
714
- # | 25 | 25 | 25 | 20 | 30 |
715
- # | 24 | 24 | 24 | 20 | 30 |
716
- # | 23.976 | 23.976 | 23.976 | 20 | 30 |
717
- # | 15 | 15 | 15 | 20 | 30 |
718
- # | 12 | 12 | 12 | 20 | 30 |
719
- # | 10 | 10 | 10 | 20 | 30 |
720
- # ```
788
+ # the input FPS, and smaller or equal to the target FPS. See
789
+ # [Calculate frame
790
+ # rate](https://cloud.google.com/transcoder/docs/concepts/frame-rate) for
791
+ # more information.
721
792
  # @!attribute [rw] aq_strength
722
793
  # @return [::Float]
723
794
  # Specify the intensity of the adaptive quantizer (AQ). Must be between 0 and
@@ -865,7 +936,10 @@ module Google
865
936
  # Segment settings for `"ts"`, `"fmp4"` and `"vtt"`.
866
937
  # @!attribute [rw] segment_duration
867
938
  # @return [::Google::Protobuf::Duration]
868
- # Duration of the segments in seconds. The default is `"6.0s"`.
939
+ # Duration of the segments in seconds. The default is `"6.0s"`. Note that
940
+ # `segmentDuration` must be greater than or equal to
941
+ # [`gopDuration`](#videostream), and `segmentDuration` must be divisible by
942
+ # [`gopDuration`](#videostream).
869
943
  # @!attribute [rw] individual_segments
870
944
  # @return [::Boolean]
871
945
  # Required. Create an individual segment file. The default is `false`.
metadata CHANGED
@@ -1,29 +1,35 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-video-transcoder-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.0
4
+ version: 0.3.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-03-09 00:00:00.000000000 Z
11
+ date: 2021-11-08 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
15
15
  requirement: !ruby/object:Gem::Requirement
16
16
  requirements:
17
- - - "~>"
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0.7'
20
+ - - "<"
18
21
  - !ruby/object:Gem::Version
19
- version: '0.3'
22
+ version: 2.a
20
23
  type: :runtime
21
24
  prerelease: false
22
25
  version_requirements: !ruby/object:Gem::Requirement
23
26
  requirements:
24
- - - "~>"
27
+ - - ">="
28
+ - !ruby/object:Gem::Version
29
+ version: '0.7'
30
+ - - "<"
25
31
  - !ruby/object:Gem::Version
26
- version: '0.3'
32
+ version: 2.a
27
33
  - !ruby/object:Gem::Dependency
28
34
  name: google-cloud-errors
29
35
  requirement: !ruby/object:Gem::Requirement
@@ -201,7 +207,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
201
207
  - !ruby/object:Gem::Version
202
208
  version: '0'
203
209
  requirements: []
204
- rubygems_version: 3.2.13
210
+ rubygems_version: 3.2.17
205
211
  signing_key:
206
212
  specification_version: 4
207
213
  summary: API Client library for the Transcoder V1beta1 API