google-cloud-pubsub-v1 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5b8d4a04b957bf51f78e7cdfd7855287072ea18b92ca22bd3deb0d69108565ca
-  data.tar.gz: 9bb5b1febf8dfbe5764ae2576674e658dd784ae97c207af9476658a836a94ea8
+  metadata.gz: cca9d3319952549629377f2711733a83ebc7e7df2f0fc6252c807bf06abaadbb
+  data.tar.gz: 33ee951144993321545c68373e1db7a349fcb788b581d1d69bbfccf113ff2a01
 SHA512:
-  metadata.gz: 06e2c616cca3ee3911ac3b47ec32682cb1e15194b5287691a5e2c1811b993b9b2b0a250397573cc768a9967af5a8168464777fb4b7c0ee48d3cbdcd2b6cfc116
-  data.tar.gz: 99589685f3ae59c8e00eccc010751f8ddf5acdbe0766411f672a533e2367840dc449116977d4981d0254707fe1bcec3df62a286061c5ae90a46e259c5a96c1fe
+  metadata.gz: c09ad2ff9cb8f6b34879b4f8c3cd83a4f061efc2fec9c57ef101f542cfae5cadbeed8d20273613f5bb2be7d7a5934b7951d2c12ed7df67ed6d81515c53b82c66
+  data.tar.gz: b7ceb6290a46805732d3732ea44fdb63875ba21ff192ad08da34796cdbc2c85b6f7e7d4879e79f0316f6886b400470493498c72446fc588529f16c5eb3e90aee

data/README.md

