google-cloud-pubsub-v1 0.15.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6e21016a2e45d034489befd63714d08d6bb558490fbb32d35a5996fda7d2de15
4
- data.tar.gz: 9563b93c44365e0a6eaccc4572383d77b017596340f4f7d5dcdcd41e6ca8bfbd
3
+ metadata.gz: ef2b50623ab3e258fe7b1095de46db9a1c038e4ac881927e725715da7094a47d
4
+ data.tar.gz: 5317692433c1dd6b31d79df6a6f91630aaaaa2ce522fb53222a0aa32cc4ed1dd
5
5
  SHA512:
6
- metadata.gz: 2bcca54d2349bdedfe87306136dc217bb307cedb5411ce500854d42fd32451b28d907e0a96bdc62ac78a7c2c0ceefe95424a9c21c730b425a0c470baa751aac4
7
- data.tar.gz: b788b3ece0f8778b831b6492eb1fff9007dd687a4e8a1fd87bb6c72092f51bc3cd4a7bf9c7ee14b0e872b40cdbfcb4772e375969c97a4bfaa118995aa751e1c8
6
+ metadata.gz: 953a676423d8161d13b27f4a49b7c54868ec4802add7bc7d75049b5c98011b20750bd06e0e449cbbc538dbe54210dd9677452d82fd47599187c155d202ceec8a
7
+ data.tar.gz: f8a65ec54c6ffbcb68d05bc3ff3586a763e3b40fc8a84c96674543ac3ab1db8f88006eba30c56276730100201615dca30861395783fea35803ea60bfc041c319
data/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Ruby Client for the Cloud Pub/Sub V1 API
2
2
 
3
- API Client library for the Cloud Pub/Sub V1 API
3
+ Provides reliable, many-to-many, asynchronous messaging between applications.
4
4
 
5
5
  Cloud Pub/Sub is a fully-managed real-time messaging service that allows you to send and receive messages between independent applications.
6
6
 
@@ -47,7 +47,7 @@ for general usage information.
47
47
 
48
48
  To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
49
  The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
50
+ or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
51
  that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -1090,9 +1090,9 @@ module Google
1090
1090
  # * (`String`) The path to a service account key file in JSON format
1091
1091
  # * (`Hash`) A service account key as a Hash
1092
1092
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1093
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1093
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1094
1094
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1095
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1095
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1096
1096
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1097
1097
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1098
1098
  # * (`nil`) indicating no credentials
@@ -65,6 +65,56 @@ module Google
65
65
  end
66
66
  default_config = Client::Configuration.new parent_config
67
67
 
68
+ default_config.rpcs.create_schema.timeout = 60.0
69
+ default_config.rpcs.create_schema.retry_policy = {
70
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
71
+ }
72
+
73
+ default_config.rpcs.get_schema.timeout = 60.0
74
+ default_config.rpcs.get_schema.retry_policy = {
75
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
76
+ }
77
+
78
+ default_config.rpcs.list_schemas.timeout = 60.0
79
+ default_config.rpcs.list_schemas.retry_policy = {
80
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
81
+ }
82
+
83
+ default_config.rpcs.list_schema_revisions.timeout = 60.0
84
+ default_config.rpcs.list_schema_revisions.retry_policy = {
85
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
86
+ }
87
+
88
+ default_config.rpcs.commit_schema.timeout = 60.0
89
+ default_config.rpcs.commit_schema.retry_policy = {
90
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
91
+ }
92
+
93
+ default_config.rpcs.rollback_schema.timeout = 60.0
94
+ default_config.rpcs.rollback_schema.retry_policy = {
95
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
96
+ }
97
+
98
+ default_config.rpcs.delete_schema_revision.timeout = 60.0
99
+ default_config.rpcs.delete_schema_revision.retry_policy = {
100
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
101
+ }
102
+
103
+ default_config.rpcs.delete_schema.timeout = 60.0
104
+ default_config.rpcs.delete_schema.retry_policy = {
105
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
106
+ }
107
+
108
+ default_config.rpcs.validate_schema.timeout = 60.0
109
+ default_config.rpcs.validate_schema.retry_policy = {
110
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
111
+ }
112
+
113
+ default_config.rpcs.validate_message.timeout = 60.0
114
+ default_config.rpcs.validate_message.retry_policy = {
115
+ initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
116
+ }
117
+
68
118
  default_config
69
119
  end
70
120
  yield @configure if block_given?
@@ -1123,9 +1173,9 @@ module Google
1123
1173
  # * (`String`) The path to a service account key file in JSON format
