googleapis-common-protos-types 1.7.0 → 1.9.0

data/lib/google/api/consumer_pb.rb

@@ -1,26 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/consumer.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/consumer.proto", :syntax => :proto3) do
-    add_message "google.api.ProjectProperties" do
-      repeated :properties, :message, 1, "google.api.Property"
-    end
-    add_message "google.api.Property" do
-      optional :name, :string, 1
-      optional :type, :enum, 2, "google.api.Property.PropertyType"
-      optional :description, :string, 3
-    end
-    add_enum "google.api.Property.PropertyType" do
-      value :UNSPECIFIED, 0
-      value :INT64, 1
-      value :BOOL, 2
-      value :STRING, 3
-      value :DOUBLE, 4
+
+descriptor_data = "\n\x19google/api/consumer.proto\x12\ngoogle.api\"=\n\x11ProjectProperties\x12(\n\nproperties\x18\x01 \x03(\x0b\x32\x14.google.api.Property\"\xac\x01\n\x08Property\x12\x0c\n\x04name\x18\x01 \x01(\t\x12/\n\x04type\x18\x02 \x01(\x0e\x32!.google.api.Property.PropertyType\x12\x13\n\x0b\x64\x65scription\x18\x03 \x01(\t\"L\n\x0cPropertyType\x12\x0f\n\x0bUNSPECIFIED\x10\x00\x12\t\n\x05INT64\x10\x01\x12\x08\n\x04\x42OOL\x10\x02\x12\n\n\x06STRING\x10\x03\x12\n\n\x06\x44OUBLE\x10\x04\x42h\n\x0e\x63om.google.apiB\rConsumerProtoP\x01ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfigb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # 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
@@ -30,3 +38,88 @@ module Google
     Property::PropertyType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.Property.PropertyType").enummodule
   end
 end
+
+#### Source proto file: google/api/consumer.proto ####
+#
+# // Copyright 2016 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.api;
+#
+# option go_package = "google.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig";
+# option java_multiple_files = true;
+# option java_outer_classname = "ConsumerProto";
+# option java_package = "com.google.api";
+#
+# // A descriptor for defining project properties for a service. One service may
+# // have many consumer projects, and the service may want to behave differently
+# // depending on some properties on the project. For example, a project may be
+# // associated with a school, or a business, or a government agency, a business
+# // type property on the project may affect how a service responds to the client.
+# // This descriptor defines which properties are allowed to be set on a project.
+# //
+# // Example:
+# //
+# //    project_properties:
+# //      properties:
+# //      - name: NO_WATERMARK
+# //        type: BOOL
+# //        description: Allows usage of the API without watermarks.
+# //      - name: EXTENDED_TILE_CACHE_PERIOD
+# //        type: INT64
+# message ProjectProperties {
+#   // List of per consumer project-specific properties.
+#   repeated Property properties = 1;
+# }
+#
+# // Defines project properties.
+# //
+# // API services can define properties that can be assigned to consumer projects
+# // so that backends can perform response customization without having to make
+# // additional calls or maintain additional storage. For example, Maps API
+# // defines properties that controls map tile cache period, or whether to embed a
+# // watermark in a result.
+# //
+# // These values can be set via API producer console. Only API providers can
+# // define and set these properties.
+# message Property {
+#   // Supported data type of the property values
+#   enum PropertyType {
+#     // The type is unspecified, and will result in an error.
+#     UNSPECIFIED = 0;
+#
+#     // The type is `int64`.
+#     INT64 = 1;
+#
+#     // The type is `bool`.
+#     BOOL = 2;
+#
+#     // The type is `string`.
+#     STRING = 3;
+#
+#     // The type is 'double'.
+#     DOUBLE = 4;
+#   }
+#
+#   // The name of the property (a.k.a key).
+#   string name = 1;
+#
+#   // The type of this property.
+#   PropertyType type = 2;
+#
+#   // The description of the property
+#   string description = 3;
+# }

data/lib/google/api/context_pb.rb

