googleapis-common-protos-types 1.3.0 → 1.12.0

data/lib/google/type/calendar_period_pb.rb

@@ -1,21 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/calendar_period.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/calendar_period.proto", :syntax => :proto3) do
-    add_enum "google.type.CalendarPeriod" do
-      value :CALENDAR_PERIOD_UNSPECIFIED, 0
-      value :DAY, 1
-      value :WEEK, 2
-      value :FORTNIGHT, 3
-      value :MONTH, 4
-      value :QUARTER, 5
-      value :HALF, 6
-      value :YEAR, 7
+
+descriptor_data = "\n!google/type/calendar_period.proto\x12\x0bgoogle.type*\x7f\n\x0e\x43\x61lendarPeriod\x12\x1f\n\x1b\x43\x41LENDAR_PERIOD_UNSPECIFIED\x10\x00\x12\x07\n\x03\x44\x41Y\x10\x01\x12\x08\n\x04WEEK\x10\x02\x12\r\n\tFORTNIGHT\x10\x03\x12\t\n\x05MONTH\x10\x04\x12\x0b\n\x07QUARTER\x10\x05\x12\x08\n\x04HALF\x10\x06\x12\x08\n\x04YEAR\x10\x07\x42x\n\x0f\x63om.google.typeB\x13\x43\x61lendarPeriodProtoP\x01ZHgoogle.golang.org/genproto/googleapis/type/calendarperiod;calendarperiod\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -23,3 +36,62 @@ module Google
     CalendarPeriod = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.CalendarPeriod").enummodule
   end
 end
+
+#### Source proto file: google/type/calendar_period.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option go_package = "google.golang.org/genproto/googleapis/type/calendarperiod;calendarperiod";
+# option java_multiple_files = true;
+# option java_outer_classname = "CalendarPeriodProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // A `CalendarPeriod` represents the abstract concept of a time period that has
+# // a canonical start. Grammatically, "the start of the current
+# // `CalendarPeriod`." All calendar times begin at midnight UTC.
+# enum CalendarPeriod {
+#   // Undefined period, raises an error.
+#   CALENDAR_PERIOD_UNSPECIFIED = 0;
+#
+#   // A day.
+#   DAY = 1;
+#
+#   // A week. Weeks begin on Monday, following
+#   // [ISO 8601](https://en.wikipedia.org/wiki/ISO_week_date).
+#   WEEK = 2;
+#
+#   // A fortnight. The first calendar fortnight of the year begins at the start
+#   // of week 1 according to
+#   // [ISO 8601](https://en.wikipedia.org/wiki/ISO_week_date).
+#   FORTNIGHT = 3;
+#
+#   // A month.
+#   MONTH = 4;
+#
+#   // A quarter. Quarters start on dates 1-Jan, 1-Apr, 1-Jul, and 1-Oct of each
+#   // year.
+#   QUARTER = 5;
+#
+#   // A half-year. Half-years start on dates 1-Jan and 1-Jul.
+#   HALF = 6;
+#
+#   // A year.
+#   YEAR = 7;
+# }

data/lib/google/type/color_pb.rb

@@ -1,18 +1,37 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/color.proto
 
 require 'google/protobuf'
 
 require 'google/protobuf/wrappers_pb'
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/color.proto", :syntax => :proto3) do
-    add_message "google.type.Color" do
-      optional :red, :float, 1
-      optional :green, :float, 2
-      optional :blue, :float, 3
-      optional :alpha, :message, 4, "google.protobuf.FloatValue"
+
+
+descriptor_data = "\n\x17google/type/color.proto\x12\x0bgoogle.type\x1a\x1egoogle/protobuf/wrappers.proto\"]\n\x05\x43olor\x12\x0b\n\x03red\x18\x01 \x01(\x02\x12\r\n\x05green\x18\x02 \x01(\x02\x12\x0c\n\x04\x62lue\x18\x03 \x01(\x02\x12*\n\x05\x61lpha\x18\x04 \x01(\x0b\x32\x1b.google.protobuf.FloatValueB`\n\x0f\x63om.google.typeB\nColorProtoP\x01Z6google.golang.org/genproto/googleapis/type/color;color\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.FloatValue", "google/protobuf/wrappers.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -20,3 +39,180 @@ module Google
     Color = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Color").msgclass
   end
 end