1124
1174
  # * (`Hash`) A service account key as a Hash
1125
1175
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1126
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1176
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1127
1177
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1128
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1178
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1129
1179
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1130
1180
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1131
1181
  # * (`nil`) indicating no credentials
@@ -263,7 +263,7 @@ module Google
263
263
  # @param options [::Gapic::CallOptions, ::Hash]
264
264
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
265
265
  #
266
- # @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)
266
+ # @overload create_subscription(name: nil, topic: nil, push_config: nil, bigquery_config: nil, cloud_storage_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)
267
267
  # Pass arguments to `create_subscription` via keyword arguments. Note that at
268
268
  # least one keyword argument is required. To specify no parameters, or to keep all
269
269
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -285,6 +285,9 @@ module Google
285
285
  # @param bigquery_config [::Google::Cloud::PubSub::V1::BigQueryConfig, ::Hash]
286
286
  # If delivery to BigQuery is used with this subscription, this field is
287
287
  # used to configure it.
288
+ # @param cloud_storage_config [::Google::Cloud::PubSub::V1::CloudStorageConfig, ::Hash]
289
+ # If delivery to Google Cloud Storage is used with this subscription, this
290
+ # field is used to configure it.
288
291
  # @param ack_deadline_seconds [::Integer]
289
292
  # The approximate amount of time (on a best-effort basis) Pub/Sub waits for
290
293
  # the subscriber to acknowledge receipt before resending the message. In the
@@ -334,7 +337,8 @@ module Google
334
337
  # successfully consuming messages from the subscription or is issuing
335
338
  # operations on the subscription. If `expiration_policy` is not set, a
336
339
  # *default policy* with `ttl` of 31 days will be used. The minimum allowed
337
- # value for `expiration_policy.ttl` is 1 day.
340
+ # value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
341
+ # but `expiration_policy.ttl` is not set, the subscription never expires.
338
342
  # @param filter [::String]
339
343
  # An expression written in the Pub/Sub [filter
340
344
  # language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
@@ -1920,9 +1924,9 @@ module Google
1920
1924
  # * (`String`) The path to a service account key file in JSON format
1921
1925
  # * (`Hash`) A service account key as a Hash
1922
1926
  # * (`Google::Auth::Credentials`) A googleauth credentials object
1923
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1927
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
1924
1928
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1925
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1929
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
1926
1930
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
1927
1931
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
1928
1932
  # * (`nil`) indicating no credentials
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module PubSub
23
23
  module V1
24
- VERSION = "0.15.0"
24
+ VERSION = "0.16.0"
25
25
  end
26
26
  end
27
27
  end
@@ -94,6 +94,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
94
94
  optional :topic, :string, 2
95
95
  optional :push_config, :message, 4, "google.pubsub.v1.PushConfig"
96
96
  optional :bigquery_config, :message, 18, "google.pubsub.v1.BigQueryConfig"
97
+ optional :cloud_storage_config, :message, 22, "google.pubsub.v1.CloudStorageConfig"
97
98
  optional :ack_deadline_seconds, :int32, 5
98
99
  optional :retain_acked_messages, :bool, 7
99
100
  optional :message_retention_duration, :message, 8, "google.protobuf.Duration"
@@ -149,6 +150,29 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
149
150
  value :NOT_FOUND, 3
150
151
  value :SCHEMA_MISMATCH, 4
151
152
  end
153
+ add_message "google.pubsub.v1.CloudStorageConfig" do
154
+ optional :bucket, :string, 1
155
+ optional :filename_prefix, :string, 2
156
+ optional :filename_suffix, :string, 3
157
+ optional :max_duration, :message, 6, "google.protobuf.Duration"
158
+ optional :max_bytes, :int64, 7
159
+ optional :state, :enum, 9, "google.pubsub.v1.CloudStorageConfig.State"
160
+ oneof :output_format do
161
+ optional :text_config, :message, 4, "google.pubsub.v1.CloudStorageConfig.TextConfig"
162
+ optional :avro_config, :message, 5, "google.pubsub.v1.CloudStorageConfig.AvroConfig"
163
+ end
164
+ end
165
+ add_message "google.pubsub.v1.CloudStorageConfig.TextConfig" do
166
+ end
167
+ add_message "google.pubsub.v1.CloudStorageConfig.AvroConfig" do
168
+ optional :write_metadata, :bool, 1
169
+ end
170
+ add_enum "google.pubsub.v1.CloudStorageConfig.State" do
171
+ value :STATE_UNSPECIFIED, 0
172
+ value :ACTIVE, 1
173
+ value :PERMISSION_DENIED, 2
174
+ value :NOT_FOUND, 3
175
+ end
152
176
  add_message "google.pubsub.v1.ReceivedMessage" do
