google-cloud-dataflow-v1beta3 0.9.0 → 0.10.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.
Files changed (24) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/client.rb +32 -3
  4. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/client.rb +32 -3
  5. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/service_stub.rb +22 -8
  6. data/lib/google/cloud/dataflow/v1beta3/jobs/client.rb +46 -15
  7. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/client.rb +42 -13
  8. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/service_stub.rb +62 -38
  9. data/lib/google/cloud/dataflow/v1beta3/messages/client.rb +33 -3
  10. data/lib/google/cloud/dataflow/v1beta3/messages/rest/client.rb +32 -3
  11. data/lib/google/cloud/dataflow/v1beta3/messages/rest/service_stub.rb +22 -8
  12. data/lib/google/cloud/dataflow/v1beta3/metrics/client.rb +38 -7
  13. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/client.rb +38 -7
  14. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/service_stub.rb +38 -20
  15. data/lib/google/cloud/dataflow/v1beta3/snapshots/client.rb +36 -7
  16. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/client.rb +36 -7
  17. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/service_stub.rb +38 -20
  18. data/lib/google/cloud/dataflow/v1beta3/templates_service/client.rb +36 -7
  19. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/client.rb +36 -7
  20. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/service_stub.rb +38 -20
  21. data/lib/google/cloud/dataflow/v1beta3/version.rb +1 -1
  22. data/proto_docs/google/api/client.rb +74 -10
  23. data/proto_docs/google/api/resource.rb +7 -2
  24. metadata +5 -5
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the get_snapshot REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "get_snapshot",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::Snapshot.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "delete_snapshot",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Dataflow::V1beta3::DeleteSnapshotResponse.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "list_snapshots",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::Dataflow::V1beta3::ListSnapshotsResponse.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -30,6 +30,9 @@ module Google
30
30
  # Provides a method to create Cloud Dataflow jobs from templates.
31
31
  #
32
32
  class Client
33
+ # @private
34
+ API_VERSION = ""
35
+
33
36
  # @private
34
37
  DEFAULT_ENDPOINT_TEMPLATE = "dataflow.$UNIVERSE_DOMAIN$"
35
38
 
@@ -154,8 +157,28 @@ module Google
154
157
  universe_domain: @config.universe_domain,
155
158
  channel_args: @config.channel_args,
156
159
  interceptors: @config.interceptors,
157
- channel_pool_config: @config.channel_pool
160
+ channel_pool_config: @config.channel_pool,
161
+ logger: @config.logger
158
162
  )
163
+
164
+ @templates_service_stub.stub_logger&.info do |entry|
165
+ entry.set_system_name
166
+ entry.set_service
167
+ entry.message = "Created client for #{entry.service}"
168
+ entry.set_credentials_fields credentials
169
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
170
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
171
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
172
+ end
173
+ end
174
+
175
+ ##
176
+ # The logger used for request/response debug logging.
177
+ #
178
+ # @return [Logger]
179
+ #
180
+ def logger
181
+ @templates_service_stub.logger
159
182
  end
160
183
 
161
184
  # Service calls
@@ -229,10 +252,11 @@ module Google
229
252
  # Customize the options with defaults
230
253
  metadata = @config.rpcs.create_job_from_template.metadata.to_h
231
254
 
232
- # Set x-goog-api-client and x-goog-user-project headers
255
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
233
256
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
234
257
  lib_name: @config.lib_name, lib_version: @config.lib_version,
235
258
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION
259
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
236
260
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
237
261
 
238
262
  header_params = {}
@@ -256,7 +280,6 @@ module Google
256
280
 
257
281
  @templates_service_stub.call_rpc :create_job_from_template, request, options: options do |response, operation|
258
282
  yield response, operation if block_given?
259
- return response
260
283
  end
261
284
  rescue ::GRPC::BadStatus => e
262
285
  raise ::Google::Cloud::Error.from_error(e)
@@ -333,10 +356,11 @@ module Google
333
356
  # Customize the options with defaults
334
357
  metadata = @config.rpcs.launch_template.metadata.to_h
335
358
 
