google-cloud-pubsub-v1 0.5.2 → 0.6.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (10) hide show
  1. checksums.yaml +4 -4
  2. data/lib/google/cloud/pubsub/v1/iam_policy/client.rb +38 -39
  3. data/lib/google/cloud/pubsub/v1/publisher/client.rb +66 -46
  4. data/lib/google/cloud/pubsub/v1/schema_service/client.rb +47 -42
  5. data/lib/google/cloud/pubsub/v1/subscriber/client.rb +80 -54
  6. data/lib/google/cloud/pubsub/v1/version.rb +1 -1
  7. data/lib/google/pubsub/v1/pubsub_pb.rb +2 -0
  8. data/proto_docs/google/pubsub/v1/pubsub.rb +21 -2
  9. data/proto_docs/google/pubsub/v1/schema.rb +2 -0
  10. metadata +4 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e6e2a4a9f6746191781373c0594d27f8dccef450607d23da6bc9abed9a13730c
4
- data.tar.gz: 5f508e848d394c34604079c27aff3e465d95bee3a176cc89170e09c9fd025b3e
3
+ metadata.gz: 441674812241a0cdd2bfe5571966a5f9893f9f247868b13858e854809d2def9b
4
+ data.tar.gz: 0b1c9adfc174e0a0ced3341c79d8de58e47501347d1295427b2b13a395c59d99
5
5
  SHA512:
6
- metadata.gz: 64c8dd6ad2f2ac7ee7bd85e72a9abc1b6fee01b2b3a35ef208e923d542c5185946f89e721f4987459d4603c096208b07b6db76a4a08e0165d5f9ce7cc95a88b2
7
- data.tar.gz: f0fb04598dc4cdb5ffaa92e045aba68e780afc9b53a7bf9e69d8763082e4cf8fda9565c695bb4173abeadb5a837769541ccb4e9a321fc4b5b395722ba41b021a
6
+ metadata.gz: 892d5ae726abd72028e2915d1d54397afe410bd61fe596edfa06c8ec9e56770dd1be1b3105c6526c1cd34490da2364568083d24650d3f53451efb7b90594aeef
7
+ data.tar.gz: bc38b3afe7a0324650f14816feac655604d375018b53e8ba0667cef087aae86adb390b518c7b40a2f07ee318aa3762bba58771af08d550e6dcd813a8a1e28151
data/lib/google/cloud/pubsub/v1/iam_policy/client.rb CHANGED
@@ -63,13 +63,12 @@ module Google
63
63
  # See {::Google::Cloud::PubSub::V1::IAMPolicy::Client::Configuration}
64
64
  # for a description of the configuration fields.
65
65
  #
66
- # ## Example
66
+ # @example
67
67
  #
68
- # To modify the configuration for all IAMPolicy clients:
69
- #
70
- # ::Google::Cloud::PubSub::V1::IAMPolicy::Client.configure do |config|
71
- # config.timeout = 10.0
72
- # end
68
+ # # Modify the configuration for all IAMPolicy clients
69
+ # ::Google::Cloud::PubSub::V1::IAMPolicy::Client.configure do |config|
70
+ # config.timeout = 10.0
71
+ # end
73
72
  #
74
73
  # @yield [config] Configure the Client client.
75
74
  # @yieldparam config [Client::Configuration]
@@ -116,19 +115,15 @@ module Google
116
115
  ##
117
116
  # Create a new IAMPolicy client object.
118
117
  #
119
- # ## Examples
120
- #
121
- # To create a new IAMPolicy client with the default
122
- # configuration:
123
- #
124
- # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new
118
+ # @example
125
119
  #
126
- # To create a new IAMPolicy client with a custom
127
- # configuration:
120
+ # # Create a client using the default configuration
121
+ # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new
128
122
  #
129
- # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new do |config|
130
- # config.timeout = 10.0
131
- # end
123
+ # # Create a client using a custom configuration
124
+ # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new do |config|
125
+ # config.timeout = 10.0
126
+ # end
132
127
  #
133
128
  # @yield [config] Configure the IAMPolicy client.
134
129
  # @yieldparam config [Client::Configuration]
@@ -148,10 +143,9 @@ module Google
148
143
 
149
144
  # Create credentials
150
145
  credentials = @config.credentials
151
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
146
+ # Use self-signed JWT if the endpoint is unchanged from default,
152
147
  # but only if the default endpoint does not have a region prefix.
153
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
154
- @config.endpoint == Client.configure.endpoint &&
148
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
155
149
  !@config.endpoint.split(".").first.include?("-")
156
150
  credentials ||= Credentials.default scope: @config.scope,
157
151
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -234,7 +228,9 @@ module Google
234
228
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
235
229
  metadata: metadata,
236
230
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
237
- options.apply_defaults metadata: @config.metadata,
231
+
232
+ options.apply_defaults timeout: @config.timeout,
233
+ metadata: @config.metadata,
238
234
  retry_policy: @config.retry_policy
239
235
 
240
236
  @iam_policy_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -306,7 +302,9 @@ module Google
306
302
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
307
303
  metadata: metadata,
308
304
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
309
- options.apply_defaults metadata: @config.metadata,
305
+
306
+ options.apply_defaults timeout: @config.timeout,
307
+ metadata: @config.metadata,
310
308
  retry_policy: @config.retry_policy
311
309
 
312
310
  @iam_policy_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -384,7 +382,9 @@ module Google
384
382
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
385
383
  metadata: metadata,