153
177
  optional :ack_id, :string, 1
154
178
  optional :message, :message, 2, "google.pubsub.v1.PubsubMessage"
@@ -297,6 +321,10 @@ module Google
297
321
  PushConfig::OidcToken = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.PushConfig.OidcToken").msgclass
298
322
  BigQueryConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.BigQueryConfig").msgclass
299
323
  BigQueryConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.BigQueryConfig.State").enummodule
324
+ CloudStorageConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CloudStorageConfig").msgclass
325
+ CloudStorageConfig::TextConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CloudStorageConfig.TextConfig").msgclass
326
+ CloudStorageConfig::AvroConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CloudStorageConfig.AvroConfig").msgclass
327
+ CloudStorageConfig::State = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.CloudStorageConfig.State").enummodule
300
328
  ReceivedMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.ReceivedMessage").msgclass
301
329
  GetSubscriptionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.GetSubscriptionRequest").msgclass
302
330
  UpdateSubscriptionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.pubsub.v1.UpdateSubscriptionRequest").msgclass
@@ -35,7 +35,9 @@ module Google
35
35
  # Details about how and where to publish client libraries.
36
36
  # @!attribute [rw] version
37
37
  # @return [::String]
38
- # Version of the API to apply these settings to.
38
+ # Version of the API to apply these settings to. This is the full protobuf
39
+ # package for the API, ending in the version element.
40
+ # Examples: "google.cloud.speech.v1" and "google.spanner.admin.database.v1".
39
41
  # @!attribute [rw] launch_stage
40
42
  # @return [::Google::Api::LaunchStage]
41
43
  # Launch stage of this version of the API.
@@ -81,7 +83,7 @@ module Google
81
83
  # long-running operation pattern.
82
84
  # @!attribute [rw] new_issue_uri
83
85
  # @return [::String]
84
- # Link to a place that API users can report issues. Example:
86
+ # Link to a *public* URI where users can report issues. Example:
85
87
  # https://issuetracker.google.com/issues/new?component=190865&template=1161103
86
88
  # @!attribute [rw] documentation_uri
87
89
  # @return [::String]
@@ -111,6 +113,10 @@ module Google
111
113
  # Client library settings. If the same version string appears multiple
112
114
  # times in this list, then the last one wins. Settings from earlier
113
115
  # settings with the same version string are discarded.
116
+ # @!attribute [rw] proto_reference_documentation_uri
117
+ # @return [::String]
118
+ # Optional link to proto reference documentation. Example:
119
+ # https://cloud.google.com/pubsub/lite/docs/reference/rpc
114
120
  class Publishing
115
121
  include ::Google::Protobuf::MessageExts
116
122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -203,9 +209,57 @@ module Google
203
209
  # @!attribute [rw] common
204
210
  # @return [::Google::Api::CommonLanguageSettings]
205
211
  # Some settings.
212
+ # @!attribute [rw] renamed_services
213
+ # @return [::Google::Protobuf::Map{::String => ::String}]
214
+ # Map from original service names to renamed versions.
215
+ # This is used when the default generated types
216
+ # would cause a naming conflict. (Neither name is
217
+ # fully-qualified.)
218
+ # Example: Subscriber to SubscriberServiceApi.
219
+ # @!attribute [rw] renamed_resources
220
+ # @return [::Google::Protobuf::Map{::String => ::String}]
221
+ # Map from full resource types to the effective short name
222
+ # for the resource. This is used when otherwise resource
223
+ # named from different services would cause naming collisions.
224
+ # Example entry:
225
+ # "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
226
+ # @!attribute [rw] ignored_resources
227
+ # @return [::Array<::String>]
228
+ # List of full resource types to ignore during generation.
229
+ # This is typically used for API-specific Location resources,
230
+ # which should be handled by the generator as if they were actually
231
+ # the common Location resources.
232
+ # Example entry: "documentai.googleapis.com/Location"
233
+ # @!attribute [rw] forced_namespace_aliases
234
+ # @return [::Array<::String>]
235
+ # Namespaces which must be aliased in snippets due to
236
+ # a known (but non-generator-predictable) naming collision
237
+ # @!attribute [rw] handwritten_signatures
238
+ # @return [::Array<::String>]
239
+ # Method signatures (in the form "service.method(signature)")
240
+ # which are provided separately, so shouldn't be generated.
241
+ # Snippets *calling* these methods are still generated, however.
206
242
  class DotnetSettings