@@ -69,6 +69,11 @@ module GRPC
 end
 ```
 
+
+## Google Cloud Samples
+
+To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
+
 ## Supported Ruby Versions
 
 This library is supported on Ruby 2.5+.

data/lib/google/cloud/pubsub/v1/subscriber/client.rb

@@ -249,7 +249,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload create_subscription(name: nil, topic: nil, push_config: nil, ack_deadline_seconds: nil, retain_acked_messages: nil, message_retention_duration: nil, labels: nil, enable_message_ordering: nil, expiration_policy: nil, filter: nil, dead_letter_policy: nil, retry_policy: nil, detached: nil, enable_exactly_once_delivery: nil)
+            # @overload create_subscription(name: nil, topic: nil, push_config: nil, bigquery_config: nil, ack_deadline_seconds: nil, retain_acked_messages: nil, message_retention_duration: nil, labels: nil, enable_message_ordering: nil, expiration_policy: nil, filter: nil, dead_letter_policy: nil, retry_policy: nil, detached: nil, enable_exactly_once_delivery: nil)
             #   Pass arguments to `create_subscription` 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).
@@ -267,8 +267,14 @@ module Google
             #     field will be `_deleted-topic_` if the topic has been deleted.
             #   @param push_config [::Google::Cloud::PubSub::V1::PushConfig, ::Hash]
             #     If push delivery is used with this subscription, this field is
-            #     used to configure it. An empty `pushConfig` signifies that the subscriber
-            #     will pull and ack messages using API methods.
+            #     used to configure it. Either `pushConfig` or `bigQueryConfig` can be set,
+            #     but not both. If both are empty, then the subscriber will pull and ack
+            #     messages using API methods.
+            #   @param bigquery_config [::Google::Cloud::PubSub::V1::BigQueryConfig, ::Hash]
+            #     If delivery to BigQuery is used with this subscription, this field is
+            #     used to configure it. Either `pushConfig` or `bigQueryConfig` can be set,
+            #     but not both. If both are empty, then the subscriber will pull and ack
+            #     messages using API methods.
             #   @param ack_deadline_seconds [::Integer]
             #     The approximate amount of time (on a best-effort basis) Pub/Sub waits for
             #     the subscriber to acknowledge receipt before resending the message. In the

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module PubSub
       module V1
-        VERSION = "0.9.0"
+        VERSION = "0.10.0"
       end
     end
   end

data/lib/google/pubsub/v1/pubsub_pb.rb

@@ -1,6 +1,8 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/pubsub/v1/pubsub.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
@@ -10,7 +12,6 @@ require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/pubsub/v1/schema_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/pubsub/v1/pubsub.proto", :syntax => :proto3) do
@@ -90,6 +91,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :name, :string, 1
       optional :topic, :string, 2
       optional :push_config, :message, 4, "google.pubsub.v1.PushConfig"
+      optional :bigquery_config, :message, 18, "google.pubsub.v1.BigQueryConfig"
       optional :ack_deadline_seconds, :int32, 5
       optional :retain_acked_messages, :bool, 7
       optional :message_retention_duration, :message, 8, "google.protobuf.Duration"
@@ -102,6 +104,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :detached, :bool, 15
       optional :enable_exactly_once_delivery, :bool, 16
       optional :topic_message_retention_duration, :message, 17, "google.protobuf.Duration"
+      optional :state, :enum, 19, "google.pubsub.v1.Subscription.State"
+    end
+    add_enum "google.pubsub.v1.Subscription.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :ACTIVE, 1
+      value :RESOURCE_ERROR, 2
     end
     add_message "google.pubsub.v1.RetryPolicy" do
       optional :minimum_backoff, :message, 1, "google.protobuf.Duration"
@@ -125,6 +133,20 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :service_account_email, :string, 1
       optional :audience, :string, 2
     end
+    add_message "google.pubsub.v1.BigQueryConfig" do
+      optional :table, :string, 1
+      optional :use_topic_schema, :bool, 2
+      optional :write_metadata, :bool, 3
+      optional :drop_unknown_fields, :bool, 4
+      optional :state, :enum, 5, "google.pubsub.v1.BigQueryConfig.State"
+    end
+    add_enum "google.pubsub.v1.BigQueryConfig.State" do
+      value :STATE_UNSPECIFIED, 0
+      value :ACTIVE, 1
+      value :PERMISSION_DENIED, 2
+      value :NOT_FOUND, 3
+      value :SCHEMA_MISMATCH, 4
+    end
     add_message "google.pubsub.v1.ReceivedMessage" do
       optional :ack_id, :string, 1
       optional :message, :message, 2, "google.pubsub.v1.PubsubMessage"
@@ -263,11 +285,14 @@ module Google
         DetachSubscriptionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionRequest").msgclass
         DetachSubscriptionResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DetachSubscriptionResponse").msgclass
         Subscription = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Subscription").msgclass
+        Subscription::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.Subscription.State").enummodule
         RetryPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.RetryPolicy").msgclass
         DeadLetterPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.DeadLetterPolicy").msgclass
         ExpirationPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ExpirationPolicy").msgclass
         PushConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig").msgclass
         PushConfig::OidcToken = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig.OidcToken").msgclass
+        BigQueryConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.BigQueryConfig").msgclass
+        BigQueryConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.BigQueryConfig.State").enummodule
         ReceivedMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ReceivedMessage").msgclass
         GetSubscriptionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetSubscriptionRequest").msgclass
         UpdateSubscriptionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.UpdateSubscriptionRequest").msgclass

data/lib/google/pubsub/v1/schema_pb.rb

@@ -1,12 +1,13 @@
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/pubsub/v1/schema.proto
 
+require 'google/protobuf'
+
 require 'google/api/annotations_pb'
 require 'google/api/client_pb'
 require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/protobuf/empty_pb'
-require 'google/protobuf'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/pubsub/v1/schema.proto", :syntax => :proto3) do

data/proto_docs/google/pubsub/v1/pubsub.rb

@@ -343,8 +343,15 @@ module Google
         # @!attribute [rw] push_config
         #   @return [::Google::Cloud::PubSub::V1::PushConfig]
         #     If push delivery is used with this subscription, this field is
-        #     used to configure it. An empty `pushConfig` signifies that the subscriber
-        #     will pull and ack messages using API methods.
+        #     used to configure it. Either `pushConfig` or `bigQueryConfig` can be set,
+        #     but not both. If both are empty, then the subscriber will pull and ack
+        #     messages using API methods.
+        # @!attribute [rw] bigquery_config
+        #   @return [::Google::Cloud::PubSub::V1::BigQueryConfig]
+        #     If delivery to BigQuery is used with this subscription, this field is
+        #     used to configure it. Either `pushConfig` or `bigQueryConfig` can be set,
+        #     but not both. If both are empty, then the subscriber will pull and ack
+        #     messages using API methods.
         # @!attribute [rw] ack_deadline_seconds
         #   @return [::Integer]
         #     The approximate amount of time (on a best-effort basis) Pub/Sub waits for
@@ -455,6 +462,10 @@ module Google
         #     `topic_message_retention_duration` are always available to subscribers. See
         #     the `message_retention_duration` field in `Topic`. This field is set only
         #     in responses from the server; it is ignored if it is set in any requests.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::PubSub::V1::Subscription::State]
+        #     Output only. An output-only field indicating whether or not the subscription can receive
+        #     messages.
         class Subscription
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -467,6 +478,20 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Possible states for a subscription.
+          module State
+            # Default value. This value is unused.
+            STATE_UNSPECIFIED = 0
+
+            # The subscription can actively receive messages
+            ACTIVE = 1
+
+            # The subscription cannot receive messages because of an error with the
+            # resource to which it pushes messages. See the more detailed error state
+            # in the corresponding configuration.
+            RESOURCE_ERROR = 2
+          end
         end
 
         # A policy that specifies how Cloud Pub/Sub retries message delivery.
@@ -613,6 +638,56 @@ module Google
           end
         end
 
+        # Configuration for a BigQuery subscription.
+        # @!attribute [rw] table
+        #   @return [::String]
+        #     The name of the table to which to write data, of the form
+        #     \\{projectId}:\\{datasetId}.\\{tableId}
+        # @!attribute [rw] use_topic_schema
+        #   @return [::Boolean]
+        #     When true, use the topic's schema as the columns to write to in BigQuery,
+        #     if it exists.
+        # @!attribute [rw] write_metadata
+        #   @return [::Boolean]
+        #     When true, write the subscription name, message_id, publish_time,
+        #     attributes, and ordering_key to additional columns in the table. The
+        #     subscription name, message_id, and publish_time fields are put in their own
+        #     columns while all other message properties (other than data) are written to
+        #     a JSON object in the attributes column.
+        # @!attribute [rw] drop_unknown_fields
+        #   @return [::Boolean]
+        #     When true and use_topic_schema is true, any fields that are a part of the
+        #     topic schema that are not part of the BigQuery table schema are dropped
+        #     when writing to BigQuery. Otherwise, the schemas must be kept in sync and
+        #     any messages with extra fields are not written and remain in the
+        #     subscription's backlog.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::PubSub::V1::BigQueryConfig::State]
+        #     Output only. An output-only field that indicates whether or not the subscription can
+        #     receive messages.
+        class BigQueryConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Possible states for a BigQuery subscription.
+          module State
+            # Default value. This value is unused.
+            STATE_UNSPECIFIED = 0
+
+            # The subscription can actively send messages to BigQuery
+            ACTIVE = 1
+
+            # Cannot write to the BigQuery table because of permission denied errors.
+            PERMISSION_DENIED = 2
+
+            # Cannot write to the BigQuery table because it does not exist.
+            NOT_FOUND = 3
+
+            # Cannot write to the BigQuery table due to a schema mismatch.
+            SCHEMA_MISMATCH = 4
+          end
+        end
+
         # A message and its corresponding acknowledgment ID.
         # @!attribute [rw] ack_id
         #   @return [::String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub-v1
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-20 00:00:00.000000000 Z
+date: 2022-05-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common