google-cloud-dataflow-v1beta3 0.4.0 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (37) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +1 -1
  3. data/README.md +2 -2
  4. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/client.rb +351 -0
  5. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest/service_stub.rb +109 -0
  6. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service/rest.rb +51 -0
  7. data/lib/google/cloud/dataflow/v1beta3/flex_templates_service.rb +7 -1
  8. data/lib/google/cloud/dataflow/v1beta3/jobs/client.rb +8 -12
  9. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/client.rb +784 -0
  10. data/lib/google/cloud/dataflow/v1beta3/jobs/rest/service_stub.rb +454 -0
  11. data/lib/google/cloud/dataflow/v1beta3/jobs/rest.rb +52 -0
  12. data/lib/google/cloud/dataflow/v1beta3/jobs.rb +7 -1
  13. data/lib/google/cloud/dataflow/v1beta3/messages/client.rb +4 -6
  14. data/lib/google/cloud/dataflow/v1beta3/messages/rest/client.rb +373 -0
  15. data/lib/google/cloud/dataflow/v1beta3/messages/rest/service_stub.rb +117 -0
  16. data/lib/google/cloud/dataflow/v1beta3/messages/rest.rb +52 -0
  17. data/lib/google/cloud/dataflow/v1beta3/messages.rb +7 -1
  18. data/lib/google/cloud/dataflow/v1beta3/metrics/client.rb +8 -12
  19. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/client.rb +539 -0
  20. data/lib/google/cloud/dataflow/v1beta3/metrics/rest/service_stub.rb +240 -0
  21. data/lib/google/cloud/dataflow/v1beta3/metrics/rest.rb +52 -0
  22. data/lib/google/cloud/dataflow/v1beta3/metrics.rb +7 -1
  23. data/lib/google/cloud/dataflow/v1beta3/rest.rb +42 -0
  24. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/client.rb +494 -0
  25. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest/service_stub.rb +261 -0
  26. data/lib/google/cloud/dataflow/v1beta3/snapshots/rest.rb +51 -0
  27. data/lib/google/cloud/dataflow/v1beta3/snapshots.rb +7 -1
  28. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/client.rb +522 -0
  29. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest/service_stub.rb +253 -0
  30. data/lib/google/cloud/dataflow/v1beta3/templates_service/rest.rb +51 -0
  31. data/lib/google/cloud/dataflow/v1beta3/templates_service.rb +7 -1
  32. data/lib/google/cloud/dataflow/v1beta3/version.rb +1 -1
  33. data/lib/google/cloud/dataflow/v1beta3.rb +7 -2
  34. data/proto_docs/google/api/client.rb +318 -0
  35. data/proto_docs/google/api/launch_stage.rb +71 -0
  36. data/proto_docs/google/rpc/status.rb +4 -2
  37. metadata +29 -8