336
- # Set x-goog-api-client and x-goog-user-project headers
359
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
337
360
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
338
361
  lib_name: @config.lib_name, lib_version: @config.lib_version,
339
362
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION
363
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
340
364
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
341
365
 
342
366
  header_params = {}
@@ -360,7 +384,6 @@ module Google
360
384
 
361
385
  @templates_service_stub.call_rpc :launch_template, request, options: options do |response, operation|
362
386
  yield response, operation if block_given?
363
- return response
364
387
  end
365
388
  rescue ::GRPC::BadStatus => e
366
389
  raise ::Google::Cloud::Error.from_error(e)
@@ -431,10 +454,11 @@ module Google
431
454
  # Customize the options with defaults
432
455
  metadata = @config.rpcs.get_template.metadata.to_h
433
456
 
434
- # Set x-goog-api-client and x-goog-user-project headers
457
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
435
458
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
436
459
  lib_name: @config.lib_name, lib_version: @config.lib_version,
437
460
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION
461
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
438
462
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
439
463
 
440
464
  header_params = {}
@@ -458,7 +482,6 @@ module Google
458
482
 
459
483
  @templates_service_stub.call_rpc :get_template, request, options: options do |response, operation|
460
484
  yield response, operation if block_given?
461
- return response
462
485
  end
463
486
  rescue ::GRPC::BadStatus => e
464
487
  raise ::Google::Cloud::Error.from_error(e)
@@ -547,6 +570,11 @@ module Google
547
570
  # default endpoint URL. The default value of nil uses the environment
548
571
  # universe (usually the default "googleapis.com" universe).
549
572
  # @return [::String,nil]
573
+ # @!attribute [rw] logger
574
+ # A custom logger to use for request/response debug logging, or the value
575
+ # `:default` (the default) to construct a default logger, or `nil` to
576
+ # explicitly disable logging.
577
+ # @return [::Logger,:default,nil]
550
578
  #
551
579
  class Configuration
552
580
  extend ::Gapic::Config
@@ -571,6 +599,7 @@ module Google
571
599
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
572
600
  config_attr :quota_project, nil, ::String, nil
573
601
  config_attr :universe_domain, nil, ::String, nil
602
+ config_attr :logger, :default, ::Logger, nil, :default
574
603
 
575
604
  # @private
576
605
  def initialize parent_config = nil
@@ -32,6 +32,9 @@ module Google
32
32
  # Provides a method to create Cloud Dataflow jobs from templates.
33
33
  #
34
34
  class Client
35
+ # @private
36
+ API_VERSION = ""
37
+
35
38
  # @private
36
39
  DEFAULT_ENDPOINT_TEMPLATE = "dataflow.$UNIVERSE_DOMAIN$"
37
40
 
@@ -147,8 +150,28 @@ module Google
147
150
  endpoint: @config.endpoint,
148
151
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
149
152
  universe_domain: @config.universe_domain,
150
- credentials: credentials
153
+ credentials: credentials,
154
+ logger: @config.logger
151
155
  )
156
+
157
+ @templates_service_stub.logger(stub: true)&.info do |entry|
158
+ entry.set_system_name
159
+ entry.set_service
160
+ entry.message = "Created client for #{entry.service}"
161
+ entry.set_credentials_fields credentials
162
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
163
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
164
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
165
+ end
166
+ end
167
+
168
+ ##
169
+ # The logger used for request/response debug logging.
170
+ #
171
+ # @return [Logger]
172
+ #
173
+ def logger
174
+ @templates_service_stub.logger
152
175
  end
153
176
 
154
177
  # Service calls
@@ -221,12 +244,13 @@ module Google
221
244
  # Customize the options with defaults
222
245
  call_metadata = @config.rpcs.create_job_from_template.metadata.to_h
223
246
 
224
- # Set x-goog-api-client and x-goog-user-project headers
247
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
225
248
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
226
249
  lib_name: @config.lib_name, lib_version: @config.lib_version,
227
250
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
228
251
  transports_version_send: [:rest]
229
252
 
253
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
230
254
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
231
255
 
232
256
  options.apply_defaults timeout: @config.rpcs.create_job_from_template.timeout,
@@ -239,7 +263,6 @@ module Google
239
263
 
