google-cloud-video-transcoder-v1beta1 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23e43f8f9ce9a7461ba2b0ef462efaf083538f46234cf4e2b6dab297f4b8493b
-  data.tar.gz: 2d9977e2b8f18149845643def2ed2a421907456e89c763358f182e6e4a18bcd2
+  metadata.gz: 82afcbdeaf7f25ad39e1370f03322f72246732d129e6d7d6674c8fee50defda9
+  data.tar.gz: b9072943d875039b18e537a38454b5dbc916c2f22e7f15853299a0f3411eae19
 SHA512:
-  metadata.gz: f7807f27ac2d52105228cd4e2ebf7a98bad7a2352a82d2ba617abd817f5b1164023f8a496e4c57b43175e9bbea79768063a98fb1565b3c8d1be6454253e13fe9
-  data.tar.gz: '069b5958ecec36aaaecbd149e7a6dcb23e88228da44af31a08501a5f6a0a82f0cb789036c7a4448bf0f0e80e8243ed91541f1b3ad93147a2946bb2cd8f0430c4'
+  metadata.gz: f3991656081acf897761d399fff9b0fc0b2512b5b02df1e695855582e813ccc55ffaf7eef166baa56c4ea84b0f8299c6504ee9849d457a31d24136d0b4daf524
+  data.tar.gz: 161b95adcaffd349f83bc74986e002e233cae1c786ab118187356e08b75ccb91dc26f76dd0f6a48b1cf9e69a10ae981019b66fedfc05b83adb7ba17d1cb42926

data/lib/google/cloud/video/transcoder/v1beta1/resources_pb.rb

@@ -22,6 +22,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :create_time, :message, 12, "google.protobuf.Timestamp"
       optional :start_time, :message, 13, "google.protobuf.Timestamp"
       optional :end_time, :message, 14, "google.protobuf.Timestamp"
+      optional :ttl_after_completion_days, :int32, 15
       oneof :job_config do
         optional :template_id, :string, 4
         optional :config, :message, 5, "google.cloud.video.transcoder.v1beta1.JobConfig"
@@ -109,6 +110,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :row_count, :int32, 6
       optional :start_time_offset, :message, 7, "google.protobuf.Duration"
       optional :end_time_offset, :message, 8, "google.protobuf.Duration"
+      optional :quality, :int32, 11
       oneof :extraction_strategy do
         optional :total_count, :int32, 9
         optional :interval, :message, 10, "google.protobuf.Duration"
@@ -157,6 +159,8 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :denoise, :message, 2, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Denoise"
       optional :deblock, :message, 3, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Deblock"
       optional :audio, :message, 4, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Audio"
+      optional :crop, :message, 5, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop"
+      optional :pad, :message, 6, "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad"
     end
     add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Color" do
       optional :saturation, :double, 1
@@ -176,6 +180,18 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :high_boost, :bool, 2
       optional :low_boost, :bool, 3
     end
+    add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop" do
+      optional :top_pixels, :int32, 1
+      optional :bottom_pixels, :int32, 2
+      optional :left_pixels, :int32, 3
+      optional :right_pixels, :int32, 4
+    end
+    add_message "google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad" do
+      optional :top_pixels, :int32, 1
+      optional :bottom_pixels, :int32, 2
+      optional :left_pixels, :int32, 3
+      optional :right_pixels, :int32, 4
+    end
     add_message "google.cloud.video.transcoder.v1beta1.VideoStream" do
       optional :codec, :string, 1
       optional :profile, :string, 2
@@ -303,6 +319,8 @@ module Google
           PreprocessingConfig::Denoise = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Denoise").msgclass
           PreprocessingConfig::Deblock = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Deblock").msgclass
           PreprocessingConfig::Audio = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Audio").msgclass
+          PreprocessingConfig::Crop = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Crop").msgclass
+          PreprocessingConfig::Pad = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.PreprocessingConfig.Pad").msgclass
           VideoStream = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.VideoStream").msgclass
           AudioStream = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.AudioStream").msgclass
           AudioStream::AudioAtom = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.video.transcoder.v1beta1.AudioStream.AudioAtom").msgclass

data/lib/google/cloud/video/transcoder/v1beta1/transcoder_service/client.rb

