google-cloud-service_management-v1 0.4.1 → 0.6.0

data/lib/google/cloud/service_management/v1/service_manager/rest.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "gapic/rest"
+require "gapic/config"
+require "gapic/config/method"
+
+require "google/cloud/service_management/v1/version"
+
+require "google/cloud/service_management/v1/service_manager/credentials"
+require "google/cloud/service_management/v1/service_manager/rest/operations"
+require "google/cloud/service_management/v1/service_manager/rest/client"
+
+module Google
+  module Cloud
+    module ServiceManagement
+      module V1
+        ##
+        # [Google Service Management
+        # API](https://cloud.google.com/service-infrastructure/docs/overview)
+        #
+        # To load this service and instantiate a REST client:
+        #
+        #     require "google/cloud/service_management/v1/service_manager/rest"
+        #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Rest::Client.new
+        #
+        module ServiceManager
+          # Client for the REST transport
+          module Rest
+          end
+        end
+      end
+    end
+  end
+end
+
+helper_path = ::File.join __dir__, "rest", "helpers.rb"
+require "google/cloud/service_management/v1/service_manager/rest/helpers" if ::File.file? helper_path

data/lib/google/cloud/service_management/v1/service_manager.rb

@@ -25,6 +25,7 @@ require "google/cloud/service_management/v1/version"
 require "google/cloud/service_management/v1/service_manager/credentials"
 require "google/cloud/service_management/v1/service_manager/operations"
 require "google/cloud/service_management/v1/service_manager/client"
+require "google/cloud/service_management/v1/service_manager/rest"
 
 module Google
   module Cloud
@@ -39,6 +40,11 @@ module Google
         #     require "google/cloud/service_management/v1/service_manager"
         #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
         #
+        # @example Load this service and instantiate a REST client
+        #
+        #     require "google/cloud/service_management/v1/service_manager/rest"
+        #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Rest::Client.new
+        #
         module ServiceManager
         end
       end

data/lib/google/cloud/service_management/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceManagement
       module V1
-        VERSION = "0.4.1"
+        VERSION = "0.6.0"
       end
     end
   end

data/lib/google/cloud/service_management/v1.rb

@@ -30,6 +30,11 @@ module Google
       #     require "google/cloud/service_management/v1"
       #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
       #
+      # @example Load this package, including all its services, and instantiate a REST client
+      #
+      #     require "google/cloud/service_management/v1"
+      #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Rest::Client.new
+      #
       module V1
       end
     end

data/proto_docs/google/api/auth.rb

@@ -63,7 +63,8 @@ module Google
     #   @return [::String]
     #     Selects the methods to which this rule applies.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] oauth
     #   @return [::Google::Api::OAuthRequirements]
     #     The requirements for OAuth credentials.

data/proto_docs/google/api/backend.rb

@@ -35,7 +35,8 @@ module Google
     #   @return [::String]
     #     Selects the methods to which this rule applies.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] address
     #   @return [::String]
     #     The address of the API backend.
@@ -105,10 +106,22 @@ module Google
     #     See
     #     https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids
     #     for more details on the supported values.
+    # @!attribute [rw] overrides_by_request_protocol
+    #   @return [::Google::Protobuf::Map{::String => ::Google::Api::BackendRule}]
+    #     The map between request protocol and the backend address.
     class BackendRule
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
 
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::Google::Api::BackendRule]
+      class OverridesByRequestProtocolEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
       # Path Translation specifies how to combine the backend address with the
       # request path in order to produce the appropriate forwarding URL for the
       # request.

data/proto_docs/google/api/billing.rb

@@ -66,11 +66,13 @@ module Google
       # @!attribute [rw] monitored_resource
       #   @return [::String]
       #     The monitored resource type. The type must be defined in
-      #     {::Google::Api::Service#monitored_resources Service.monitored_resources} section.
+      #     {::Google::Api::Service#monitored_resources Service.monitored_resources}
+      #     section.
       # @!attribute [rw] metrics
       #   @return [::Array<::String>]
       #     Names of the metrics to report to this billing destination.
-      #     Each name must be defined in {::Google::Api::Service#metrics Service.metrics} section.
+      #     Each name must be defined in
+      #     {::Google::Api::Service#metrics Service.metrics} section.
       class BillingDestination
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/client.rb