240
264
  @templates_service_stub.create_job_from_template request, options do |result, operation|
241
265
  yield result, operation if block_given?
242
- return result
243
266
  end
244
267
  rescue ::Gapic::Rest::Error => e
245
268
  raise ::Google::Cloud::Error.from_error(e)
@@ -315,12 +338,13 @@ module Google
315
338
  # Customize the options with defaults
316
339
  call_metadata = @config.rpcs.launch_template.metadata.to_h
317
340
 
318
- # Set x-goog-api-client and x-goog-user-project headers
341
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
319
342
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
320
343
  lib_name: @config.lib_name, lib_version: @config.lib_version,
321
344
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
322
345
  transports_version_send: [:rest]
323
346
 
347
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
324
348
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
325
349
 
326
350
  options.apply_defaults timeout: @config.rpcs.launch_template.timeout,
@@ -333,7 +357,6 @@ module Google
333
357
 
334
358
  @templates_service_stub.launch_template request, options do |result, operation|
335
359
  yield result, operation if block_given?
336
- return result
337
360
  end
338
361
  rescue ::Gapic::Rest::Error => e
339
362
  raise ::Google::Cloud::Error.from_error(e)
@@ -403,12 +426,13 @@ module Google
403
426
  # Customize the options with defaults
404
427
  call_metadata = @config.rpcs.get_template.metadata.to_h
405
428
 
406
- # Set x-goog-api-client and x-goog-user-project headers
429
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
407
430
  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
408
431
  lib_name: @config.lib_name, lib_version: @config.lib_version,
409
432
  gapic_version: ::Google::Cloud::Dataflow::V1beta3::VERSION,
410
433
  transports_version_send: [:rest]
411
434
 
435
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
412
436
  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
413
437
 
414
438
  options.apply_defaults timeout: @config.rpcs.get_template.timeout,
@@ -421,7 +445,6 @@ module Google
421
445
 
422
446
  @templates_service_stub.get_template request, options do |result, operation|
423
447
  yield result, operation if block_given?
424
- return result
425
448
  end
426
449
  rescue ::Gapic::Rest::Error => e
427
450
  raise ::Google::Cloud::Error.from_error(e)
@@ -501,6 +524,11 @@ module Google
501
524
  # default endpoint URL. The default value of nil uses the environment
502
525
  # universe (usually the default "googleapis.com" universe).
503
526
  # @return [::String,nil]
527
+ # @!attribute [rw] logger
528
+ # A custom logger to use for request/response debug logging, or the value
529
+ # `:default` (the default) to construct a default logger, or `nil` to
530
+ # explicitly disable logging.
531
+ # @return [::Logger,:default,nil]
504
532
  #
505
533
  class Configuration
506
534
  extend ::Gapic::Config
@@ -522,6 +550,7 @@ module Google
522
550
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
523
551
  config_attr :quota_project, nil, ::String, nil
524
552
  config_attr :universe_domain, nil, ::String, nil
553
+ config_attr :logger, :default, ::Logger, nil, :default
525
554
 
526
555
  # @private
527
556
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the create_job_from_template REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "create_job_from_template",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "launch_template",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Dataflow::V1beta3::LaunchTemplateResponse.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "get_template",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Cloud::Dataflow::V1beta3::GetTemplateResponse.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module Dataflow
23
23
  module V1beta3
24
- VERSION = "0.9.0"
24
+ VERSION = "0.10.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -118,6 +121,10 @@ module Google
118
121
  # @return [::String]
119
122
  # Optional link to proto reference documentation. Example:
120
123
  # https://cloud.google.com/pubsub/lite/docs/reference/rpc
124
+ # @!attribute [rw] rest_reference_documentation_uri
125
+ # @return [::String]
126
+ # Optional link to REST reference documentation. Example:
127
+ # https://cloud.google.com/pubsub/lite/docs/reference/rest
121
128
  class Publishing
122
129
  include ::Google::Protobuf::MessageExts
123
130
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -192,9 +199,32 @@ module Google
192
199
  # @!attribute [rw] common
193
200
  # @return [::Google::Api::CommonLanguageSettings]
194
201
  # Some settings.
