google-area120-tables-v1alpha1 0.2.5 → 0.4.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.
@@ -0,0 +1,1220 @@
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/cloud/errors"
20
+ require "google/area120/tables/v1alpha1/tables_pb"
21
+ require "google/area120/tables/v1alpha1/tables_service/rest/service_stub"
22
+
23
+ module Google
24
+ module Area120
25
+ module Tables
26
+ module V1alpha1
27
+ module TablesService
28
+ module Rest
29
+ ##
30
+ # REST client for the TablesService service.
31
+ #
32
+ # The Tables Service provides an API for reading and updating tables.
33
+ # It defines the following resource model:
34
+ #
35
+ # - The API has a collection of {::Google::Area120::Tables::V1alpha1::Table Table}
36
+ # resources, named `tables/*`
37
+ #
38
+ # - Each Table has a collection of {::Google::Area120::Tables::V1alpha1::Row Row}
39
+ # resources, named `tables/*/rows/*`
40
+ #
41
+ # - The API has a collection of
42
+ # {::Google::Area120::Tables::V1alpha1::Workspace Workspace}
43
+ # resources, named `workspaces/*`.
44
+ #
45
+ class Client
46
+ include Paths
47
+
48
+ # @private
49
+ attr_reader :tables_service_stub
50
+
51
+ ##
52
+ # Configure the TablesService Client class.
53
+ #
54
+ # See {::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client::Configuration}
55
+ # for a description of the configuration fields.
56
+ #
57
+ # @example
58
+ #
59
+ # # Modify the configuration for all TablesService clients
60
+ # ::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client.configure do |config|
61
+ # config.timeout = 10.0
62
+ # end
63
+ #
64
+ # @yield [config] Configure the Client client.
65
+ # @yieldparam config [Client::Configuration]
66
+ #
67
+ # @return [Client::Configuration]
68
+ #
69
+ def self.configure
70
+ @configure ||= begin
71
+ namespace = ["Google", "Area120", "Tables", "V1alpha1"]
72
+ parent_config = while namespace.any?
73
+ parent_name = namespace.join "::"
74
+ parent_const = const_get parent_name
75
+ break parent_const.configure if parent_const.respond_to? :configure
76
+ namespace.pop
77
+ end
78
+ default_config = Client::Configuration.new parent_config
79
+
80
+ default_config.timeout = 60.0
81
+ default_config.retry_policy = {
82
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
83
+ }
84
+
85
+ default_config.rpcs.get_table.timeout = 60.0
86
+
87
+ default_config.rpcs.list_tables.timeout = 60.0
88
+
89
+ default_config.rpcs.get_workspace.timeout = 60.0
90
+
91
+ default_config.rpcs.list_workspaces.timeout = 60.0
92
+
93
+ default_config.rpcs.get_row.timeout = 60.0
94
+
95
+ default_config.rpcs.list_rows.timeout = 60.0
96
+
97
+ default_config.rpcs.create_row.timeout = 60.0
98
+
99
+ default_config.rpcs.batch_create_rows.timeout = 60.0
100
+
101
+ default_config.rpcs.update_row.timeout = 60.0
102
+
103
+ default_config.rpcs.batch_update_rows.timeout = 60.0
104
+
105
+ default_config.rpcs.delete_row.timeout = 60.0
106
+
107
+ default_config.rpcs.batch_delete_rows.timeout = 60.0
108
+
109
+ default_config
110
+ end
111
+ yield @configure if block_given?
112
+ @configure
113
+ end
114
+
115
+ ##
116
+ # Configure the TablesService Client instance.
117
+ #
118
+ # The configuration is set to the derived mode, meaning that values can be changed,
119
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
120
+ # should be made on {Client.configure}.
121
+ #
122
+ # See {::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client::Configuration}
123
+ # for a description of the configuration fields.
124
+ #
125
+ # @yield [config] Configure the Client client.
126
+ # @yieldparam config [Client::Configuration]
127
+ #
128
+ # @return [Client::Configuration]
129
+ #
130
+ def configure
131
+ yield @config if block_given?
132
+ @config
133
+ end
134
+
135
+ ##
136
+ # Create a new TablesService REST client object.
137
+ #
138
+ # @example
139
+ #
140
+ # # Create a client using the default configuration
141
+ # client = ::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client.new
142
+ #
143
+ # # Create a client using a custom configuration
144
+ # client = ::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client.new do |config|
145
+ # config.timeout = 10.0
146
+ # end
147
+ #
148
+ # @yield [config] Configure the TablesService client.
149
+ # @yieldparam config [Client::Configuration]
150
+ #
151
+ def initialize
152
+ # Create the configuration object
153
+ @config = Configuration.new Client.configure
154
+
155
+ # Yield the configuration if needed
156
+ yield @config if block_given?
157
+
158
+ # Create credentials
159
+ credentials = @config.credentials
160
+ # Use self-signed JWT if the endpoint is unchanged from default,
161
+ # but only if the default endpoint does not have a region prefix.
162
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
163
+ !@config.endpoint.split(".").first.include?("-")
164
+ credentials ||= Credentials.default scope: @config.scope,
165
+ enable_self_signed_jwt: enable_self_signed_jwt
166
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
167
+ credentials = Credentials.new credentials, scope: @config.scope
168
+ end
169
+
170
+ @quota_project_id = @config.quota_project
171
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
172
+
173
+ @tables_service_stub = ::Google::Area120::Tables::V1alpha1::TablesService::Rest::ServiceStub.new endpoint: @config.endpoint, credentials: credentials
174
+ end
175
+
176
+ # Service calls
177
+
178
+ ##
179
+ # Gets a table. Returns NOT_FOUND if the table does not exist.
180
+ #
181
+ # @overload get_table(request, options = nil)
182
+ # Pass arguments to `get_table` via a request object, either of type
183
+ # {::Google::Area120::Tables::V1alpha1::GetTableRequest} or an equivalent Hash.
184
+ #
185
+ # @param request [::Google::Area120::Tables::V1alpha1::GetTableRequest, ::Hash]
186
+ # A request object representing the call parameters. Required. To specify no
187
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
188
+ # @param options [::Gapic::CallOptions, ::Hash]
189
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
190
+ #
191
+ # @overload get_table(name: nil)
192
+ # Pass arguments to `get_table` via keyword arguments. Note that at
193
+ # least one keyword argument is required. To specify no parameters, or to keep all
194
+ # the default parameter values, pass an empty Hash as a request object (see above).
195
+ #
196
+ # @param name [::String]
197
+ # Required. The name of the table to retrieve.
198
+ # Format: tables/\\{table}
199
+ # @yield [result, operation] Access the result along with the TransportOperation object
200
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::Table]
201
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
202
+ #
203
+ # @return [::Google::Area120::Tables::V1alpha1::Table]
204
+ #
205
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
206
+ def get_table request, options = nil
207
+ raise ::ArgumentError, "request must be provided" if request.nil?
208
+
209
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::GetTableRequest
210
+
211
+ # Converts hash and nil to an options object
212
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
213
+
214
+ # Customize the options with defaults
215
+ call_metadata = @config.rpcs.get_table.metadata.to_h
216
+
217
+ # Set x-goog-api-client and x-goog-user-project headers
218
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
219
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
220
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
221
+ transports_version_send: [:rest]
222
+
223
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
224
+
225
+ options.apply_defaults timeout: @config.rpcs.get_table.timeout,
226
+ metadata: call_metadata,
227
+ retry_policy: @config.rpcs.get_table.retry_policy
228
+
229
+ options.apply_defaults timeout: @config.timeout,
230
+ metadata: @config.metadata,
231
+ retry_policy: @config.retry_policy
232
+
233
+ @tables_service_stub.get_table request, options do |result, operation|
234
+ yield result, operation if block_given?
235
+ return result
236
+ end
237
+ rescue ::Gapic::Rest::Error => e
238
+ raise ::Google::Cloud::Error.from_error(e)
239
+ end
240
+
241
+ ##
242
+ # Lists tables for the user.
243
+ #
244
+ # @overload list_tables(request, options = nil)
245
+ # Pass arguments to `list_tables` via a request object, either of type
246
+ # {::Google::Area120::Tables::V1alpha1::ListTablesRequest} or an equivalent Hash.
247
+ #
248
+ # @param request [::Google::Area120::Tables::V1alpha1::ListTablesRequest, ::Hash]
249
+ # A request object representing the call parameters. Required. To specify no
250
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
251
+ # @param options [::Gapic::CallOptions, ::Hash]
252
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
253
+ #
254
+ # @overload list_tables(page_size: nil, page_token: nil)
255
+ # Pass arguments to `list_tables` via keyword arguments. Note that at
256
+ # least one keyword argument is required. To specify no parameters, or to keep all
257
+ # the default parameter values, pass an empty Hash as a request object (see above).
258
+ #
259
+ # @param page_size [::Integer]
260
+ # The maximum number of tables to return. The service may return fewer than
261
+ # this value.
262
+ #
263
+ # If unspecified, at most 20 tables are returned. The maximum value is 100;
264
+ # values above 100 are coerced to 100.
265
+ # @param page_token [::String]
266
+ # A page token, received from a previous `ListTables` call.
267
+ # Provide this to retrieve the subsequent page.
268
+ #
269
+ # When paginating, all other parameters provided to `ListTables` must match
270
+ # the call that provided the page token.
271
+ # @yield [result, operation] Access the result along with the TransportOperation object
272
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Table>]
273
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
274
+ #
275
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Table>]
276
+ #
277
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
278
+ def list_tables request, options = nil
279
+ raise ::ArgumentError, "request must be provided" if request.nil?
280
+
281
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::ListTablesRequest
282
+
283
+ # Converts hash and nil to an options object
284
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
285
+
286
+ # Customize the options with defaults
287
+ call_metadata = @config.rpcs.list_tables.metadata.to_h
288
+
289
+ # Set x-goog-api-client and x-goog-user-project headers
290
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
291
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
292
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
293
+ transports_version_send: [:rest]
294
+
295
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
296
+
297
+ options.apply_defaults timeout: @config.rpcs.list_tables.timeout,
298
+ metadata: call_metadata,
299
+ retry_policy: @config.rpcs.list_tables.retry_policy
300
+
301
+ options.apply_defaults timeout: @config.timeout,
302
+ metadata: @config.metadata,
303
+ retry_policy: @config.retry_policy
304
+
305
+ @tables_service_stub.list_tables request, options do |result, operation|
306
+ result = ::Gapic::Rest::PagedEnumerable.new @tables_service_stub, :list_tables, "tables", request, result, options
307
+ yield result, operation if block_given?
308
+ return result
309
+ end
310
+ rescue ::Gapic::Rest::Error => e
311
+ raise ::Google::Cloud::Error.from_error(e)
312
+ end
313
+
314
+ ##
315
+ # Gets a workspace. Returns NOT_FOUND if the workspace does not exist.
316
+ #
317
+ # @overload get_workspace(request, options = nil)
318
+ # Pass arguments to `get_workspace` via a request object, either of type
319
+ # {::Google::Area120::Tables::V1alpha1::GetWorkspaceRequest} or an equivalent Hash.
320
+ #
321
+ # @param request [::Google::Area120::Tables::V1alpha1::GetWorkspaceRequest, ::Hash]
322
+ # A request object representing the call parameters. Required. To specify no
323
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
324
+ # @param options [::Gapic::CallOptions, ::Hash]
325
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
326
+ #
327
+ # @overload get_workspace(name: nil)
328
+ # Pass arguments to `get_workspace` via keyword arguments. Note that at
329
+ # least one keyword argument is required. To specify no parameters, or to keep all
330
+ # the default parameter values, pass an empty Hash as a request object (see above).
331
+ #
332
+ # @param name [::String]
333
+ # Required. The name of the workspace to retrieve.
334
+ # Format: workspaces/\\{workspace}
335
+ # @yield [result, operation] Access the result along with the TransportOperation object
336
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::Workspace]
337
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
338
+ #
339
+ # @return [::Google::Area120::Tables::V1alpha1::Workspace]
340
+ #
341
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
342
+ def get_workspace request, options = nil
343
+ raise ::ArgumentError, "request must be provided" if request.nil?
344
+
345
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::GetWorkspaceRequest
346
+
347
+ # Converts hash and nil to an options object
348
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
349
+
350
+ # Customize the options with defaults
351
+ call_metadata = @config.rpcs.get_workspace.metadata.to_h
352
+
353
+ # Set x-goog-api-client and x-goog-user-project headers
354
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
355
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
356
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
357
+ transports_version_send: [:rest]
358
+
359
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
360
+
361
+ options.apply_defaults timeout: @config.rpcs.get_workspace.timeout,
362
+ metadata: call_metadata,
363
+ retry_policy: @config.rpcs.get_workspace.retry_policy
364
+
365
+ options.apply_defaults timeout: @config.timeout,
366
+ metadata: @config.metadata,
367
+ retry_policy: @config.retry_policy
368
+
369
+ @tables_service_stub.get_workspace request, options do |result, operation|
370
+ yield result, operation if block_given?
371
+ return result
372
+ end
373
+ rescue ::Gapic::Rest::Error => e
374
+ raise ::Google::Cloud::Error.from_error(e)
375
+ end
376
+
377
+ ##
378
+ # Lists workspaces for the user.
379
+ #
380
+ # @overload list_workspaces(request, options = nil)
381
+ # Pass arguments to `list_workspaces` via a request object, either of type
382
+ # {::Google::Area120::Tables::V1alpha1::ListWorkspacesRequest} or an equivalent Hash.
383
+ #
384
+ # @param request [::Google::Area120::Tables::V1alpha1::ListWorkspacesRequest, ::Hash]
385
+ # A request object representing the call parameters. Required. To specify no
386
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
387
+ # @param options [::Gapic::CallOptions, ::Hash]
388
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
389
+ #
390
+ # @overload list_workspaces(page_size: nil, page_token: nil)
391
+ # Pass arguments to `list_workspaces` via keyword arguments. Note that at
392
+ # least one keyword argument is required. To specify no parameters, or to keep all
393
+ # the default parameter values, pass an empty Hash as a request object (see above).
394
+ #
395
+ # @param page_size [::Integer]
396
+ # The maximum number of workspaces to return. The service may return fewer
397
+ # than this value.
398
+ #
399
+ # If unspecified, at most 10 workspaces are returned. The maximum value is
400
+ # 25; values above 25 are coerced to 25.
401
+ # @param page_token [::String]
402
+ # A page token, received from a previous `ListWorkspaces` call.
403
+ # Provide this to retrieve the subsequent page.
404
+ #
405
+ # When paginating, all other parameters provided to `ListWorkspaces` must
406
+ # match the call that provided the page token.
407
+ # @yield [result, operation] Access the result along with the TransportOperation object
408
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Workspace>]
409
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
410
+ #
411
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Workspace>]
412
+ #
413
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
414
+ def list_workspaces request, options = nil
415
+ raise ::ArgumentError, "request must be provided" if request.nil?
416
+
417
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::ListWorkspacesRequest
418
+
419
+ # Converts hash and nil to an options object
420
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
421
+
422
+ # Customize the options with defaults
423
+ call_metadata = @config.rpcs.list_workspaces.metadata.to_h
424
+
425
+ # Set x-goog-api-client and x-goog-user-project headers
426
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
427
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
428
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
429
+ transports_version_send: [:rest]
430
+
431
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
432
+
433
+ options.apply_defaults timeout: @config.rpcs.list_workspaces.timeout,
434
+ metadata: call_metadata,
435
+ retry_policy: @config.rpcs.list_workspaces.retry_policy
436
+
437
+ options.apply_defaults timeout: @config.timeout,
438
+ metadata: @config.metadata,
439
+ retry_policy: @config.retry_policy
440
+
441
+ @tables_service_stub.list_workspaces request, options do |result, operation|
442
+ result = ::Gapic::Rest::PagedEnumerable.new @tables_service_stub, :list_workspaces, "workspaces", request, result, options
443
+ yield result, operation if block_given?
444
+ return result
445
+ end
446
+ rescue ::Gapic::Rest::Error => e
447
+ raise ::Google::Cloud::Error.from_error(e)
448
+ end
449
+
450
+ ##
451
+ # Gets a row. Returns NOT_FOUND if the row does not exist in the table.
452
+ #
453
+ # @overload get_row(request, options = nil)
454
+ # Pass arguments to `get_row` via a request object, either of type
455
+ # {::Google::Area120::Tables::V1alpha1::GetRowRequest} or an equivalent Hash.
456
+ #
457
+ # @param request [::Google::Area120::Tables::V1alpha1::GetRowRequest, ::Hash]
458
+ # A request object representing the call parameters. Required. To specify no
459
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
460
+ # @param options [::Gapic::CallOptions, ::Hash]
461
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
462
+ #
463
+ # @overload get_row(name: nil, view: nil)
464
+ # Pass arguments to `get_row` via keyword arguments. Note that at
465
+ # least one keyword argument is required. To specify no parameters, or to keep all
466
+ # the default parameter values, pass an empty Hash as a request object (see above).
467
+ #
468
+ # @param name [::String]
469
+ # Required. The name of the row to retrieve.
470
+ # Format: tables/\\{table}/rows/\\{row}
471
+ # @param view [::Google::Area120::Tables::V1alpha1::View]
472
+ # Optional. Column key to use for values in the row.
473
+ # Defaults to user entered name.
474
+ # @yield [result, operation] Access the result along with the TransportOperation object
475
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::Row]
476
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
477
+ #
478
+ # @return [::Google::Area120::Tables::V1alpha1::Row]
479
+ #
480
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
481
+ def get_row request, options = nil
482
+ raise ::ArgumentError, "request must be provided" if request.nil?
483
+
484
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::GetRowRequest
485
+
486
+ # Converts hash and nil to an options object
487
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
488
+
489
+ # Customize the options with defaults
490
+ call_metadata = @config.rpcs.get_row.metadata.to_h
491
+
492
+ # Set x-goog-api-client and x-goog-user-project headers
493
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
494
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
495
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
496
+ transports_version_send: [:rest]
497
+
498
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
499
+
500
+ options.apply_defaults timeout: @config.rpcs.get_row.timeout,
501
+ metadata: call_metadata,
502
+ retry_policy: @config.rpcs.get_row.retry_policy
503
+
504
+ options.apply_defaults timeout: @config.timeout,
505
+ metadata: @config.metadata,
506
+ retry_policy: @config.retry_policy
507
+
508
+ @tables_service_stub.get_row request, options do |result, operation|
509
+ yield result, operation if block_given?
510
+ return result
511
+ end
512
+ rescue ::Gapic::Rest::Error => e
513
+ raise ::Google::Cloud::Error.from_error(e)
514
+ end
515
+
516
+ ##
517
+ # Lists rows in a table. Returns NOT_FOUND if the table does not exist.
518
+ #
519
+ # @overload list_rows(request, options = nil)
520
+ # Pass arguments to `list_rows` via a request object, either of type
521
+ # {::Google::Area120::Tables::V1alpha1::ListRowsRequest} or an equivalent Hash.
522
+ #
523
+ # @param request [::Google::Area120::Tables::V1alpha1::ListRowsRequest, ::Hash]
524
+ # A request object representing the call parameters. Required. To specify no
525
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
526
+ # @param options [::Gapic::CallOptions, ::Hash]
527
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
528
+ #
529
+ # @overload list_rows(parent: nil, page_size: nil, page_token: nil, view: nil, filter: nil)
530
+ # Pass arguments to `list_rows` via keyword arguments. Note that at
531
+ # least one keyword argument is required. To specify no parameters, or to keep all
532
+ # the default parameter values, pass an empty Hash as a request object (see above).
533
+ #
534
+ # @param parent [::String]
535
+ # Required. The parent table.
536
+ # Format: tables/\\{table}
537
+ # @param page_size [::Integer]
538
+ # The maximum number of rows to return. The service may return fewer than
539
+ # this value.
540
+ #
541
+ # If unspecified, at most 50 rows are returned. The maximum value is 1,000;
542
+ # values above 1,000 are coerced to 1,000.
543
+ # @param page_token [::String]
544
+ # A page token, received from a previous `ListRows` call.
545
+ # Provide this to retrieve the subsequent page.
546
+ #
547
+ # When paginating, all other parameters provided to `ListRows` must match
548
+ # the call that provided the page token.
549
+ # @param view [::Google::Area120::Tables::V1alpha1::View]
550
+ # Optional. Column key to use for values in the row.
551
+ # Defaults to user entered name.
552
+ # @param filter [::String]
553
+ # Optional. Raw text query to search for in rows of the table.
554
+ # Special characters must be escaped. Logical operators and field specific
555
+ # filtering not supported.
556
+ # @yield [result, operation] Access the result along with the TransportOperation object
557
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Row>]
558
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
559
+ #
560
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Area120::Tables::V1alpha1::Row>]
561
+ #
562
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
563
+ def list_rows request, options = nil
564
+ raise ::ArgumentError, "request must be provided" if request.nil?
565
+
566
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::ListRowsRequest
567
+
568
+ # Converts hash and nil to an options object
569
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
570
+
571
+ # Customize the options with defaults
572
+ call_metadata = @config.rpcs.list_rows.metadata.to_h
573
+
574
+ # Set x-goog-api-client and x-goog-user-project headers
575
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
576
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
577
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
578
+ transports_version_send: [:rest]
579
+
580
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
581
+
582
+ options.apply_defaults timeout: @config.rpcs.list_rows.timeout,
583
+ metadata: call_metadata,
584
+ retry_policy: @config.rpcs.list_rows.retry_policy
585
+
586
+ options.apply_defaults timeout: @config.timeout,
587
+ metadata: @config.metadata,
588
+ retry_policy: @config.retry_policy
589
+
590
+ @tables_service_stub.list_rows request, options do |result, operation|
591
+ result = ::Gapic::Rest::PagedEnumerable.new @tables_service_stub, :list_rows, "rows", request, result, options
592
+ yield result, operation if block_given?
593
+ return result
594
+ end
595
+ rescue ::Gapic::Rest::Error => e
596
+ raise ::Google::Cloud::Error.from_error(e)
597
+ end
598
+
599
+ ##
600
+ # Creates a row.
601
+ #
602
+ # @overload create_row(request, options = nil)
603
+ # Pass arguments to `create_row` via a request object, either of type
604
+ # {::Google::Area120::Tables::V1alpha1::CreateRowRequest} or an equivalent Hash.
605
+ #
606
+ # @param request [::Google::Area120::Tables::V1alpha1::CreateRowRequest, ::Hash]
607
+ # A request object representing the call parameters. Required. To specify no
608
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
609
+ # @param options [::Gapic::CallOptions, ::Hash]
610
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
611
+ #
612
+ # @overload create_row(parent: nil, row: nil, view: nil)
613
+ # Pass arguments to `create_row` via keyword arguments. Note that at
614
+ # least one keyword argument is required. To specify no parameters, or to keep all
615
+ # the default parameter values, pass an empty Hash as a request object (see above).
616
+ #
617
+ # @param parent [::String]
618
+ # Required. The parent table where this row will be created.
619
+ # Format: tables/\\{table}
620
+ # @param row [::Google::Area120::Tables::V1alpha1::Row, ::Hash]
621
+ # Required. The row to create.
622
+ # @param view [::Google::Area120::Tables::V1alpha1::View]
623
+ # Optional. Column key to use for values in the row.
624
+ # Defaults to user entered name.
625
+ # @yield [result, operation] Access the result along with the TransportOperation object
626
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::Row]
627
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
628
+ #
629
+ # @return [::Google::Area120::Tables::V1alpha1::Row]
630
+ #
631
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
632
+ def create_row request, options = nil
633
+ raise ::ArgumentError, "request must be provided" if request.nil?
634
+
635
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::CreateRowRequest
636
+
637
+ # Converts hash and nil to an options object
638
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
639
+
640
+ # Customize the options with defaults
641
+ call_metadata = @config.rpcs.create_row.metadata.to_h
642
+
643
+ # Set x-goog-api-client and x-goog-user-project headers
644
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
645
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
646
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
647
+ transports_version_send: [:rest]
648
+
649
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
650
+
651
+ options.apply_defaults timeout: @config.rpcs.create_row.timeout,
652
+ metadata: call_metadata,
653
+ retry_policy: @config.rpcs.create_row.retry_policy
654
+
655
+ options.apply_defaults timeout: @config.timeout,
656
+ metadata: @config.metadata,
657
+ retry_policy: @config.retry_policy
658
+
659
+ @tables_service_stub.create_row request, options do |result, operation|
660
+ yield result, operation if block_given?
661
+ return result
662
+ end
663
+ rescue ::Gapic::Rest::Error => e
664
+ raise ::Google::Cloud::Error.from_error(e)
665
+ end
666
+
667
+ ##
668
+ # Creates multiple rows.
669
+ #
670
+ # @overload batch_create_rows(request, options = nil)
671
+ # Pass arguments to `batch_create_rows` via a request object, either of type
672
+ # {::Google::Area120::Tables::V1alpha1::BatchCreateRowsRequest} or an equivalent Hash.
673
+ #
674
+ # @param request [::Google::Area120::Tables::V1alpha1::BatchCreateRowsRequest, ::Hash]
675
+ # A request object representing the call parameters. Required. To specify no
676
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
677
+ # @param options [::Gapic::CallOptions, ::Hash]
678
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
679
+ #
680
+ # @overload batch_create_rows(parent: nil, requests: nil)
681
+ # Pass arguments to `batch_create_rows` via keyword arguments. Note that at
682
+ # least one keyword argument is required. To specify no parameters, or to keep all
683
+ # the default parameter values, pass an empty Hash as a request object (see above).
684
+ #
685
+ # @param parent [::String]
686
+ # Required. The parent table where the rows will be created.
687
+ # Format: tables/\\{table}
688
+ # @param requests [::Array<::Google::Area120::Tables::V1alpha1::CreateRowRequest, ::Hash>]
689
+ # Required. The request message specifying the rows to create.
690
+ #
691
+ # A maximum of 500 rows can be created in a single batch.
692
+ # @yield [result, operation] Access the result along with the TransportOperation object
693
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::BatchCreateRowsResponse]
694
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
695
+ #
696
+ # @return [::Google::Area120::Tables::V1alpha1::BatchCreateRowsResponse]
697
+ #
698
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
699
+ def batch_create_rows request, options = nil
700
+ raise ::ArgumentError, "request must be provided" if request.nil?
701
+
702
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::BatchCreateRowsRequest
703
+
704
+ # Converts hash and nil to an options object
705
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
706
+
707
+ # Customize the options with defaults
708
+ call_metadata = @config.rpcs.batch_create_rows.metadata.to_h
709
+
710
+ # Set x-goog-api-client and x-goog-user-project headers
711
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
712
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
713
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
714
+ transports_version_send: [:rest]
715
+
716
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
717
+
718
+ options.apply_defaults timeout: @config.rpcs.batch_create_rows.timeout,
719
+ metadata: call_metadata,
720
+ retry_policy: @config.rpcs.batch_create_rows.retry_policy
721
+
722
+ options.apply_defaults timeout: @config.timeout,
723
+ metadata: @config.metadata,
724
+ retry_policy: @config.retry_policy
725
+
726
+ @tables_service_stub.batch_create_rows request, options do |result, operation|
727
+ yield result, operation if block_given?
728
+ return result
729
+ end
730
+ rescue ::Gapic::Rest::Error => e
731
+ raise ::Google::Cloud::Error.from_error(e)
732
+ end
733
+
734
+ ##
735
+ # Updates a row.
736
+ #
737
+ # @overload update_row(request, options = nil)
738
+ # Pass arguments to `update_row` via a request object, either of type
739
+ # {::Google::Area120::Tables::V1alpha1::UpdateRowRequest} or an equivalent Hash.
740
+ #
741
+ # @param request [::Google::Area120::Tables::V1alpha1::UpdateRowRequest, ::Hash]
742
+ # A request object representing the call parameters. Required. To specify no
743
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
744
+ # @param options [::Gapic::CallOptions, ::Hash]
745
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
746
+ #
747
+ # @overload update_row(row: nil, update_mask: nil, view: nil)
748
+ # Pass arguments to `update_row` via keyword arguments. Note that at
749
+ # least one keyword argument is required. To specify no parameters, or to keep all
750
+ # the default parameter values, pass an empty Hash as a request object (see above).
751
+ #
752
+ # @param row [::Google::Area120::Tables::V1alpha1::Row, ::Hash]
753
+ # Required. The row to update.
754
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
755
+ # The list of fields to update.
756
+ # @param view [::Google::Area120::Tables::V1alpha1::View]
757
+ # Optional. Column key to use for values in the row.
758
+ # Defaults to user entered name.
759
+ # @yield [result, operation] Access the result along with the TransportOperation object
760
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::Row]
761
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
762
+ #
763
+ # @return [::Google::Area120::Tables::V1alpha1::Row]
764
+ #
765
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
766
+ def update_row request, options = nil
767
+ raise ::ArgumentError, "request must be provided" if request.nil?
768
+
769
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::UpdateRowRequest
770
+
771
+ # Converts hash and nil to an options object
772
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
773
+
774
+ # Customize the options with defaults
775
+ call_metadata = @config.rpcs.update_row.metadata.to_h
776
+
777
+ # Set x-goog-api-client and x-goog-user-project headers
778
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
779
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
780
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
781
+ transports_version_send: [:rest]
782
+
783
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
784
+
785
+ options.apply_defaults timeout: @config.rpcs.update_row.timeout,
786
+ metadata: call_metadata,
787
+ retry_policy: @config.rpcs.update_row.retry_policy
788
+
789
+ options.apply_defaults timeout: @config.timeout,
790
+ metadata: @config.metadata,
791
+ retry_policy: @config.retry_policy
792
+
793
+ @tables_service_stub.update_row request, options do |result, operation|
794
+ yield result, operation if block_given?
795
+ return result
796
+ end
797
+ rescue ::Gapic::Rest::Error => e
798
+ raise ::Google::Cloud::Error.from_error(e)
799
+ end
800
+
801
+ ##
802
+ # Updates multiple rows.
803
+ #
804
+ # @overload batch_update_rows(request, options = nil)
805
+ # Pass arguments to `batch_update_rows` via a request object, either of type
806
+ # {::Google::Area120::Tables::V1alpha1::BatchUpdateRowsRequest} or an equivalent Hash.
807
+ #
808
+ # @param request [::Google::Area120::Tables::V1alpha1::BatchUpdateRowsRequest, ::Hash]
809
+ # A request object representing the call parameters. Required. To specify no
810
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
811
+ # @param options [::Gapic::CallOptions, ::Hash]
812
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
813
+ #
814
+ # @overload batch_update_rows(parent: nil, requests: nil)
815
+ # Pass arguments to `batch_update_rows` via keyword arguments. Note that at
816
+ # least one keyword argument is required. To specify no parameters, or to keep all
817
+ # the default parameter values, pass an empty Hash as a request object (see above).
818
+ #
819
+ # @param parent [::String]
820
+ # Required. The parent table shared by all rows being updated.
821
+ # Format: tables/\\{table}
822
+ # @param requests [::Array<::Google::Area120::Tables::V1alpha1::UpdateRowRequest, ::Hash>]
823
+ # Required. The request messages specifying the rows to update.
824
+ #
825
+ # A maximum of 500 rows can be modified in a single batch.
826
+ # @yield [result, operation] Access the result along with the TransportOperation object
827
+ # @yieldparam result [::Google::Area120::Tables::V1alpha1::BatchUpdateRowsResponse]
828
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
829
+ #
830
+ # @return [::Google::Area120::Tables::V1alpha1::BatchUpdateRowsResponse]
831
+ #
832
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
833
+ def batch_update_rows request, options = nil
834
+ raise ::ArgumentError, "request must be provided" if request.nil?
835
+
836
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::BatchUpdateRowsRequest
837
+
838
+ # Converts hash and nil to an options object
839
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
840
+
841
+ # Customize the options with defaults
842
+ call_metadata = @config.rpcs.batch_update_rows.metadata.to_h
843
+
844
+ # Set x-goog-api-client and x-goog-user-project headers
845
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
846
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
847
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
848
+ transports_version_send: [:rest]
849
+
850
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
851
+
852
+ options.apply_defaults timeout: @config.rpcs.batch_update_rows.timeout,
853
+ metadata: call_metadata,
854
+ retry_policy: @config.rpcs.batch_update_rows.retry_policy
855
+
856
+ options.apply_defaults timeout: @config.timeout,
857
+ metadata: @config.metadata,
858
+ retry_policy: @config.retry_policy
859
+
860
+ @tables_service_stub.batch_update_rows request, options do |result, operation|
861
+ yield result, operation if block_given?
862
+ return result
863
+ end
864
+ rescue ::Gapic::Rest::Error => e
865
+ raise ::Google::Cloud::Error.from_error(e)
866
+ end
867
+
868
+ ##
869
+ # Deletes a row.
870
+ #
871
+ # @overload delete_row(request, options = nil)
872
+ # Pass arguments to `delete_row` via a request object, either of type
873
+ # {::Google::Area120::Tables::V1alpha1::DeleteRowRequest} or an equivalent Hash.
874
+ #
875
+ # @param request [::Google::Area120::Tables::V1alpha1::DeleteRowRequest, ::Hash]
876
+ # A request object representing the call parameters. Required. To specify no
877
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
878
+ # @param options [::Gapic::CallOptions, ::Hash]
879
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
880
+ #
881
+ # @overload delete_row(name: nil)
882
+ # Pass arguments to `delete_row` via keyword arguments. Note that at
883
+ # least one keyword argument is required. To specify no parameters, or to keep all
884
+ # the default parameter values, pass an empty Hash as a request object (see above).
885
+ #
886
+ # @param name [::String]
887
+ # Required. The name of the row to delete.
888
+ # Format: tables/\\{table}/rows/\\{row}
889
+ # @yield [result, operation] Access the result along with the TransportOperation object
890
+ # @yieldparam result [::Google::Protobuf::Empty]
891
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
892
+ #
893
+ # @return [::Google::Protobuf::Empty]
894
+ #
895
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
896
+ def delete_row request, options = nil
897
+ raise ::ArgumentError, "request must be provided" if request.nil?
898
+
899
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::DeleteRowRequest
900
+
901
+ # Converts hash and nil to an options object
902
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
903
+
904
+ # Customize the options with defaults
905
+ call_metadata = @config.rpcs.delete_row.metadata.to_h
906
+
907
+ # Set x-goog-api-client and x-goog-user-project headers
908
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
909
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
910
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
911
+ transports_version_send: [:rest]
912
+
913
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
914
+
915
+ options.apply_defaults timeout: @config.rpcs.delete_row.timeout,
916
+ metadata: call_metadata,
917
+ retry_policy: @config.rpcs.delete_row.retry_policy
918
+
919
+ options.apply_defaults timeout: @config.timeout,
920
+ metadata: @config.metadata,
921
+ retry_policy: @config.retry_policy
922
+
923
+ @tables_service_stub.delete_row request, options do |result, operation|
924
+ yield result, operation if block_given?
925
+ return result
926
+ end
927
+ rescue ::Gapic::Rest::Error => e
928
+ raise ::Google::Cloud::Error.from_error(e)
929
+ end
930
+
931
+ ##
932
+ # Deletes multiple rows.
933
+ #
934
+ # @overload batch_delete_rows(request, options = nil)
935
+ # Pass arguments to `batch_delete_rows` via a request object, either of type
936
+ # {::Google::Area120::Tables::V1alpha1::BatchDeleteRowsRequest} or an equivalent Hash.
937
+ #
938
+ # @param request [::Google::Area120::Tables::V1alpha1::BatchDeleteRowsRequest, ::Hash]
939
+ # A request object representing the call parameters. Required. To specify no
940
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
941
+ # @param options [::Gapic::CallOptions, ::Hash]
942
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
943
+ #
944
+ # @overload batch_delete_rows(parent: nil, names: nil)
945
+ # Pass arguments to `batch_delete_rows` via keyword arguments. Note that at
946
+ # least one keyword argument is required. To specify no parameters, or to keep all
947
+ # the default parameter values, pass an empty Hash as a request object (see above).
948
+ #
949
+ # @param parent [::String]
950
+ # Required. The parent table shared by all rows being deleted.
951
+ # Format: tables/\\{table}
952
+ # @param names [::Array<::String>]
953
+ # Required. The names of the rows to delete. All rows must belong to the parent table
954
+ # or else the entire batch will fail. A maximum of 500 rows can be deleted
955
+ # in a batch.
956
+ # Format: tables/\\{table}/rows/\\{row}
957
+ # @yield [result, operation] Access the result along with the TransportOperation object
958
+ # @yieldparam result [::Google::Protobuf::Empty]
959
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
960
+ #
961
+ # @return [::Google::Protobuf::Empty]
962
+ #
963
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
964
+ def batch_delete_rows request, options = nil
965
+ raise ::ArgumentError, "request must be provided" if request.nil?
966
+
967
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Area120::Tables::V1alpha1::BatchDeleteRowsRequest
968
+
969
+ # Converts hash and nil to an options object
970
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
971
+
972
+ # Customize the options with defaults
973
+ call_metadata = @config.rpcs.batch_delete_rows.metadata.to_h
974
+
975
+ # Set x-goog-api-client and x-goog-user-project headers
976
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
977
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
978
+ gapic_version: ::Google::Area120::Tables::V1alpha1::VERSION,
979
+ transports_version_send: [:rest]
980
+
981
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
982
+
983
+ options.apply_defaults timeout: @config.rpcs.batch_delete_rows.timeout,
984
+ metadata: call_metadata,
985
+ retry_policy: @config.rpcs.batch_delete_rows.retry_policy
986
+
987
+ options.apply_defaults timeout: @config.timeout,
988
+ metadata: @config.metadata,
989
+ retry_policy: @config.retry_policy
990
+
991
+ @tables_service_stub.batch_delete_rows request, options do |result, operation|
992
+ yield result, operation if block_given?
993
+ return result
994
+ end
995
+ rescue ::Gapic::Rest::Error => e
996
+ raise ::Google::Cloud::Error.from_error(e)
997
+ end
998
+
999
+ ##
1000
+ # Configuration class for the TablesService REST API.
1001
+ #
1002
+ # This class represents the configuration for TablesService REST,
1003
+ # providing control over timeouts, retry behavior, logging, transport
1004
+ # parameters, and other low-level controls. Certain parameters can also be
1005
+ # applied individually to specific RPCs. See
1006
+ # {::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client::Configuration::Rpcs}
1007
+ # for a list of RPCs that can be configured independently.
1008
+ #
1009
+ # Configuration can be applied globally to all clients, or to a single client
1010
+ # on construction.
1011
+ #
1012
+ # @example
1013
+ #
1014
+ # # Modify the global config, setting the timeout for
1015
+ # # get_table to 20 seconds,
1016
+ # # and all remaining timeouts to 10 seconds.
1017
+ # ::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client.configure do |config|
1018
+ # config.timeout = 10.0
1019
+ # config.rpcs.get_table.timeout = 20.0
1020
+ # end
1021
+ #
1022
+ # # Apply the above configuration only to a new client.
1023
+ # client = ::Google::Area120::Tables::V1alpha1::TablesService::Rest::Client.new do |config|
1024
+ # config.timeout = 10.0
1025
+ # config.rpcs.get_table.timeout = 20.0
1026
+ # end
1027
+ #
1028
+ # @!attribute [rw] endpoint
1029
+ # The hostname or hostname:port of the service endpoint.
1030
+ # Defaults to `"area120tables.googleapis.com"`.
1031
+ # @return [::String]
1032
+ # @!attribute [rw] credentials
1033
+ # Credentials to send with calls. You may provide any of the following types:
1034
+ # * (`String`) The path to a service account key file in JSON format
1035
+ # * (`Hash`) A service account key as a Hash
1036
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
1037
+ # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
1038
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
1039
+ # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
1040
+ # * (`nil`) indicating no credentials
1041
+ # @return [::Object]
1042
+ # @!attribute [rw] scope
1043
+ # The OAuth scopes
1044
+ # @return [::Array<::String>]
1045
+ # @!attribute [rw] lib_name
1046
+ # The library name as recorded in instrumentation and logging
1047
+ # @return [::String]
1048
+ # @!attribute [rw] lib_version
1049
+ # The library version as recorded in instrumentation and logging
1050
+ # @return [::String]
1051
+ # @!attribute [rw] timeout
1052
+ # The call timeout in seconds.
1053
+ # @return [::Numeric]
1054
+ # @!attribute [rw] metadata
1055
+ # Additional headers to be sent with the call.
1056
+ # @return [::Hash{::Symbol=>::String}]
1057
+ # @!attribute [rw] retry_policy
1058
+ # The retry policy. The value is a hash with the following keys:
1059
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1060
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1061
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1062
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1063
+ # trigger a retry.
1064
+ # @return [::Hash]
1065
+ # @!attribute [rw] quota_project
1066
+ # A separate project against which to charge quota.
1067
+ # @return [::String]
1068
+ #
1069
+ class Configuration
1070
+ extend ::Gapic::Config
1071
+
1072
+ config_attr :endpoint, "area120tables.googleapis.com", ::String
1073
+ config_attr :credentials, nil do |value|
1074
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
1075
+ allowed.any? { |klass| klass === value }
1076
+ end
1077
+ config_attr :scope, nil, ::String, ::Array, nil
1078
+ config_attr :lib_name, nil, ::String, nil
1079
+ config_attr :lib_version, nil, ::String, nil
1080
+ config_attr :timeout, nil, ::Numeric, nil
1081
+ config_attr :metadata, nil, ::Hash, nil
1082
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1083
+ config_attr :quota_project, nil, ::String, nil
1084
+
1085
+ # @private
1086
+ def initialize parent_config = nil
1087
+ @parent_config = parent_config unless parent_config.nil?
1088
+
1089
+ yield self if block_given?
1090
+ end
1091
+
1092
+ ##
1093
+ # Configurations for individual RPCs
1094
+ # @return [Rpcs]
1095
+ #
1096
+ def rpcs
1097
+ @rpcs ||= begin
1098
+ parent_rpcs = nil
1099
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
1100
+ Rpcs.new parent_rpcs
1101
+ end
1102
+ end
1103
+
1104
+ ##
1105
+ # Configuration RPC class for the TablesService API.
1106
+ #
1107
+ # Includes fields providing the configuration for each RPC in this service.
1108
+ # Each configuration object is of type `Gapic::Config::Method` and includes
1109
+ # the following configuration fields:
1110
+ #
1111
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
1112
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
1113
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
1114
+ # include the following keys:
1115
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
1116
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
1117
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
1118
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
1119
+ # trigger a retry.
1120
+ #
1121
+ class Rpcs
1122
+ ##
1123
+ # RPC-specific configuration for `get_table`
1124
+ # @return [::Gapic::Config::Method]
1125
+ #
1126
+ attr_reader :get_table
1127
+ ##
1128
+ # RPC-specific configuration for `list_tables`
1129
+ # @return [::Gapic::Config::Method]
1130
+ #
1131
+ attr_reader :list_tables
1132
+ ##
1133
+ # RPC-specific configuration for `get_workspace`
1134
+ # @return [::Gapic::Config::Method]
1135
+ #
1136
+ attr_reader :get_workspace
1137
+ ##
1138
+ # RPC-specific configuration for `list_workspaces`
1139
+ # @return [::Gapic::Config::Method]
1140
+ #
1141
+ attr_reader :list_workspaces
1142
+ ##
1143
+ # RPC-specific configuration for `get_row`
1144
+ # @return [::Gapic::Config::Method]
1145
+ #
1146
+ attr_reader :get_row
1147
+ ##
1148
+ # RPC-specific configuration for `list_rows`
1149
+ # @return [::Gapic::Config::Method]
1150
+ #
1151
+ attr_reader :list_rows
1152
+ ##
1153
+ # RPC-specific configuration for `create_row`
1154
+ # @return [::Gapic::Config::Method]
1155
+ #
1156
+ attr_reader :create_row
1157
+ ##
1158
+ # RPC-specific configuration for `batch_create_rows`
1159
+ # @return [::Gapic::Config::Method]
1160
+ #
1161
+ attr_reader :batch_create_rows
1162
+ ##
1163
+ # RPC-specific configuration for `update_row`
1164
+ # @return [::Gapic::Config::Method]
1165
+ #
1166
+ attr_reader :update_row
1167
+ ##
1168
+ # RPC-specific configuration for `batch_update_rows`
1169
+ # @return [::Gapic::Config::Method]
1170
+ #
1171
+ attr_reader :batch_update_rows
1172
+ ##
1173
+ # RPC-specific configuration for `delete_row`
1174
+ # @return [::Gapic::Config::Method]
1175
+ #
1176
+ attr_reader :delete_row
1177
+ ##
1178
+ # RPC-specific configuration for `batch_delete_rows`
1179
+ # @return [::Gapic::Config::Method]
1180
+ #
1181
+ attr_reader :batch_delete_rows
1182
+
1183
+ # @private
1184
+ def initialize parent_rpcs = nil
1185
+ get_table_config = parent_rpcs.get_table if parent_rpcs.respond_to? :get_table
1186
+ @get_table = ::Gapic::Config::Method.new get_table_config
1187
+ list_tables_config = parent_rpcs.list_tables if parent_rpcs.respond_to? :list_tables
1188
+ @list_tables = ::Gapic::Config::Method.new list_tables_config
1189
+ get_workspace_config = parent_rpcs.get_workspace if parent_rpcs.respond_to? :get_workspace
1190
+ @get_workspace = ::Gapic::Config::Method.new get_workspace_config
1191
+ list_workspaces_config = parent_rpcs.list_workspaces if parent_rpcs.respond_to? :list_workspaces
1192
+ @list_workspaces = ::Gapic::Config::Method.new list_workspaces_config
1193
+ get_row_config = parent_rpcs.get_row if parent_rpcs.respond_to? :get_row
1194
+ @get_row = ::Gapic::Config::Method.new get_row_config
1195
+ list_rows_config = parent_rpcs.list_rows if parent_rpcs.respond_to? :list_rows
1196
+ @list_rows = ::Gapic::Config::Method.new list_rows_config
1197
+ create_row_config = parent_rpcs.create_row if parent_rpcs.respond_to? :create_row
1198
+ @create_row = ::Gapic::Config::Method.new create_row_config
1199
+ batch_create_rows_config = parent_rpcs.batch_create_rows if parent_rpcs.respond_to? :batch_create_rows
1200
+ @batch_create_rows = ::Gapic::Config::Method.new batch_create_rows_config
1201
+ update_row_config = parent_rpcs.update_row if parent_rpcs.respond_to? :update_row
1202
+ @update_row = ::Gapic::Config::Method.new update_row_config
1203
+ batch_update_rows_config = parent_rpcs.batch_update_rows if parent_rpcs.respond_to? :batch_update_rows
1204
+ @batch_update_rows = ::Gapic::Config::Method.new batch_update_rows_config
1205
+ delete_row_config = parent_rpcs.delete_row if parent_rpcs.respond_to? :delete_row
1206
+ @delete_row = ::Gapic::Config::Method.new delete_row_config
1207
+ batch_delete_rows_config = parent_rpcs.batch_delete_rows if parent_rpcs.respond_to? :batch_delete_rows
1208
+ @batch_delete_rows = ::Gapic::Config::Method.new batch_delete_rows_config
1209
+
1210
+ yield self if block_given?
1211
+ end
1212
+ end
1213
+ end
1214
+ end
1215
+ end
1216
+ end
1217
+ end
1218
+ end
1219
+ end
1220
+ end