386
384
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
387
- options.apply_defaults metadata: @config.metadata,
385
+
386
+ options.apply_defaults timeout: @config.timeout,
387
+ metadata: @config.metadata,
388
388
  retry_policy: @config.retry_policy
389
389
 
390
390
  @iam_policy_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -408,22 +408,21 @@ module Google
408
408
  # Configuration can be applied globally to all clients, or to a single client
409
409
  # on construction.
410
410
  #
411
- # # Examples
412
- #
413
- # To modify the global config, setting the timeout for set_iam_policy
414
- # to 20 seconds, and all remaining timeouts to 10 seconds:
415
- #
416
- # ::Google::Cloud::PubSub::V1::IAMPolicy::Client.configure do |config|
417
- # config.timeout = 10.0
418
- # config.rpcs.set_iam_policy.timeout = 20.0
419
- # end
420
- #
421
- # To apply the above configuration only to a new client:
422
- #
423
- # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new do |config|
424
- # config.timeout = 10.0
425
- # config.rpcs.set_iam_policy.timeout = 20.0
426
- # end
411
+ # @example
412
+ #
413
+ # # Modify the global config, setting the timeout for
414
+ # # set_iam_policy to 20 seconds,
415
+ # # and all remaining timeouts to 10 seconds.
416
+ # ::Google::Cloud::PubSub::V1::IAMPolicy::Client.configure do |config|
417
+ # config.timeout = 10.0
418
+ # config.rpcs.set_iam_policy.timeout = 20.0
419
+ # end
420
+ #
421
+ # # Apply the above configuration only to a new client.
422
+ # client = ::Google::Cloud::PubSub::V1::IAMPolicy::Client.new do |config|
423
+ # config.timeout = 10.0
424
+ # config.rpcs.set_iam_policy.timeout = 20.0
425
+ # end
427
426
  #
428
427
  # @!attribute [rw] endpoint
429
428
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/pubsub/v1/publisher/client.rb CHANGED
@@ -42,13 +42,12 @@ module Google
42
42
  # See {::Google::Cloud::PubSub::V1::Publisher::Client::Configuration}
43
43
  # for a description of the configuration fields.
44
44
  #
45
- # ## Example
45
+ # @example
46
46
  #
47
- # To modify the configuration for all Publisher clients:
48
- #
49
- # ::Google::Cloud::PubSub::V1::Publisher::Client.configure do |config|
50
- # config.timeout = 10.0
51
- # end
47
+ # # Modify the configuration for all Publisher clients
48
+ # ::Google::Cloud::PubSub::V1::Publisher::Client.configure do |config|
49
+ # config.timeout = 10.0
50
+ # end
52
51
  #
53
52
  # @yield [config] Configure the Client client.
54
53
  # @yieldparam config [Client::Configuration]
@@ -140,19 +139,15 @@ module Google
140
139
  ##
141
140
  # Create a new Publisher client object.
142
141
  #
143
- # ## Examples
144
- #
145
- # To create a new Publisher client with the default
146
- # configuration:
142
+ # @example
147
143
  #
148
- # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new
144
+ # # Create a client using the default configuration
145
+ # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new
149
146
  #
150
- # To create a new Publisher client with a custom
151
- # configuration:
152
- #
153
- # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new do |config|
154
- # config.timeout = 10.0
155
- # end
147
+ # # Create a client using a custom configuration
148
+ # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new do |config|
149
+ # config.timeout = 10.0
150
+ # end
156
151
  #
157
152
  # @yield [config] Configure the Publisher client.
158
153
  # @yieldparam config [Client::Configuration]
@@ -172,10 +167,9 @@ module Google
172
167
 
173
168
  # Create credentials
174
169
  credentials = @config.credentials
175
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
170
+ # Use self-signed JWT if the endpoint is unchanged from default,
176
171
  # but only if the default endpoint does not have a region prefix.
177
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
178
- @config.endpoint == Client.configure.endpoint &&
172
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
179
173
  !@config.endpoint.split(".").first.include?("-")
180
174
  credentials ||= Credentials.default scope: @config.scope,
181
175
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -210,7 +204,7 @@ module Google
210
204
  # @param options [::Gapic::CallOptions, ::Hash]
211
205
  # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
212
206
  #
213
- # @overload create_topic(name: nil, labels: nil, message_storage_policy: nil, kms_key_name: nil, schema_settings: nil, satisfies_pzs: nil)
207
+ # @overload create_topic(name: nil, labels: nil, message_storage_policy: nil, kms_key_name: nil, schema_settings: nil, satisfies_pzs: nil, message_retention_duration: nil)
214
208
  # Pass arguments to `create_topic` via keyword arguments. Note that at
215
209
  # least one keyword argument is required. To specify no parameters, or to keep all
216
210
  # the default parameter values, pass an empty Hash as a request object (see above).
@@ -239,6 +233,15 @@ module Google
239
233
  # @param satisfies_pzs [::Boolean]
240
234
  # Reserved for future use. This field is set only in responses from the
241
235
  # server; it is ignored if it is set in any requests.
236
+ # @param message_retention_duration [::Google::Protobuf::Duration, ::Hash]
237
+ # Indicates the minimum duration to retain a message after it is published to
238
+ # the topic. If this field is set, messages published to the topic in the
239
+ # last `message_retention_duration` are always available to subscribers. For
240
+ # instance, it allows any attached subscription to [seek to a
241
+ # timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
242
+ # that is up to `message_retention_duration` in the past. If this field is
243
+ # not set, message retention is controlled by settings on individual
244
+ # subscriptions. Cannot be more than 7 days or less than 10 minutes.
242
245
  #
243
246
  # @yield [response, operation] Access the result along with the RPC operation