+
+#### Source proto file: google/type/color.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# import "google/protobuf/wrappers.proto";
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/color;color";
+# option java_multiple_files = true;
+# option java_outer_classname = "ColorProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a color in the RGBA color space. This representation is designed
+# // for simplicity of conversion to/from color representations in various
+# // languages over compactness. For example, the fields of this representation
+# // can be trivially provided to the constructor of `java.awt.Color` in Java; it
+# // can also be trivially provided to UIColor's `+colorWithRed:green:blue:alpha`
+# // method in iOS; and, with just a little work, it can be easily formatted into
+# // a CSS `rgba()` string in JavaScript.
+# //
+# // This reference page doesn't carry information about the absolute color
+# // space
+# // that should be used to interpret the RGB value (e.g. sRGB, Adobe RGB,
+# // DCI-P3, BT.2020, etc.). By default, applications should assume the sRGB color
+# // space.
+# //
+# // When color equality needs to be decided, implementations, unless
+# // documented otherwise, treat two colors as equal if all their red,
+# // green, blue, and alpha values each differ by at most 1e-5.
+# //
+# // Example (Java):
+# //
+# //      import com.google.type.Color;
+# //
+# //      // ...
+# //      public static java.awt.Color fromProto(Color protocolor) {
+# //        float alpha = protocolor.hasAlpha()
+# //            ? protocolor.getAlpha().getValue()
+# //            : 1.0;
+# //
+# //        return new java.awt.Color(
+# //            protocolor.getRed(),
+# //            protocolor.getGreen(),
+# //            protocolor.getBlue(),
+# //            alpha);
+# //      }
+# //
+# //      public static Color toProto(java.awt.Color color) {
+# //        float red = (float) color.getRed();
+# //        float green = (float) color.getGreen();
+# //        float blue = (float) color.getBlue();
+# //        float denominator = 255.0;
+# //        Color.Builder resultBuilder =
+# //            Color
+# //                .newBuilder()
+# //                .setRed(red / denominator)
+# //                .setGreen(green / denominator)
+# //                .setBlue(blue / denominator);
+# //        int alpha = color.getAlpha();
+# //        if (alpha != 255) {
+# //          result.setAlpha(
+# //              FloatValue
+# //                  .newBuilder()
+# //                  .setValue(((float) alpha) / denominator)
+# //                  .build());
+# //        }
+# //        return resultBuilder.build();
+# //      }
+# //      // ...
+# //
+# // Example (iOS / Obj-C):
+# //
+# //      // ...
+# //      static UIColor* fromProto(Color* protocolor) {
+# //         float red = [protocolor red];
+# //         float green = [protocolor green];
+# //         float blue = [protocolor blue];
+# //         FloatValue* alpha_wrapper = [protocolor alpha];
+# //         float alpha = 1.0;
+# //         if (alpha_wrapper != nil) {
+# //           alpha = [alpha_wrapper value];
+# //         }
+# //         return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
+# //      }
+# //
+# //      static Color* toProto(UIColor* color) {
+# //          CGFloat red, green, blue, alpha;
+# //          if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
+# //            return nil;
+# //          }
+# //          Color* result = [[Color alloc] init];
+# //          [result setRed:red];
+# //          [result setGreen:green];
+# //          [result setBlue:blue];
+# //          if (alpha <= 0.9999) {
+# //            [result setAlpha:floatWrapperWithValue(alpha)];
+# //          }
+# //          [result autorelease];
+# //          return result;
+# //     }
+# //     // ...
+# //
+# //  Example (JavaScript):
+# //
+# //     // ...
+# //
+# //     var protoToCssColor = function(rgb_color) {
+# //        var redFrac = rgb_color.red || 0.0;
+# //        var greenFrac = rgb_color.green || 0.0;
+# //        var blueFrac = rgb_color.blue || 0.0;
+# //        var red = Math.floor(redFrac * 255);
+# //        var green = Math.floor(greenFrac * 255);
+# //        var blue = Math.floor(blueFrac * 255);
+# //
+# //        if (!('alpha' in rgb_color)) {
+# //           return rgbToCssColor(red, green, blue);
+# //        }
+# //
+# //        var alphaFrac = rgb_color.alpha.value || 0.0;
+# //        var rgbParams = [red, green, blue].join(',');
+# //        return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
+# //     };
+# //
+# //     var rgbToCssColor = function(red, green, blue) {
+# //       var rgbNumber = new Number((red << 16) | (green << 8) | blue);
+# //       var hexString = rgbNumber.toString(16);
+# //       var missingZeros = 6 - hexString.length;
+# //       var resultBuilder = ['#'];
+# //       for (var i = 0; i < missingZeros; i++) {
+# //          resultBuilder.push('0');
+# //       }
+# //       resultBuilder.push(hexString);
+# //       return resultBuilder.join('');
+# //     };
+# //
+# //     // ...
+# message Color {
+#   // The amount of red in the color as a value in the interval [0, 1].
+#   float red = 1;
+#
+#   // The amount of green in the color as a value in the interval [0, 1].
+#   float green = 2;
+#
+#   // The amount of blue in the color as a value in the interval [0, 1].
+#   float blue = 3;
+#
+#   // The fraction of this color that should be applied to the pixel. That is,
+#   // the final pixel color is defined by the equation:
+#   //
+#   //   `pixel color = alpha * (this color) + (1.0 - alpha) * (background color)`
+#   //
+#   // This means that a value of 1.0 corresponds to a solid color, whereas
+#   // a value of 0.0 corresponds to a completely transparent color. This
+#   // uses a wrapper message rather than a simple float scalar so that it is
+#   // possible to distinguish between a default value and the value being unset.
+#   // If omitted, this color object is rendered as a solid color
+#   // (as if the alpha value had been explicitly given a value of 1.0).
+#   google.protobuf.FloatValue alpha = 4;
+# }

