google-cloud-advisory_notifications-v1 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae8aa38cff67aeb75b6b746b95509c0149c18ab243d036dfe97499153d2465d7
-  data.tar.gz: 1838a9e83c521771a07298d3bb4631bf89a703e78998a5de0b7e9bbd36ff3ee3
+  metadata.gz: c4686ad87bde5a52207fbb53dee9c79fee6e851125ef300e4e86601bc9d3d702
+  data.tar.gz: 1cbd5e1af7a672059957b1fc9a8e5317d41a2e97936de9ffdf59f2525cc24607
 SHA512:
-  metadata.gz: 727a1d815f083de18fd01700d0edc4e2051c4aed890bf1fc0730a5b2e58d5b1a7ce7a2eb6b09c6ed1c6bd9bb1431823cb6db7c74121a698ca28d4043774e56a1
-  data.tar.gz: c28c87ca71df3486f127847fc22e514a2de5a144db59d7f3835dad07e2742e21d2c561778ad2305dc61e27f7cfb40bbd0807ce9b4f3c32b52ff5da6e64ff064c
+  metadata.gz: a72db8d741b1658b0b8d20c58c54f445fc55e1102990eee4de67a2cf65da476ed4e6cf3e09f641baf3784b18574278ecb3df0cc0e850cbb9b46c27753cf7ba92
+  data.tar.gz: 6d38d2aad090987c4966dd7c122fe54bbb9f8e4b0eac277090bac6edafce423b1e426eba87047fa159206673ba4c07d322c004650616e4fb8c1f091dfa16e788

data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/client.rb

@@ -357,6 +357,178 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Get notification settings.
+            #
+            # @overload get_settings(request, options = nil)
+            #   Pass arguments to `get_settings` via a request object, either of type
+            #   {::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest, ::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 get_settings(name: nil)
+            #   Pass arguments to `get_settings` 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 name [::String]
+            #     Required. The resource name of the settings to retrieve.
+            #     Format:
+            #     organizations/\\{organization}/locations/\\{location}/settings.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/advisory_notifications/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::AdvisoryNotifications::V1::AdvisoryNotificationsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest.new
+            #
+            #   # Call the get_settings method.
+            #   result = client.get_settings request
+            #
+            #   # The returned object is of type Google::Cloud::AdvisoryNotifications::V1::Settings.
+            #   p result
+            #
+            def get_settings request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest
+
+              # 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.get_settings.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::AdvisoryNotifications::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.name
+                header_params["name"] = request.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.get_settings.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.get_settings.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @advisory_notifications_service_stub.call_rpc :get_settings, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
+            ##
+            # Update notification settings.
+            #
+            # @overload update_settings(request, options = nil)
+            #   Pass arguments to `update_settings` via a request object, either of type
+            #   {::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest, ::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 update_settings(settings: nil)
+            #   Pass arguments to `update_settings` 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 settings [::Google::Cloud::AdvisoryNotifications::V1::Settings, ::Hash]
+            #     Required. New settings.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC is aborted.
+            #
+            # @example Basic example
+            #   require "google/cloud/advisory_notifications/v1"
+            #
+            #   # Create a client object. The client can be reused for multiple calls.
+            #   client = Google::Cloud::AdvisoryNotifications::V1::AdvisoryNotificationsService::Client.new
+            #
+            #   # Create a request. To set request fields, pass in keyword arguments.
+            #   request = Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest.new
+            #
+            #   # Call the update_settings method.
+            #   result = client.update_settings request
+            #
+            #   # The returned object is of type Google::Cloud::AdvisoryNotifications::V1::Settings.
+            #   p result
+            #
+            def update_settings request, options = nil
+              raise ::ArgumentError, "request must be provided" if request.nil?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest
+
+              # 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.update_settings.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::AdvisoryNotifications::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.settings&.name
+                header_params["settings.name"] = request.settings.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.update_settings.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.update_settings.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @advisory_notifications_service_stub.call_rpc :update_settings, request, options: options do |response, operation|
+                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 AdvisoryNotificationsService API.
             #
@@ -512,6 +684,16 @@ module Google
                 # @return [::Gapic::Config::Method]
                 #
                 attr_reader :get_notification