244
247
  # @yieldparam response [::Google::Cloud::PubSub::V1::Topic]
@@ -274,7 +277,9 @@ module Google
274
277
  options.apply_defaults timeout: @config.rpcs.create_topic.timeout,
275
278
  metadata: metadata,
276
279
  retry_policy: @config.rpcs.create_topic.retry_policy
277
- options.apply_defaults metadata: @config.metadata,
280
+
281
+ options.apply_defaults timeout: @config.timeout,
282
+ metadata: @config.metadata,
278
283
  retry_policy: @config.retry_policy
279
284
 
280
285
  @publisher_stub.call_rpc :create_topic, request, options: options do |response, operation|
@@ -347,7 +352,9 @@ module Google
347
352
  options.apply_defaults timeout: @config.rpcs.update_topic.timeout,
348
353
  metadata: metadata,
349
354
  retry_policy: @config.rpcs.update_topic.retry_policy
350
- options.apply_defaults metadata: @config.metadata,
355
+
356
+ options.apply_defaults timeout: @config.timeout,
357
+ metadata: @config.metadata,
351
358
  retry_policy: @config.retry_policy
352
359
 
353
360
  @publisher_stub.call_rpc :update_topic, request, options: options do |response, operation|
@@ -417,7 +424,9 @@ module Google
417
424
  options.apply_defaults timeout: @config.rpcs.publish.timeout,
418
425
  metadata: metadata,
419
426
  retry_policy: @config.rpcs.publish.retry_policy
420
- options.apply_defaults metadata: @config.metadata,
427
+
428
+ options.apply_defaults timeout: @config.timeout,
429
+ metadata: @config.metadata,
421
430
  retry_policy: @config.retry_policy
422
431
 
423
432
  @publisher_stub.call_rpc :publish, request, options: options do |response, operation|
@@ -484,7 +493,9 @@ module Google
484
493
  options.apply_defaults timeout: @config.rpcs.get_topic.timeout,
485
494
  metadata: metadata,
486
495
  retry_policy: @config.rpcs.get_topic.retry_policy
487
- options.apply_defaults metadata: @config.metadata,
496
+
497
+ options.apply_defaults timeout: @config.timeout,
498
+ metadata: @config.metadata,
488
499
  retry_policy: @config.retry_policy
489
500
 
490
501
  @publisher_stub.call_rpc :get_topic, request, options: options do |response, operation|
@@ -557,7 +568,9 @@ module Google
557
568
  options.apply_defaults timeout: @config.rpcs.list_topics.timeout,
558
569
  metadata: metadata,
559
570
  retry_policy: @config.rpcs.list_topics.retry_policy
560
- options.apply_defaults metadata: @config.metadata,
571
+
572
+ options.apply_defaults timeout: @config.timeout,
573
+ metadata: @config.metadata,
561
574
  retry_policy: @config.retry_policy
562
575
 
563
576
  @publisher_stub.call_rpc :list_topics, request, options: options do |response, operation|
@@ -631,7 +644,9 @@ module Google
631
644
  options.apply_defaults timeout: @config.rpcs.list_topic_subscriptions.timeout,
632
645
  metadata: metadata,
633
646
  retry_policy: @config.rpcs.list_topic_subscriptions.retry_policy
634
- options.apply_defaults metadata: @config.metadata,
647
+
648
+ options.apply_defaults timeout: @config.timeout,
649
+ metadata: @config.metadata,
635
650
  retry_policy: @config.retry_policy
636
651
 
637
652
  @publisher_stub.call_rpc :list_topic_subscriptions, request, options: options do |response, operation|
@@ -708,7 +723,9 @@ module Google
708
723
  options.apply_defaults timeout: @config.rpcs.list_topic_snapshots.timeout,
709
724
  metadata: metadata,
710
725
  retry_policy: @config.rpcs.list_topic_snapshots.retry_policy
711
- options.apply_defaults metadata: @config.metadata,
726
+
727
+ options.apply_defaults timeout: @config.timeout,
728
+ metadata: @config.metadata,
712
729
  retry_policy: @config.retry_policy
713
730
 
714
731
  @publisher_stub.call_rpc :list_topic_snapshots, request, options: options do |response, operation|
@@ -779,7 +796,9 @@ module Google
779
796
  options.apply_defaults timeout: @config.rpcs.delete_topic.timeout,
780
797
  metadata: metadata,
781
798
  retry_policy: @config.rpcs.delete_topic.retry_policy
782
- options.apply_defaults metadata: @config.metadata,
799
+
800
+ options.apply_defaults timeout: @config.timeout,
801
+ metadata: @config.metadata,
783
802
  retry_policy: @config.retry_policy
784
803
 
785
804
  @publisher_stub.call_rpc :delete_topic, request, options: options do |response, operation|
@@ -849,7 +868,9 @@ module Google
849
868
  options.apply_defaults timeout: @config.rpcs.detach_subscription.timeout,
850
869
  metadata: metadata,
851
870
  retry_policy: @config.rpcs.detach_subscription.retry_policy
852
- options.apply_defaults metadata: @config.metadata,
871
+
872
+ options.apply_defaults timeout: @config.timeout,
873
+ metadata: @config.metadata,
853
874
  retry_policy: @config.retry_policy
854
875
 
855
876
  @publisher_stub.call_rpc :detach_subscription, request, options: options do |response, operation|
@@ -873,22 +894,21 @@ module Google
873
894
  # Configuration can be applied globally to all clients, or to a single client
874
895
  # on construction.
875
896
  #