data/lib/google/type/date_pb.rb

@@ -1,16 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/date.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/date.proto", :syntax => :proto3) do
-    add_message "google.type.Date" do
-      optional :year, :int32, 1
-      optional :month, :int32, 2
-      optional :day, :int32, 3
+
+descriptor_data = "\n\x16google/type/date.proto\x12\x0bgoogle.type\"0\n\x04\x44\x61te\x12\x0c\n\x04year\x18\x01 \x01(\x05\x12\r\n\x05month\x18\x02 \x01(\x05\x12\x0b\n\x03\x64\x61y\x18\x03 \x01(\x05\x42]\n\x0f\x63om.google.typeB\tDateProtoP\x01Z4google.golang.org/genproto/googleapis/type/date;date\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -18,3 +36,58 @@ module Google
     Date = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.Date").msgclass
   end
 end
+
+#### Source proto file: google/type/date.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/date;date";
+# option java_multiple_files = true;
+# option java_outer_classname = "DateProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents a whole or partial calendar date, such as a birthday. The time of
+# // day and time zone are either specified elsewhere or are insignificant. The
+# // date is relative to the Gregorian Calendar. This can represent one of the
+# // following:
+# //
+# // * A full date, with non-zero year, month, and day values
+# // * A month and day value, with a zero year, such as an anniversary
+# // * A year on its own, with zero month and day values
+# // * A year and month value, with a zero day, such as a credit card expiration
+# // date
+# //
+# // Related types are [google.type.TimeOfDay][google.type.TimeOfDay] and
+# // `google.protobuf.Timestamp`.
+# message Date {
+#   // Year of the date. Must be from 1 to 9999, or 0 to specify a date without
+#   // a year.
+#   int32 year = 1;
+#
+#   // Month of a year. Must be from 1 to 12, or 0 to specify a year without a
+#   // month and day.
+#   int32 month = 2;
+#
+#   // Day of a month. Must be from 1 to 31 and valid for the year and month, or 0
+#   // to specify a year by itself or a year and month where the day isn't
+#   // significant.
+#   int32 day = 3;
+# }

data/lib/google/type/datetime_pb.rb

@@ -1,29 +1,37 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/type/datetime.proto
 
 require 'google/protobuf'
 
 require 'google/protobuf/duration_pb'
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/type/datetime.proto", :syntax => :proto3) do
-    add_message "google.type.DateTime" do
-      optional :year, :int32, 1
-      optional :month, :int32, 2
-      optional :day, :int32, 3
-      optional :hours, :int32, 4
-      optional :minutes, :int32, 5
-      optional :seconds, :int32, 6
-      optional :nanos, :int32, 7
-      oneof :time_offset do
-        optional :utc_offset, :message, 8, "google.protobuf.Duration"
-        optional :time_zone, :message, 9, "google.type.TimeZone"
-      end
-    end
-    add_message "google.type.TimeZone" do
-      optional :id, :string, 1
-      optional :version, :string, 2
+
+
+descriptor_data = "\n\x1agoogle/type/datetime.proto\x12\x0bgoogle.type\x1a\x1egoogle/protobuf/duration.proto\"\xe0\x01\n\x08\x44\x61teTime\x12\x0c\n\x04year\x18\x01 \x01(\x05\x12\r\n\x05month\x18\x02 \x01(\x05\x12\x0b\n\x03\x64\x61y\x18\x03 \x01(\x05\x12\r\n\x05hours\x18\x04 \x01(\x05\x12\x0f\n\x07minutes\x18\x05 \x01(\x05\x12\x0f\n\x07seconds\x18\x06 \x01(\x05\x12\r\n\x05nanos\x18\x07 \x01(\x05\x12/\n\nutc_offset\x18\x08 \x01(\x0b\x32\x19.google.protobuf.DurationH\x00\x12*\n\ttime_zone\x18\t \x01(\x0b\x32\x15.google.type.TimeZoneH\x00\x42\r\n\x0btime_offset\"\'\n\x08TimeZone\x12\n\n\x02id\x18\x01 \x01(\t\x12\x0f\n\x07version\x18\x02 \x01(\tBi\n\x0f\x63om.google.typeB\rDateTimeProtoP\x01Z<google.golang.org/genproto/googleapis/type/datetime;datetime\xf8\x01\x01\xa2\x02\x03GTPb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Duration", "google/protobuf/duration.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google
@@ -32,3 +40,110 @@ module Google
     TimeZone = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.type.TimeZone").msgclass
   end
 end