207
243
  include ::Google::Protobuf::MessageExts
208
244
  extend ::Google::Protobuf::MessageExts::ClassMethods
245
+
246
+ # @!attribute [rw] key
247
+ # @return [::String]
248
+ # @!attribute [rw] value
249
+ # @return [::String]
250
+ class RenamedServicesEntry
251
+ include ::Google::Protobuf::MessageExts
252
+ extend ::Google::Protobuf::MessageExts::ClassMethods
253
+ end
254
+
255
+ # @!attribute [rw] key
256
+ # @return [::String]
257
+ # @!attribute [rw] value
258
+ # @return [::String]
259
+ class RenamedResourcesEntry
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
209
263
  end
210
264
 
211
265
  # Settings for Ruby client libraries.
@@ -240,8 +294,8 @@ module Google
240
294
  # Example of a YAML configuration::
241
295
  #
242
296
  # publishing:
243
- # method_behavior:
244
- # - selector: CreateAdDomain
297
+ # method_settings:
298
+ # - selector: google.cloud.speech.v2.Speech.BatchRecognize
245
299
  # long_running:
246
300
  # initial_poll_delay:
247
301
  # seconds: 60 # 1 minute
@@ -299,6 +353,15 @@ module Google
299
353
 
300
354
  # Street View Org.
301
355
  STREET_VIEW = 4
356
+
357
+ # Shopping Org.
358
+ SHOPPING = 5
359
+
360
+ # Geo Org.
361
+ GEO = 6
362
+
363
+ # Generative AI - https://developers.generativeai.google
364
+ GENERATIVE_AI = 7
302
365
  end
303
366
 
304
367
  # To where should client libraries be published?
@@ -150,6 +150,8 @@ module Google
150
150
  # delivered to subscribers in the order in which they are received by the
151
151
  # Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
152
152
  # must specify the same `ordering_key` value.
153
+ # For more information, see [ordering
154
+ # messages](https://cloud.google.com/pubsub/docs/ordering).
153
155
  class PubsubMessage
154
156
  include ::Google::Protobuf::MessageExts
155
157
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -336,9 +338,9 @@ module Google
336
338
  extend ::Google::Protobuf::MessageExts::ClassMethods
337
339
  end
338
340
 
339
- # A subscription resource. If none of `push_config` or `bigquery_config` is
340
- # set, then the subscriber will pull and ack messages using API methods. At
341
- # most one of these fields may be set.
341
+ # A subscription resource. If none of `push_config`, `bigquery_config`, or
342
+ # `cloud_storage_config` is set, then the subscriber will pull and ack messages
343
+ # using API methods. At most one of these fields may be set.
342
344
  # @!attribute [rw] name
343
345
  # @return [::String]
344
346
  # Required. The name of the subscription. It must have the format
@@ -360,6 +362,10 @@ module Google
360
362
  # @return [::Google::Cloud::PubSub::V1::BigQueryConfig]
361
363
  # If delivery to BigQuery is used with this subscription, this field is
362
364
  # used to configure it.
365
+ # @!attribute [rw] cloud_storage_config
366
+ # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig]
367
+ # If delivery to Google Cloud Storage is used with this subscription, this
368
+ # field is used to configure it.
363
369
  # @!attribute [rw] ack_deadline_seconds
364
370
  # @return [::Integer]
365
371
  # The approximate amount of time (on a best-effort basis) Pub/Sub waits for
@@ -415,7 +421,8 @@ module Google
415
421
  # successfully consuming messages from the subscription or is issuing
416
422
  # operations on the subscription. If `expiration_policy` is not set, a
417
423
  # *default policy* with `ttl` of 31 days will be used. The minimum allowed
418
- # value for `expiration_policy.ttl` is 1 day.
424
+ # value for `expiration_policy.ttl` is 1 day. If `expiration_policy` is set,
425
+ # but `expiration_policy.ttl` is not set, the subscription never expires.
419
426
  # @!attribute [rw] filter
420
427
  # @return [::String]
421
428
  # An expression written in the Pub/Sub [filter
@@ -620,9 +627,9 @@ module Google
620
627
  # @return [::String]
621
628
  # [Service account
622
629
  # email](https://cloud.google.com/iam/docs/service-accounts)
623
- # to be used for generating the OIDC token. The caller (for
624
- # CreateSubscription, UpdateSubscription, and ModifyPushConfig RPCs) must
625
- # have the iam.serviceAccounts.actAs permission for the service account.
630
+ # used for generating the OIDC token. For more information
631
+ # on setting up authentication, see
632
+ # [Push subscriptions](https://cloud.google.com/pubsub/docs/push).
626
633
  # @!attribute [rw] audience