202
+ # @!attribute [rw] experimental_features
203
+ # @return [::Google::Api::PythonSettings::ExperimentalFeatures]
204
+ # Experimental features to be included during client library generation.
195
205
  class PythonSettings
196
206
  include ::Google::Protobuf::MessageExts
197
207
  extend ::Google::Protobuf::MessageExts::ClassMethods
208
+
209
+ # Experimental features to be included during client library generation.
210
+ # These fields will be deprecated once the feature graduates and is enabled
211
+ # by default.
212
+ # @!attribute [rw] rest_async_io_enabled
213
+ # @return [::Boolean]
214
+ # Enables generation of asynchronous REST clients if `rest` transport is
215
+ # enabled. By default, asynchronous REST clients will not be generated.
216
+ # This feature will be enabled by default 1 month after launching the
217
+ # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
224
+ class ExperimentalFeatures
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
198
228
  end
199
229
 
200
230
  # Settings for Node client libraries.
@@ -276,9 +306,28 @@ module Google
276
306
  # @!attribute [rw] common
277
307
  # @return [::Google::Api::CommonLanguageSettings]
278
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
279
319
  class GoSettings
280
320
  include ::Google::Protobuf::MessageExts
281
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
282
331
  end
283
332
 
284
333
  # Describes the generator configuration for a method.
@@ -286,6 +335,13 @@ module Google
286
335
  # @return [::String]
287
336
  # The fully qualified name of the method, for which the options below apply.
288
337
  # This is used to find the method to apply the options.
338
+ #
339
+ # Example:
340
+ #
341
+ # publishing:
342
+ # method_settings:
343
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
344
+ # # method settings for CreateFolder...
289
345
  # @!attribute [rw] long_running
290
346
  # @return [::Google::Api::MethodSettings::LongRunning]
291
347
  # Describes settings to use for long-running operations when generating
@@ -294,17 +350,14 @@ module Google
294
350
  #
295
351
  # Example of a YAML configuration::
296
352
  #
297
- # publishing:
298
- # method_settings:
353
+ # publishing:
354
+ # method_settings:
299
355
  # - selector: google.cloud.speech.v2.Speech.BatchRecognize
300
356
  # long_running:
301
- # initial_poll_delay:
302
- # seconds: 60 # 1 minute
357
+ # initial_poll_delay: 60s # 1 minute
303
358
  # poll_delay_multiplier: 1.5
304
- # max_poll_delay:
305
- # seconds: 360 # 6 minutes
306
- # total_poll_timeout:
307
- # seconds: 54000 # 90 minutes
359
+ # max_poll_delay: 360s # 6 minutes
360
+ # total_poll_timeout: 54000s # 90 minutes
308
361
  # @!attribute [rw] auto_populated_fields
309
362
  # @return [::Array<::String>]
310
363
  # List of top-level fields of the request message, that should be
@@ -313,8 +366,8 @@ module Google
313
366
  #
314
367
  # Example of a YAML configuration:
315
368
  #
316
- # publishing:
317
- # method_settings:
369
+ # publishing:
370
+ # method_settings:
318
371
  # - selector: google.example.v1.ExampleService.CreateExample
319
372
  # auto_populated_fields:
320
373
  # - request_id
@@ -350,6 +403,17 @@ module Google
350
403
  end
351
404
  end
352
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
353
417
  # The organization for which the client libraries are being published.
354
418
  # Affects the url where generated docs are published, etc.
355
419
  module ClientLibraryOrganization
@@ -124,8 +124,13 @@ module Google
124
124
  # @return [::String]
125
125
  # The plural name used in the resource name and permission names, such as
126
126
  # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
- # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
- # concept of the `plural` field in k8s CRD spec
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
128
+ # to this is for Nested Collections that have stuttering names, as defined
129
+ # in [AIP-122](https://google.aip.dev/122#nested-collections), where the
130
+ # collection ID in the resource name pattern does not necessarily directly
131
+ # match the `plural` value.
132
+ #
133
+ # It is the same concept of the `plural` field in k8s CRD spec
129
134
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
135
  #
131
136
  # Note: The plural form is required even for singleton resources. See