@@ -47,13 +47,14 @@ module Google
               # See {::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client::Configuration}
               # for a description of the configuration fields.
               #
-              # ## Example
+              # @deprecated This service is deprecated and may be removed in the next major version update.
               #
-              # To modify the configuration for all TranscoderService clients:
+              # @example
               #
-              #     ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Modify the configuration for all TranscoderService clients
+              #   ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the Client client.
               # @yieldparam config [Client::Configuration]
@@ -121,19 +122,15 @@ module Google
               ##
               # Create a new TranscoderService client object.
               #
-              # ## Examples
+              # @example
               #
-              # To create a new TranscoderService client with the default
-              # configuration:
+              #   # Create a client using the default configuration
+              #   client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
               #
-              #     client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new
-              #
-              # To create a new TranscoderService client with a custom
-              # configuration:
-              #
-              #     client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
-              #       config.timeout = 10.0
-              #     end
+              #   # Create a client using a custom configuration
+              #   client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
+              #     config.timeout = 10.0
+              #   end
               #
               # @yield [config] Configure the TranscoderService client.
               # @yieldparam config [Client::Configuration]
@@ -153,10 +150,9 @@ module Google
 
                 # Create credentials
                 credentials = @config.credentials
-                # Use self-signed JWT if the scope and endpoint are unchanged from default,
+                # Use self-signed JWT if the endpoint is unchanged from default,
                 # but only if the default endpoint does not have a region prefix.
-                enable_self_signed_jwt = @config.scope == Client.configure.scope &&
-                                         @config.endpoint == Client.configure.endpoint &&
+                enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                                          !@config.endpoint.split(".").first.include?("-")
                 credentials ||= Credentials.default scope: @config.scope,
                                                     enable_self_signed_jwt: enable_self_signed_jwt
@@ -235,7 +231,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.create_job.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_job.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :create_job, request, options: options do |response, operation|
@@ -306,7 +304,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.list_jobs.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_jobs.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :list_jobs, request, options: options do |response, operation|
@@ -374,7 +374,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.get_job.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_job.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :get_job, request, options: options do |response, operation|
@@ -441,7 +443,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.delete_job.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_job.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :delete_job, request, options: options do |response, operation|
@@ -516,7 +520,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.create_job_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.create_job_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :create_job_template, request, options: options do |response, operation|
@@ -588,7 +594,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.list_job_templates.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.list_job_templates.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :list_job_templates, request, options: options do |response, operation|
@@ -657,7 +665,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.get_job_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.get_job_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :get_job_template, request, options: options do |response, operation|
@@ -724,7 +734,9 @@ module Google
                 options.apply_defaults timeout:      @config.rpcs.delete_job_template.timeout,
                                        metadata:     metadata,
                                        retry_policy: @config.rpcs.delete_job_template.retry_policy
-                options.apply_defaults metadata:     @config.metadata,
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
                                        retry_policy: @config.retry_policy
 
                 @transcoder_service_stub.call_rpc :delete_job_template, request, options: options do |response, operation|
@@ -748,22 +760,21 @@ module Google
               # Configuration can be applied globally to all clients, or to a single client
               # on construction.
               #
-              # # Examples
-              #
-              # To modify the global config, setting the timeout for create_job
-              # to 20 seconds, and all remaining timeouts to 10 seconds:
-              #
-              #     ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_job.timeout = 20.0
-              #     end
-              #
-              # To apply the above configuration only to a new client:
-              #
-              #     client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
-              #       config.timeout = 10.0
-              #       config.rpcs.create_job.timeout = 20.0
-              #     end
+              # @example
+              #
+              #   # Modify the global config, setting the timeout for
+              #   # create_job to 20 seconds,
+              #   # and all remaining timeouts to 10 seconds.
+              #   ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.configure do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_job.timeout = 20.0
+              #   end
+              #
+              #   # Apply the above configuration only to a new client.
+              #   client = ::Google::Cloud::Video::Transcoder::V1beta1::TranscoderService::Client.new do |config|
+              #     config.timeout = 10.0
+              #     config.rpcs.create_job.timeout = 20.0
+              #   end
               #
               # @!attribute [rw] endpoint
               #   The hostname or hostname:port of the service endpoint.