876
- # # Examples
877
- #
878
- # To modify the global config, setting the timeout for create_topic
879
- # to 20 seconds, and all remaining timeouts to 10 seconds:
880
- #
881
- # ::Google::Cloud::PubSub::V1::Publisher::Client.configure do |config|
882
- # config.timeout = 10.0
883
- # config.rpcs.create_topic.timeout = 20.0
884
- # end
885
- #
886
- # To apply the above configuration only to a new client:
887
- #
888
- # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new do |config|
889
- # config.timeout = 10.0
890
- # config.rpcs.create_topic.timeout = 20.0
891
- # end
897
+ # @example
898
+ #
899
+ # # Modify the global config, setting the timeout for
900
+ # # create_topic to 20 seconds,
901
+ # # and all remaining timeouts to 10 seconds.
902
+ # ::Google::Cloud::PubSub::V1::Publisher::Client.configure do |config|
903
+ # config.timeout = 10.0
904
+ # config.rpcs.create_topic.timeout = 20.0
905
+ # end
906
+ #
907
+ # # Apply the above configuration only to a new client.
908
+ # client = ::Google::Cloud::PubSub::V1::Publisher::Client.new do |config|
909
+ # config.timeout = 10.0
910
+ # config.rpcs.create_topic.timeout = 20.0
911
+ # end
892
912
  #
893
913
  # @!attribute [rw] endpoint
894
914
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/pubsub/v1/schema_service/client.rb CHANGED
@@ -41,13 +41,12 @@ module Google
41
41
  # See {::Google::Cloud::PubSub::V1::SchemaService::Client::Configuration}
42
42
  # for a description of the configuration fields.
43
43
  #
44
- # ## Example
44
+ # @example
45
45
  #
46
- # To modify the configuration for all SchemaService clients:
47
- #
48
- # ::Google::Cloud::PubSub::V1::SchemaService::Client.configure do |config|
49
- # config.timeout = 10.0
50
- # end
46
+ # # Modify the configuration for all SchemaService clients
47
+ # ::Google::Cloud::PubSub::V1::SchemaService::Client.configure do |config|
48
+ # config.timeout = 10.0
49
+ # end
51
50
  #
52
51
  # @yield [config] Configure the Client client.
53
52
  # @yieldparam config [Client::Configuration]
@@ -94,19 +93,15 @@ module Google
94
93
  ##
95
94
  # Create a new SchemaService client object.
96
95
  #
97
- # ## Examples
98
- #
99
- # To create a new SchemaService client with the default
100
- # configuration:
96
+ # @example
101
97
  #
102
- # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new
98
+ # # Create a client using the default configuration
99
+ # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new
103
100
  #
104
- # To create a new SchemaService client with a custom
105
- # configuration:
106
- #
107
- # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new do |config|
108
- # config.timeout = 10.0
109
- # end
101
+ # # Create a client using a custom configuration
102
+ # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new do |config|
103
+ # config.timeout = 10.0
104
+ # end
110
105
  #
111
106
  # @yield [config] Configure the SchemaService client.
112
107
  # @yieldparam config [Client::Configuration]
@@ -126,10 +121,9 @@ module Google
126
121
 
127
122
  # Create credentials
128
123
  credentials = @config.credentials
129
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
124
+ # Use self-signed JWT if the endpoint is unchanged from default,
130
125
  # but only if the default endpoint does not have a region prefix.
131
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
132
- @config.endpoint == Client.configure.endpoint &&
126
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
133
127
  !@config.endpoint.split(".").first.include?("-")
134
128
  credentials ||= Credentials.default scope: @config.scope,
135
129
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -218,7 +212,9 @@ module Google
218
212
  options.apply_defaults timeout: @config.rpcs.create_schema.timeout,
219
213
  metadata: metadata,
220
214
  retry_policy: @config.rpcs.create_schema.retry_policy
221
- options.apply_defaults metadata: @config.metadata,
215
+
216
+ options.apply_defaults timeout: @config.timeout,
217
+ metadata: @config.metadata,
222
218
  retry_policy: @config.retry_policy
223
219
 
224
220
  @schema_service_stub.call_rpc :create_schema, request, options: options do |response, operation|
@@ -289,7 +285,9 @@ module Google
289
285
  options.apply_defaults timeout: @config.rpcs.get_schema.timeout,
290
286
  metadata: metadata,
291
287
  retry_policy: @config.rpcs.get_schema.retry_policy
292
- options.apply_defaults metadata: @config.metadata,
288
+
289
+ options.apply_defaults timeout: @config.timeout,
290
+ metadata: @config.metadata,
293
291
  retry_policy: @config.retry_policy
294
292
 
295
293
  @schema_service_stub.call_rpc :get_schema, request, options: options do |response, operation|
@@ -366,7 +364,9 @@ module Google
366
364
  options.apply_defaults timeout: @config.rpcs.list_schemas.timeout,
367
365
  metadata: metadata,
368
366
  retry_policy: @config.rpcs.list_schemas.retry_policy
369
- options.apply_defaults metadata: @config.metadata,
367
+
368
+ options.apply_defaults timeout: @config.timeout,
369
+ metadata: @config.metadata,
370
370
  retry_policy: @config.retry_policy
371
371
 
372
372
  @schema_service_stub.call_rpc :list_schemas, request, options: options do |response, operation|
@@ -434,7 +434,9 @@ module Google
434
434
  options.apply_defaults timeout: @config.rpcs.delete_schema.timeout,
435
435
  metadata: metadata,
436
436
  retry_policy: @config.rpcs.delete_schema.retry_policy
