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

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