+                ##
+                # RPC-specific configuration for `get_settings`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :get_settings
+                ##
+                # RPC-specific configuration for `update_settings`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :update_settings
 
                 # @private
                 def initialize parent_rpcs = nil
@@ -519,6 +701,10 @@ module Google
                   @list_notifications = ::Gapic::Config::Method.new list_notifications_config
                   get_notification_config = parent_rpcs.get_notification if parent_rpcs.respond_to? :get_notification
                   @get_notification = ::Gapic::Config::Method.new get_notification_config
+                  get_settings_config = parent_rpcs.get_settings if parent_rpcs.respond_to? :get_settings
+                  @get_settings = ::Gapic::Config::Method.new get_settings_config
+                  update_settings_config = parent_rpcs.update_settings if parent_rpcs.respond_to? :update_settings
+                  @update_settings = ::Gapic::Config::Method.new update_settings_config
 
                   yield self if block_given?
                 end

data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/paths.rb

@@ -60,6 +60,23 @@ module Google
               "organizations/#{organization}/locations/#{location}/notifications/#{notification}"
             end
 
+            ##
+            # Create a fully-qualified Settings resource string.
+            #
+            # The resource will be in the following format:
+            #
+            # `organizations/{organization}/locations/{location}/settings`
+            #
+            # @param organization [String]
+            # @param location [String]
+            #
+            # @return [::String]
+            def settings_path organization:, location:
+              raise ::ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+
+              "organizations/#{organization}/locations/#{location}/settings"
+            end
+
             extend self
           end
         end

data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/rest/client.rb

@@ -333,6 +333,164 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Get notification settings.
+              #
+              # @overload get_settings(request, options = nil)
+              #   Pass arguments to `get_settings` via a request object, either of type
+              #   {::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest, ::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 get_settings(name: nil)
+              #   Pass arguments to `get_settings` 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 name [::String]
+              #     Required. The resource name of the settings to retrieve.
+              #     Format:
+              #     organizations/\\{organization}/locations/\\{location}/settings.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/advisory_notifications/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::AdvisoryNotifications::V1::AdvisoryNotificationsService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest.new
+              #
+              #   # Call the get_settings method.
+              #   result = client.get_settings request
+              #
+              #   # The returned object is of type Google::Cloud::AdvisoryNotifications::V1::Settings.
+              #   p result
+              #
+              def get_settings request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest
+
+                # 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
+                call_metadata = @config.rpcs.get_settings.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                call_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::AdvisoryNotifications::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.get_settings.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.get_settings.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @advisory_notifications_service_stub.get_settings request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
+              ##
+              # Update notification settings.
+              #
+              # @overload update_settings(request, options = nil)
+              #   Pass arguments to `update_settings` via a request object, either of type
+              #   {::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest, ::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 update_settings(settings: nil)
+              #   Pass arguments to `update_settings` 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 settings [::Google::Cloud::AdvisoryNotifications::V1::Settings, ::Hash]
+              #     Required. New settings.
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              #
+              # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/advisory_notifications/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::AdvisoryNotifications::V1::AdvisoryNotificationsService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest.new
+              #
+              #   # Call the update_settings method.
+              #   result = client.update_settings request
+              #
+              #   # The returned object is of type Google::Cloud::AdvisoryNotifications::V1::Settings.
+              #   p result
+              #
+              def update_settings request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest
+
+                # 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
+                call_metadata = @config.rpcs.update_settings.metadata.to_h
+
+                # Set x-goog-api-client and x-goog-user-project headers
+                call_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::AdvisoryNotifications::V1::VERSION,
+                  transports_version_send: [:rest]
+
+                call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.update_settings.timeout,
+                                       metadata:     call_metadata,
+                                       retry_policy: @config.rpcs.update_settings.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @advisory_notifications_service_stub.update_settings request, options do |result, operation|
+                  yield result, operation if block_given?
+                  return result
+                end
+              rescue ::Gapic::Rest::Error => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the AdvisoryNotificationsService REST API.
               #
@@ -468,6 +626,16 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :get_notification
+                  ##
+                  # RPC-specific configuration for `get_settings`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :get_settings
+                  ##
+                  # RPC-specific configuration for `update_settings`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :update_settings
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -475,6 +643,10 @@ module Google
                     @list_notifications = ::Gapic::Config::Method.new list_notifications_config
                     get_notification_config = parent_rpcs.get_notification if parent_rpcs.respond_to? :get_notification
                     @get_notification = ::Gapic::Config::Method.new get_notification_config
