googleapis-common-protos-types 1.7.0 → 1.8.0

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;
+# }

data/lib/google/api/documentation_pb.rb

@@ -1,29 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/documentation.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/documentation.proto", :syntax => :proto3) do
-    add_message "google.api.Documentation" do
-      optional :summary, :string, 1
-      repeated :pages, :message, 5, "google.api.Page"
-      repeated :rules, :message, 3, "google.api.DocumentationRule"
-      optional :documentation_root_url, :string, 4
-      optional :service_root_url, :string, 6
-      optional :overview, :string, 2
-    end
-    add_message "google.api.DocumentationRule" do
-      optional :selector, :string, 1
-      optional :description, :string, 2
-      optional :deprecation_description, :string, 3
-    end
-    add_message "google.api.Page" do
-      optional :name, :string, 1
-      optional :content, :string, 2
-      repeated :subpages, :message, 3, "google.api.Page"
+
+descriptor_data = "\n\x1egoogle/api/documentation.proto\x12\ngoogle.api\"\xbb\x01\n\rDocumentation\x12\x0f\n\x07summary\x18\x01 \x01(\t\x12\x1f\n\x05pages\x18\x05 \x03(\x0b\x32\x10.google.api.Page\x12,\n\x05rules\x18\x03 \x03(\x0b\x32\x1d.google.api.DocumentationRule\x12\x1e\n\x16\x64ocumentation_root_url\x18\x04 \x01(\t\x12\x18\n\x10service_root_url\x18\x06 \x01(\t\x12\x10\n\x08overview\x18\x02 \x01(\t\"[\n\x11\x44ocumentationRule\x12\x10\n\x08selector\x18\x01 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x02 \x01(\t\x12\x1f\n\x17\x64\x65precation_description\x18\x03 \x01(\t\"I\n\x04Page\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\t\x12\"\n\x08subpages\x18\x03 \x03(\x0b\x32\x10.google.api.PageBt\n\x0e\x63om.google.apiB\x12\x44ocumentationProtoP\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
@@ -33,3 +38,174 @@ module Google
     Page = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.Page").msgclass
   end
 end
+
+#### Source proto file: google/api/documentation.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 = "DocumentationProto";
+# option java_package = "com.google.api";
+# option objc_class_prefix = "GAPI";
+#
+# // `Documentation` provides the information for describing a service.
+# //
+# // Example:
+# // <pre><code>documentation:
+# //   summary: >
+# //     The Google Calendar API gives access
+# //     to most calendar features.
+# //   pages:
+# //   - name: Overview
+# //     content: &#40;== include google/foo/overview.md ==&#41;
+# //   - name: Tutorial
+# //     content: &#40;== include google/foo/tutorial.md ==&#41;
+# //     subpages;
+# //     - name: Java
+# //       content: &#40;== include google/foo/tutorial_java.md ==&#41;
+# //   rules:
+# //   - selector: google.calendar.Calendar.Get
+# //     description: >
+# //       ...
+# //   - selector: google.calendar.Calendar.Put
+# //     description: >
+# //       ...
+# // </code></pre>
+# // Documentation is provided in markdown syntax. In addition to
+# // standard markdown features, definition lists, tables and fenced
+# // code blocks are supported. Section headers can be provided and are
+# // interpreted relative to the section nesting of the context where
+# // a documentation fragment is embedded.
+# //
+# // Documentation from the IDL is merged with documentation defined
+# // via the config at normalization time, where documentation provided
+# // by config rules overrides IDL provided.
+# //
+# // A number of constructs specific to the API platform are supported
+# // in documentation text.
+# //
+# // In order to reference a proto element, the following
+# // notation can be used:
+# // <pre><code>&#91;fully.qualified.proto.name]&#91;]</code></pre>
+# // To override the display text used for the link, this can be used:
+# // <pre><code>&#91;display text]&#91;fully.qualified.proto.name]</code></pre>
+# // Text can be excluded from doc using the following notation:
+# // <pre><code>&#40;-- internal comment --&#41;</code></pre>
+# //
+# // A few directives are available in documentation. Note that
+# // directives must appear on a single line to be properly
+# // identified. The `include` directive includes a markdown file from
+# // an external source:
+# // <pre><code>&#40;== include path/to/file ==&#41;</code></pre>
+# // The `resource_for` directive marks a message to be the resource of
+# // a collection in REST view. If it is not specified, tools attempt
+# // to infer the resource from the operations in a collection:
+# // <pre><code>&#40;== resource_for v1.shelves.books ==&#41;</code></pre>
+# // The directive `suppress_warning` does not directly affect documentation
+# // and is documented together with service config validation.
+# message Documentation {
+#   // A short description of what the service does. The summary must be plain
+#   // text. It becomes the overview of the service displayed in Google Cloud
+#   // Console.
+#   // NOTE: This field is equivalent to the standard field `description`.
+#   string summary = 1;
+#
+#   // The top level pages for the documentation set.
+#   repeated Page pages = 5;
+#
+#   // A list of documentation rules that apply to individual API elements.
+#   //
+#   // **NOTE:** All service configuration rules follow "last one wins" order.
+#   repeated DocumentationRule rules = 3;
+#
+#   // The URL to the root of documentation.
+#   string documentation_root_url = 4;
+#
+#   // Specifies the service root url if the default one (the service name
+#   // from the yaml file) is not suitable. This can be seen in any fully
+#   // specified service urls as well as sections that show a base that other
+#   // urls are relative to.
+#   string service_root_url = 6;
+#
+#   // Declares a single overview page. For example:
+#   // <pre><code>documentation:
+#   //   summary: ...
+#   //   overview: &#40;== include overview.md ==&#41;
+#   // </code></pre>
+#   // This is a shortcut for the following declaration (using pages style):
+#   // <pre><code>documentation:
+#   //   summary: ...
+#   //   pages:
+#   //   - name: Overview
+#   //     content: &#40;== include overview.md ==&#41;
+#   // </code></pre>
+#   // Note: you cannot specify both `overview` field and `pages` field.
+#   string overview = 2;
+# }
+#
+# // A documentation rule provides information about individual API elements.
+# message DocumentationRule {
+#   // The selector is a comma-separated list of patterns for any element such as
+#   // a method, a field, an enum value. Each pattern is a qualified name of the
+#   // element which may end in "*", indicating a wildcard. Wildcards are only
+#   // allowed at the end and for a whole component of the qualified name,
+#   // i.e. "foo.*" is ok, but not "foo.b*" or "foo.*.bar". A wildcard will match
+#   // one or more components. To specify a default for all applicable elements,
+#   // the whole pattern "*" is used.
+#   string selector = 1;
+#
+#   // Description of the selected proto element (e.g. a message, a method, a
+#   // 'service' definition, or a field). Defaults to leading & trailing comments
+#   // taken from the proto source definition of the proto element.
+#   string description = 2;
+#
+#   // Deprecation description of the selected element(s). It can be provided if
+#   // an element is marked as `deprecated`.
+#   string deprecation_description = 3;
+# }
+#
+# // Represents a documentation page. A page can contain subpages to represent
+# // nested documentation set structure.
+# message Page {
+#   // The name of the page. It will be used as an identity of the page to
+#   // generate URI of the page, text of the link to this page in navigation,
+#   // etc. The full page name (start from the root page name to this page
+#   // concatenated with `.`) can be used as reference to the page in your
+#   // documentation. For example:
+#   // <pre><code>pages:
+#   // - name: Tutorial
+#   //   content: &#40;== include tutorial.md ==&#41;
+#   //   subpages:
+#   //   - name: Java
+#   //     content: &#40;== include tutorial_java.md ==&#41;
+#   // </code></pre>
+#   // You can reference `Java` page using Markdown reference link syntax:
+#   // `[Java][Tutorial.Java]`.
+#   string name = 1;
+#
+#   // The Markdown content of the page. You can use <code>&#40;== include {path}
+#   // ==&#41;</code> to include content from a Markdown file. The content can be
+#   // used to produce the documentation page such as HTML format page.
+#   string content = 2;
+#
+#   // Subpages of this page. The order of subpages specified here will be
+#   // honored in the generated docset.
+#   repeated Page subpages = 3;
+# }