627
634
  # @return [::String]
628
635
  # Audience to be used when generating OIDC token. The audience claim
@@ -701,6 +708,81 @@ module Google
701
708
  end
702
709
  end
703
710
 
711
+ # Configuration for a Cloud Storage subscription.
712
+ # @!attribute [rw] bucket
713
+ # @return [::String]
714
+ # Required. User-provided name for the Cloud Storage bucket.
715
+ # The bucket must be created by the user. The bucket name must be without
716
+ # any prefix like "gs://". See the [bucket naming
717
+ # requirements] (https://cloud.google.com/storage/docs/buckets#naming).
718
+ # @!attribute [rw] filename_prefix
719
+ # @return [::String]
720
+ # User-provided prefix for Cloud Storage filename. See the [object naming
721
+ # requirements](https://cloud.google.com/storage/docs/objects#naming).
722
+ # @!attribute [rw] filename_suffix
723
+ # @return [::String]
724
+ # User-provided suffix for Cloud Storage filename. See the [object naming
725
+ # requirements](https://cloud.google.com/storage/docs/objects#naming).
726
+ # @!attribute [rw] text_config
727
+ # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::TextConfig]
728
+ # If set, message data will be written to Cloud Storage in text format.
729
+ # @!attribute [rw] avro_config
730
+ # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::AvroConfig]
731
+ # If set, message data will be written to Cloud Storage in Avro format.
732
+ # @!attribute [rw] max_duration
733
+ # @return [::Google::Protobuf::Duration]
734
+ # The maximum duration that can elapse before a new Cloud Storage file is
735
+ # created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
736
+ # the subscription's acknowledgement deadline.
737
+ # @!attribute [rw] max_bytes
738
+ # @return [::Integer]
739
+ # The maximum bytes that can be written to a Cloud Storage file before a new
740
+ # file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be exceeded
741
+ # in cases where messages are larger than the limit.
742
+ # @!attribute [r] state
743
+ # @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::State]
744
+ # Output only. An output-only field that indicates whether or not the
745
+ # subscription can receive messages.
746
+ class CloudStorageConfig
747
+ include ::Google::Protobuf::MessageExts
748
+ extend ::Google::Protobuf::MessageExts::ClassMethods
749
+
750
+ # Configuration for writing message data in text format.
751
+ # Message payloads will be written to files as raw text, separated by a
752
+ # newline.
753
+ class TextConfig
754
+ include ::Google::Protobuf::MessageExts
755
+ extend ::Google::Protobuf::MessageExts::ClassMethods
756
+ end
757
+
758
+ # Configuration for writing message data in Avro format.
759
+ # Message payloads and metadata will be written to files as an Avro binary.
760
+ # @!attribute [rw] write_metadata
761
+ # @return [::Boolean]
762
+ # When true, write the subscription name, message_id, publish_time,
763
+ # attributes, and ordering_key as additional fields in the output.
764
+ class AvroConfig
765
+ include ::Google::Protobuf::MessageExts
766
+ extend ::Google::Protobuf::MessageExts::ClassMethods
767
+ end
768
+
769
+ # Possible states for a Cloud Storage subscription.
770
+ module State
771
+ # Default value. This value is unused.
772
+ STATE_UNSPECIFIED = 0
773
+
774
+ # The subscription can actively send messages to Cloud Storage.
775
+ ACTIVE = 1
776
+
777
+ # Cannot write to the Cloud Storage bucket because of permission denied
778
+ # errors.
779
+ PERMISSION_DENIED = 2
780
+
781
+ # Cannot write to the Cloud Storage bucket because it does not exist.
782
+ NOT_FOUND = 3
783
+ end
784
+ end
785
+
704
786
  # A message and its corresponding acknowledgment ID.
705
787
  # @!attribute [rw] ack_id
706
788
  # @return [::String]
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-pubsub-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.15.0
4
+ version: 0.16.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-02-17 00:00:00.000000000 Z
11
+ date: 2023-05-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.17.1
19
+ version: 0.18.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.17.1
29
+ version: 0.18.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -248,5 +248,5 @@ requirements: []
248
248
  rubygems_version: 3.4.2
249
249
  signing_key:
250
250
  specification_version: 4
251
- summary: API Client library for the Cloud Pub/Sub V1 API
251
+ summary: Provides reliable, many-to-many, asynchronous messaging between applications.
252
252
  test_files: []