@@ -1,21 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/context.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/context.proto", :syntax => :proto3) do
-    add_message "google.api.Context" do
-      repeated :rules, :message, 1, "google.api.ContextRule"
-    end
-    add_message "google.api.ContextRule" do
-      optional :selector, :string, 1
-      repeated :requested, :string, 2
-      repeated :provided, :string, 3
-      repeated :allowed_request_extensions, :string, 4
-      repeated :allowed_response_extensions, :string, 5
+
+descriptor_data = "\n\x18google/api/context.proto\x12\ngoogle.api\"1\n\x07\x43ontext\x12&\n\x05rules\x18\x01 \x03(\x0b\x32\x17.google.api.ContextRule\"\x8d\x01\n\x0b\x43ontextRule\x12\x10\n\x08selector\x18\x01 \x01(\t\x12\x11\n\trequested\x18\x02 \x03(\t\x12\x10\n\x08provided\x18\x03 \x03(\t\x12\"\n\x1a\x61llowed_request_extensions\x18\x04 \x03(\t\x12#\n\x1b\x61llowed_response_extensions\x18\x05 \x03(\tBn\n\x0e\x63om.google.apiB\x0c\x43ontextProtoP\x01ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\xa2\x02\x04GAPIb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # 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
@@ -24,3 +37,96 @@ module Google
     ContextRule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.ContextRule").msgclass
   end
 end
+
+#### Source proto file: google/api/context.proto ####
+#
+# // Copyright 2023 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.api;
+#
+# option go_package = "google.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig";
+# option java_multiple_files = true;
+# option java_outer_classname = "ContextProto";
+# option java_package = "com.google.api";
+# option objc_class_prefix = "GAPI";
+#
+# // `Context` defines which contexts an API requests.
+# //
+# // Example:
+# //
+# //     context:
+# //       rules:
+# //       - selector: "*"
+# //         requested:
+# //         - google.rpc.context.ProjectContext
+# //         - google.rpc.context.OriginContext
+# //
+# // The above specifies that all methods in the API request
+# // `google.rpc.context.ProjectContext` and
+# // `google.rpc.context.OriginContext`.
+# //
+# // Available context types are defined in package
+# // `google.rpc.context`.
+# //
+# // This also provides mechanism to allowlist any protobuf message extension that
+# // can be sent in grpc metadata using “x-goog-ext-<extension_id>-bin” and
+# // “x-goog-ext-<extension_id>-jspb” format. For example, list any service
+# // specific protobuf types that can appear in grpc metadata as follows in your
+# // yaml file:
+# //
+# // Example:
+# //
+# //     context:
+# //       rules:
+# //        - selector: "google.example.library.v1.LibraryService.CreateBook"
+# //          allowed_request_extensions:
+# //          - google.foo.v1.NewExtension
+# //          allowed_response_extensions:
+# //          - google.foo.v1.NewExtension
+# //
+# // You can also specify extension ID instead of fully qualified extension name
+# // here.
+# message Context {
+#   // A list of RPC context rules that apply to individual API methods.
+#   //
+#   // **NOTE:** All service configuration rules follow "last one wins" order.
+#   repeated ContextRule rules = 1;
+# }
+#
+# // A context rule provides information about the context for an individual API
+# // element.
+# message ContextRule {
+#   // Selects the methods to which this rule applies.
+#   //
+#   // Refer to [selector][google.api.DocumentationRule.selector] for syntax
+#   // details.
+#   string selector = 1;
+#
+#   // A list of full type names of requested contexts.
+#   repeated string requested = 2;
+#
+#   // A list of full type names of provided contexts.
+#   repeated string provided = 3;
+#
+#   // A list of full type names or extension IDs of extensions allowed in grpc
+#   // side channel from client to backend.
+#   repeated string allowed_request_extensions = 4;
+#
+#   // A list of full type names or extension IDs of extensions allowed in grpc
+#   // side channel from backend to client.
+#   repeated string allowed_response_extensions = 5;
+# }

data/lib/google/api/control_pb.rb

@@ -1,14 +1,37 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/control.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/control.proto", :syntax => :proto3) do
-    add_message "google.api.Control" do
-      optional :environment, :string, 1
+require 'google/api/policy_pb'
+
+
+descriptor_data = "\n\x18google/api/control.proto\x12\ngoogle.api\x1a\x17google/api/policy.proto\"Q\n\x07\x43ontrol\x12\x13\n\x0b\x65nvironment\x18\x01 \x01(\t\x12\x31\n\x0fmethod_policies\x18\x04 \x03(\x0b\x32\x18.google.api.MethodPolicyBn\n\x0e\x63om.google.apiB\x0c\x43ontrolProtoP\x01ZEgoogle.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig\xa2\x02\x04GAPIb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # 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.api.MethodPolicy", "google/api/policy.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
@@ -16,3 +39,47 @@ module Google
     Control = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.Control").msgclass
   end
 end