437
- options.apply_defaults metadata: @config.metadata,
437
+
438
+ options.apply_defaults timeout: @config.timeout,
439
+ metadata: @config.metadata,
438
440
  retry_policy: @config.retry_policy
439
441
 
440
442
  @schema_service_stub.call_rpc :delete_schema, request, options: options do |response, operation|
@@ -503,7 +505,9 @@ module Google
503
505
  options.apply_defaults timeout: @config.rpcs.validate_schema.timeout,
504
506
  metadata: metadata,
505
507
  retry_policy: @config.rpcs.validate_schema.retry_policy
506
- options.apply_defaults metadata: @config.metadata,
508
+
509
+ options.apply_defaults timeout: @config.timeout,
510
+ metadata: @config.metadata,
507
511
  retry_policy: @config.retry_policy
508
512
 
509
513
  @schema_service_stub.call_rpc :validate_schema, request, options: options do |response, operation|
@@ -580,7 +584,9 @@ module Google
580
584
  options.apply_defaults timeout: @config.rpcs.validate_message.timeout,
581
585
  metadata: metadata,
582
586
  retry_policy: @config.rpcs.validate_message.retry_policy
583
- options.apply_defaults metadata: @config.metadata,
587
+
588
+ options.apply_defaults timeout: @config.timeout,
589
+ metadata: @config.metadata,
584
590
  retry_policy: @config.retry_policy
585
591
 
586
592
  @schema_service_stub.call_rpc :validate_message, request, options: options do |response, operation|
@@ -604,22 +610,21 @@ module Google
604
610
  # Configuration can be applied globally to all clients, or to a single client
605
611
  # on construction.
606
612
  #
607
- # # Examples
608
- #
609
- # To modify the global config, setting the timeout for create_schema
610
- # to 20 seconds, and all remaining timeouts to 10 seconds:
611
- #
612
- # ::Google::Cloud::PubSub::V1::SchemaService::Client.configure do |config|
613
- # config.timeout = 10.0
614
- # config.rpcs.create_schema.timeout = 20.0
615
- # end
616
- #
617
- # To apply the above configuration only to a new client:
618
- #
619
- # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new do |config|
620
- # config.timeout = 10.0
621
- # config.rpcs.create_schema.timeout = 20.0
622
- # end
613
+ # @example
614
+ #
615
+ # # Modify the global config, setting the timeout for
616
+ # # create_schema to 20 seconds,
617
+ # # and all remaining timeouts to 10 seconds.
618
+ # ::Google::Cloud::PubSub::V1::SchemaService::Client.configure do |config|
619
+ # config.timeout = 10.0
620
+ # config.rpcs.create_schema.timeout = 20.0
621
+ # end
622
+ #
623
+ # # Apply the above configuration only to a new client.
624
+ # client = ::Google::Cloud::PubSub::V1::SchemaService::Client.new do |config|
625
+ # config.timeout = 10.0
626
+ # config.rpcs.create_schema.timeout = 20.0
627
+ # end
623
628
  #
624
629
  # @!attribute [rw] endpoint
625
630
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/pubsub/v1/subscriber/client.rb CHANGED
@@ -43,13 +43,12 @@ module Google
43
43
  # See {::Google::Cloud::PubSub::V1::Subscriber::Client::Configuration}
44
44
  # for a description of the configuration fields.
45
45
  #
46
- # ## Example
46
+ # @example
47
47
  #
48
- # To modify the configuration for all Subscriber clients:
49
- #
50
- # ::Google::Cloud::PubSub::V1::Subscriber::Client.configure do |config|
51
- # config.timeout = 10.0
52
- # end
48
+ # # Modify the configuration for all Subscriber clients
49
+ # ::Google::Cloud::PubSub::V1::Subscriber::Client.configure do |config|
50
+ # config.timeout = 10.0
51
+ # end
53
52
  #
54
53
  # @yield [config] Configure the Client client.
55
54
  # @yieldparam config [Client::Configuration]
@@ -176,19 +175,15 @@ module Google
176
175
  ##
177
176
  # Create a new Subscriber client object.
178
177
  #
179
- # ## Examples
180
- #
181
- # To create a new Subscriber client with the default
182
- # configuration:
183
- #
184
- # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new
178
+ # @example
185
179
  #
186
- # To create a new Subscriber client with a custom
187
- # configuration:
180
+ # # Create a client using the default configuration
181
+ # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new
188
182
  #
189
- # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new do |config|
190
- # config.timeout = 10.0
191
- # end
183
+ # # Create a client using a custom configuration
184
+ # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new do |config|
185
+ # config.timeout = 10.0
186
+ # end
192
187
  #
193
188
  # @yield [config] Configure the Subscriber client.
194
189
  # @yieldparam config [Client::Configuration]
@@ -208,10 +203,9 @@ module Google
208
203
 
209
204
  # Create credentials
210
205
  credentials = @config.credentials
211
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
206
+ # Use self-signed JWT if the endpoint is unchanged from default,
212
207
  # but only if the default endpoint does not have a region prefix.
213
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
214
- @config.endpoint == Client.configure.endpoint &&
208
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
215
209
  !@config.endpoint.split(".").first.include?("-")
216
210
  credentials ||= Credentials.default scope: @config.scope,
217
211
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -300,8 +294,9 @@ module Google
300
294
  # Indicates whether to retain acknowledged messages. If true, then
301
295
  # messages are not expunged from the subscription's backlog, even if they are
302
296
  # acknowledged, until they fall out of the `message_retention_duration`