@@ -35,7 +35,9 @@ module Google
     # Details about how and where to publish client libraries.
     # @!attribute [rw] version
     #   @return [::String]
-    #     Version of the API to apply these settings to.
+    #     Version of the API to apply these settings to. This is the full protobuf
+    #     package for the API, ending in the version element.
+    #     Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
     # @!attribute [rw] launch_stage
     #   @return [::Google::Api::LaunchStage]
     #     Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -111,6 +113,10 @@ module Google
     #     Client library settings.  If the same version string appears multiple
     #     times in this list, then the last one wins.  Settings from earlier
     #     settings with the same version string are discarded.
+    # @!attribute [rw] proto_reference_documentation_uri
+    #   @return [::String]
+    #     Optional link to proto reference documentation.  Example:
+    #     https://cloud.google.com/pubsub/lite/docs/reference/rpc
     class Publishing
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
     #     Example of a YAML configuration::
     #
     #      publishing:
-    #        method_behavior:
-    #          - selector: CreateAdDomain
+    #        method_settings:
+    #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
     #              initial_poll_delay:
     #                seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

data/proto_docs/google/api/context.rb

@@ -71,7 +71,8 @@ module Google
     #   @return [::String]
     #     Selects the methods to which this rule applies.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] requested
     #   @return [::Array<::String>]
     #     A list of full type names of requested contexts.

data/proto_docs/google/api/logging.rb

@@ -69,13 +69,14 @@ module Google
       # @!attribute [rw] monitored_resource
       #   @return [::String]
       #     The monitored resource type. The type must be defined in the
-      #     {::Google::Api::Service#monitored_resources Service.monitored_resources} section.
+      #     {::Google::Api::Service#monitored_resources Service.monitored_resources}
+      #     section.
       # @!attribute [rw] logs
       #   @return [::Array<::String>]
       #     Names of the logs to be sent to this destination. Each name must
-      #     be defined in the {::Google::Api::Service#logs Service.logs} section. If the log name is
-      #     not a domain scoped name, it will be automatically prefixed with
-      #     the service name followed by "/".
+      #     be defined in the {::Google::Api::Service#logs Service.logs} section. If the
+      #     log name is not a domain scoped name, it will be automatically prefixed
+      #     with the service name followed by "/".
       class LoggingDestination
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/metric.rb

@@ -174,9 +174,10 @@ module Google
     #   @return [::Array<::String>]
     #     Read-only. If present, then a [time
     #     series][google.monitoring.v3.TimeSeries], which is identified partially by
-    #     a metric type and a {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}, that is associated
-    #     with this metric type can only be associated with one of the monitored
-    #     resource types listed here.
+    #     a metric type and a
+    #     {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}, that
+    #     is associated with this metric type can only be associated with one of the
+    #     monitored resource types listed here.
     class MetricDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -184,7 +185,9 @@ module Google
       # Additional annotations that can be used to guide the usage of a metric.
       # @!attribute [rw] launch_stage
       #   @return [::Google::Api::LaunchStage]
-      #     Deprecated. Must use the {::Google::Api::MetricDescriptor#launch_stage MetricDescriptor.launch_stage} instead.
+      #     Deprecated. Must use the
+      #     {::Google::Api::MetricDescriptor#launch_stage MetricDescriptor.launch_stage}
+      #     instead.
       # @!attribute [rw] sample_period
       #   @return [::Google::Protobuf::Duration]
       #     The sampling period of metric data points. For metrics which are written
@@ -253,8 +256,9 @@ module Google
     # labels of a {::Google::Api::MetricDescriptor `MetricDescriptor`}.
     # @!attribute [rw] type
     #   @return [::String]
-    #     An existing metric type, see {::Google::Api::MetricDescriptor google.api.MetricDescriptor}.
-    #     For example, `custom.googleapis.com/invoice/paid/amount`.
+    #     An existing metric type, see
+    #     {::Google::Api::MetricDescriptor google.api.MetricDescriptor}. For example,
+    #     `custom.googleapis.com/invoice/paid/amount`.
     # @!attribute [rw] labels
     #   @return [::Google::Protobuf::Map{::String => ::String}]
     #     The set of label values that uniquely identify this metric. All

data/proto_docs/google/api/monitored_resource.rb

@@ -19,9 +19,10 @@
 
 module Google
   module Api