data/lib/google/api/endpoint_pb.rb

@@ -1,17 +1,34 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/endpoint.proto
 
 require 'google/protobuf'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/api/endpoint.proto", :syntax => :proto3) do
-    add_message "google.api.Endpoint" do
-      optional :name, :string, 1
-      repeated :aliases, :string, 2
-      optional :target, :string, 101
-      optional :allow_cors, :bool, 5
+
+descriptor_data = "\n\x19google/api/endpoint.proto\x12\ngoogle.api\"Q\n\x08\x45ndpoint\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x13\n\x07\x61liases\x18\x02 \x03(\tB\x02\x18\x01\x12\x0e\n\x06target\x18\x65 \x01(\t\x12\x12\n\nallow_cors\x18\x05 \x01(\x08\x42o\n\x0e\x63om.google.apiB\rEndpointProtoP\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
@@ -19,3 +36,79 @@ module Google
     Endpoint = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.Endpoint").msgclass
   end
 end
+
+#### Source proto file: google/api/endpoint.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 = "EndpointProto";
+# option java_package = "com.google.api";
+# option objc_class_prefix = "GAPI";
+#
+# // `Endpoint` describes a network address of a service that serves a set of
+# // APIs. It is commonly known as a service endpoint. A service may expose
+# // any number of service endpoints, and all service endpoints share the same
+# // service definition, such as quota limits and monitoring metrics.
+# //
+# // Example:
+# //
+# //     type: google.api.Service
+# //     name: library-example.googleapis.com
+# //     endpoints:
+# //       # Declares network address `https://library-example.googleapis.com`
+# //       # for service `library-example.googleapis.com`. The `https` scheme
+# //       # is implicit for all service endpoints. Other schemes may be
+# //       # supported in the future.
+# //     - name: library-example.googleapis.com
+# //       allow_cors: false
+# //     - name: content-staging-library-example.googleapis.com
+# //       # Allows HTTP OPTIONS calls to be passed to the API frontend, for it
+# //       # to decide whether the subsequent cross-origin request is allowed
+# //       # to proceed.
+# //       allow_cors: true
+# message Endpoint {
+#   // The canonical name of this endpoint.
+#   string name = 1;
+#
+#   // Unimplemented. Dot not use.
+#   //
+#   // DEPRECATED: This field is no longer supported. Instead of using aliases,
+#   // please specify multiple [google.api.Endpoint][google.api.Endpoint] for each
+#   // of the intended aliases.
+#   //
+#   // Additional names that this endpoint will be hosted on.
+#   repeated string aliases = 2 [deprecated = true];
+#
+#   // The specification of an Internet routable address of API frontend that will
+#   // handle requests to this [API
+#   // Endpoint](https://cloud.google.com/apis/design/glossary). It should be
+#   // either a valid IPv4 address or a fully-qualified domain name. For example,
+#   // "8.8.8.8" or "myservice.appspot.com".
+#   string target = 101;
+#
+#   // Allowing
+#   // [CORS](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing), aka
+#   // cross-domain traffic, would allow the backends served from this endpoint to
+#   // receive and respond to HTTP OPTIONS requests. The response will be used by
+#   // the browser to determine whether the subsequent cross-origin request is
+#   // allowed to proceed.
+#   bool allow_cors = 5;
+# }