google-cloud-eventarc-publishing-v1 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7f30dce6c17286f82b749c0075c470960c6e695438d419611111e4952e4ecc6
-  data.tar.gz: 2199fffa08b6a7218c8116500090fd63352f3582151479c5db9ffeb835dec8d7
+  metadata.gz: 126c8e55957c1b5cfa6e28b95c7566b63b448b9a5518fcbc57d75bd72b09c348
+  data.tar.gz: e8b14193445703a6709582f3f22d6153973dfbe8637f2d55738b7acae3821464
 SHA512:
-  metadata.gz: ce7c436e0695780dcec9d6235499b2251865e6cb9b9a4f7380b1f60504b8534df5abda3a450facce52e4de2de193ae153a24f690095d8372ded0ebf0fe672ee2
-  data.tar.gz: a53cf4b4cfc9f72ccf4310bd72f2f679c23f57393689e83839a08f0b5625fdfc4ec661fe55329139f6d2c3f5008a9b8460fb081683b6a52e3795c2ed5db56b1a
+  metadata.gz: 9519a8cd56e94ad04e66ce9f0b22c6d0471611c54893ba3b6a18373e90cf3935b20387631c29a2833252fc0e76cc5618160b1344d5cbcee9576d9e33b3c6b3e7
+  data.tar.gz: d6e92b1fba7fdd68b9d261d8bf045faffcc4e029c14e415ceb92ce8dbee88f731d6ba79cdaf8a3512c603713ff51bf6b38c0f170d042af6a57935cc5dda093eb

data/lib/google/cloud/eventarc/publishing/v1/publisher/client.rb

@@ -256,6 +256,94 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Publish events to a subscriber's channel.
+              #
+              # @overload publish_events(request, options = nil)
+              #   Pass arguments to `publish_events` via a request object, either of type
+              #   {::Google::Cloud::Eventarc::Publishing::V1::PublishEventsRequest} or an equivalent Hash.
+              #
+              #   @param request [::Google::Cloud::Eventarc::Publishing::V1::PublishEventsRequest, ::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 publish_events(channel: nil, events: nil)
+              #   Pass arguments to `publish_events` 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 channel [::String]
+              #     The full name of the channel to publish to. For example:
+              #     `projects/{project}/locations/{location}/channels/{channel-id}`.
+              #   @param events [::Array<::Google::Protobuf::Any, ::Hash>]
+              #     The CloudEvents v1.0 events to publish. No other types are allowed.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Cloud::Eventarc::Publishing::V1::PublishEventsResponse]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Cloud::Eventarc::Publishing::V1::PublishEventsResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/eventarc/publishing/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Eventarc::Publishing::V1::Publisher::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Eventarc::Publishing::V1::PublishEventsRequest.new
+              #
+              #   # Call the publish_events method.
+              #   result = client.publish_events request
+              #
+              #   # The returned object is of type Google::Cloud::Eventarc::Publishing::V1::PublishEventsResponse.
+              #   p result
+              #
+              def publish_events request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Eventarc::Publishing::V1::PublishEventsRequest
+
+                # 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.publish_events.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::Eventarc::Publishing::V1::VERSION
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                header_params = {}
+                if request.channel
+                  header_params["channel"] = request.channel
+                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.publish_events.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.publish_events.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @publisher_stub.call_rpc :publish_events, 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 Publisher API.
               #
@@ -396,11 +484,18 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :publish_channel_connection_events
+                  ##
+                  # RPC-specific configuration for `publish_events`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :publish_events
 
                   # @private
                   def initialize parent_rpcs = nil
                     publish_channel_connection_events_config = parent_rpcs.publish_channel_connection_events if parent_rpcs.respond_to? :publish_channel_connection_events
                     @publish_channel_connection_events = ::Gapic::Config::Method.new publish_channel_connection_events_config
+                    publish_events_config = parent_rpcs.publish_events if parent_rpcs.respond_to? :publish_events
+                    @publish_events = ::Gapic::Config::Method.new publish_events_config
 
                     yield self if block_given?
                   end

data/lib/google/cloud/eventarc/publishing/v1/publisher_pb.rb

@@ -2,8 +2,8 @@
 # source: google/cloud/eventarc/publishing/v1/publisher.proto
 
 require 'google/api/annotations_pb'
-require 'google/protobuf/any_pb'
 require 'google/api/client_pb'
+require 'google/protobuf/any_pb'
 require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
@@ -14,6 +14,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "google.cloud.eventarc.publishing.v1.PublishChannelConnectionEventsResponse" do
     end
+    add_message "google.cloud.eventarc.publishing.v1.PublishEventsRequest" do
+      optional :channel, :string, 1
+      repeated :events, :message, 2, "google.protobuf.Any"
+    end
+    add_message "google.cloud.eventarc.publishing.v1.PublishEventsResponse" do
+    end
   end
 end
 
@@ -24,6 +30,8 @@ module Google
         module V1
           PublishChannelConnectionEventsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.eventarc.publishing.v1.PublishChannelConnectionEventsRequest").msgclass
           PublishChannelConnectionEventsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.eventarc.publishing.v1.PublishChannelConnectionEventsResponse").msgclass
+          PublishEventsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.eventarc.publishing.v1.PublishEventsRequest").msgclass
+          PublishEventsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.eventarc.publishing.v1.PublishEventsResponse").msgclass
         end
       end
     end

data/lib/google/cloud/eventarc/publishing/v1/publisher_services_pb.rb

@@ -59,6 +59,8 @@ module Google
 
               # Publish events to a ChannelConnection in a partner's project.
               rpc :PublishChannelConnectionEvents, ::Google::Cloud::Eventarc::Publishing::V1::PublishChannelConnectionEventsRequest, ::Google::Cloud::Eventarc::Publishing::V1::PublishChannelConnectionEventsResponse
+              # Publish events to a subscriber's channel.
+              rpc :PublishEvents, ::Google::Cloud::Eventarc::Publishing::V1::PublishEventsRequest, ::Google::Cloud::Eventarc::Publishing::V1::PublishEventsResponse
             end
 
             Stub = Service.rpc_stub_class

data/lib/google/cloud/eventarc/publishing/v1/version.rb

@@ -22,7 +22,7 @@ module Google
     module Eventarc
       module Publishing
         module V1
-          VERSION = "0.1.0"
+          VERSION = "0.2.0"
         end
       end
     end

data/lib/google/cloud/eventarc/publishing/v1.rb

@@ -26,6 +26,8 @@ module Google
         ##
         # To load this package, including all its services, and instantiate a client:
         #
+        # @example
+        #
         #     require "google/cloud/eventarc/publishing/v1"
         #     client = ::Google::Cloud::Eventarc::Publishing::V1::Publisher::Client.new
         #

data/proto_docs/google/cloud/eventarc/publishing/v1/publisher.rb

@@ -40,6 +40,25 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # The request message for the PublishEvents method.
+          # @!attribute [rw] channel
+          #   @return [::String]
+          #     The full name of the channel to publish to. For example:
+          #     `projects/{project}/locations/{location}/channels/{channel-id}`.
+          # @!attribute [rw] events
+          #   @return [::Array<::Google::Protobuf::Any>]
+          #     The CloudEvents v1.0 events to publish. No other types are allowed.
+          class PublishEventsRequest
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The response message for the PublishEvents method.
+          class PublishEventsResponse
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-eventarc-publishing-v1
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-15 00:00:00.000000000 Z
+date: 2022-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common