feat!: update proto files, add create_time, start_time and end_time, height_pixels and width_pixels become optional

PiperOrigin-RevId: 334639492

Source-Author: Google APIs <noreply@google.com>
Source-Date: Wed Sep 30 11:15:35 2020 -0700
Source-Repo: googleapis/googleapis
Source-Sha: 054339f961e16b2a359b0efc35a927b5f899c90f
Source-Link: googleapis/googleapis@054339f

Author: yoshi-automation

google/cloud/video/transcoder_v1beta1/services/transcoder_service/async_client.py

@@ -31,6 +31,7 @@
 from google.cloud.video.transcoder_v1beta1.services.transcoder_service import pagers
 from google.cloud.video.transcoder_v1beta1.types import resources
 from google.cloud.video.transcoder_v1beta1.types import services
+from google.protobuf import timestamp_pb2 as timestamp  # type: ignore
 
 from .transports.base import TranscoderServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc_asyncio import TranscoderServiceGrpcAsyncIOTransport
@@ -441,7 +442,8 @@ async def create_job_template(
                 resource name.
 
                 This value should be 4-63 characters, and valid
-                characters are ``/[a-zA-Z0-9_-_]/``.
+                characters must match the regular expression
+                ``[a-zA-Z][a-zA-Z0-9_-]*``.
                 This corresponds to the ``job_template_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

google/cloud/video/transcoder_v1beta1/services/transcoder_service/client.py

@@ -35,6 +35,7 @@
 from google.cloud.video.transcoder_v1beta1.services.transcoder_service import pagers
 from google.cloud.video.transcoder_v1beta1.types import resources
 from google.cloud.video.transcoder_v1beta1.types import services
+from google.protobuf import timestamp_pb2 as timestamp  # type: ignore
 
 from .transports.base import TranscoderServiceTransport, DEFAULT_CLIENT_INFO
 from .transports.grpc import TranscoderServiceGrpcTransport
@@ -624,7 +625,8 @@ def create_job_template(
                 resource name.
 
                 This value should be 4-63 characters, and valid
-                characters are ``/[a-zA-Z0-9_-_]/``.
+                characters must match the regular expression
+                ``[a-zA-Z][a-zA-Z0-9_-]*``.
                 This corresponds to the ``job_template_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.

google/cloud/video/transcoder_v1beta1/types/resources.py

@@ -19,6 +19,7 @@
 
 
 from google.protobuf import duration_pb2 as duration  # type: ignore
+from google.protobuf import timestamp_pb2 as timestamp  # type: ignore
 
 
 __protobuf__ = proto.module(
@@ -99,6 +100,14 @@ class Job(proto.Message):
             Output only. List of failure details. This property may
             contain additional information about the failure when
             ``failure_reason`` is present.
+        create_time (~.timestamp.Timestamp):
+            Output only. The time the job was created.
+        start_time (~.timestamp.Timestamp):
+            Output only. The time the transcoding
+            started.
+        end_time (~.timestamp.Timestamp):
+            Output only. The time the transcoding
+            finished.
     """
 
     class ProcessingState(proto.Enum):
@@ -152,6 +161,12 @@ class OriginUri(proto.Message):
         proto.MESSAGE, number=11, message="FailureDetail",
     )
 
+    create_time = proto.Field(proto.MESSAGE, number=12, message=timestamp.Timestamp,)
+
+    start_time = proto.Field(proto.MESSAGE, number=13, message=timestamp.Timestamp,)
+
+    end_time = proto.Field(proto.MESSAGE, number=14, message=timestamp.Timestamp,)
+
 
 class JobTemplate(proto.Message):
     r"""Transcoding job template resource.
@@ -387,9 +402,9 @@ class Manifest(proto.Message):
 
     Attributes:
         file_name (str):
-            The name of the generated file. The default is ``"master"``
-            with the extension suffix corresponding to the
-            ``Manifest.type``.
+            The name of the generated file. The default is
+            ``"manifest"`` with the extension suffix corresponding to
+            the ``Manifest.type``.
         type_ (~.resources.Manifest.ManifestType):
             Required. Type of the manifest, can be "HLS"
             or "DASH".
@@ -811,11 +826,17 @@ class VideoStream(proto.Message):
             Enforce specified codec preset. The default is
             ``"veryfast"``.
         height_pixels (int):
-            Required. The height of video in pixels. Must
-            be an even integer.
+            The height of the video in pixels. Must be an
+            even integer. When not specified, the height is
+            adjusted to match the specified width and input
+            aspect ratio. If both are omitted, the input
+            height is used.
         width_pixels (int):
-            Required. The width of video in pixels. Must
-            be an even integer.
+            The width of the video in pixels. Must be an
+            even integer. When not specified, the width is
+            adjusted to match the specified height and input
+            aspect ratio. If both are omitted, the input
+            width is used.
         pixel_format (str):
             Pixel format to use. The default is ``"yuv420p"``.
 
@@ -880,10 +901,26 @@ class VideoStream(proto.Message):
             equal to zero. Must be less than
             ``VideoStream.gop_frame_count`` if set. The default is 0.
         frame_rate (float):
-            Required. The video frame rate in frames per
-            second. Must be less than or equal to 120. Will
-            default to the input frame rate if larger than
-            the input frame rate.
+            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 \|
         aq_strength (float):
             Specify the intensity of the adaptive
             quantizer (AQ). Must be between 0 and 1, where 0

google/cloud/video/transcoder_v1beta1/types/services.py

@@ -136,7 +136,8 @@ class CreateJobTemplateRequest(proto.Message):
             name.
 
             This value should be 4-63 characters, and valid characters
-            are ``/[a-zA-Z0-9_-_]/``.
+            must match the regular expression
+            ``[a-zA-Z][a-zA-Z0-9_-]*``.
     """
 
     parent = proto.Field(proto.STRING, number=1)

tests/unit/gapic/transcoder_v1beta1/test_transcoder_service.py

@@ -44,6 +44,7 @@
 from google.cloud.video.transcoder_v1beta1.types import services
 from google.oauth2 import service_account
 from google.protobuf import duration_pb2 as duration  # type: ignore
+from google.protobuf import timestamp_pb2 as timestamp  # type: ignore
 
 
 def client_cert_source_callback():