+
+#### Source proto file: google/type/datetime.proto ####
+#
+# // Copyright 2021 Google LLC
+# //
+# // Licensed under the Apache License, Version 2.0 (the "License");
+# // you may not use this file except in compliance with the License.
+# // You may obtain a copy of the License at
+# //
+# //     http://www.apache.org/licenses/LICENSE-2.0
+# //
+# // Unless required by applicable law or agreed to in writing, software
+# // distributed under the License is distributed on an "AS IS" BASIS,
+# // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# // See the License for the specific language governing permissions and
+# // limitations under the License.
+#
+# syntax = "proto3";
+#
+# package google.type;
+#
+# import "google/protobuf/duration.proto";
+#
+# option cc_enable_arenas = true;
+# option go_package = "google.golang.org/genproto/googleapis/type/datetime;datetime";
+# option java_multiple_files = true;
+# option java_outer_classname = "DateTimeProto";
+# option java_package = "com.google.type";
+# option objc_class_prefix = "GTP";
+#
+# // Represents civil time (or occasionally physical time).
+# //
+# // This type can represent a civil time in one of a few possible ways:
+# //
+# //  * When utc_offset is set and time_zone is unset: a civil time on a calendar
+# //    day with a particular offset from UTC.
+# //  * When time_zone is set and utc_offset is unset: a civil time on a calendar
+# //    day in a particular time zone.
+# //  * When neither time_zone nor utc_offset is set: a civil time on a calendar
+# //    day in local time.
+# //
+# // The date is relative to the Proleptic Gregorian Calendar.
+# //
+# // If year is 0, the DateTime is considered not to have a specific year. month
+# // and day must have valid, non-zero values.
+# //
+# // This type may also be used to represent a physical time if all the date and
+# // time fields are set and either case of the `time_offset` oneof is set.
+# // Consider using `Timestamp` message for physical time instead. If your use
+# // case also would like to store the user's timezone, that can be done in
+# // another field.
+# //
+# // This type is more flexible than some applications may want. Make sure to
+# // document and validate your application's limitations.
+# message DateTime {
+#   // Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a
+#   // datetime without a year.
+#   int32 year = 1;
+#
+#   // Required. Month of year. Must be from 1 to 12.
+#   int32 month = 2;
+#
+#   // Required. Day of month. Must be from 1 to 31 and valid for the year and
+#   // month.
+#   int32 day = 3;
+#
+#   // Required. Hours of day in 24 hour format. Should be from 0 to 23. An API
+#   // may choose to allow the value "24:00:00" for scenarios like business
+#   // closing time.
+#   int32 hours = 4;
+#
+#   // Required. Minutes of hour of day. Must be from 0 to 59.
+#   int32 minutes = 5;
+#
+#   // Required. Seconds of minutes of the time. Must normally be from 0 to 59. An
+#   // API may allow the value 60 if it allows leap-seconds.
+#   int32 seconds = 6;
+#
+#   // Required. Fractions of seconds in nanoseconds. Must be from 0 to
+#   // 999,999,999.
+#   int32 nanos = 7;
+#
+#   // Optional. Specifies either the UTC offset or the time zone of the DateTime.
+#   // Choose carefully between them, considering that time zone data may change
+#   // in the future (for example, a country modifies their DST start/end dates,
+#   // and future DateTimes in the affected range had already been stored).
+#   // If omitted, the DateTime is considered to be in local time.
+#   oneof time_offset {
+#     // UTC offset. Must be whole seconds, between -18 hours and +18 hours.
+#     // For example, a UTC offset of -4:00 would be represented as
+#     // { seconds: -14400 }.
+#     google.protobuf.Duration utc_offset = 8;
+#
+#     // Time zone.
+#     TimeZone time_zone = 9;
+#   }
+# }
+#
+# // Represents a time zone from the
+# // [IANA Time Zone Database](https://www.iana.org/time-zones).
+# message TimeZone {
+#   // IANA Time Zone Database time zone, e.g. "America/New_York".
+#   string id = 1;
+#
+#   // Optional. IANA Time Zone Database version number, e.g. "2019a".
+#   string version = 2;
+# }