-    # An object that describes the schema of a {::Google::Api::MonitoredResource MonitoredResource} object using a
-    # type name and a set of labels.  For example, the monitored resource
-    # descriptor for Google Compute Engine VM instances has a type of
+    # An object that describes the schema of a
+    # {::Google::Api::MonitoredResource MonitoredResource} object using a type name
+    # and a set of labels.  For example, the monitored resource descriptor for
+    # Google Compute Engine VM instances has a type of
     # `"gce_instance"` and specifies the use of the labels `"instance_id"` and
     # `"zone"` to identify particular VM instances.
     #
@@ -70,11 +71,13 @@ module Google
     # An object representing a resource that can be used for monitoring, logging,
     # billing, or other purposes. Examples include virtual machine instances,
     # databases, and storage devices such as disks. The `type` field identifies a
-    # {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object that describes the resource's
-    # schema. Information in the `labels` field identifies the actual resource and
-    # its attributes according to the schema. For example, a particular Compute
-    # Engine VM instance could be represented by the following object, because the
-    # {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for `"gce_instance"` has labels
+    # {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object
+    # that describes the resource's schema. Information in the `labels` field
+    # identifies the actual resource and its attributes according to the schema.
+    # For example, a particular Compute Engine VM instance could be represented by
+    # the following object, because the
+    # {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} for
+    # `"gce_instance"` has labels
     # `"project_id"`, `"instance_id"` and `"zone"`:
     #
     #     { "type": "gce_instance",
@@ -84,10 +87,12 @@ module Google
     # @!attribute [rw] type
     #   @return [::String]
     #     Required. The monitored resource type. This field must match
-    #     the `type` field of a {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor} object. For
-    #     example, the type of a Compute Engine VM instance is `gce_instance`.
-    #     Some descriptors include the service name in the type; for example,
-    #     the type of a Datastream stream is `datastream.googleapis.com/Stream`.
+    #     the `type` field of a
+    #     {::Google::Api::MonitoredResourceDescriptor MonitoredResourceDescriptor}
+    #     object. For example, the type of a Compute Engine VM instance is
+    #     `gce_instance`. Some descriptors include the service name in the type; for
+    #     example, the type of a Datastream stream is
+    #     `datastream.googleapis.com/Stream`.
     # @!attribute [rw] labels
     #   @return [::Google::Protobuf::Map{::String => ::String}]
     #     Required. Values for all of the labels listed in the associated monitored
@@ -107,12 +112,12 @@ module Google
       end
     end
 
-    # Auxiliary metadata for a {::Google::Api::MonitoredResource MonitoredResource} object.
-    # {::Google::Api::MonitoredResource MonitoredResource} objects contain the minimum set of information to
-    # uniquely identify a monitored resource instance. There is some other useful
-    # auxiliary metadata. Monitoring and Logging use an ingestion
-    # pipeline to extract metadata for cloud resources of all types, and store
-    # the metadata in this message.
+    # Auxiliary metadata for a {::Google::Api::MonitoredResource MonitoredResource}
+    # object. {::Google::Api::MonitoredResource MonitoredResource} objects contain the
+    # minimum set of information to uniquely identify a monitored resource
+    # instance. There is some other useful auxiliary metadata. Monitoring and
+    # Logging use an ingestion pipeline to extract metadata for cloud resources of
+    # all types, and store the metadata in this message.
     # @!attribute [rw] system_labels
     #   @return [::Google::Protobuf::Struct]
     #     Output only. Values for predefined system metadata labels.

data/proto_docs/google/api/monitoring.rb

@@ -96,11 +96,13 @@ module Google
       # @!attribute [rw] monitored_resource
       #   @return [::String]
       #     The monitored resource type. The type must be defined in
-      #     {::Google::Api::Service#monitored_resources Service.monitored_resources} section.
+      #     {::Google::Api::Service#monitored_resources Service.monitored_resources}
+      #     section.
       # @!attribute [rw] metrics
       #   @return [::Array<::String>]
       #     Types of the metrics to report to this monitoring destination.
-      #     Each type must be defined in {::Google::Api::Service#metrics Service.metrics} section.
+      #     Each type must be defined in
+      #     {::Google::Api::Service#metrics Service.metrics} section.
       class MonitoringDestination
         include ::Google::Protobuf::MessageExts
         extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/api/quota.rb

