google-cloud-service_management-v1 0.3.6 → 0.3.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08670dcd2436bd5ca038f3642bf032428700c9710456d0454d6e0a042c99d746'
-  data.tar.gz: 1a200a5d2a56cd10c2b9c55f92d63349512bdca63b93f67456af50edfcd1263e
+  metadata.gz: ec1222d9da72a94e95e79259fb66d969809d0df642ee30d0d818c7efa6fe1a22
+  data.tar.gz: d5675736c700851350a5c1dd50c2f61e275fb5f9dd2393f777995e85ac4f9be1
 SHA512:
-  metadata.gz: 86792cc0240a868dad3564ad3f0b1102a106a7032990732b95763458e0bbbd661efbea6d25573138f961681c3f00b3bfe4188948cd0c9c2ce5d59ead8720d8ff
-  data.tar.gz: 997c0cc69166353387d8cece94783a7161f69af48ac1c319853cfb8c005f237547a9aff599a9055b737220d941e86f501ec1e514237241740b38ec102807b7b6
+  metadata.gz: e9f25db1c9c234205b1d0d2b728736b80978fd441dea5efd502b64a7aeb8b274469ea46a9a17f64a450222ea72b30e145ca4816308a091e8cddbda0dcb126be6
+  data.tar.gz: 49ef15b4c801f448342a0cf0d96e962a41d1ae5614dc356d0037224331c400891c943fedaf9cae609a202f356fdc2b8e65f05f77d1302a26d4e1aa15de6a6246

data/.yardopts

@@ -1,5 +1,5 @@
 --no-private
---title="Service Management API V1 API"
+--title="Service Management V1 API"
 --exclude _pb\.rb$
 --markup markdown
 --markup-provider redcarpet

data/README.md

@@ -1,13 +1,13 @@
-# Ruby Client for the Service Management API V1 API
+# Ruby Client for the Service Management V1 API
 
-API Client library for the Service Management API V1 API
+API Client library for the Service Management V1 API
 
 Google Service Management allows service producers to publish their services on Google Cloud Platform so that they can be discovered and used by service consumers.
 
 https://github.com/googleapis/google-cloud-ruby
 
 This gem is a _versioned_ client. It provides basic client classes for a