data/lib/google/cloud/dataflow/v1beta3/jobs/rest/service_stub.rb ADDED
@@ -0,0 +1,454 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/dataflow/v1beta3/jobs_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module Dataflow
24
+ module V1beta3
25
+ module Jobs
26
+ module Rest
27
+ ##
28
+ # REST service stub for the Jobs service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ def initialize endpoint:, credentials:
34
+ # These require statements are intentionally placed here to initialize
35
+ # the REST modules only when it's required.
36
+ require "gapic/rest"
37
+
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ numeric_enums: true,
40
+ raise_faraday_errors: false
41
+ end
42
+
43
+ ##
44
+ # Baseline implementation for the create_job REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::CreateJobRequest]
47
+ # A request object representing the call parameters. Required.
48
+ # @param options [::Gapic::CallOptions]
49
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
50
+ #
51
+ # @yield [result, operation] Access the result along with the TransportOperation object
52
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::Job]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::Dataflow::V1beta3::Job]
56
+ # A result object deserialized from the server's reply
57
+ def create_job request_pb, options = nil
58
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
59
+
60
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_job_request request_pb
61
+ query_string_params = if query_string_params.any?
62
+ query_string_params.to_h { |p| p.split("=", 2) }
63
+ else
64
+ {}
65
+ end
66
+
67
+ response = @client_stub.make_http_request(
68
+ verb,
69
+ uri: uri,
70
+ body: body || "",
71
+ params: query_string_params,
72
+ options: options
73
+ )
74
+ operation = ::Gapic::Rest::TransportOperation.new response
75
+ result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
76
+
77
+ yield result, operation if block_given?
78
+ result
79
+ end
80
+
81
+ ##
82
+ # Baseline implementation for the get_job REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::GetJobRequest]
85
+ # A request object representing the call parameters. Required.
86
+ # @param options [::Gapic::CallOptions]
87
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
88
+ #
89
+ # @yield [result, operation] Access the result along with the TransportOperation object
90
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::Job]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::Dataflow::V1beta3::Job]
94
+ # A result object deserialized from the server's reply
95
+ def get_job request_pb, options = nil
96
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
97
+
98
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_job_request request_pb
99
+ query_string_params = if query_string_params.any?
100
+ query_string_params.to_h { |p| p.split("=", 2) }
101
+ else
102
+ {}
103
+ end
104
+
105
+ response = @client_stub.make_http_request(
106
+ verb,
107
+ uri: uri,
108
+ body: body || "",
109
+ params: query_string_params,
110
+ options: options
111
+ )
112
+ operation = ::Gapic::Rest::TransportOperation.new response
113
+ result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
114
+
115
+ yield result, operation if block_given?
116
+ result
117
+ end
118
+
119
+ ##
120
+ # Baseline implementation for the update_job REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::UpdateJobRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @param options [::Gapic::CallOptions]
125
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
+ #
127
+ # @yield [result, operation] Access the result along with the TransportOperation object
128
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::Job]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Cloud::Dataflow::V1beta3::Job]
132
+ # A result object deserialized from the server's reply
133
+ def update_job request_pb, options = nil
134
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
135
+
136
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_job_request request_pb
137
+ query_string_params = if query_string_params.any?
138
+ query_string_params.to_h { |p| p.split("=", 2) }
139
+ else
140
+ {}
141
+ end
142
+
143
+ response = @client_stub.make_http_request(
144
+ verb,
145
+ uri: uri,
146
+ body: body || "",
147
+ params: query_string_params,
148
+ options: options
149
+ )
150
+ operation = ::Gapic::Rest::TransportOperation.new response
151
+ result = ::Google::Cloud::Dataflow::V1beta3::Job.decode_json response.body, ignore_unknown_fields: true
152
+
153
+ yield result, operation if block_given?
154
+ result
155
+ end
156
+
157
+ ##
158
+ # Baseline implementation for the list_jobs REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::ListJobsRequest]
161
+ # A request object representing the call parameters. Required.
162
+ # @param options [::Gapic::CallOptions]
163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
164
+ #
165
+ # @yield [result, operation] Access the result along with the TransportOperation object
166
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::ListJobsResponse]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Cloud::Dataflow::V1beta3::ListJobsResponse]
170
+ # A result object deserialized from the server's reply
171
+ def list_jobs request_pb, options = nil
172
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
173
+
174
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_jobs_request request_pb
175
+ query_string_params = if query_string_params.any?
176
+ query_string_params.to_h { |p| p.split("=", 2) }
177
+ else
178
+ {}
179
+ end
180
+
181
+ response = @client_stub.make_http_request(
182
+ verb,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Cloud::Dataflow::V1beta3::ListJobsResponse.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # Baseline implementation for the aggregated_list_jobs REST call
197
+ #
198
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::ListJobsRequest]
199
+ # A request object representing the call parameters. Required.
200
+ # @param options [::Gapic::CallOptions]
201
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
202
+ #
203
+ # @yield [result, operation] Access the result along with the TransportOperation object
204
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::ListJobsResponse]
205
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
206
+ #
207
+ # @return [::Google::Cloud::Dataflow::V1beta3::ListJobsResponse]
208
+ # A result object deserialized from the server's reply
209
+ def aggregated_list_jobs request_pb, options = nil
210
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
211
+
212
+ verb, uri, query_string_params, body = ServiceStub.transcode_aggregated_list_jobs_request request_pb
213
+ query_string_params = if query_string_params.any?
214
+ query_string_params.to_h { |p| p.split("=", 2) }
215
+ else
216
+ {}
217
+ end
218
+
219
+ response = @client_stub.make_http_request(
220
+ verb,
221
+ uri: uri,
222
+ body: body || "",
223
+ params: query_string_params,
224
+ options: options
225
+ )
226
+ operation = ::Gapic::Rest::TransportOperation.new response
227
+ result = ::Google::Cloud::Dataflow::V1beta3::ListJobsResponse.decode_json response.body, ignore_unknown_fields: true
228
+
229
+ yield result, operation if block_given?
230
+ result
231
+ end
232
+
233
+ ##
234
+ # Baseline implementation for the snapshot_job REST call
235
+ #
236
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::SnapshotJobRequest]
237
+ # A request object representing the call parameters. Required.
238
+ # @param options [::Gapic::CallOptions]
239
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
240
+ #
241
+ # @yield [result, operation] Access the result along with the TransportOperation object
242
+ # @yieldparam result [::Google::Cloud::Dataflow::V1beta3::Snapshot]
243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
244
+ #
245
+ # @return [::Google::Cloud::Dataflow::V1beta3::Snapshot]
246
+ # A result object deserialized from the server's reply
247
+ def snapshot_job request_pb, options = nil
248
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
249
+
250
+ verb, uri, query_string_params, body = ServiceStub.transcode_snapshot_job_request request_pb
251
+ query_string_params = if query_string_params.any?
252
+ query_string_params.to_h { |p| p.split("=", 2) }
253
+ else
254
+ {}
255
+ end
256
+
257
+ response = @client_stub.make_http_request(
258
+ verb,
259
+ uri: uri,
260
+ body: body || "",
261
+ params: query_string_params,
262
+ options: options
263
+ )
264
+ operation = ::Gapic::Rest::TransportOperation.new response
265
+ result = ::Google::Cloud::Dataflow::V1beta3::Snapshot.decode_json response.body, ignore_unknown_fields: true
266
+
267
+ yield result, operation if block_given?
268
+ result
269
+ end
270
+
271
+ ##
272
+ # @private
273
+ #
274
+ # GRPC transcoding helper method for the create_job REST call
275
+ #
276
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::CreateJobRequest]
277
+ # A request object representing the call parameters. Required.
278
+ # @return [Array(String, [String, nil], Hash{String => String})]
279
+ # Uri, Body, Query string parameters
280
+ def self.transcode_create_job_request request_pb
281
+ transcoder = Gapic::Rest::GrpcTranscoder.new
282
+ .with_bindings(
283
+ uri_method: :post,
284
+ uri_template: "/v1b3/projects/{project_id}/locations/{location}/jobs",
285
+ body: "job",
286
+ matches: [
287
+ ["project_id", %r{^[^/]+/?$}, false],
288
+ ["location", %r{^[^/]+/?$}, false]
289
+ ]
290
+ )
291
+ .with_bindings(
292
+ uri_method: :post,
293
+ uri_template: "/v1b3/projects/{project_id}/jobs",
294
+ body: "job",
295
+ matches: [
296
+ ["project_id", %r{^[^/]+/?$}, false]
297
+ ]
298
+ )
299
+ transcoder.transcode request_pb
300
+ end
301
+
302
+ ##
303
+ # @private
304
+ #
305
+ # GRPC transcoding helper method for the get_job REST call
306
+ #
307
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::GetJobRequest]
308
+ # A request object representing the call parameters. Required.
309
+ # @return [Array(String, [String, nil], Hash{String => String})]
310
+ # Uri, Body, Query string parameters
311
+ def self.transcode_get_job_request request_pb
312
+ transcoder = Gapic::Rest::GrpcTranscoder.new
313
+ .with_bindings(
314
+ uri_method: :get,
315
+ uri_template: "/v1b3/projects/{project_id}/locations/{location}/jobs/{job_id}",
316
+ matches: [
317
+ ["project_id", %r{^[^/]+/?$}, false],
318
+ ["location", %r{^[^/]+/?$}, false],
319
+ ["job_id", %r{^[^/]+/?$}, false]
320
+ ]
321
+ )
322
+ .with_bindings(
323
+ uri_method: :get,
324
+ uri_template: "/v1b3/projects/{project_id}/jobs/{job_id}",
325
+ matches: [
326
+ ["project_id", %r{^[^/]+/?$}, false],
327
+ ["job_id", %r{^[^/]+/?$}, false]
328
+ ]
329
+ )
330
+ transcoder.transcode request_pb
331
+ end
332
+
333
+ ##
334
+ # @private
335
+ #
336
+ # GRPC transcoding helper method for the update_job REST call
337
+ #
338
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::UpdateJobRequest]
339
+ # A request object representing the call parameters. Required.
340
+ # @return [Array(String, [String, nil], Hash{String => String})]
341
+ # Uri, Body, Query string parameters
342
+ def self.transcode_update_job_request request_pb
343
+ transcoder = Gapic::Rest::GrpcTranscoder.new
344
+ .with_bindings(
345
+ uri_method: :put,
346
+ uri_template: "/v1b3/projects/{project_id}/locations/{location}/jobs/{job_id}",
347
+ body: "job",
348
+ matches: [
349
+ ["project_id", %r{^[^/]+/?$}, false],
350
+ ["location", %r{^[^/]+/?$}, false],
351
+ ["job_id", %r{^[^/]+/?$}, false]
352
+ ]
353
+ )
354
+ .with_bindings(
355
+ uri_method: :put,
356
+ uri_template: "/v1b3/projects/{project_id}/jobs/{job_id}",
357
+ body: "job",
358
+ matches: [
359
+ ["project_id", %r{^[^/]+/?$}, false],
360
+ ["job_id", %r{^[^/]+/?$}, false]
361
+ ]
362
+ )
363
+ transcoder.transcode request_pb
364
+ end
365
+
366
+ ##
367
+ # @private
368
+ #
369
+ # GRPC transcoding helper method for the list_jobs REST call
370
+ #
371
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::ListJobsRequest]
372
+ # A request object representing the call parameters. Required.
373
+ # @return [Array(String, [String, nil], Hash{String => String})]
374
+ # Uri, Body, Query string parameters
375
+ def self.transcode_list_jobs_request request_pb
376
+ transcoder = Gapic::Rest::GrpcTranscoder.new
377
+ .with_bindings(
378
+ uri_method: :get,
379
+ uri_template: "/v1b3/projects/{project_id}/locations/{location}/jobs",
380
+ matches: [
381
+ ["project_id", %r{^[^/]+/?$}, false],
382
+ ["location", %r{^[^/]+/?$}, false]
383
+ ]
384
+ )
385
+ .with_bindings(
386
+ uri_method: :get,
387
+ uri_template: "/v1b3/projects/{project_id}/jobs",
388
+ matches: [
389
+ ["project_id", %r{^[^/]+/?$}, false]
390
+ ]
391
+ )
392
+ transcoder.transcode request_pb
393
+ end
394
+
395
+ ##
396
+ # @private
397
+ #
398
+ # GRPC transcoding helper method for the aggregated_list_jobs REST call
399
+ #
400
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::ListJobsRequest]
401
+ # A request object representing the call parameters. Required.
402
+ # @return [Array(String, [String, nil], Hash{String => String})]
403
+ # Uri, Body, Query string parameters
404
+ def self.transcode_aggregated_list_jobs_request request_pb
405
+ transcoder = Gapic::Rest::GrpcTranscoder.new
406
+ .with_bindings(
407
+ uri_method: :get,
408
+ uri_template: "/v1b3/projects/{project_id}/jobs:aggregated",
409
+ matches: [
410
+ ["project_id", %r{^[^/]+/?$}, false]
411
+ ]
412
+ )
413
+ transcoder.transcode request_pb
414
+ end
415
+
416
+ ##
417
+ # @private
418
+ #
419
+ # GRPC transcoding helper method for the snapshot_job REST call
420
+ #
421
+ # @param request_pb [::Google::Cloud::Dataflow::V1beta3::SnapshotJobRequest]
422
+ # A request object representing the call parameters. Required.
423
+ # @return [Array(String, [String, nil], Hash{String => String})]
424
+ # Uri, Body, Query string parameters
425
+ def self.transcode_snapshot_job_request request_pb
426
+ transcoder = Gapic::Rest::GrpcTranscoder.new
427
+ .with_bindings(
428
+ uri_method: :post,
429
+ uri_template: "/v1b3/projects/{project_id}/locations/{location}/jobs/{job_id}:snapshot",
430
+ body: "*",
431
+ matches: [
432
+ ["project_id", %r{^[^/]+/?$}, false],
433
+ ["location", %r{^[^/]+/?$}, false],
434
+ ["job_id", %r{^[^/]+/?$}, false]
435
+ ]
436
+ )
437
+ .with_bindings(
438
+ uri_method: :post,
439
+ uri_template: "/v1b3/projects/{project_id}/jobs/{job_id}:snapshot",
440
+ body: "*",
441
+ matches: [
442
+ ["project_id", %r{^[^/]+/?$}, false],
443
+ ["job_id", %r{^[^/]+/?$}, false]
444
+ ]
445
+ )
446
+ transcoder.transcode request_pb
447
+ end
448
+ end
449
+ end
450
+ end
451
+ end
452
+ end
453
+ end
454
+ end
data/lib/google/cloud/dataflow/v1beta3/jobs/rest.rb ADDED
@@ -0,0 +1,52 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/cloud/dataflow/v1beta3/version"
24
+
25
+ require "google/cloud/dataflow/v1beta3/jobs/credentials"
26
+ require "google/cloud/dataflow/v1beta3/jobs/rest/client"
27
+
28
+ module Google
29
+ module Cloud
30
+ module Dataflow
31
+ module V1beta3
32
+ ##
33
+ # Provides a method to create and modify Google Cloud Dataflow jobs.
34
+ # A Job is a multi-stage computation graph run by the Cloud Dataflow service.
35
+ #
36
+ # To load this service and instantiate a REST client:
37
+ #
38
+ # require "google/cloud/dataflow/v1beta3/jobs/rest"
39
+ # client = ::Google::Cloud::Dataflow::V1beta3::Jobs::Rest::Client.new
40
+ #
41
+ module Jobs
42
+ # Client for the REST transport
43
+ module Rest
44
+ end
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+
51
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
52
+ require "google/cloud/dataflow/v1beta3/jobs/rest/helpers" if ::File.file? helper_path
data/lib/google/cloud/dataflow/v1beta3/jobs.rb CHANGED
@@ -24,6 +24,7 @@ require "google/cloud/dataflow/v1beta3/version"
24
24
 