+
+#### Source proto file: google/api/control.proto ####
+#
+# // Copyright 2023 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.api;
+#
+# import "google/api/policy.proto";
+#
+# option go_package = "google.golang.org/genproto/googleapis/api/serviceconfig;serviceconfig";
+# option java_multiple_files = true;
+# option java_outer_classname = "ControlProto";
+# option java_package = "com.google.api";
+# option objc_class_prefix = "GAPI";
+#
+# // Selects and configures the service controller used by the service.
+# //
+# // Example:
+# //
+# //     control:
+# //       environment: servicecontrol.googleapis.com
+# message Control {
+#   // The service controller environment to use. If empty, no control plane
+#   // feature (like quota and billing) will be enabled. The recommended value for
+#   // most services is servicecontrol.googleapis.com
+#   string environment = 1;
+#
+#   // Defines policies applying to the API methods of the service.
+#   repeated MethodPolicy method_policies = 4;
+# }

data/lib/google/api/distribution_pb.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/distribution.proto
 
@@ -6,47 +7,33 @@ require 'google/protobuf'
 require 'google/protobuf/any_pb'
 require 'google/protobuf/timestamp_pb'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/distribution.proto", :syntax => :proto3) do
-    add_message "google.api.Distribution" do
-      optional :count, :int64, 1
-      optional :mean, :double, 2
-      optional :sum_of_squared_deviation, :double, 3
-      optional :range, :message, 4, "google.api.Distribution.Range"
-      optional :bucket_options, :message, 6, "google.api.Distribution.BucketOptions"
-      repeated :bucket_counts, :int64, 7
-      repeated :exemplars, :message, 10, "google.api.Distribution.Exemplar"
-    end
-    add_message "google.api.Distribution.Range" do
-      optional :min, :double, 1
-      optional :max, :double, 2
-    end
-    add_message "google.api.Distribution.BucketOptions" do
-      oneof :options do
-        optional :linear_buckets, :message, 1, "google.api.Distribution.BucketOptions.Linear"
-        optional :exponential_buckets, :message, 2, "google.api.Distribution.BucketOptions.Exponential"
-        optional :explicit_buckets, :message, 3, "google.api.Distribution.BucketOptions.Explicit"
-      end
-    end
-    add_message "google.api.Distribution.BucketOptions.Linear" do
-      optional :num_finite_buckets, :int32, 1
-      optional :width, :double, 2
-      optional :offset, :double, 3
-    end
-    add_message "google.api.Distribution.BucketOptions.Exponential" do
-      optional :num_finite_buckets, :int32, 1
-      optional :growth_factor, :double, 2
-      optional :scale, :double, 3
-    end
-    add_message "google.api.Distribution.BucketOptions.Explicit" do
-      repeated :bounds, :double, 1
-    end
-    add_message "google.api.Distribution.Exemplar" do
-      optional :value, :double, 1
-      optional :timestamp, :message, 2, "google.protobuf.Timestamp"
-      repeated :attachments, :message, 3, "google.protobuf.Any"
+
+descriptor_data = "\n\x1dgoogle/api/distribution.proto\x12\ngoogle.api\x1a\x19google/protobuf/any.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xd9\x06\n\x0c\x44istribution\x12\r\n\x05\x63ount\x18\x01 \x01(\x03\x12\x0c\n\x04mean\x18\x02 \x01(\x01\x12 \n\x18sum_of_squared_deviation\x18\x03 \x01(\x01\x12-\n\x05range\x18\x04 \x01(\x0b\x32\x1e.google.api.Distribution.Range\x12>\n\x0e\x62ucket_options\x18\x06 \x01(\x0b\x32&.google.api.Distribution.BucketOptions\x12\x15\n\rbucket_counts\x18\x07 \x03(\x03\x12\x34\n\texemplars\x18\n \x03(\x0b\x32!.google.api.Distribution.Exemplar\x1a!\n\x05Range\x12\x0b\n\x03min\x18\x01 \x01(\x01\x12\x0b\n\x03max\x18\x02 \x01(\x01\x1a\xb5\x03\n\rBucketOptions\x12G\n\x0elinear_buckets\x18\x01 \x01(\x0b\x32-.google.api.Distribution.BucketOptions.LinearH\x00\x12Q\n\x13\x65xponential_buckets\x18\x02 \x01(\x0b\x32\x32.google.api.Distribution.BucketOptions.ExponentialH\x00\x12K\n\x10\x65xplicit_buckets\x18\x03 \x01(\x0b\x32/.google.api.Distribution.BucketOptions.ExplicitH\x00\x1a\x43\n\x06Linear\x12\x1a\n\x12num_finite_buckets\x18\x01 \x01(\x05\x12\r\n\x05width\x18\x02 \x01(\x01\x12\x0e\n\x06offset\x18\x03 \x01(\x01\x1aO\n\x0b\x45xponential\x12\x1a\n\x12num_finite_buckets\x18\x01 \x01(\x05\x12\x15\n\rgrowth_factor\x18\x02 \x01(\x01\x12\r\n\x05scale\x18\x03 \x01(\x01\x1a\x1a\n\x08\x45xplicit\x12\x0e\n\x06\x62ounds\x18\x01 \x03(\x01\x42\t\n\x07options\x1as\n\x08\x45xemplar\x12\r\n\x05value\x18\x01 \x01(\x01\x12-\n\ttimestamp\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12)\n\x0b\x61ttachments\x18\x03 \x03(\x0b\x32\x14.google.protobuf.AnyBq\n\x0e\x63om.google.apiB\x11\x44istributionProtoP\x01ZCgoogle.golang.org/genproto/googleapis/api/distribution;distribution\xa2\x02\x04GAPIb\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # 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.Timestamp", "google/protobuf/timestamp.proto"],
+    ["google.protobuf.Any", "google/protobuf/any.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
@@ -60,3 +47,219 @@ module Google
     Distribution::Exemplar = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.Distribution.Exemplar").msgclass
   end
 end
+
+#### Source proto file: google/api/distribution.proto ####
+#
+# // Copyright 2023 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.api;
+#
+# import "google/protobuf/any.proto";
+# import "google/protobuf/timestamp.proto";
+#
+# option go_package = "google.golang.org/genproto/googleapis/api/distribution;distribution";
+# option java_multiple_files = true;
+# option java_outer_classname = "DistributionProto";
+# option java_package = "com.google.api";
+# option objc_class_prefix = "GAPI";
+#
+# // `Distribution` contains summary statistics for a population of values. It
+# // optionally contains a histogram representing the distribution of those values
+# // across a set of buckets.
+# //
+# // The summary statistics are the count, mean, sum of the squared deviation from
+# // the mean, the minimum, and the maximum of the set of population of values.
+# // The histogram is based on a sequence of buckets and gives a count of values
+# // that fall into each bucket. The boundaries of the buckets are given either
+# // explicitly or by formulas for buckets of fixed or exponentially increasing
+# // widths.
+# //
+# // Although it is not forbidden, it is generally a bad idea to include
+# // non-finite values (infinities or NaNs) in the population of values, as this
+# // will render the `mean` and `sum_of_squared_deviation` fields meaningless.
+# message Distribution {
+#   // The range of the population values.
+#   message Range {
+#     // The minimum of the population values.
+#     double min = 1;
+#
+#     // The maximum of the population values.
+#     double max = 2;
+#   }
+#
+#   // `BucketOptions` describes the bucket boundaries used to create a histogram
+#   // for the distribution. The buckets can be in a linear sequence, an
+#   // exponential sequence, or each bucket can be specified explicitly.
+#   // `BucketOptions` does not include the number of values in each bucket.
+#   //
+#   // A bucket has an inclusive lower bound and exclusive upper bound for the
+#   // values that are counted for that bucket. The upper bound of a bucket must
+#   // be strictly greater than the lower bound. The sequence of N buckets for a
+#   // distribution consists of an underflow bucket (number 0), zero or more
+#   // finite buckets (number 1 through N - 2) and an overflow bucket (number N -
+#   // 1). The buckets are contiguous: the lower bound of bucket i (i > 0) is the
+#   // same as the upper bound of bucket i - 1. The buckets span the whole range
+#   // of finite values: lower bound of the underflow bucket is -infinity and the
+#   // upper bound of the overflow bucket is +infinity. The finite buckets are
+#   // so-called because both bounds are finite.
+#   message BucketOptions {
+#     // Specifies a linear sequence of buckets that all have the same width
+#     // (except overflow and underflow). Each bucket represents a constant
+#     // absolute uncertainty on the specific value in the bucket.
+#     //
+#     // There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
+#     // following boundaries:
+#     //
+#     //    Upper bound (0 <= i < N-1):     offset + (width * i).
+#     //
+#     //    Lower bound (1 <= i < N):       offset + (width * (i - 1)).
+#     message Linear {
+#       // Must be greater than 0.
+#       int32 num_finite_buckets = 1;
+#
+#       // Must be greater than 0.
+#       double width = 2;
+#
+#       // Lower bound of the first bucket.
+#       double offset = 3;
+#     }
+#
+#     // Specifies an exponential sequence of buckets that have a width that is
+#     // proportional to the value of the lower bound. Each bucket represents a
+#     // constant relative uncertainty on a specific value in the bucket.
+#     //
+#     // There are `num_finite_buckets + 2` (= N) buckets. Bucket `i` has the
+#     // following boundaries:
+#     //
+#     //    Upper bound (0 <= i < N-1):     scale * (growth_factor ^ i).
+#     //
+#     //    Lower bound (1 <= i < N):       scale * (growth_factor ^ (i - 1)).
+#     message Exponential {
+#       // Must be greater than 0.
+#       int32 num_finite_buckets = 1;
+#
+#       // Must be greater than 1.
+#       double growth_factor = 2;
+#
+#       // Must be greater than 0.
+#       double scale = 3;
+#     }
+#
+#     // Specifies a set of buckets with arbitrary widths.
+#     //
+#     // There are `size(bounds) + 1` (= N) buckets. Bucket `i` has the following
+#     // boundaries:
+#     //
+#     //    Upper bound (0 <= i < N-1):     bounds[i]
+#     //    Lower bound (1 <= i < N);       bounds[i - 1]
+#     //
+#     // The `bounds` field must contain at least one element. If `bounds` has
+#     // only one element, then there are no finite buckets, and that single
+#     // element is the common boundary of the overflow and underflow buckets.
+#     message Explicit {
+#       // The values must be monotonically increasing.
+#       repeated double bounds = 1;
+#     }
+#
+#     // Exactly one of these three fields must be set.
+#     oneof options {
+#       // The linear bucket.
+#       Linear linear_buckets = 1;
+#
+#       // The exponential buckets.
+#       Exponential exponential_buckets = 2;
+#
+#       // The explicit buckets.
+#       Explicit explicit_buckets = 3;
+#     }
+#   }
+#
+#   // Exemplars are example points that may be used to annotate aggregated
+#   // distribution values. They are metadata that gives information about a
+#   // particular value added to a Distribution bucket, such as a trace ID that
+#   // was active when a value was added. They may contain further information,
+#   // such as a example values and timestamps, origin, etc.
+#   message Exemplar {
+#     // Value of the exemplar point. This value determines to which bucket the
+#     // exemplar belongs.
+#     double value = 1;
+#
+#     // The observation (sampling) time of the above value.
+#     google.protobuf.Timestamp timestamp = 2;
+#
+#     // Contextual information about the example value. Examples are:
+#     //
+#     //   Trace: type.googleapis.com/google.monitoring.v3.SpanContext
+#     //
+#     //   Literal string: type.googleapis.com/google.protobuf.StringValue
+#     //
+#     //   Labels dropped during aggregation:
+#     //     type.googleapis.com/google.monitoring.v3.DroppedLabels
+#     //
+#     // There may be only a single attachment of any given message type in a
+#     // single exemplar, and this is enforced by the system.
+#     repeated google.protobuf.Any attachments = 3;
+#   }
+#
+#   // The number of values in the population. Must be non-negative. This value
+#   // must equal the sum of the values in `bucket_counts` if a histogram is
+#   // provided.
+#   int64 count = 1;
+#
+#   // The arithmetic mean of the values in the population. If `count` is zero
+#   // then this field must be zero.
+#   double mean = 2;
+#
+#   // The sum of squared deviations from the mean of the values in the
+#   // population. For values x_i this is:
+#   //
+#   //     Sum[i=1..n]((x_i - mean)^2)
+#   //
+#   // Knuth, "The Art of Computer Programming", Vol. 2, page 232, 3rd edition
+#   // describes Welford's method for accumulating this sum in one pass.
+#   //
+#   // If `count` is zero then this field must be zero.
+#   double sum_of_squared_deviation = 3;
+#
+#   // If specified, contains the range of the population values. The field
+#   // must not be present if the `count` is zero.
+#   Range range = 4;
+#
+#   // Defines the histogram bucket boundaries. If the distribution does not
+#   // contain a histogram, then omit this field.
+#   BucketOptions bucket_options = 6;
+#
+#   // The number of values in each bucket of the histogram, as described in
+#   // `bucket_options`. If the distribution does not have a histogram, then omit
+#   // this field. If there is a histogram, then the sum of the values in
+#   // `bucket_counts` must equal the value in the `count` field of the
+#   // distribution.
+#   //
+#   // If present, `bucket_counts` should contain N values, where N is the number
+#   // of buckets specified in `bucket_options`. If you supply fewer than N
+#   // values, the remaining values are assumed to be 0.
+#   //
+#   // The order of the values in `bucket_counts` follows the bucket numbering
+#   // schemes described for the three bucket types. The first value must be the
+#   // count for the underflow bucket (number 0). The next N-2 values are the
+#   // counts for the finite buckets (number 1 through N-2). The N'th value in
+#   // `bucket_counts` is the count for the overflow bucket (number N-1).
+#   repeated int64 bucket_counts = 7;
+#
+#   // Must be in increasing order of `value` field.
+#   repeated Exemplar exemplars = 10;
+# }