+                    get_settings_config = parent_rpcs.get_settings if parent_rpcs.respond_to? :get_settings
+                    @get_settings = ::Gapic::Config::Method.new get_settings_config
+                    update_settings_config = parent_rpcs.update_settings if parent_rpcs.respond_to? :update_settings
+                    @update_settings = ::Gapic::Config::Method.new update_settings_config
 
                     yield self if block_given?
                   end

data/lib/google/cloud/advisory_notifications/v1/advisory_notifications_service/rest/service_stub.rb

@@ -116,6 +116,82 @@ module Google
                 result
               end
 
+              ##
+              # Baseline implementation for the get_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              #   A result object deserialized from the server's reply
+              def get_settings request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_get_settings_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri:     uri,
+                  body:    body || "",
+                  params:  query_string_params,
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::AdvisoryNotifications::V1::Settings.decode_json response.body, ignore_unknown_fields: true
+
+                yield result, operation if block_given?
+                result
+              end
+
+              ##
+              # Baseline implementation for the update_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @param options [::Gapic::CallOptions]
+              #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+              #
+              # @yield [result, operation] Access the result along with the TransportOperation object
+              # @yieldparam result [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              # @yieldparam operation [::Gapic::Rest::TransportOperation]
+              #
+              # @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+              #   A result object deserialized from the server's reply
+              def update_settings request_pb, options = nil
+                raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                verb, uri, query_string_params, body = ServiceStub.transcode_update_settings_request request_pb
+                query_string_params = if query_string_params.any?
+                                        query_string_params.to_h { |p| p.split "=", 2 }
+                                      else
+                                        {}
+                                      end
+
+                response = @client_stub.make_http_request(
+                  verb,
+                  uri:     uri,
+                  body:    body || "",
+                  params:  query_string_params,
+                  options: options
+                )
+                operation = ::Gapic::Rest::TransportOperation.new response
+                result = ::Google::Cloud::AdvisoryNotifications::V1::Settings.decode_json response.body, ignore_unknown_fields: true
+
+                yield result, operation if block_given?
+                result
+              end
+
               ##
               # @private
               #
@@ -157,6 +233,49 @@ module Google
                                                         )
                 transcoder.transcode request_pb
               end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the get_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_get_settings_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :get,