25
25
  require "google/cloud/dataflow/v1beta3/jobs/credentials"
26
26
  require "google/cloud/dataflow/v1beta3/jobs/client"
27
+ require "google/cloud/dataflow/v1beta3/jobs/rest"
27
28
 
28
29
  module Google
29
30
  module Cloud
@@ -33,11 +34,16 @@ module Google
33
34
  # Provides a method to create and modify Google Cloud Dataflow jobs.
34
35
  # A Job is a multi-stage computation graph run by the Cloud Dataflow service.
35
36
  #
36
- # To load this service and instantiate a client:
37
+ # @example Load this service and instantiate a gRPC client
37
38
  #
38
39
  # require "google/cloud/dataflow/v1beta3/jobs"
39
40
  # client = ::Google::Cloud::Dataflow::V1beta3::Jobs::Client.new
40
41
  #
42
+ # @example Load this service and instantiate a REST client
43
+ #
44
+ # require "google/cloud/dataflow/v1beta3/jobs/rest"
45
+ # client = ::Google::Cloud::Dataflow::V1beta3::Jobs::Rest::Client.new
46
+ #
41
47
  module Jobs
42
48
  end
43
49
  end
data/lib/google/cloud/dataflow/v1beta3/messages/client.rb CHANGED
@@ -214,13 +214,11 @@ module Google
214
214
  # # Call the list_job_messages method.
215
215
  # result = client.list_job_messages request
216
216
  #
217
- # # The returned object is of type Gapic::PagedEnumerable. You can
218
- # # iterate over all elements by calling #each, and the enumerable
219
- # # will lazily make API calls to fetch subsequent pages. Other
220
- # # methods are also available for managing paging directly.
221
- # result.each do |response|
217
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
218
+ # # over elements, and API calls will be issued to fetch pages as needed.
219
+ # result.each do |item|
222
220
  # # Each element is of type ::Google::Cloud::Dataflow::V1beta3::JobMessage.
223
- # p response
221
+ # p item
224
222
  # end
225
223
  #
226
224
  def list_job_messages request, options = nil