303
- # window. This must be true if you would like to [Seek to a timestamp]
304
- # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
297
+ # window. This must be true if you would like to [`Seek` to a timestamp]
298
+ # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in
299
+ # the past to replay previously-acknowledged messages.
305
300
  # @param message_retention_duration [::Google::Protobuf::Duration, ::Hash]
306
301
  # How long to retain unacknowledged messages in the subscription's backlog,
307
302
  # from the moment a message is published.
@@ -388,7 +383,9 @@ module Google
388
383
  options.apply_defaults timeout: @config.rpcs.create_subscription.timeout,
389
384
  metadata: metadata,
390
385
  retry_policy: @config.rpcs.create_subscription.retry_policy
391
- options.apply_defaults metadata: @config.metadata,
386
+
387
+ options.apply_defaults timeout: @config.timeout,
388
+ metadata: @config.metadata,
392
389
  retry_policy: @config.retry_policy
393
390
 
394
391
  @subscriber_stub.call_rpc :create_subscription, request, options: options do |response, operation|
@@ -455,7 +452,9 @@ module Google
455
452
  options.apply_defaults timeout: @config.rpcs.get_subscription.timeout,
456
453
  metadata: metadata,
457
454
  retry_policy: @config.rpcs.get_subscription.retry_policy
458
- options.apply_defaults metadata: @config.metadata,
455
+
456
+ options.apply_defaults timeout: @config.timeout,
457
+ metadata: @config.metadata,
459
458
  retry_policy: @config.retry_policy
460
459
 
461
460
  @subscriber_stub.call_rpc :get_subscription, request, options: options do |response, operation|
@@ -525,7 +524,9 @@ module Google
525
524
  options.apply_defaults timeout: @config.rpcs.update_subscription.timeout,
526
525
  metadata: metadata,
527
526
  retry_policy: @config.rpcs.update_subscription.retry_policy
528
- options.apply_defaults metadata: @config.metadata,
527
+
528
+ options.apply_defaults timeout: @config.timeout,
529
+ metadata: @config.metadata,
529
530
  retry_policy: @config.retry_policy
530
531
 
531
532
  @subscriber_stub.call_rpc :update_subscription, request, options: options do |response, operation|
@@ -598,7 +599,9 @@ module Google
598
599
  options.apply_defaults timeout: @config.rpcs.list_subscriptions.timeout,
599
600
  metadata: metadata,
600
601
  retry_policy: @config.rpcs.list_subscriptions.retry_policy
601
- options.apply_defaults metadata: @config.metadata,
602
+
603
+ options.apply_defaults timeout: @config.timeout,
604
+ metadata: @config.metadata,
602
605
  retry_policy: @config.retry_policy
603
606
 
604
607
  @subscriber_stub.call_rpc :list_subscriptions, request, options: options do |response, operation|
@@ -670,7 +673,9 @@ module Google
670
673
  options.apply_defaults timeout: @config.rpcs.delete_subscription.timeout,
671
674
  metadata: metadata,
672
675
  retry_policy: @config.rpcs.delete_subscription.retry_policy
673
- options.apply_defaults metadata: @config.metadata,
676
+
677
+ options.apply_defaults timeout: @config.timeout,
678
+ metadata: @config.metadata,
674
679
  retry_policy: @config.retry_policy
675
680
 
676
681
  @subscriber_stub.call_rpc :delete_subscription, request, options: options do |response, operation|
@@ -752,7 +757,9 @@ module Google
752
757
  options.apply_defaults timeout: @config.rpcs.modify_ack_deadline.timeout,
753
758
  metadata: metadata,
754
759
  retry_policy: @config.rpcs.modify_ack_deadline.retry_policy
755
- options.apply_defaults metadata: @config.metadata,
760
+
761
+ options.apply_defaults timeout: @config.timeout,
762
+ metadata: @config.metadata,
756
763
  retry_policy: @config.retry_policy
757
764
 
758
765
  @subscriber_stub.call_rpc :modify_ack_deadline, request, options: options do |response, operation|
@@ -829,7 +836,9 @@ module Google
829
836
  options.apply_defaults timeout: @config.rpcs.acknowledge.timeout,
830
837
  metadata: metadata,
831
838
  retry_policy: @config.rpcs.acknowledge.retry_policy
832
- options.apply_defaults metadata: @config.metadata,
839
+
840
+ options.apply_defaults timeout: @config.timeout,
841
+ metadata: @config.metadata,
833
842
  retry_policy: @config.retry_policy
834
843
 
835
844
  @subscriber_stub.call_rpc :acknowledge, request, options: options do |response, operation|
@@ -910,7 +919,9 @@ module Google
910
919
  options.apply_defaults timeout: @config.rpcs.pull.timeout,
911
920
  metadata: metadata,
912
921
  retry_policy: @config.rpcs.pull.retry_policy
913
- options.apply_defaults metadata: @config.metadata,
922
+
923
+ options.apply_defaults timeout: @config.timeout,
924
+ metadata: @config.metadata,
914
925
  retry_policy: @config.retry_policy
915
926
 
916
927
  @subscriber_stub.call_rpc :pull, request, options: options do |response, operation|
@@ -968,7 +979,9 @@ module Google
968
979
  options.apply_defaults timeout: @config.rpcs.streaming_pull.timeout,
969
980
  metadata: metadata,
970
981
  retry_policy: @config.rpcs.streaming_pull.retry_policy
971
- options.apply_defaults metadata: @config.metadata,
982
+
983
+ options.apply_defaults timeout: @config.timeout,
984
+ metadata: @config.metadata,
972
985
  retry_policy: @config.retry_policy