@@ -86,7 +86,8 @@ module Google
     #   @return [::String]
     #     Selects the methods to which this rule applies.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] metric_costs
     #   @return [::Google::Protobuf::Map{::String => ::Integer}]
     #     Metrics to update when the selected methods are called, and the associated

data/proto_docs/google/api/service.rb

@@ -74,10 +74,10 @@ module Google
     # @!attribute [rw] apis
     #   @return [::Array<::Google::Protobuf::Api>]
     #     A list of API interfaces exported by this service. Only the `name` field
-    #     of the {::Google::Protobuf::Api google.protobuf.Api} needs to be provided by the configuration
-    #     author, as the remaining fields will be derived from the IDL during the
-    #     normalization process. It is an error to specify an API interface here
-    #     which cannot be resolved against the associated IDL files.
+    #     of the {::Google::Protobuf::Api google.protobuf.Api} needs to be provided by
+    #     the configuration author, as the remaining fields will be derived from the
+    #     IDL during the normalization process. It is an error to specify an API
+    #     interface here which cannot be resolved against the associated IDL files.
     # @!attribute [rw] types
     #   @return [::Array<::Google::Protobuf::Type>]
     #     A list of all proto message types included in this API service.
@@ -135,7 +135,8 @@ module Google
     # @!attribute [rw] monitored_resources
     #   @return [::Array<::Google::Api::MonitoredResourceDescriptor>]
     #     Defines the monitored resources used by this service. This is required
-    #     by the {::Google::Api::Service#monitoring Service.monitoring} and {::Google::Api::Service#logging Service.logging} configurations.
+    #     by the {::Google::Api::Service#monitoring Service.monitoring} and
+    #     {::Google::Api::Service#logging Service.logging} configurations.
     # @!attribute [rw] billing
     #   @return [::Google::Api::Billing]
     #     Billing configuration.

data/proto_docs/google/api/system_parameter.rb

@@ -68,7 +68,8 @@ module Google
     #     Selects the methods to which this rule applies. Use '*' to indicate all
     #     methods in all APIs.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] parameters
     #   @return [::Array<::Google::Api::SystemParameter>]
     #     Define parameters. Multiple names may be defined for a parameter.

data/proto_docs/google/api/usage.rb

@@ -81,7 +81,8 @@ module Google
     #     Selects the methods to which this rule applies. Use '*' to indicate all
     #     methods in all APIs.
     #
-    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax details.
+    #     Refer to {::Google::Api::DocumentationRule#selector selector} for syntax
+    #     details.
     # @!attribute [rw] allow_unregistered_calls
     #   @return [::Boolean]
     #     If true, the selected method allows unregistered calls, e.g. calls

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/api.rb

@@ -148,7 +148,7 @@ module Google
     # The mixin construct implies that all methods in `AccessControl` are
     # also declared with same name and request/response types in
     # `Storage`. A documentation generator or annotation processor will
-    # see the effective `Storage.GetAcl` method after inheriting
+    # see the effective `Storage.GetAcl` method after inherting
     # documentation and annotations as follows:
     #
     #     service Storage {

data/proto_docs/google/protobuf/struct.rb

@@ -87,7 +87,7 @@ module Google
     # `NullValue` is a singleton enumeration to represent the null value for the
     # `Value` type union.
     #
-    #  The JSON representation for `NullValue` is JSON `null`.
+    # The JSON representation for `NullValue` is JSON `null`.
     module NullValue
       # Null value.
       NULL_VALUE = 0

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

data/proto_docs/google/protobuf/type.rb

@@ -38,6 +38,9 @@ module Google
     # @!attribute [rw] syntax
     #   @return [::Google::Protobuf::Syntax]
     #     The source syntax.
+    # @!attribute [rw] edition
+    #   @return [::String]
+    #     The source edition string, only valid when syntax is SYNTAX_EDITIONS.
     class Type
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -172,6 +175,9 @@ module Google
     # @!attribute [rw] syntax
     #   @return [::Google::Protobuf::Syntax]
     #     The source syntax.
+    # @!attribute [rw] edition
+    #   @return [::String]
+    #     The source edition string, only valid when syntax is SYNTAX_EDITIONS.
     class Enum
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -218,6 +224,9 @@ module Google
 
       # Syntax `proto3`.
       SYNTAX_PROTO3 = 1
+
+      # Syntax `editions`.
+      SYNTAX_EDITIONS = 2
     end
   end
 end