data/lib/google/cloud/video/transcoder/v1beta1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Video
       module Transcoder
         module V1beta1
-          VERSION = "0.2.2"
+          VERSION = "0.3.0"
         end
       end
     end

data/proto_docs/google/cloud/video/transcoder/v1beta1/resources.rb

@@ -31,8 +31,8 @@ module Google
           #   @return [::String]
           #     Input only. Specify the `input_uri` to populate empty `uri` fields in each element of
           #     `Job.config.inputs` or `JobTemplate.config.inputs` when using template.
-          #     URI of the media. It must be stored in Cloud Storage. For example,
-          #     `gs://bucket/inputs/file.mp4`.
+          #     URI of the media. Input files must be at least 5 seconds in duration and
+          #     stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`).
           # @!attribute [rw] output_uri
           #   @return [::String]
           #     Input only. Specify the `output_uri` to populate an empty `Job.config.output.uri` or
@@ -58,6 +58,7 @@ module Google
           # @!attribute [r] origin_uri
           #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Job::OriginUri]
           #     Output only. The origin URI.
+          #     <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
           # @!attribute [r] state
           #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Job::ProcessingState]
           #     Output only. The current state of the job.
@@ -65,6 +66,7 @@ module Google
           #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Progress]
           #     Output only. Estimated fractional progress, from `0` to `1` for each
           #     step.
+          #     <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
           # @!attribute [r] failure_reason
           #   @return [::String]
           #     Output only. A description of the reason for the failure. This property is
@@ -73,6 +75,7 @@ module Google
           #   @return [::Array<::Google::Cloud::Video::Transcoder::V1beta1::FailureDetail>]
           #     Output only. List of failure details. This property may contain additional
           #     information about the failure when `failure_reason` is present.
+          #     <aside class="note"><b>Note</b>: This feature is not yet available.</aside>
           # @!attribute [r] create_time
           #   @return [::Google::Protobuf::Timestamp]
           #     Output only. The time the job was created.
@@ -82,6 +85,11 @@ module Google
           # @!attribute [r] end_time
           #   @return [::Google::Protobuf::Timestamp]
           #     Output only. The time the transcoding finished.
+          # @!attribute [rw] ttl_after_completion_days
+          #   @return [::Integer]
+          #     Job time to live value in days, which will be effective after job
+          #     completion. Job should be deleted automatically after the given TTL. Enter
+          #     a value between 1 and 90. The default is 30.
           class Job
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,8 +97,8 @@ module Google
             # The origin URI.
             # @!attribute [rw] hls
             #   @return [::String]
-            #     HLS master manifest URI. If multiple HLS master manifests are created
-            #     only first one is listed.
+            #     HLS manifest URI per https://tools.ietf.org/html/rfc8216#section-4.3.4.
+            #     If multiple HLS manifests are created, only the first one is listed.
             # @!attribute [rw] dash
             #   @return [::String]
             #     Dash manifest URI. If multiple Dash manifests are created, only the first
@@ -179,9 +187,9 @@ module Google
           #     mapping and edit lists.
           # @!attribute [rw] uri
           #   @return [::String]
-          #     URI of the media. It must be stored in Cloud Storage. Example
-          #     `gs://bucket/inputs/file.mp4`.
-          #     If empty the value will be populated from `Job.input_uri`.
+          #     URI of the media. Input files must be at least 5 seconds in duration and
+          #     stored in Cloud Storage (for example, `gs://bucket/inputs/file.mp4`).
+          #     If empty, the value will be populated from `Job.input_uri`.
           # @!attribute [rw] preprocessing_config
           #   @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig]
           #     Preprocessing configurations.
@@ -345,10 +353,16 @@ module Google
           #     from 0 before the extension, such as `"sprite_sheet0000000123.jpeg"`.
           # @!attribute [rw] sprite_width_pixels
           #   @return [::Integer]
-          #     Required. The width of sprite in pixels. Must be an even integer.
+          #     Required. The width of sprite in pixels. Must be an even integer. To preserve the
+          #     source aspect ratio, set the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_width_pixels SpriteSheet.sprite_width_pixels} field or
+          #     the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_height_pixels SpriteSheet.sprite_height_pixels} field, but not both (the API will
+          #     automatically calculate the missing field).
           # @!attribute [rw] sprite_height_pixels
           #   @return [::Integer]