-specific version of the Service Management API V1 API. Most users should consider using
+specific version of the Service Management V1 API. Most users should consider using
 the main client gem,
 [google-cloud-service_management](https://rubygems.org/gems/google-cloud-service_management).
 See the section below titled *Which client should I use?* for more information.
@@ -37,7 +37,7 @@ request = ::Google::Cloud::ServiceManagement::V1::ListServicesRequest.new # (req
 response = client.list_services request
 ```
 
-View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-service_management-v1/latest)
+View the [Client Library Documentation](https://cloud.google.com/ruby/docs/reference/google-cloud-service_management-v1/latest)
 for class and method documentation.
 
 See also the [Product Documentation](https://cloud.google.com/service-infrastructure/docs/overview/)

data/lib/google/api/servicemanagement/v1/resources_pb.rb

@@ -1,17 +1,9 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/api/servicemanagement/v1/resources.proto
 
-require 'google/api/annotations_pb'
 require 'google/api/config_change_pb'
 require 'google/api/field_behavior_pb'
-require 'google/api/metric_pb'
-require 'google/api/quota_pb'
-require 'google/api/service_pb'
-require 'google/longrunning/operations_pb'
-require 'google/protobuf/any_pb'
-require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/rpc/status_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do

data/lib/google/api/servicemanagement/v1/servicemanager_pb.rb

@@ -8,8 +8,6 @@ require 'google/api/service_pb'
 require 'google/api/servicemanagement/v1/resources_pb'
 require 'google/longrunning/operations_pb'
 require 'google/protobuf/any_pb'
-require 'google/protobuf/field_mask_pb'
-require 'google/rpc/status_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -87,18 +85,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :service_name, :string, 1
       optional :rollout_id, :string, 2
     end
-    add_message "google.api.servicemanagement.v1.EnableServiceRequest" do
-      optional :service_name, :string, 1
-      optional :consumer_id, :string, 2
-    end
-    add_message "google.api.servicemanagement.v1.EnableServiceResponse" do
-    end
-    add_message "google.api.servicemanagement.v1.DisableServiceRequest" do
-      optional :service_name, :string, 1
-      optional :consumer_id, :string, 2
-    end
-    add_message "google.api.servicemanagement.v1.DisableServiceResponse" do
-    end
     add_message "google.api.servicemanagement.v1.GenerateConfigReportRequest" do
       optional :new_config, :message, 1, "google.protobuf.Any"
       optional :old_config, :message, 2, "google.protobuf.Any"
@@ -134,10 +120,6 @@ module Google
         ListServiceRolloutsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.ListServiceRolloutsRequest").msgclass
         ListServiceRolloutsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.ListServiceRolloutsResponse").msgclass
         GetServiceRolloutRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.GetServiceRolloutRequest").msgclass
-        EnableServiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.EnableServiceRequest").msgclass
-        EnableServiceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.EnableServiceResponse").msgclass
-        DisableServiceRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.DisableServiceRequest").msgclass
-        DisableServiceResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.DisableServiceResponse").msgclass
         GenerateConfigReportRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.GenerateConfigReportRequest").msgclass
         GenerateConfigReportResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.api.servicemanagement.v1.GenerateConfigReportResponse").msgclass
       end

data/lib/google/api/servicemanagement/v1/servicemanager_services_pb.rb

@@ -1,7 +1,7 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # Source: google/api/servicemanagement/v1/servicemanager.proto for package 'Google.Cloud.ServiceManagement.V1'
 # Original file comments:
-# Copyright 2019 Google LLC.
+# Copyright 2022 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -24,7 +24,8 @@ module Google
     module ServiceManagement
       module V1
         module ServiceManager
-          # [Google Service Management API](https://cloud.google.com/service-management/overview)
+          # [Google Service Management
+          # API](https://cloud.google.com/service-infrastructure/docs/overview)
           class Service
 
             include ::GRPC::GenericService
@@ -38,23 +39,28 @@ module Google
             # Returns all public services. For authenticated users, also returns all
             # services the calling user has "servicemanagement.services.get" permission
             # for.
-            #
-            # **BETA:** If the caller specifies the `consumer_id`, it returns only the
-            # services enabled on the consumer. The `consumer_id` must have the format
-            # of "project:{PROJECT-ID}".
             rpc :ListServices, ::Google::Cloud::ServiceManagement::V1::ListServicesRequest, ::Google::Cloud::ServiceManagement::V1::ListServicesResponse
             # Gets a managed service. Authentication is required unless the service is
             # public.
             rpc :GetService, ::Google::Cloud::ServiceManagement::V1::GetServiceRequest, ::Google::Cloud::ServiceManagement::V1::ManagedService
             # Creates a new managed service.
-            # Please note one producer project can own no more than 20 services.
+            #
+            # A managed service is immutable, and is subject to mandatory 30-day
+            # data retention. You cannot move a service or recreate it within 30 days
+            # after deletion.
+            #
+            # One producer project can own no more than 500 services. For security and
+            # reliability purposes, a production service should be hosted in a
+            # dedicated producer project.
             #
             # Operation<response: ManagedService>
             rpc :CreateService, ::Google::Cloud::ServiceManagement::V1::CreateServiceRequest, ::Google::Longrunning::Operation
             # Deletes a managed service. This method will change the service to the
             # `Soft-Delete` state for 30 days. Within this period, service producers may
-            # call [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService] to restore the service.
-            # After 30 days, the service will be permanently deleted.
+            # call
+            # [UndeleteService][google.api.servicemanagement.v1.ServiceManager.UndeleteService]
+            # to restore the service. After 30 days, the service will be permanently
+            # deleted.
             #
             # Operation<response: google.protobuf.Empty>
             rpc :DeleteService, ::Google::Cloud::ServiceManagement::V1::DeleteServiceRequest, ::Google::Longrunning::Operation
@@ -85,7 +91,8 @@ module Google
             # Specification). This method stores the source configurations as well as the
             # generated service configuration. To rollout the service configuration to
             # other services,
-            # please call [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout].
+            # please call
+            # [CreateServiceRollout][google.api.servicemanagement.v1.ServiceManager.CreateServiceRollout].
             #
             # Only the 100 most recent configuration sources and ones referenced by
             # existing service configurtions are kept for each service. The rest will be
@@ -96,7 +103,8 @@ module Google
             # Lists the history of the service configuration rollouts for a managed
             # service, from the newest to the oldest.
             rpc :ListServiceRollouts, ::Google::Cloud::ServiceManagement::V1::ListServiceRolloutsRequest, ::Google::Cloud::ServiceManagement::V1::ListServiceRolloutsResponse
-            # Gets a service configuration [rollout][google.api.servicemanagement.v1.Rollout].
+            # Gets a service configuration
+            # [rollout][google.api.servicemanagement.v1.Rollout].
             rpc :GetServiceRollout, ::Google::Cloud::ServiceManagement::V1::GetServiceRolloutRequest, ::Google::Cloud::ServiceManagement::V1::Rollout
             # Creates a new service configuration rollout. Based on rollout, the
             # Google Service Management will roll out the service configurations to
@@ -125,19 +133,6 @@ module Google
             # will compare GenerateConfigReportRequest.new_value with the last pushed
             # service configuration.
             rpc :GenerateConfigReport, ::Google::Cloud::ServiceManagement::V1::GenerateConfigReportRequest, ::Google::Cloud::ServiceManagement::V1::GenerateConfigReportResponse
-            # Enables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can be used
-            # for the project. See
-            # [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for
-            # more information.
-            #
-            # Operation<response: EnableServiceResponse>
-            rpc :EnableService, ::Google::Cloud::ServiceManagement::V1::EnableServiceRequest, ::Google::Longrunning::Operation
-            # Disables a [service][google.api.servicemanagement.v1.ManagedService] for a project, so it can no longer be
-            # be used for the project. It prevents accidental usage that may cause
-            # unexpected billing charges or security leaks.
-            #
-            # Operation<response: DisableServiceResponse>
-            rpc :DisableService, ::Google::Cloud::ServiceManagement::V1::DisableServiceRequest, ::Google::Longrunning::Operation
           end
 
           Stub = Service.rpc_stub_class

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

@@ -27,7 +27,8 @@ module Google
           ##
           # Client for the ServiceManager service.
           #
-          # [Google Service Management API](https://cloud.google.com/service-management/overview)
+          # [Google Service Management
+          # API](https://cloud.google.com/service-infrastructure/docs/overview)
           #
           class Client
             # @private
@@ -62,6 +63,8 @@ module Google
                                 end
                 default_config = Client::Configuration.new parent_config
 
+                default_config.timeout = 10.0
+
                 default_config
               end
               yield @configure if block_given?
@@ -162,10 +165,6 @@ module Google
             # services the calling user has "servicemanagement.services.get" permission
             # for.
             #
-            # **BETA:** If the caller specifies the `consumer_id`, it returns only the
-            # services enabled on the consumer. The `consumer_id` must have the format
-            # of "project:\\{PROJECT-ID}".
-            #
             # @overload list_services(request, options = nil)
             #   Pass arguments to `list_services` via a request object, either of type
             #   {::Google::Cloud::ServiceManagement::V1::ListServicesRequest} or an equivalent Hash.
@@ -279,8 +278,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the `ServiceManager` overview for naming
-            #     requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the `ServiceManager` overview for
+            #     naming requirements.  For example: `example.googleapis.com`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::ServiceManagement::V1::ManagedService]
@@ -348,7 +347,14 @@ module Google
 
             ##
             # Creates a new managed service.
-            # Please note one producer project can own no more than 20 services.
+            #
+            # A managed service is immutable, and is subject to mandatory 30-day
+            # data retention. You cannot move a service or recreate it within 30 days
+            # after deletion.
+            #
+            # One producer project can own no more than 500 services. For security and
+            # reliability purposes, a production service should be hosted in a
+            # dedicated producer project.
             #
             # Operation<response: ManagedService>
             #
@@ -437,8 +443,10 @@ module Google
             ##
             # Deletes a managed service. This method will change the service to the
             # `Soft-Delete` state for 30 days. Within this period, service producers may
-            # call {::Google::Cloud::ServiceManagement::V1::ServiceManager::Client#undelete_service UndeleteService} to restore the service.
-            # After 30 days, the service will be permanently deleted.
+            # call
+            # {::Google::Cloud::ServiceManagement::V1::ServiceManager::Client#undelete_service UndeleteService}
+            # to restore the service. After 30 days, the service will be permanently
+            # deleted.
             #
             # Operation<response: google.protobuf.Empty>
             #
@@ -458,8 +466,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -557,8 +566,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements. For example: `example.googleapis.com`.
+            #     Required. The name of the service. See the
+            #     [overview](/service-management/overview) for naming requirements. For
+            #     example: `example.googleapis.com`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -652,8 +662,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param page_token [::String]
             #     The token of the page to retrieve.
             #   @param page_size [::Integer]
@@ -750,8 +761,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param config_id [::String]
             #     Required. The id of the service configuration resource.
             #
@@ -854,8 +866,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param service_config [::Google::Api::Service, ::Hash]
             #     Required. The service configuration resource.
             #
@@ -930,7 +943,8 @@ module Google
             # Specification). This method stores the source configurations as well as the
             # generated service configuration. To rollout the service configuration to
             # other services,
-            # please call {::Google::Cloud::ServiceManagement::V1::ServiceManager::Client#create_service_rollout CreateServiceRollout}.
+            # please call
+            # {::Google::Cloud::ServiceManagement::V1::ServiceManager::Client#create_service_rollout CreateServiceRollout}.
             #
             # Only the 100 most recent configuration sources and ones referenced by
             # existing service configurtions are kept for each service. The rest will be
@@ -954,8 +968,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param config_source [::Google::Cloud::ServiceManagement::V1::ConfigSource, ::Hash]
             #     Required. The source configuration for the service.
             #   @param validate_only [::Boolean]
@@ -1055,8 +1070,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param page_token [::String]
             #     The token of the page to retrieve.
             #   @param page_size [::Integer]
@@ -1144,7 +1160,8 @@ module Google
             end
 
             ##
-            # Gets a service configuration {::Google::Cloud::ServiceManagement::V1::Rollout rollout}.
+            # Gets a service configuration
+            # {::Google::Cloud::ServiceManagement::V1::Rollout rollout}.
             #
             # @overload get_service_rollout(request, options = nil)
             #   Pass arguments to `get_service_rollout` via a request object, either of type
@@ -1162,8 +1179,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param rollout_id [::String]
             #     Required. The id of the rollout resource.
             #
@@ -1266,8 +1284,9 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param service_name [::String]
-            #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-            #     for naming requirements.  For example: `example.googleapis.com`.
+            #     Required. The name of the service.  See the
+            #     [overview](/service-management/overview) for naming requirements.  For
+            #     example: `example.googleapis.com`.
             #   @param rollout [::Google::Cloud::ServiceManagement::V1::Rollout, ::Hash]
             #     Required. The rollout resource. The `service_name` field is output only.
             #
@@ -1440,227 +1459,6 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
-            ##
-            # Enables a {::Google::Cloud::ServiceManagement::V1::ManagedService service} for a project, so it can be used
-            # for the project. See
-            # [Cloud Auth Guide](https://cloud.google.com/docs/authentication) for
-            # more information.
-            #
-            # Operation<response: EnableServiceResponse>
-            #
-            # @deprecated This method is deprecated and may be removed in the next major version update.
-            #
-            # @overload enable_service(request, options = nil)
-            #   Pass arguments to `enable_service` via a request object, either of type
-            #   {::Google::Cloud::ServiceManagement::V1::EnableServiceRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ServiceManagement::V1::EnableServiceRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload enable_service(service_name: nil, consumer_id: nil)
-            #   Pass arguments to `enable_service` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param service_name [::String]
-            #     Required. Name of the service to enable. Specifying an unknown service name will
-            #     cause the request to fail.
-            #   @param consumer_id [::String]
-            #     Required. The identity of consumer resource which service enablement will be
-            #     applied to.
-            #
-            #     The Google Service Management implementation accepts the following
-            #     forms:
-            #     - "project:<project_id>"
-            #
-            #     Note: this is made compatible with
-            #     google.api.servicecontrol.v1.Operation.consumer_id.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::Operation]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::Operation]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/service_management/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ServiceManagement::V1::EnableServiceRequest.new
-            #
-            #   # Call the enable_service method.
-            #   result = client.enable_service request
-            #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
-            #   result.wait_until_done! timeout: 60
-            #   if result.response?
-            #     p result.response
-            #   else
-            #     puts "Error!"
-            #   end
-            #
-            def enable_service request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::EnableServiceRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.enable_service.metadata.to_h
-
-              # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.service_name
-                header_params["service_name"] = request.service_name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.enable_service.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.enable_service.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @service_manager_stub.call_rpc :enable_service, request, options: options do |response, operation|
-                response = ::Gapic::Operation.new response, @operations_client, options: options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
-            ##
-            # Disables a {::Google::Cloud::ServiceManagement::V1::ManagedService service} for a project, so it can no longer be
-            # be used for the project. It prevents accidental usage that may cause
-            # unexpected billing charges or security leaks.
-            #
-            # Operation<response: DisableServiceResponse>
-            #
-            # @deprecated This method is deprecated and may be removed in the next major version update.
-            #
-            # @overload disable_service(request, options = nil)
-            #   Pass arguments to `disable_service` via a request object, either of type
-            #   {::Google::Cloud::ServiceManagement::V1::DisableServiceRequest} or an equivalent Hash.
-            #
-            #   @param request [::Google::Cloud::ServiceManagement::V1::DisableServiceRequest, ::Hash]
-            #     A request object representing the call parameters. Required. To specify no
-            #     parameters, or to keep all the default parameter values, pass an empty Hash.
-            #   @param options [::Gapic::CallOptions, ::Hash]
-            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
-            #
-            # @overload disable_service(service_name: nil, consumer_id: nil)
-            #   Pass arguments to `disable_service` via keyword arguments. Note that at
-            #   least one keyword argument is required. To specify no parameters, or to keep all
-            #   the default parameter values, pass an empty Hash as a request object (see above).
-            #
-            #   @param service_name [::String]
-            #     Required. Name of the service to disable. Specifying an unknown service name
-            #     will cause the request to fail.
-            #   @param consumer_id [::String]
-            #     Required. The identity of consumer resource which service disablement will be
-            #     applied to.
-            #
-            #     The Google Service Management implementation accepts the following
-            #     forms:
-            #     - "project:<project_id>"
-            #
-            #     Note: this is made compatible with
-            #     google.api.servicecontrol.v1.Operation.consumer_id.
-            #
-            # @yield [response, operation] Access the result along with the RPC operation
-            # @yieldparam response [::Gapic::Operation]
-            # @yieldparam operation [::GRPC::ActiveCall::Operation]
-            #
-            # @return [::Gapic::Operation]
-            #
-            # @raise [::Google::Cloud::Error] if the RPC is aborted.
-            #
-            # @example Basic example
-            #   require "google/cloud/service_management/v1"
-            #
-            #   # Create a client object. The client can be reused for multiple calls.
-            #   client = Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
-            #
-            #   # Create a request. To set request fields, pass in keyword arguments.
-            #   request = Google::Cloud::ServiceManagement::V1::DisableServiceRequest.new
-            #
-            #   # Call the disable_service method.
-            #   result = client.disable_service request
-            #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
-            #   result.wait_until_done! timeout: 60
-            #   if result.response?
-            #     p result.response
-            #   else
-            #     puts "Error!"
-            #   end
-            #
-            def disable_service request, options = nil
-              raise ::ArgumentError, "request must be provided" if request.nil?
-
-              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::ServiceManagement::V1::DisableServiceRequest
-
-              # Converts hash and nil to an options object
-              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
-
-              # Customize the options with defaults
-              metadata = @config.rpcs.disable_service.metadata.to_h
-
-              # Set x-goog-api-client and x-goog-user-project headers
-              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
-                lib_name: @config.lib_name, lib_version: @config.lib_version,
-                gapic_version: ::Google::Cloud::ServiceManagement::V1::VERSION
-              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
-
-              header_params = {}
-              if request.service_name
-                header_params["service_name"] = request.service_name
-              end
-
-              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
-              metadata[:"x-goog-request-params"] ||= request_params_header
-
-              options.apply_defaults timeout:      @config.rpcs.disable_service.timeout,
-                                     metadata:     metadata,
-                                     retry_policy: @config.rpcs.disable_service.retry_policy
-
-              options.apply_defaults timeout:      @config.timeout,
-                                     metadata:     @config.metadata,
-                                     retry_policy: @config.retry_policy
-
-              @service_manager_stub.call_rpc :disable_service, request, options: options do |response, operation|
-                response = ::Gapic::Operation.new response, @operations_client, options: options
-                yield response, operation if block_given?
-                return response
-              end
-            rescue ::GRPC::BadStatus => e
-              raise ::Google::Cloud::Error.from_error(e)
-            end
-
             ##
             # Configuration class for the ServiceManager API.
             #
@@ -1861,16 +1659,6 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :generate_config_report
-                ##
-                # RPC-specific configuration for `enable_service`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :enable_service
-                ##
-                # RPC-specific configuration for `disable_service`
-                # @return [::Gapic::Config::Method]
-                #
-                attr_reader :disable_service
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -1900,10 +1688,6 @@ module Google
                   @create_service_rollout = ::Gapic::Config::Method.new create_service_rollout_config
                   generate_config_report_config = parent_rpcs.generate_config_report if parent_rpcs.respond_to? :generate_config_report
                   @generate_config_report = ::Gapic::Config::Method.new generate_config_report_config
-                  enable_service_config = parent_rpcs.enable_service if parent_rpcs.respond_to? :enable_service
-                  @enable_service = ::Gapic::Config::Method.new enable_service_config
-                  disable_service_config = parent_rpcs.disable_service if parent_rpcs.respond_to? :disable_service
-                  @disable_service = ::Gapic::Config::Method.new disable_service_config
 
                   yield self if block_given?
                 end

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

@@ -31,7 +31,8 @@ module Google
     module ServiceManagement
       module V1
         ##
-        # [Google Service Management API](https://cloud.google.com/service-management/overview)
+        # [Google Service Management
+        # API](https://cloud.google.com/service-infrastructure/docs/overview)
         #
         # To load this service and instantiate a client:
         #

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceManagement
       module V1
-        VERSION = "0.3.6"
+        VERSION = "0.3.9"
       end
     end
   end

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

@@ -25,6 +25,8 @@ module Google
       ##
       # To load this package, including all its services, and instantiate a client:
       #
+      # @example
+      #
       #     require "google/cloud/service_management/v1"
       #     client = ::Google::Cloud::ServiceManagement::V1::ServiceManager::Client.new
       #

data/proto_docs/README.md

@@ -1,4 +1,4 @@
-# Service Management API V1 Protocol Buffer Documentation
+# Service Management V1 Protocol Buffer Documentation
 
 These files are for the YARD documentation of the generated protobuf files.
 They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/servicemanagement/v1/resources.rb

@@ -25,7 +25,8 @@ module Google
         # Google Service Management.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
+        #     The name of the service. See the
+        #     [overview](https://cloud.google.com/service-infrastructure/docs/overview)
         #     for naming requirements.
         # @!attribute [rw] producer_project_id
         #   @return [::String]
@@ -204,8 +205,9 @@ module Google
         # service config, and then create a Rollout to push the service config.
         # @!attribute [rw] rollout_id
         #   @return [::String]
-        #     Optional. Unique identifier of this Rollout. Must be no longer than 63 characters
-        #     and only lower case letters, digits, '.', '_' and '-' are allowed.
+        #     Optional. Unique identifier of this Rollout. Must be no longer than 63
+        #     characters and only lower case letters, digits, '.', '_' and '-' are
+        #     allowed.
         #
         #     If not specified by client, the server will generate one. The generated id
         #     will have the form of <date><revision number>, where "date" is the create

data/proto_docs/google/api/servicemanagement/v1/servicemanager.rb

@@ -60,8 +60,8 @@ module Google
         # Request message for `GetService` method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the `ServiceManager` overview for naming
-        #     requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the `ServiceManager` overview for
+        #     naming requirements.  For example: `example.googleapis.com`.
         class GetServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -79,8 +79,9 @@ module Google
         # Request message for DeleteService method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         class DeleteServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,8 +90,9 @@ module Google
         # Request message for UndeleteService method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service. See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements. For example: `example.googleapis.com`.
+        #     Required. The name of the service. See the
+        #     [overview](/service-management/overview) for naming requirements. For
+        #     example: `example.googleapis.com`.
         class UndeleteServiceRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -108,8 +110,9 @@ module Google
         # Request message for GetServiceConfig method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] config_id
         #   @return [::String]
         #     Required. The id of the service configuration resource.
@@ -139,8 +142,9 @@ module Google
         # Request message for ListServiceConfigs method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The token of the page to retrieve.
@@ -168,8 +172,9 @@ module Google
         # Request message for CreateServiceConfig method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] service_config
         #   @return [::Google::Api::Service]
         #     Required. The service configuration resource.
@@ -181,8 +186,9 @@ module Google
         # Request message for SubmitConfigSource method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] config_source
         #   @return [::Google::Cloud::ServiceManagement::V1::ConfigSource]
         #     Required. The source configuration for the service.
@@ -208,8 +214,9 @@ module Google
         # Request message for 'CreateServiceRollout'
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] rollout
         #   @return [::Google::Cloud::ServiceManagement::V1::Rollout]
         #     Required. The rollout resource. The `service_name` field is output only.
@@ -221,8 +228,9 @@ module Google
         # Request message for 'ListServiceRollouts'
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     The token of the page to retrieve.
@@ -260,8 +268,9 @@ module Google
         # Request message for GetServiceRollout method.
         # @!attribute [rw] service_name
         #   @return [::String]
-        #     Required. The name of the service.  See the [overview](https://cloud.google.com/service-management/overview)
-        #     for naming requirements.  For example: `example.googleapis.com`.
+        #     Required. The name of the service.  See the
+        #     [overview](/service-management/overview) for naming requirements.  For
+        #     example: `example.googleapis.com`.
         # @!attribute [rw] rollout_id
         #   @return [::String]
         #     Required. The id of the rollout resource.
@@ -270,60 +279,6 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Request message for EnableService method.
-        # @!attribute [rw] service_name
-        #   @return [::String]
-        #     Required. Name of the service to enable. Specifying an unknown service name will
-        #     cause the request to fail.
-        # @!attribute [rw] consumer_id
-        #   @return [::String]
-        #     Required. The identity of consumer resource which service enablement will be
-        #     applied to.
-        #
-        #     The Google Service Management implementation accepts the following
-        #     forms:
-        #     - "project:<project_id>"
-        #
-        #     Note: this is made compatible with
-        #     google.api.servicecontrol.v1.Operation.consumer_id.
-        class EnableServiceRequest
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        end
-
-        # Operation payload for EnableService method.
-        class EnableServiceResponse
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        end
-
-        # Request message for DisableService method.
-        # @!attribute [rw] service_name
-        #   @return [::String]
-        #     Required. Name of the service to disable. Specifying an unknown service name
-        #     will cause the request to fail.
-        # @!attribute [rw] consumer_id
-        #   @return [::String]
-        #     Required. The identity of consumer resource which service disablement will be
-        #     applied to.
-        #
-        #     The Google Service Management implementation accepts the following
-        #     forms:
-        #     - "project:<project_id>"
-        #
-        #     Note: this is made compatible with
-        #     google.api.servicecontrol.v1.Operation.consumer_id.
-        class DisableServiceRequest
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        end
-
-        # Operation payload for DisableService method.
-        class DisableServiceResponse
-          include ::Google::Protobuf::MessageExts
-          extend ::Google::Protobuf::MessageExts::ClassMethods
-        end
-
         # Request message for GenerateConfigReport method.
         # @!attribute [rw] new_config
         #   @return [::Google::Protobuf::Any]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_management-v1
 version: !ruby/object:Gem::Version
-  version: 0.3.6
+  version: 0.3.9
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-11 00:00:00.000000000 Z
+date: 2022-04-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -210,7 +210,6 @@ files:
 - proto_docs/google/protobuf/api.rb
 - proto_docs/google/protobuf/duration.rb
 - proto_docs/google/protobuf/empty.rb
-- proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/source_context.rb
 - proto_docs/google/protobuf/struct.rb
 - proto_docs/google/protobuf/timestamp.rb
@@ -236,8 +235,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.4
+rubygems_version: 3.3.5
 signing_key: 
 specification_version: 4
-summary: API Client library for the Service Management API V1 API
+summary: API Client library for the Service Management V1 API
 test_files: []

data/proto_docs/google/protobuf/field_mask.rb

@@ -1,229 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2020 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!
-
-
-module Google
-  module Protobuf
-    # `FieldMask` represents a set of symbolic field paths, for example:
-    #
-    #     paths: "f.a"
-    #     paths: "f.b.d"
-    #
-    # Here `f` represents a field in some root message, `a` and `b`
-    # fields in the message found in `f`, and `d` a field found in the
-    # message in `f.b`.
-    #
-    # Field masks are used to specify a subset of fields that should be
-    # returned by a get operation or modified by an update operation.
-    # Field masks also have a custom JSON encoding (see below).
-    #
-    # # Field Masks in Projections
-    #
-    # When used in the context of a projection, a response message or
-    # sub-message is filtered by the API to only contain those fields as
-    # specified in the mask. For example, if the mask in the previous
-    # example is applied to a response message as follows:
-    #
-    #     f {
-    #       a : 22
-    #       b {
-    #         d : 1
-    #         x : 2
-    #       }
-    #       y : 13
-    #     }
-    #     z: 8
-    #
-    # The result will not contain specific values for fields x,y and z
-    # (their value will be set to the default, and omitted in proto text
-    # output):
-    #
-    #
-    #     f {
-    #       a : 22
-    #       b {
-    #         d : 1
-    #       }
-    #     }
-    #
-    # A repeated field is not allowed except at the last position of a
-    # paths string.
-    #
-    # If a FieldMask object is not present in a get operation, the
-    # operation applies to all fields (as if a FieldMask of all fields
-    # had been specified).
-    #
-    # Note that a field mask does not necessarily apply to the
-    # top-level response message. In case of a REST get operation, the
-    # field mask applies directly to the response, but in case of a REST
-    # list operation, the mask instead applies to each individual message
-    # in the returned resource list. In case of a REST custom method,
-    # other definitions may be used. Where the mask applies will be
-    # clearly documented together with its declaration in the API.  In
-    # any case, the effect on the returned resource/resources is required
-    # behavior for APIs.
-    #
-    # # Field Masks in Update Operations
-    #
-    # A field mask in update operations specifies which fields of the
-    # targeted resource are going to be updated. The API is required
-    # to only change the values of the fields as specified in the mask
-    # and leave the others untouched. If a resource is passed in to
-    # describe the updated values, the API ignores the values of all
-    # fields not covered by the mask.
-    #
-    # If a repeated field is specified for an update operation, new values will
-    # be appended to the existing repeated field in the target resource. Note that
-    # a repeated field is only allowed in the last position of a `paths` string.
-    #
-    # If a sub-message is specified in the last position of the field mask for an
-    # update operation, then new value will be merged into the existing sub-message
-    # in the target resource.
-    #
-    # For example, given the target message:
-    #
-    #     f {
-    #       b {
-    #         d: 1
-    #         x: 2
-    #       }
-    #       c: [1]
-    #     }
-    #
-    # And an update message:
-    #
-    #     f {
-    #       b {
-    #         d: 10
-    #       }
-    #       c: [2]
-    #     }
-    #
-    # then if the field mask is:
-    #
-    #  paths: ["f.b", "f.c"]
-    #
-    # then the result will be:
-    #
-    #     f {
-    #       b {
-    #         d: 10
-    #         x: 2
-    #       }
-    #       c: [1, 2]
-    #     }
-    #
-    # An implementation may provide options to override this default behavior for
-    # repeated and message fields.
-    #
-    # In order to reset a field's value to the default, the field must
-    # be in the mask and set to the default value in the provided resource.
-    # Hence, in order to reset all fields of a resource, provide a default
-    # instance of the resource and set all fields in the mask, or do
-    # not provide a mask as described below.
-    #
-    # If a field mask is not present on update, the operation applies to
-    # all fields (as if a field mask of all fields has been specified).
-    # Note that in the presence of schema evolution, this may mean that
-    # fields the client does not know and has therefore not filled into
-    # the request will be reset to their default. If this is unwanted
-    # behavior, a specific service may require a client to always specify
-    # a field mask, producing an error if not.
-    #
-    # As with get operations, the location of the resource which
-    # describes the updated values in the request message depends on the
-    # operation kind. In any case, the effect of the field mask is
-    # required to be honored by the API.
-    #
-    # ## Considerations for HTTP REST
-    #
-    # The HTTP kind of an update operation which uses a field mask must
-    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
-    # (PUT must only be used for full updates).
-    #
-    # # JSON Encoding of Field Masks
-    #
-    # In JSON, a field mask is encoded as a single string where paths are
-    # separated by a comma. Fields name in each path are converted
-    # to/from lower-camel naming conventions.
-    #
-    # As an example, consider the following message declarations:
-    #
-    #     message Profile {
-    #       User user = 1;
-    #       Photo photo = 2;
-    #     }
-    #     message User {
-    #       string display_name = 1;
-    #       string address = 2;
-    #     }
-    #
-    # In proto a field mask for `Profile` may look as such:
-    #
-    #     mask {
-    #       paths: "user.display_name"
-    #       paths: "photo"
-    #     }
-    #
-    # In JSON, the same mask is represented as below:
-    #
-    #     {
-    #       mask: "user.displayName,photo"
-    #     }
-    #
-    # # Field Masks and Oneof Fields
-    #
-    # Field masks treat fields in oneofs just as regular fields. Consider the
-    # following message:
-    #
-    #     message SampleMessage {
-    #       oneof test_oneof {
-    #         string name = 4;
-    #         SubMessage sub_message = 9;
-    #       }
-    #     }
-    #
-    # The field mask can be:
-    #
-    #     mask {
-    #       paths: "name"
-    #     }
-    #
-    # Or:
-    #
-    #     mask {
-    #       paths: "sub_message"
-    #     }
-    #
-    # Note that oneof type names ("test_oneof" in this case) cannot be used in
-    # paths.
-    #
-    # ## Field Mask Verification
-    #
-    # The implementation of any API method which has a FieldMask type field in the
-    # request should verify the included field paths, and return an
-    # `INVALID_ARGUMENT` error if any path is unmappable.
-    # @!attribute [rw] paths
-    #   @return [::Array<::String>]
-    #     The set of field mask paths.
-    class FieldMask
-      include ::Google::Protobuf::MessageExts
-      extend ::Google::Protobuf::MessageExts::ClassMethods
-    end
-  end
-end