973
986
 
974
987
  @subscriber_stub.call_rpc :streaming_pull, request, options: options do |response, operation|
@@ -1047,7 +1060,9 @@ module Google
1047
1060
  options.apply_defaults timeout: @config.rpcs.modify_push_config.timeout,
1048
1061
  metadata: metadata,
1049
1062
  retry_policy: @config.rpcs.modify_push_config.retry_policy
1050
- options.apply_defaults metadata: @config.metadata,
1063
+
1064
+ options.apply_defaults timeout: @config.timeout,
1065
+ metadata: @config.metadata,
1051
1066
  retry_policy: @config.retry_policy
1052
1067
 
1053
1068
  @subscriber_stub.call_rpc :modify_push_config, request, options: options do |response, operation|
@@ -1118,7 +1133,9 @@ module Google
1118
1133
  options.apply_defaults timeout: @config.rpcs.get_snapshot.timeout,
1119
1134
  metadata: metadata,
1120
1135
  retry_policy: @config.rpcs.get_snapshot.retry_policy
1121
- options.apply_defaults metadata: @config.metadata,
1136
+
1137
+ options.apply_defaults timeout: @config.timeout,
1138
+ metadata: @config.metadata,
1122
1139
  retry_policy: @config.retry_policy
1123
1140
 
1124
1141
  @subscriber_stub.call_rpc :get_snapshot, request, options: options do |response, operation|
@@ -1195,7 +1212,9 @@ module Google
1195
1212
  options.apply_defaults timeout: @config.rpcs.list_snapshots.timeout,
1196
1213
  metadata: metadata,
1197
1214
  retry_policy: @config.rpcs.list_snapshots.retry_policy
1198
- options.apply_defaults metadata: @config.metadata,
1215
+
1216
+ options.apply_defaults timeout: @config.timeout,
1217
+ metadata: @config.metadata,
1199
1218
  retry_policy: @config.retry_policy
1200
1219
 
1201
1220
  @subscriber_stub.call_rpc :list_snapshots, request, options: options do |response, operation|
@@ -1295,7 +1314,9 @@ module Google
1295
1314
  options.apply_defaults timeout: @config.rpcs.create_snapshot.timeout,
1296
1315
  metadata: metadata,
1297
1316
  retry_policy: @config.rpcs.create_snapshot.retry_policy
1298
- options.apply_defaults metadata: @config.metadata,
1317
+
1318
+ options.apply_defaults timeout: @config.timeout,
1319
+ metadata: @config.metadata,
1299
1320
  retry_policy: @config.retry_policy
1300
1321
 
1301
1322
  @subscriber_stub.call_rpc :create_snapshot, request, options: options do |response, operation|
@@ -1369,7 +1390,9 @@ module Google
1369
1390
  options.apply_defaults timeout: @config.rpcs.update_snapshot.timeout,
1370
1391
  metadata: metadata,
1371
1392
  retry_policy: @config.rpcs.update_snapshot.retry_policy
1372
- options.apply_defaults metadata: @config.metadata,
1393
+
1394
+ options.apply_defaults timeout: @config.timeout,
1395
+ metadata: @config.metadata,
1373
1396
  retry_policy: @config.retry_policy
1374
1397
 
1375
1398
  @subscriber_stub.call_rpc :update_snapshot, request, options: options do |response, operation|
@@ -1444,7 +1467,9 @@ module Google
1444
1467
  options.apply_defaults timeout: @config.rpcs.delete_snapshot.timeout,
1445
1468
  metadata: metadata,
1446
1469
  retry_policy: @config.rpcs.delete_snapshot.retry_policy
1447
- options.apply_defaults metadata: @config.metadata,
1470
+
1471
+ options.apply_defaults timeout: @config.timeout,
1472
+ metadata: @config.metadata,
1448
1473
  retry_policy: @config.retry_policy
1449
1474
 
1450
1475
  @subscriber_stub.call_rpc :delete_snapshot, request, options: options do |response, operation|
@@ -1532,7 +1557,9 @@ module Google
1532
1557
  options.apply_defaults timeout: @config.rpcs.seek.timeout,
1533
1558
  metadata: metadata,
1534
1559
  retry_policy: @config.rpcs.seek.retry_policy
1535
- options.apply_defaults metadata: @config.metadata,
1560
+
1561
+ options.apply_defaults timeout: @config.timeout,
1562
+ metadata: @config.metadata,
1536
1563
  retry_policy: @config.retry_policy
1537
1564
 
1538
1565
  @subscriber_stub.call_rpc :seek, request, options: options do |response, operation|
@@ -1556,22 +1583,21 @@ module Google
1556
1583
  # Configuration can be applied globally to all clients, or to a single client
1557
1584
  # on construction.
1558
1585
  #
1559
- # # Examples
1560
- #
1561
- # To modify the global config, setting the timeout for create_subscription
1562
- # to 20 seconds, and all remaining timeouts to 10 seconds:
1563
- #
1564
- # ::Google::Cloud::PubSub::V1::Subscriber::Client.configure do |config|
1565
- # config.timeout = 10.0
1566
- # config.rpcs.create_subscription.timeout = 20.0
1567
- # end
1568
- #
1569
- # To apply the above configuration only to a new client:
1570
- #
1571
- # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new do |config|
1572
- # config.timeout = 10.0
1573
- # config.rpcs.create_subscription.timeout = 20.0
1574
- # end
1586
+ # @example
1587
+ #
1588
+ # # Modify the global config, setting the timeout for
1589
+ # # create_subscription to 20 seconds,
1590
+ # # and all remaining timeouts to 10 seconds.
1591
+ # ::Google::Cloud::PubSub::V1::Subscriber::Client.configure do |config|
1592
+ # config.timeout = 10.0
1593
+ # config.rpcs.create_subscription.timeout = 20.0
1594
+ # end
1595
+ #
1596
+ # # Apply the above configuration only to a new client.
1597
+ # client = ::Google::Cloud::PubSub::V1::Subscriber::Client.new do |config|
1598
+ # config.timeout = 10.0
1599
+ # config.rpcs.create_subscription.timeout = 20.0
1600
+ # end
1575
1601
  #