-          #     Required. The height of sprite in pixels. Must be an even integer.
+          #     Required. The height of sprite in pixels. Must be an even integer. To preserve the
+          #     source aspect ratio, set the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_height_pixels SpriteSheet.sprite_height_pixels} field or
+          #     the {::Google::Cloud::Video::Transcoder::V1beta1::SpriteSheet#sprite_width_pixels SpriteSheet.sprite_width_pixels} field, but not both (the API will
+          #     automatically calculate the missing field).
           # @!attribute [rw] column_count
           #   @return [::Integer]
           #     The maximum number of sprites per row in a sprite sheet. The default is 0,
@@ -376,6 +390,12 @@ module Google
           #   @return [::Google::Protobuf::Duration]
           #     Starting from `0s`, create sprites at regular intervals. Specify the
           #     interval value in seconds.
+          # @!attribute [rw] quality
+          #   @return [::Integer]
+          #     The quality of the generated sprite sheet. Enter a value between 1
+          #     and 100, where 1 is the lowest quality and 100 is the highest quality.
+          #     The default is 100. A high quality value corresponds to a low image data
+          #     compression ratio.
           class SpriteSheet
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -408,8 +428,8 @@ module Google
             # Overlaid jpeg image.
             # @!attribute [rw] uri
             #   @return [::String]
-            #     Required. URI of the image in Cloud Storage. For example,
-            #     `gs://bucket/inputs/image.jpeg`.
+            #     Required. URI of the JPEG image in Cloud Storage. For example,
+            #     `gs://bucket/inputs/image.jpeg`. JPEG is the only supported image type.
             # @!attribute [rw] resolution
             #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
             #     Normalized image resolution, based on output video resolution. Valid
@@ -418,8 +438,8 @@ module Google
             #     both `x` and `y` to `0.0`.
             # @!attribute [rw] alpha
             #   @return [::Float]
-            #     Target image opacity. Valid values: `1` (solid, default),
-            #     `0` (transparent).
+            #     Target image opacity. Valid values are from  `1.0` (solid, default) to
+            #     `0.0` (transparent), exclusive. Set this to a value greater than `0.0`.
             class Image
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -430,7 +450,9 @@ module Google
             #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
             #     Normalized coordinates based on output video resolution. Valid
             #     values: `0.0`–`1.0`. `xy` is the upper-left coordinate of the overlay
-            #     object.
+            #     object. For example, use the x and y coordinates \\{0,0} to position the
+            #     top-left corner of the overlay animation in the top-left corner of the
+            #     output video.
             # @!attribute [rw] start_time_offset
             #   @return [::Google::Protobuf::Duration]
             #     The time to start displaying the overlay object, in seconds. Default: 0
@@ -447,7 +469,9 @@ module Google
             #   @return [::Google::Cloud::Video::Transcoder::V1beta1::Overlay::NormalizedCoordinate]
             #     Normalized coordinates based on output video resolution. Valid
             #     values: `0.0`–`1.0`. `xy` is the upper-left coordinate of the overlay
-            #     object.
+            #     object. For example, use the x and y coordinates \\{0,0} to position the
+            #     top-left corner of the overlay animation in the top-left corner of the
+            #     output video.
             # @!attribute [rw] start_time_offset
             #   @return [::Google::Protobuf::Duration]
             #     The time to start the fade animation, in seconds. Default: 0
@@ -512,6 +536,12 @@ module Google
           # @!attribute [rw] audio
           #   @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Audio]
           #     Audio preprocessing configuration.
+          # @!attribute [rw] crop
+          #   @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Crop]
+          #     Specify the video cropping configuration.
+          # @!attribute [rw] pad
+          #   @return [::Google::Cloud::Video::Transcoder::V1beta1::PreprocessingConfig::Pad]
+          #     Specify the video pad filter configuration.
           class PreprocessingConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -572,12 +602,16 @@ module Google
             # @!attribute [rw] lufs
             #   @return [::Float]
             #     Specify audio loudness normalization in loudness units relative to full
