google-cloud-dataflow-v1beta3 0.4.0 → 0.5.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 (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
@@ -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
@@ -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
@@ -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
@@ -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