1576
1602
  # @!attribute [rw] endpoint
1577
1603
  # The hostname or hostname:port of the service endpoint.
data/lib/google/cloud/pubsub/v1/version.rb CHANGED
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module PubSub
23
23
  module V1
24
- VERSION = "0.5.2"
24
+ VERSION = "0.6.0"
25
25
  end
26
26
  end
27
27
  end
data/lib/google/pubsub/v1/pubsub_pb.rb CHANGED
@@ -28,6 +28,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
28
28
  optional :kms_key_name, :string, 5
29
29
  optional :schema_settings, :message, 6, "google.pubsub.v1.SchemaSettings"
30
30
  optional :satisfies_pzs, :bool, 7
31
+ optional :message_retention_duration, :message, 8, "google.protobuf.Duration"
31
32
  end
32
33
  add_message "google.pubsub.v1.PubsubMessage" do
33
34
  optional :data, :bytes, 1
@@ -99,6 +100,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
99
100
  optional :dead_letter_policy, :message, 13, "google.pubsub.v1.DeadLetterPolicy"
100
101
  optional :retry_policy, :message, 14, "google.pubsub.v1.RetryPolicy"
101
102
  optional :detached, :bool, 15
103
+ optional :topic_message_retention_duration, :message, 17, "google.protobuf.Duration"
102
104
  end
103
105
  add_message "google.pubsub.v1.RetryPolicy" do
104
106
  optional :minimum_backoff, :message, 1, "google.protobuf.Duration"
data/proto_docs/google/pubsub/v1/pubsub.rb CHANGED
@@ -80,6 +80,16 @@ module Google
80
80
  # @return [::Boolean]
81
81
  # Reserved for future use. This field is set only in responses from the
82
82
  # server; it is ignored if it is set in any requests.
83
+ # @!attribute [rw] message_retention_duration
84
+ # @return [::Google::Protobuf::Duration]
85
+ # Indicates the minimum duration to retain a message after it is published to
86
+ # the topic. If this field is set, messages published to the topic in the
87
+ # last `message_retention_duration` are always available to subscribers. For
88
+ # instance, it allows any attached subscription to [seek to a
89
+ # timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time)
90
+ # that is up to `message_retention_duration` in the past. If this field is
91
+ # not set, message retention is controlled by settings on individual
92
+ # subscriptions. Cannot be more than 7 days or less than 10 minutes.
83
93
  class Topic
84
94
  include ::Google::Protobuf::MessageExts
85
95
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -362,8 +372,9 @@ module Google
362
372
  # Indicates whether to retain acknowledged messages. If true, then
363
373
  # messages are not expunged from the subscription's backlog, even if they are
364
374
  # acknowledged, until they fall out of the `message_retention_duration`
365
- # window. This must be true if you would like to [Seek to a timestamp]
366
- # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
375
+ # window. This must be true if you would like to [`Seek` to a timestamp]
376
+ # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) in
377
+ # the past to replay previously-acknowledged messages.
367
378
  # @!attribute [rw] message_retention_duration
368
379
  # @return [::Google::Protobuf::Duration]
369
380
  # How long to retain unacknowledged messages in the subscription's backlog,
@@ -423,6 +434,14 @@ module Google
423
434
  # backlog. `Pull` and `StreamingPull` requests will return
424
435
  # FAILED_PRECONDITION. If the subscription is a push subscription, pushes to
425
436
  # the endpoint will not be made.
437
+ # @!attribute [r] topic_message_retention_duration
438
+ # @return [::Google::Protobuf::Duration]
439
+ # Output only. Indicates the minimum duration for which a message is retained
440
+ # after it is published to the subscription's topic. If this field is set,
441
+ # messages published to the subscription's topic in the last
442
+ # `topic_message_retention_duration` are always available to subscribers. See
443
+ # the `message_retention_duration` field in `Topic`. This field is set only
444
+ # in responses from the server; it is ignored if it is set in any requests.
426
445
  class Subscription
427
446
  include ::Google::Protobuf::MessageExts
428
447
  extend ::Google::Protobuf::MessageExts::ClassMethods
data/proto_docs/google/pubsub/v1/schema.rb CHANGED
@@ -150,6 +150,7 @@ module Google
150
150
  end
151
151
 
152
152
  # Response for the `ValidateSchema` method.
153
+ # Empty for now.
153
154
  class ValidateSchemaResponse
154
155
  include ::Google::Protobuf::MessageExts
155
156
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -180,6 +181,7 @@ module Google
180
181
  end
181
182
 
182
183
  # Response for the `ValidateMessage` method.
184
+ # Empty for now.
183
185
  class ValidateMessageResponse
184
186
  include ::Google::Protobuf::MessageExts
185
187
  extend ::Google::Protobuf::MessageExts::ClassMethods
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.5.2
4
+ version: 0.6.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: 2021-07-12 00:00:00.000000000 Z
11
+ date: 2021-08-11 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.5'
19
+ version: '0.7'
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.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a