-            #     scale (LUFS). Enter a value between -24 and 0, where -24 is the Advanced
-            #     Television Systems Committee (ATSC A/85), -23 is the EU R128 broadcast
-            #     standard, -19 is the prior standard for online mono audio, -18 is the
-            #     ReplayGain standard, -16 is the prior standard for stereo audio, -14 is
-            #     the new online audio standard recommended by Spotify, as well as Amazon
-            #     Echo, and 0 disables normalization. The default is 0.
+            #     scale (LUFS). Enter a value between -24 and 0 (the default), where:
+            #
+            #     *   -24 is the Advanced Television Systems Committee (ATSC A/85) standard
+            #     *   -23 is the EU R128 broadcast standard
+            #     *   -19 is the prior standard for online mono audio
+            #     *   -18 is the ReplayGain standard
+            #     *   -16 is the prior standard for stereo audio
+            #     *   -14 is the new online audio standard recommended by Spotify, as well
+            #         as Amazon Echo
+            #     *   0 disables normalization
             # @!attribute [rw] high_boost
             #   @return [::Boolean]
             #     Enable boosting high frequency components. The default is `false`.
@@ -588,31 +622,82 @@ module Google
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Video cropping configuration for the input video. The cropped input video
+            # is scaled to match the output resolution.
+            # @!attribute [rw] top_pixels
+            #   @return [::Integer]
+            #     The number of pixels to crop from the top. The default is 0.
+            # @!attribute [rw] bottom_pixels
+            #   @return [::Integer]
+            #     The number of pixels to crop from the bottom. The default is 0.
+            # @!attribute [rw] left_pixels
+            #   @return [::Integer]
+            #     The number of pixels to crop from the left. The default is 0.
+            # @!attribute [rw] right_pixels
+            #   @return [::Integer]
+            #     The number of pixels to crop from the right. The default is 0.
+            class Crop
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Pad filter configuration for the input video. The padded input video
+            # is scaled after padding with black to match the output resolution.
+            # @!attribute [rw] top_pixels
+            #   @return [::Integer]
+            #     The number of pixels to add to the top. The default is 0.
+            # @!attribute [rw] bottom_pixels
+            #   @return [::Integer]
+            #     The number of pixels to add to the bottom. The default is 0.
+            # @!attribute [rw] left_pixels
+            #   @return [::Integer]
+            #     The number of pixels to add to the left. The default is 0.
+            # @!attribute [rw] right_pixels
+            #   @return [::Integer]
+            #     The number of pixels to add to the right. The default is 0.
+            class Pad
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # Video stream resource.
           # @!attribute [rw] codec
           #   @return [::String]
-          #     Codec type. The default is `"h264"`.
+          #     Codec type. The following codecs are supported:
           #
-          #     Supported codecs:
-          #     - 'h264'
-          #     - 'h265'
-          #     - 'vp9'
+          #     *   `h264` (default)
+          #     *   `h265`
+          #     *   `vp9`
           # @!attribute [rw] profile
           #   @return [::String]
-          #     Enforce specified codec profile. The default is `"high"`.
+          #     Enforces the specified codec profile. The following profiles are supported:
+          #
+          #     *   `baseline`
+          #     *   `main`
+          #     *   `high` (default)
           #
-          #     Supported codec profiles:
-          #     - 'baseline'
-          #     - 'main'
-          #     - 'high'
+          #     The available options are
+          #     <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Profile"
+          #     class="external">FFmpeg-compatible</a>. Note that certain values for this
+          #     field may cause the transcoder to override other fields you set in the
+          #     `VideoStream` message.
           # @!attribute [rw] tune
           #   @return [::String]
-          #     Enforce specified codec tune.
+          #     Enforces the specified codec tune. The available options are
+          #     <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Tune"
+          #     class="external">FFmpeg-compatible</a>. Note that certain values for this
+          #     field may cause the transcoder to override other fields you set in the
+          #     `VideoStream` message.
           # @!attribute [rw] preset
           #   @return [::String]
-          #     Enforce specified codec preset. The default is `"veryfast"`.
+          #     Enforces the specified codec preset. The default is `veryfast`. The
+          #     available options are
+          #     <a href="https://trac.ffmpeg.org/wiki/Encode/H.264#Preset"
+          #     class="external">FFmpeg-compatible</a>. Note that certain values for this
+          #     field may cause the transcoder to override other fields you set in the
+          #     `VideoStream` message.
           # @!attribute [rw] height_pixels
           #   @return [::Integer]
           #     The height of the video in pixels. Must be an even integer.