+                                                          uri_template: "/v1/{name}",
+                                                          matches: [
+                                                            ["name", %r{^organizations/[^/]+/locations/[^/]+/settings/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
+
+              ##
+              # @private
+              #
+              # GRPC transcoding helper method for the update_settings REST call
+              #
+              # @param request_pb [::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest]
+              #   A request object representing the call parameters. Required.
+              # @return [Array(String, [String, nil], Hash{String => String})]
+              #   Uri, Body, Query string parameters
+              def self.transcode_update_settings_request request_pb
+                transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                        .with_bindings(
+                                                          uri_method: :patch,
+                                                          uri_template: "/v1/{settings.name}",
+                                                          body: "settings",
+                                                          matches: [
+                                                            ["settings.name", %r{^organizations/[^/]+/locations/[^/]+/settings/?$}, false]
+                                                          ]
+                                                        )
+                transcoder.transcode request_pb
+              end
             end
           end
         end

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module AdvisoryNotifications
       module V1
-        VERSION = "0.5.0"
+        VERSION = "0.6.0"
       end
     end
   end

data/lib/google/cloud/advisorynotifications/v1/service_pb.rb

@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
 require 'google/protobuf/timestamp_pb'
 
 
-descriptor_data = "\n3google/cloud/advisorynotifications/v1/service.proto\x12%google.cloud.advisorynotifications.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xd0\x03\n\x0cNotification\x12\x0c\n\x04name\x18\x01 \x01(\t\x12?\n\x07subject\x18\x02 \x01(\x0b\x32..google.cloud.advisorynotifications.v1.Subject\x12@\n\x08messages\x18\x03 \x03(\x0b\x32..google.cloud.advisorynotifications.v1.Message\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12R\n\x11notification_type\x18\x0c \x01(\x0e\x32\x37.google.cloud.advisorynotifications.v1.NotificationType:\xa4\x01\xea\x41\xa0\x01\n1advisorynotifications.googleapis.com/Notification\x12Norganizations/{organization}/locations/{location}/notifications/{notification}*\rnotifications2\x0cnotification\"\x85\x01\n\x04Text\x12\x0f\n\x07\x65n_text\x18\x01 \x01(\t\x12\x16\n\x0elocalized_text\x18\x02 \x01(\t\x12T\n\x12localization_state\x18\x03 \x01(\x0e\x32\x38.google.cloud.advisorynotifications.v1.LocalizationState\"D\n\x07Subject\x12\x39\n\x04text\x18\x01 \x01(\x0b\x32+.google.cloud.advisorynotifications.v1.Text\"\xbf\x02\n\x07Message\x12\x41\n\x04\x62ody\x18\x01 \x01(\x0b\x32\x33.google.cloud.advisorynotifications.v1.Message.Body\x12\x46\n\x0b\x61ttachments\x18\x02 \x03(\x0b\x32\x31.google.cloud.advisorynotifications.v1.Attachment\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11localization_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a\x41\n\x04\x42ody\x12\x39\n\x04text\x18\x01 \x01(\x0b\x32+.google.cloud.advisorynotifications.v1.Text\"e\n\nAttachment\x12\x39\n\x03\x63sv\x18\x02 \x01(\x0b\x32*.google.cloud.advisorynotifications.v1.CsvH\x00\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04\x64\x61ta\"w\n\x03\x43sv\x12\x0f\n\x07headers\x18\x01 \x03(\t\x12\x44\n\tdata_rows\x18\x02 \x03(\x0b\x32\x31.google.cloud.advisorynotifications.v1.Csv.CsvRow\x1a\x19\n\x06\x43svRow\x12\x0f\n\x07\x65ntries\x18\x01 \x03(\t\"\xea\x01\n\x18ListNotificationsRequest\x12I\n\x06parent\x18\x01 \x01(\tB9\xe0\x41\x02\xfa\x41\x33\x12\x31\x61\x64visorynotifications.googleapis.com/Notification\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x45\n\x04view\x18\x04 \x01(\x0e\x32\x37.google.cloud.advisorynotifications.v1.NotificationView\x12\x15\n\rlanguage_code\x18\x05 \x01(\t\"\x94\x01\n\x19ListNotificationsResponse\x12J\n\rnotifications\x18\x01 \x03(\x0b\x32\x33.google.cloud.advisorynotifications.v1.Notification\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05\"x\n\x16GetNotificationRequest\x12G\n\x04name\x18\x01 \x01(\tB9\xe0\x41\x02\xfa\x41\x33\n1advisorynotifications.googleapis.com/Notification\x12\x15\n\rlanguage_code\x18\x05 \x01(\t*J\n\x10NotificationView\x12!\n\x1dNOTIFICATION_VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02*\xa0\x01\n\x11LocalizationState\x12\"\n\x1eLOCALIZATION_STATE_UNSPECIFIED\x10\x00\x12%\n!LOCALIZATION_STATE_NOT_APPLICABLE\x10\x01\x12\x1e\n\x1aLOCALIZATION_STATE_PENDING\x10\x02\x12 \n\x1cLOCALIZATION_STATE_COMPLETED\x10\x03*\xda\x01\n\x10NotificationType\x12!\n\x1dNOTIFICATION_TYPE_UNSPECIFIED\x10\x00\x12/\n+NOTIFICATION_TYPE_SECURITY_PRIVACY_ADVISORY\x10\x01\x12\'\n#NOTIFICATION_TYPE_SENSITIVE_ACTIONS\x10\x02\x12\"\n\x1eNOTIFICATION_TYPE_SECURITY_MSA\x10\x03\x12%\n!NOTIFICATION_TYPE_THREAT_HORIZONS\x10\x04\x32\xa9\x04\n\x1c\x41\x64visoryNotificationsService\x12\xdf\x01\n\x11ListNotifications\x12?.google.cloud.advisorynotifications.v1.ListNotificationsRequest\x1a@.google.cloud.advisorynotifications.v1.ListNotificationsResponse\"G\x82\xd3\xe4\x93\x02\x38\x12\x36/v1/{parent=organizations/*/locations/*}/notifications\xda\x41\x06parent\x12\xcc\x01\n\x0fGetNotification\x12=.google.cloud.advisorynotifications.v1.GetNotificationRequest\x1a\x33.google.cloud.advisorynotifications.v1.Notification\"E\x82\xd3\xe4\x93\x02\x38\x12\x36/v1/{name=organizations/*/locations/*/notifications/*}\xda\x41\x04name\x1aX\xca\x41$advisorynotifications.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xfc\x02\n)com.google.cloud.advisorynotifications.v1B\x0cServiceProtoP\x01Z_cloud.google.com/go/advisorynotifications/apiv1/advisorynotificationspb;advisorynotificationspb\xaa\x02%Google.Cloud.AdvisoryNotifications.V1\xca\x02%Google\\Cloud\\AdvisoryNotifications\\V1\xea\x02(Google::Cloud::AdvisoryNotifications::V1\xea\x41\x62\n-advisorynotifications.googleapis.com/Location\x12\x31organizations/{organization}/locations/{location}b\x06proto3"
+descriptor_data = "\n3google/cloud/advisorynotifications/v1/service.proto\x12%google.cloud.advisorynotifications.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xd0\x03\n\x0cNotification\x12\x0c\n\x04name\x18\x01 \x01(\t\x12?\n\x07subject\x18\x02 \x01(\x0b\x32..google.cloud.advisorynotifications.v1.Subject\x12@\n\x08messages\x18\x03 \x03(\x0b\x32..google.cloud.advisorynotifications.v1.Message\x12\x34\n\x0b\x63reate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12R\n\x11notification_type\x18\x0c \x01(\x0e\x32\x37.google.cloud.advisorynotifications.v1.NotificationType:\xa4\x01\xea\x41\xa0\x01\n1advisorynotifications.googleapis.com/Notification\x12Norganizations/{organization}/locations/{location}/notifications/{notification}*\rnotifications2\x0cnotification\"\x85\x01\n\x04Text\x12\x0f\n\x07\x65n_text\x18\x01 \x01(\t\x12\x16\n\x0elocalized_text\x18\x02 \x01(\t\x12T\n\x12localization_state\x18\x03 \x01(\x0e\x32\x38.google.cloud.advisorynotifications.v1.LocalizationState\"D\n\x07Subject\x12\x39\n\x04text\x18\x01 \x01(\x0b\x32+.google.cloud.advisorynotifications.v1.Text\"\xbf\x02\n\x07Message\x12\x41\n\x04\x62ody\x18\x01 \x01(\x0b\x32\x33.google.cloud.advisorynotifications.v1.Message.Body\x12\x46\n\x0b\x61ttachments\x18\x02 \x03(\x0b\x32\x31.google.cloud.advisorynotifications.v1.Attachment\x12/\n\x0b\x63reate_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x35\n\x11localization_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x1a\x41\n\x04\x42ody\x12\x39\n\x04text\x18\x01 \x01(\x0b\x32+.google.cloud.advisorynotifications.v1.Text\"e\n\nAttachment\x12\x39\n\x03\x63sv\x18\x02 \x01(\x0b\x32*.google.cloud.advisorynotifications.v1.CsvH\x00\x12\x14\n\x0c\x64isplay_name\x18\x01 \x01(\tB\x06\n\x04\x64\x61ta\"w\n\x03\x43sv\x12\x0f\n\x07headers\x18\x01 \x03(\t\x12\x44\n\tdata_rows\x18\x02 \x03(\x0b\x32\x31.google.cloud.advisorynotifications.v1.Csv.CsvRow\x1a\x19\n\x06\x43svRow\x12\x0f\n\x07\x65ntries\x18\x01 \x03(\t\"\xea\x01\n\x18ListNotificationsRequest\x12I\n\x06parent\x18\x01 \x01(\tB9\xe0\x41\x02\xfa\x41\x33\x12\x31\x61\x64visorynotifications.googleapis.com/Notification\x12\x11\n\tpage_size\x18\x02 \x01(\x05\x12\x12\n\npage_token\x18\x03 \x01(\t\x12\x45\n\x04view\x18\x04 \x01(\x0e\x32\x37.google.cloud.advisorynotifications.v1.NotificationView\x12\x15\n\rlanguage_code\x18\x05 \x01(\t\"\x94\x01\n\x19ListNotificationsResponse\x12J\n\rnotifications\x18\x01 \x03(\x0b\x32\x33.google.cloud.advisorynotifications.v1.Notification\x12\x17\n\x0fnext_page_token\x18\x02 \x01(\t\x12\x12\n\ntotal_size\x18\x03 \x01(\x05\"x\n\x16GetNotificationRequest\x12G\n\x04name\x18\x01 \x01(\tB9\xe0\x41\x02\xfa\x41\x33\n1advisorynotifications.googleapis.com/Notification\x12\x15\n\rlanguage_code\x18\x05 \x01(\t\"\x89\x03\n\x08Settings\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x03\x12m\n\x15notification_settings\x18\x02 \x03(\x0b\x32I.google.cloud.advisorynotifications.v1.Settings.NotificationSettingsEntryB\x03\xe0\x41\x02\x12\x11\n\x04\x65tag\x18\x03 \x01(\tB\x03\xe0\x41\x02\x1ax\n\x19NotificationSettingsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12J\n\x05value\x18\x02 \x01(\x0b\x32;.google.cloud.advisorynotifications.v1.NotificationSettings:\x02\x38\x01:n\xea\x41k\n-advisorynotifications.googleapis.com/Settings\x12:organizations/{organization}/locations/{location}/settings\"\'\n\x14NotificationSettings\x12\x0f\n\x07\x65nabled\x18\x01 \x01(\x08\"Y\n\x12GetSettingsRequest\x12\x43\n\x04name\x18\x01 \x01(\tB5\xe0\x41\x02\xfa\x41/\n-advisorynotifications.googleapis.com/Settings\"_\n\x15UpdateSettingsRequest\x12\x46\n\x08settings\x18\x01 \x01(\x0b\x32/.google.cloud.advisorynotifications.v1.SettingsB\x03\xe0\x41\x02*J\n\x10NotificationView\x12!\n\x1dNOTIFICATION_VIEW_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41SIC\x10\x01\x12\x08\n\x04\x46ULL\x10\x02*\xa0\x01\n\x11LocalizationState\x12\"\n\x1eLOCALIZATION_STATE_UNSPECIFIED\x10\x00\x12%\n!LOCALIZATION_STATE_NOT_APPLICABLE\x10\x01\x12\x1e\n\x1aLOCALIZATION_STATE_PENDING\x10\x02\x12 \n\x1cLOCALIZATION_STATE_COMPLETED\x10\x03*\xda\x01\n\x10NotificationType\x12!\n\x1dNOTIFICATION_TYPE_UNSPECIFIED\x10\x00\x12/\n+NOTIFICATION_TYPE_SECURITY_PRIVACY_ADVISORY\x10\x01\x12\'\n#NOTIFICATION_TYPE_SENSITIVE_ACTIONS\x10\x02\x12\"\n\x1eNOTIFICATION_TYPE_SECURITY_MSA\x10\x03\x12%\n!NOTIFICATION_TYPE_THREAT_HORIZONS\x10\x04\x32\xbe\x07\n\x1c\x41\x64visoryNotificationsService\x12\xdf\x01\n\x11ListNotifications\x12?.google.cloud.advisorynotifications.v1.ListNotificationsRequest\x1a@.google.cloud.advisorynotifications.v1.ListNotificationsResponse\"G\x82\xd3\xe4\x93\x02\x38\x12\x36/v1/{parent=organizations/*/locations/*}/notifications\xda\x41\x06parent\x12\xcc\x01\n\x0fGetNotification\x12=.google.cloud.advisorynotifications.v1.GetNotificationRequest\x1a\x33.google.cloud.advisorynotifications.v1.Notification\"E\x82\xd3\xe4\x93\x02\x38\x12\x36/v1/{name=organizations/*/locations/*/notifications/*}\xda\x41\x04name\x12\xb9\x01\n\x0bGetSettings\x12\x39.google.cloud.advisorynotifications.v1.GetSettingsRequest\x1a/.google.cloud.advisorynotifications.v1.Settings\">\x82\xd3\xe4\x93\x02\x31\x12//v1/{name=organizations/*/locations/*/settings}\xda\x41\x04name\x12\xd6\x01\n\x0eUpdateSettings\x12<.google.cloud.advisorynotifications.v1.UpdateSettingsRequest\x1a/.google.cloud.advisorynotifications.v1.Settings\"U\x82\xd3\xe4\x93\x02\x44\x32\x38/v1/{settings.name=organizations/*/locations/*/settings}:\x08settings\xda\x41\x08settings\x1aX\xca\x41$advisorynotifications.googleapis.com\xd2\x41.https://www.googleapis.com/auth/cloud-platformB\xfc\x02\n)com.google.cloud.advisorynotifications.v1B\x0cServiceProtoP\x01Z_cloud.google.com/go/advisorynotifications/apiv1/advisorynotificationspb;advisorynotificationspb\xaa\x02%Google.Cloud.AdvisoryNotifications.V1\xca\x02%Google\\Cloud\\AdvisoryNotifications\\V1\xea\x02(Google::Cloud::AdvisoryNotifications::V1\xea\x41\x62\n-advisorynotifications.googleapis.com/Location\x12\x31organizations/{organization}/locations/{location}b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -53,6 +53,10 @@ module Google
         ListNotificationsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.ListNotificationsRequest").msgclass
         ListNotificationsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.ListNotificationsResponse").msgclass
         GetNotificationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.GetNotificationRequest").msgclass
+        Settings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.Settings").msgclass
+        NotificationSettings = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.NotificationSettings").msgclass
+        GetSettingsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.GetSettingsRequest").msgclass
+        UpdateSettingsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.UpdateSettingsRequest").msgclass
         NotificationView = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.NotificationView").enummodule
         LocalizationState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.LocalizationState").enummodule
         NotificationType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.advisorynotifications.v1.NotificationType").enummodule

data/lib/google/cloud/advisorynotifications/v1/service_services_pb.rb

@@ -37,6 +37,10 @@ module Google
             rpc :ListNotifications, ::Google::Cloud::AdvisoryNotifications::V1::ListNotificationsRequest, ::Google::Cloud::AdvisoryNotifications::V1::ListNotificationsResponse
             # Gets a notification.
             rpc :GetNotification, ::Google::Cloud::AdvisoryNotifications::V1::GetNotificationRequest, ::Google::Cloud::AdvisoryNotifications::V1::Notification
+            # Get notification settings.
+            rpc :GetSettings, ::Google::Cloud::AdvisoryNotifications::V1::GetSettingsRequest, ::Google::Cloud::AdvisoryNotifications::V1::Settings
+            # Update notification settings.
+            rpc :UpdateSettings, ::Google::Cloud::AdvisoryNotifications::V1::UpdateSettingsRequest, ::Google::Cloud::AdvisoryNotifications::V1::Settings
           end
 
           Stub = Service.rpc_stub_class

data/proto_docs/google/cloud/advisorynotifications/v1/service.rb

@@ -198,6 +198,66 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Settings for Advisory Notifications.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. The resource name of the settings to retrieve.
+        #     Format:
+        #     organizations/\\{organization}/locations/\\{location}/settings.
+        # @!attribute [rw] notification_settings
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::AdvisoryNotifications::V1::NotificationSettings}]
+        #     Required. Map of each notification type and its settings to get/set all
+        #     settings at once. The server will validate the value for each notification
+        #     type.
+        # @!attribute [rw] etag
+        #   @return [::String]
+        #     Required. Fingerprint for optimistic concurrency returned in Get requests.
+        #     Must be provided for Update requests. If the value provided does not match
+        #     the value known to the server, ABORTED will be thrown, and the client
+        #     should retry the read-modify-write cycle.
+        class Settings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::AdvisoryNotifications::V1::NotificationSettings]
+          class NotificationSettingsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Settings for each NotificationType.
+        # @!attribute [rw] enabled
+        #   @return [::Boolean]
+        #     Whether the associated NotificationType is enabled.
+        class NotificationSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request of GetSettings endpoint.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the settings to retrieve.
+        #     Format:
+        #     organizations/\\{organization}/locations/\\{location}/settings.
+        class GetSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request of UpdateSettings endpoint.
+        # @!attribute [rw] settings
+        #   @return [::Google::Cloud::AdvisoryNotifications::V1::Settings]
+        #     Required. New settings.
+        class UpdateSettingsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Notification view.
         module NotificationView
           # Not specified, equivalent to BASIC.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-advisory_notifications-v1
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-12 00:00:00.000000000 Z
+date: 2023-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common