@@ -639,7 +724,9 @@ module Google
           #     - 'yuv444p12' 12-bit HDR pixel format.
           # @!attribute [rw] bitrate_bps
           #   @return [::Integer]
-          #     Required. The video bitrate in bits per second. Must be between 1 and 1,000,000,000.
+          #     Required. The video bitrate in bits per second. The minimum value is 1,000.
+          #     The maximum value for H264/H265 is 800,000,000. The maximum value for VP9
+          #     is 480,000,000.
           # @!attribute [rw] rate_control_mode
           #   @return [::String]
           #     Specify the `rate_control_mode`. The default is `"vbr"`.
@@ -675,7 +762,9 @@ module Google
           # @!attribute [rw] gop_duration
           #   @return [::Google::Protobuf::Duration]
           #     Select the GOP size based on the specified duration. The default is
-          #     `"3s"`.
+          #     `"3s"`. Note that `gopDuration` must be less than or equal to
+          #     [`segmentDuration`](#SegmentSettings), and
+          #     [`segmentDuration`](#SegmentSettings) must be divisible by `gopDuration`.
           # @!attribute [rw] entropy_coder
           #   @return [::String]
           #     The entropy coder to use. The default is `"cabac"`.
@@ -696,28 +785,10 @@ module Google
           #     Required. The target video frame rate in frames per second (FPS). Must be less than
           #     or equal to 120. Will default to the input frame rate if larger than the
           #     input frame rate. The API will generate an output FPS that is divisible by
-          #     the input FPS, and smaller or equal to the target FPS.
-          #
-          #     The following table shows the computed video FPS given the target FPS (in
-          #     parenthesis) and input FPS (in the first column):
-          #     ```
-          #     |        | (30)   | (60)   | (25) | (50) |
-          #     |--------|--------|--------|------|------|
-          #     | 240    | Fail   | Fail   | Fail | Fail |
-          #     | 120    | 30     | 60     | 20   | 30   |
-          #     | 100    | 25     | 50     | 20   | 30   |
-          #     | 50     | 25     | 50     | 20   | 30   |
-          #     | 60     | 30     | 60     | 20   | 30   |
-          #     | 59.94  | 29.97  | 59.94  | 20   | 30   |
-          #     | 48     | 24     | 48     | 20   | 30   |
-          #     | 30     | 30     | 30     | 20   | 30   |
-          #     | 25     | 25     | 25     | 20   | 30   |
-          #     | 24     | 24     | 24     | 20   | 30   |
-          #     | 23.976 | 23.976 | 23.976 | 20   | 30   |
-          #     | 15     | 15     | 15     | 20   | 30   |
-          #     | 12     | 12     | 12     | 20   | 30   |
-          #     | 10     | 10     | 10     | 20   | 30   |
-          #     ```
+          #     the input FPS, and smaller or equal to the target FPS. See
+          #     [Calculate frame
+          #     rate](https://cloud.google.com/transcoder/docs/concepts/frame-rate) for
+          #     more information.
           # @!attribute [rw] aq_strength
           #   @return [::Float]
           #     Specify the intensity of the adaptive quantizer (AQ). Must be between 0 and
@@ -865,7 +936,10 @@ module Google
           # Segment settings for `"ts"`, `"fmp4"` and `"vtt"`.
           # @!attribute [rw] segment_duration
           #   @return [::Google::Protobuf::Duration]
-          #     Duration of the segments in seconds. The default is `"6.0s"`.
+          #     Duration of the segments in seconds. The default is `"6.0s"`. Note that
+          #     `segmentDuration` must be greater than or equal to
+          #     [`gopDuration`](#videostream), and `segmentDuration` must be divisible by
+          #     [`gopDuration`](#videostream).
           # @!attribute [rw] individual_segments
           #   @return [::Boolean]
           #     Required. Create an individual segment file. The default is `false`.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-video-transcoder-v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-12 00:00:00.000000000 Z
+date: 2021-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.5'
+        version: '0.7'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a