google-api-client 0.14.1 → 0.14.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (88) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +33 -0
  3. data/generated/google/apis/adexchangebuyer2_v2beta1.rb +1 -1
  4. data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb +0 -18
  5. data/generated/google/apis/adexperiencereport_v1.rb +1 -1
  6. data/generated/google/apis/adexperiencereport_v1/classes.rb +0 -6
  7. data/generated/google/apis/adexperiencereport_v1/representations.rb +0 -1
  8. data/generated/google/apis/admin_directory_v1.rb +1 -1
  9. data/generated/google/apis/admin_directory_v1/classes.rb +46 -0
  10. data/generated/google/apis/admin_directory_v1/representations.rb +19 -2
  11. data/generated/google/apis/androiddeviceprovisioning_v1.rb +1 -1
  12. data/generated/google/apis/androiddeviceprovisioning_v1/classes.rb +14 -12
  13. data/generated/google/apis/androiddeviceprovisioning_v1/service.rb +7 -5
  14. data/generated/google/apis/androidmanagement_v1.rb +1 -1
  15. data/generated/google/apis/androidmanagement_v1/classes.rb +8 -9
  16. data/generated/google/apis/androidpublisher_v2/service.rb +1 -1
  17. data/generated/google/apis/bigquerydatatransfer_v1.rb +1 -1
  18. data/generated/google/apis/bigquerydatatransfer_v1/classes.rb +4 -2
  19. data/generated/google/apis/cloudbuild_v1.rb +1 -1
  20. data/generated/google/apis/cloudbuild_v1/classes.rb +3 -0
  21. data/generated/google/apis/cloudtrace_v2.rb +1 -1
  22. data/generated/google/apis/container_v1.rb +1 -1
  23. data/generated/google/apis/container_v1/classes.rb +93 -0
  24. data/generated/google/apis/container_v1/representations.rb +58 -0
  25. data/generated/google/apis/container_v1/service.rb +42 -0
  26. data/generated/google/apis/container_v1beta1.rb +1 -1
  27. data/generated/google/apis/container_v1beta1/classes.rb +119 -0
  28. data/generated/google/apis/container_v1beta1/representations.rb +62 -0
  29. data/generated/google/apis/container_v1beta1/service.rb +77 -0
  30. data/generated/google/apis/dataproc_v1beta2.rb +1 -1
  31. data/generated/google/apis/dataproc_v1beta2/classes.rb +184 -0
  32. data/generated/google/apis/dataproc_v1beta2/representations.rb +70 -0
  33. data/generated/google/apis/dataproc_v1beta2/service.rb +105 -0
  34. data/generated/google/apis/deploymentmanager_alpha.rb +1 -1
  35. data/generated/google/apis/deploymentmanager_alpha/classes.rb +63 -64
  36. data/generated/google/apis/deploymentmanager_v2.rb +1 -1
  37. data/generated/google/apis/deploymentmanager_v2/classes.rb +51 -50
  38. data/generated/google/apis/deploymentmanager_v2/service.rb +1 -1
  39. data/generated/google/apis/deploymentmanager_v2beta.rb +1 -1
  40. data/generated/google/apis/deploymentmanager_v2beta/classes.rb +62 -62
  41. data/generated/google/apis/dlp_v2beta1.rb +1 -1
  42. data/generated/google/apis/dlp_v2beta1/classes.rb +23 -17
  43. data/generated/google/apis/dlp_v2beta1/service.rb +10 -10
  44. data/generated/google/apis/dns_v1/service.rb +1 -1
  45. data/generated/google/apis/genomics_v1.rb +1 -1
  46. data/generated/google/apis/genomics_v1/classes.rb +1 -1
  47. data/generated/google/apis/genomics_v1alpha2.rb +1 -1
  48. data/generated/google/apis/genomics_v1alpha2/classes.rb +1 -1
  49. data/generated/google/apis/gmail_v1.rb +1 -1
  50. data/generated/google/apis/oauth2_v2/service.rb +1 -1
  51. data/generated/google/apis/oslogin_v1alpha.rb +7 -1
  52. data/generated/google/apis/oslogin_v1alpha/classes.rb +2 -1
  53. data/generated/google/apis/oslogin_v1alpha/representations.rb +2 -2
  54. data/generated/google/apis/oslogin_v1beta.rb +43 -0
  55. data/generated/google/apis/oslogin_v1beta/classes.rb +202 -0
  56. data/generated/google/apis/oslogin_v1beta/representations.rb +105 -0
  57. data/generated/google/apis/oslogin_v1beta/service.rb +228 -0
  58. data/generated/google/apis/sheets_v4.rb +1 -1
  59. data/generated/google/apis/sheets_v4/classes.rb +906 -0
  60. data/generated/google/apis/sheets_v4/representations.rb +389 -0
  61. data/generated/google/apis/sheets_v4/service.rb +230 -0
  62. data/generated/google/apis/spanner_v1.rb +1 -1
  63. data/generated/google/apis/spanner_v1/classes.rb +73 -2
  64. data/generated/google/apis/spanner_v1/representations.rb +32 -0
  65. data/generated/google/apis/spanner_v1/service.rb +52 -1
  66. data/generated/google/apis/sqladmin_v1beta4/service.rb +1 -1
  67. data/generated/google/apis/storage_v1.rb +1 -1
  68. data/generated/google/apis/storage_v1/service.rb +15 -13
  69. data/generated/google/apis/storagetransfer_v1.rb +1 -1
  70. data/generated/google/apis/storagetransfer_v1/classes.rb +0 -1
  71. data/generated/google/apis/streetviewpublish_v1.rb +1 -1
  72. data/generated/google/apis/streetviewpublish_v1/classes.rb +1 -1
  73. data/generated/google/apis/tagmanager_v2.rb +1 -1
  74. data/generated/google/apis/tagmanager_v2/classes.rb +181 -0
  75. data/generated/google/apis/tagmanager_v2/representations.rb +75 -0
  76. data/generated/google/apis/testing_v1.rb +38 -0
  77. data/generated/google/apis/testing_v1/classes.rb +1616 -0
  78. data/generated/google/apis/testing_v1/representations.rb +688 -0
  79. data/generated/google/apis/testing_v1/service.rb +221 -0
  80. data/generated/google/apis/videointelligence_v1beta1.rb +3 -3
  81. data/generated/google/apis/videointelligence_v1beta1/service.rb +2 -2
  82. data/generated/google/apis/youtube_partner_v1.rb +1 -1
  83. data/generated/google/apis/youtube_v3.rb +1 -1
  84. data/generated/google/apis/youtube_v3/classes.rb +9 -0
  85. data/generated/google/apis/youtube_v3/representations.rb +1 -0
  86. data/generated/google/apis/youtube_v3/service.rb +1 -1
  87. data/lib/google/apis/version.rb +1 -1
  88. metadata +11 -3
@@ -177,6 +177,127 @@ module Google
177
177
  execute_or_queue_command(command, &block)
178
178
  end
179
179
 
180
+ # Returns the spreadsheet at the given ID.
181
+ # The caller must specify the spreadsheet ID.
182
+ # This method differs from GetSpreadsheet in that it allows selecting
183
+ # which subsets of spreadsheet data to return by specifying a
184
+ # dataFilters parameter.
185
+ # Multiple DataFilters can be specified. Specifying one or
186
+ # more data filters will return the portions of the spreadsheet that
187
+ # intersect ranges matched by any of the filters.
188
+ # By default, data within grids will not be returned.
189
+ # You can include grid data one of two ways:
190
+ # * Specify a field mask listing your desired fields using the `fields` URL
191
+ # parameter in HTTP
192
+ # * Set the includeGridData
193
+ # parameter to true. If a field mask is set, the `includeGridData`
194
+ # parameter is ignored
195
+ # For large spreadsheets, it is recommended to retrieve only the specific
196
+ # fields of the spreadsheet that you want.
197
+ # @param [String] spreadsheet_id
198
+ # The spreadsheet to request.
199
+ # @param [Google::Apis::SheetsV4::GetSpreadsheetByDataFilterRequest] get_spreadsheet_by_data_filter_request_object
200
+ # @param [String] fields
201
+ # Selector specifying which fields to include in a partial response.
202
+ # @param [String] quota_user
203
+ # Available to use for quota purposes for server-side applications. Can be any
204
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
205
+ # @param [Google::Apis::RequestOptions] options
206
+ # Request-specific options
207
+ #
208
+ # @yield [result, err] Result & error if block supplied
209
+ # @yieldparam result [Google::Apis::SheetsV4::Spreadsheet] parsed result object
210
+ # @yieldparam err [StandardError] error object if request failed
211
+ #
212
+ # @return [Google::Apis::SheetsV4::Spreadsheet]
213
+ #
214
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
215
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
216
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
217
+ def get_spreadsheet_by_data_filter(spreadsheet_id, get_spreadsheet_by_data_filter_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
218
+ command = make_simple_command(:post, 'v4/spreadsheets/{spreadsheetId}:getByDataFilter', options)
219
+ command.request_representation = Google::Apis::SheetsV4::GetSpreadsheetByDataFilterRequest::Representation
220
+ command.request_object = get_spreadsheet_by_data_filter_request_object
221
+ command.response_representation = Google::Apis::SheetsV4::Spreadsheet::Representation
222
+ command.response_class = Google::Apis::SheetsV4::Spreadsheet
223
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
224
+ command.query['fields'] = fields unless fields.nil?
225
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
226
+ execute_or_queue_command(command, &block)
227
+ end
228
+
229
+ # Returns the developer metadata with the specified id.
230
+ # The caller must specify the spreadsheet ID and the developer metadata's
231
+ # unique metadataId.
232
+ # @param [String] spreadsheet_id
233
+ # The ID of the spreadsheet to retrieve metadata from.
234
+ # @param [Fixnum] metadata_id
235
+ # The ID of the developer metadata to retrieve.
236
+ # @param [String] fields
237
+ # Selector specifying which fields to include in a partial response.
238
+ # @param [String] quota_user
239
+ # Available to use for quota purposes for server-side applications. Can be any
240
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
241
+ # @param [Google::Apis::RequestOptions] options
242
+ # Request-specific options
243
+ #
244
+ # @yield [result, err] Result & error if block supplied
245
+ # @yieldparam result [Google::Apis::SheetsV4::DeveloperMetadata] parsed result object
246
+ # @yieldparam err [StandardError] error object if request failed
247
+ #
248
+ # @return [Google::Apis::SheetsV4::DeveloperMetadata]
249
+ #
250
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
251
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
252
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
253
+ def get_spreadsheet_developer_metadatum(spreadsheet_id, metadata_id, fields: nil, quota_user: nil, options: nil, &block)
254
+ command = make_simple_command(:get, 'v4/spreadsheets/{spreadsheetId}/developerMetadata/{metadataId}', options)
255
+ command.response_representation = Google::Apis::SheetsV4::DeveloperMetadata::Representation
256
+ command.response_class = Google::Apis::SheetsV4::DeveloperMetadata
257
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
258
+ command.params['metadataId'] = metadata_id unless metadata_id.nil?
259
+ command.query['fields'] = fields unless fields.nil?
260
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
261
+ execute_or_queue_command(command, &block)
262
+ end
263
+
264
+ # Returns all developer metadata matching the specified DataFilter.
265
+ # If the provided DataFilter represents a DeveloperMetadataLookup object,
266
+ # this will return all DeveloperMetadata entries selected by it. If the
267
+ # DataFilter represents a location in a spreadsheet, this will return all
268
+ # developer metadata associated with locations intersecting that region.
269
+ # @param [String] spreadsheet_id
270
+ # The ID of the spreadsheet to retrieve metadata from.
271
+ # @param [Google::Apis::SheetsV4::SearchDeveloperMetadataRequest] search_developer_metadata_request_object
272
+ # @param [String] fields
273
+ # Selector specifying which fields to include in a partial response.
274
+ # @param [String] quota_user
275
+ # Available to use for quota purposes for server-side applications. Can be any
276
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
277
+ # @param [Google::Apis::RequestOptions] options
278
+ # Request-specific options
279
+ #
280
+ # @yield [result, err] Result & error if block supplied
281
+ # @yieldparam result [Google::Apis::SheetsV4::SearchDeveloperMetadataResponse] parsed result object
282
+ # @yieldparam err [StandardError] error object if request failed
283
+ #
284
+ # @return [Google::Apis::SheetsV4::SearchDeveloperMetadataResponse]
285
+ #
286
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
287
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
288
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
289
+ def search_developer_metadatum_developer_metadata(spreadsheet_id, search_developer_metadata_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
290
+ command = make_simple_command(:post, 'v4/spreadsheets/{spreadsheetId}/developerMetadata:search', options)
291
+ command.request_representation = Google::Apis::SheetsV4::SearchDeveloperMetadataRequest::Representation
292
+ command.request_object = search_developer_metadata_request_object
293
+ command.response_representation = Google::Apis::SheetsV4::SearchDeveloperMetadataResponse::Representation
294
+ command.response_class = Google::Apis::SheetsV4::SearchDeveloperMetadataResponse
295
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
296
+ command.query['fields'] = fields unless fields.nil?
297
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
298
+ execute_or_queue_command(command, &block)
299
+ end
300
+
180
301
  # Copies a single sheet from a spreadsheet to another spreadsheet.
181
302
  # Returns the properties of the newly created sheet.
182
303
  # @param [String] spreadsheet_id
@@ -320,6 +441,43 @@ module Google
320
441
  execute_or_queue_command(command, &block)
321
442
  end
322
443
 
444
+ # Clears one or more ranges of values from a spreadsheet.
445
+ # The caller must specify the spreadsheet ID and one or more
446
+ # DataFilters. Ranges matching any of the specified data
447
+ # filters will be cleared. Only values are cleared -- all other properties
448
+ # of the cell (such as formatting, data validation, etc..) are kept.
449
+ # @param [String] spreadsheet_id
450
+ # The ID of the spreadsheet to update.
451
+ # @param [Google::Apis::SheetsV4::BatchClearValuesByDataFilterRequest] batch_clear_values_by_data_filter_request_object
452
+ # @param [String] fields
453
+ # Selector specifying which fields to include in a partial response.
454
+ # @param [String] quota_user
455
+ # Available to use for quota purposes for server-side applications. Can be any
456
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
457
+ # @param [Google::Apis::RequestOptions] options
458
+ # Request-specific options
459
+ #
460
+ # @yield [result, err] Result & error if block supplied
461
+ # @yieldparam result [Google::Apis::SheetsV4::BatchClearValuesByDataFilterResponse] parsed result object
462
+ # @yieldparam err [StandardError] error object if request failed
463
+ #
464
+ # @return [Google::Apis::SheetsV4::BatchClearValuesByDataFilterResponse]
465
+ #
466
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
467
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
468
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
469
+ def batch_spreadsheet_value_clear_by_data_filter(spreadsheet_id, batch_clear_values_by_data_filter_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
470
+ command = make_simple_command(:post, 'v4/spreadsheets/{spreadsheetId}/values:batchClearByDataFilter', options)
471
+ command.request_representation = Google::Apis::SheetsV4::BatchClearValuesByDataFilterRequest::Representation
472
+ command.request_object = batch_clear_values_by_data_filter_request_object
473
+ command.response_representation = Google::Apis::SheetsV4::BatchClearValuesByDataFilterResponse::Representation
474
+ command.response_class = Google::Apis::SheetsV4::BatchClearValuesByDataFilterResponse
475
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
476
+ command.query['fields'] = fields unless fields.nil?
477
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
478
+ execute_or_queue_command(command, &block)
479
+ end
480
+
323
481
  # Returns one or more ranges of values from a spreadsheet.
324
482
  # The caller must specify the spreadsheet ID and one or more ranges.
325
483
  # @param [String] spreadsheet_id
@@ -372,6 +530,42 @@ module Google
372
530
  execute_or_queue_command(command, &block)
373
531
  end
374
532
 
533
+ # Returns one or more ranges of values from a spreadsheet that match the
534
+ # specified data filters. The caller must specify the spreadsheet ID and
535
+ # one or more DataFilters. Ranges that match any of the data
536
+ # filters in the request will be returned.
537
+ # @param [String] spreadsheet_id
538
+ # The ID of the spreadsheet to retrieve data from.
539
+ # @param [Google::Apis::SheetsV4::BatchGetValuesByDataFilterRequest] batch_get_values_by_data_filter_request_object
540
+ # @param [String] fields
541
+ # Selector specifying which fields to include in a partial response.
542
+ # @param [String] quota_user
543
+ # Available to use for quota purposes for server-side applications. Can be any
544
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
545
+ # @param [Google::Apis::RequestOptions] options
546
+ # Request-specific options
547
+ #
548
+ # @yield [result, err] Result & error if block supplied
549
+ # @yieldparam result [Google::Apis::SheetsV4::BatchGetValuesByDataFilterResponse] parsed result object
550
+ # @yieldparam err [StandardError] error object if request failed
551
+ #
552
+ # @return [Google::Apis::SheetsV4::BatchGetValuesByDataFilterResponse]
553
+ #
554
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
555
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
556
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
557
+ def batch_spreadsheet_value_get_by_data_filter(spreadsheet_id, batch_get_values_by_data_filter_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
558
+ command = make_simple_command(:post, 'v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter', options)
559
+ command.request_representation = Google::Apis::SheetsV4::BatchGetValuesByDataFilterRequest::Representation
560
+ command.request_object = batch_get_values_by_data_filter_request_object
561
+ command.response_representation = Google::Apis::SheetsV4::BatchGetValuesByDataFilterResponse::Representation
562
+ command.response_class = Google::Apis::SheetsV4::BatchGetValuesByDataFilterResponse
563
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
564
+ command.query['fields'] = fields unless fields.nil?
565
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
566
+ execute_or_queue_command(command, &block)
567
+ end
568
+
375
569
  # Sets values in one or more ranges of a spreadsheet.
376
570
  # The caller must specify the spreadsheet ID,
377
571
  # a valueInputOption, and one or more
@@ -408,6 +602,42 @@ module Google
408
602
  execute_or_queue_command(command, &block)
409
603
  end
410
604
 
605
+ # Sets values in one or more ranges of a spreadsheet.
606
+ # The caller must specify the spreadsheet ID,
607
+ # a valueInputOption, and one or more
608
+ # DataFilterValueRanges.
609
+ # @param [String] spreadsheet_id
610
+ # The ID of the spreadsheet to update.
611
+ # @param [Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterRequest] batch_update_values_by_data_filter_request_object
612
+ # @param [String] fields
613
+ # Selector specifying which fields to include in a partial response.
614
+ # @param [String] quota_user
615
+ # Available to use for quota purposes for server-side applications. Can be any
616
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
617
+ # @param [Google::Apis::RequestOptions] options
618
+ # Request-specific options
619
+ #
620
+ # @yield [result, err] Result & error if block supplied
621
+ # @yieldparam result [Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterResponse] parsed result object
622
+ # @yieldparam err [StandardError] error object if request failed
623
+ #
624
+ # @return [Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterResponse]
625
+ #
626
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
627
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
628
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
629
+ def batch_spreadsheet_value_update_by_data_filter(spreadsheet_id, batch_update_values_by_data_filter_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
630
+ command = make_simple_command(:post, 'v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter', options)
631
+ command.request_representation = Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterRequest::Representation
632
+ command.request_object = batch_update_values_by_data_filter_request_object
633
+ command.response_representation = Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterResponse::Representation
634
+ command.response_class = Google::Apis::SheetsV4::BatchUpdateValuesByDataFilterResponse
635
+ command.params['spreadsheetId'] = spreadsheet_id unless spreadsheet_id.nil?
636
+ command.query['fields'] = fields unless fields.nil?
637
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
638
+ execute_or_queue_command(command, &block)
639
+ end
640
+
411
641
  # Clears values from a spreadsheet.
412
642
  # The caller must specify the spreadsheet ID and range.
413
643
  # Only values are cleared -- all other properties of the cell (such as
@@ -26,7 +26,7 @@ module Google
26
26
  # @see https://cloud.google.com/spanner/
27
27
  module SpannerV1
28
28
  VERSION = 'V1'
29
- REVISION = '20170825'
29
+ REVISION = '20170914'
30
30
 
31
31
  # View and manage your data across Google Cloud Platform services
32
32
  AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'
@@ -631,6 +631,25 @@ module Google
631
631
  end
632
632
  end
633
633
 
634
+ # The request for CreateSession.
635
+ class CreateSessionRequest
636
+ include Google::Apis::Core::Hashable
637
+
638
+ # A session in the Cloud Spanner API.
639
+ # Corresponds to the JSON property `session`
640
+ # @return [Google::Apis::SpannerV1::Session]
641
+ attr_accessor :session
642
+
643
+ def initialize(**args)
644
+ update!(**args)
645
+ end
646
+
647
+ # Update properties of this object
648
+ def update!(**args)
649
+ @session = args[:session] if args.key?(:session)
650
+ end
651
+ end
652
+
634
653
  # A Cloud Spanner database.
635
654
  class Database
636
655
  include Google::Apis::Core::Hashable
@@ -1215,6 +1234,33 @@ module Google
1215
1234
  end
1216
1235
  end
1217
1236
 
1237
+ # The response for ListSessions.
1238
+ class ListSessionsResponse
1239
+ include Google::Apis::Core::Hashable
1240
+
1241
+ # `next_page_token` can be sent in a subsequent
1242
+ # ListSessions call to fetch more of the matching
1243
+ # sessions.
1244
+ # Corresponds to the JSON property `nextPageToken`
1245
+ # @return [String]
1246
+ attr_accessor :next_page_token
1247
+
1248
+ # The list of requested sessions.
1249
+ # Corresponds to the JSON property `sessions`
1250
+ # @return [Array<Google::Apis::SpannerV1::Session>]
1251
+ attr_accessor :sessions
1252
+
1253
+ def initialize(**args)
1254
+ update!(**args)
1255
+ end
1256
+
1257
+ # Update properties of this object
1258
+ def update!(**args)
1259
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
1260
+ @sessions = args[:sessions] if args.key?(:sessions)
1261
+ end
1262
+ end
1263
+
1218
1264
  # A modification to one or more Cloud Spanner rows. Mutations can be
1219
1265
  # applied to a Cloud Spanner database by sending them in a
1220
1266
  # Commit call.
@@ -1270,7 +1316,7 @@ module Google
1270
1316
  include Google::Apis::Core::Hashable
1271
1317
 
1272
1318
  # If the value is `false`, it means the operation is still in progress.
1273
- # If true, the operation is completed, and either `error` or `response` is
1319
+ # If `true`, the operation is completed, and either `error` or `response` is
1274
1320
  # available.
1275
1321
  # Corresponds to the JSON property `done`
1276
1322
  # @return [Boolean]
@@ -1740,6 +1786,7 @@ module Google
1740
1786
 
1741
1787
  # If greater than zero, only the first `limit` rows are yielded. If `limit`
1742
1788
  # is zero, the default is no limit.
1789
+ # A limit cannot be specified if partition_token is set.
1743
1790
  # Corresponds to the JSON property `limit`
1744
1791
  # @return [Fixnum]
1745
1792
  attr_accessor :limit
@@ -1916,7 +1963,28 @@ module Google
1916
1963
  class Session
1917
1964
  include Google::Apis::Core::Hashable
1918
1965
 
1919
- # Required. The name of the session.
1966
+ # Output only. The approximate timestamp when the session is last used. It is
1967
+ # typically earlier than the actual last use time.
1968
+ # Corresponds to the JSON property `approximateLastUseTime`
1969
+ # @return [String]
1970
+ attr_accessor :approximate_last_use_time
1971
+
1972
+ # Output only. The timestamp when the session is created.
1973
+ # Corresponds to the JSON property `createTime`
1974
+ # @return [String]
1975
+ attr_accessor :create_time
1976
+
1977
+ # The labels for the session.
1978
+ # * Label keys must be between 1 and 63 characters long and must conform to
1979
+ # the following regular expression: `[a-z]([-a-z0-9]*[a-z0-9])?`.
1980
+ # * Label values must be between 0 and 63 characters long and must conform
1981
+ # to the regular expression `([a-z]([-a-z0-9]*[a-z0-9])?)?`.
1982
+ # * No more than 20 labels can be associated with a given session.
1983
+ # Corresponds to the JSON property `labels`
1984
+ # @return [Hash<String,String>]
1985
+ attr_accessor :labels
1986
+
1987
+ # The name of the session.
1920
1988
  # Corresponds to the JSON property `name`
1921
1989
  # @return [String]
1922
1990
  attr_accessor :name
@@ -1927,6 +1995,9 @@ module Google
1927
1995
 
1928
1996
  # Update properties of this object
1929
1997
  def update!(**args)
1998
+ @approximate_last_use_time = args[:approximate_last_use_time] if args.key?(:approximate_last_use_time)
1999
+ @create_time = args[:create_time] if args.key?(:create_time)
2000
+ @labels = args[:labels] if args.key?(:labels)
1930
2001
  @name = args[:name] if args.key?(:name)
1931
2002
  end
1932
2003
  end
@@ -76,6 +76,12 @@ module Google
76
76
  include Google::Apis::Core::JsonObjectSupport
77
77
  end
78
78
 
79
+ class CreateSessionRequest
80
+ class Representation < Google::Apis::Core::JsonRepresentation; end
81
+
82
+ include Google::Apis::Core::JsonObjectSupport
83
+ end
84
+
79
85
  class Database
80
86
  class Representation < Google::Apis::Core::JsonRepresentation; end
81
87
 
@@ -166,6 +172,12 @@ module Google
166
172
  include Google::Apis::Core::JsonObjectSupport
167
173
  end
168
174
 
175
+ class ListSessionsResponse
176
+ class Representation < Google::Apis::Core::JsonRepresentation; end
177
+
178
+ include Google::Apis::Core::JsonObjectSupport
179
+ end
180
+
169
181
  class Mutation
170
182
  class Representation < Google::Apis::Core::JsonRepresentation; end
171
183
 
@@ -418,6 +430,14 @@ module Google
418
430
  end
419
431
  end
420
432
 
433
+ class CreateSessionRequest
434
+ # @private
435
+ class Representation < Google::Apis::Core::JsonRepresentation
436
+ property :session, as: 'session', class: Google::Apis::SpannerV1::Session, decorator: Google::Apis::SpannerV1::Session::Representation
437
+
438
+ end
439
+ end
440
+
421
441
  class Database
422
442
  # @private
423
443
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -557,6 +577,15 @@ module Google
557
577
  end
558
578
  end
559
579
 
580
+ class ListSessionsResponse
581
+ # @private
582
+ class Representation < Google::Apis::Core::JsonRepresentation
583
+ property :next_page_token, as: 'nextPageToken'
584
+ collection :sessions, as: 'sessions', class: Google::Apis::SpannerV1::Session, decorator: Google::Apis::SpannerV1::Session::Representation
585
+
586
+ end
587
+ end
588
+
560
589
  class Mutation
561
590
  # @private
562
591
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -708,6 +737,9 @@ module Google
708
737
  class Session
709
738
  # @private
710
739
  class Representation < Google::Apis::Core::JsonRepresentation
740
+ property :approximate_last_use_time, as: 'approximateLastUseTime'
741
+ property :create_time, as: 'createTime'
742
+ hash :labels, as: 'labels'
711
743
  property :name, as: 'name'
712
744
  end
713
745
  end
@@ -1066,6 +1066,7 @@ module Google
1066
1066
  # periodically, e.g., `"SELECT 1"`.
1067
1067
  # @param [String] database
1068
1068
  # Required. The database in which the new session is created.
1069
+ # @param [Google::Apis::SpannerV1::CreateSessionRequest] create_session_request_object
1069
1070
  # @param [String] fields
1070
1071
  # Selector specifying which fields to include in a partial response.
1071
1072
  # @param [String] quota_user
@@ -1083,8 +1084,10 @@ module Google
1083
1084
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1084
1085
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1085
1086
  # @raise [Google::Apis::AuthorizationError] Authorization is required
1086
- def create_project_instance_database_session(database, fields: nil, quota_user: nil, options: nil, &block)
1087
+ def create_project_instance_database_session(database, create_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1087
1088
  command = make_simple_command(:post, 'v1/{+database}/sessions', options)
1089
+ command.request_representation = Google::Apis::SpannerV1::CreateSessionRequest::Representation
1090
+ command.request_object = create_session_request_object
1088
1091
  command.response_representation = Google::Apis::SpannerV1::Session::Representation
1089
1092
  command.response_class = Google::Apis::SpannerV1::Session
1090
1093
  command.params['database'] = database unless database.nil?
@@ -1233,6 +1236,54 @@ module Google
1233
1236
  execute_or_queue_command(command, &block)
1234
1237
  end
1235
1238
 
1239
+ # Lists all sessions in a given database.
1240
+ # @param [String] database
1241
+ # Required. The database in which to list sessions.
1242
+ # @param [String] filter
1243
+ # An expression for filtering the results of the request. Filter rules are
1244
+ # case insensitive. The fields eligible for filtering are:
1245
+ # * labels.key where key is the name of a label
1246
+ # Some examples of using filters are:
1247
+ # * labels.env:* --> The session has the label "env".
1248
+ # * labels.env:dev --> The session has the label "env" and the value of
1249
+ # the label contains the string "dev".
1250
+ # @param [Fixnum] page_size
1251
+ # Number of sessions to be returned in the response. If 0 or less, defaults
1252
+ # to the server's maximum allowed page size.
1253
+ # @param [String] page_token
1254
+ # If non-empty, `page_token` should contain a
1255
+ # next_page_token from a previous
1256
+ # ListSessionsResponse.
1257
+ # @param [String] fields
1258
+ # Selector specifying which fields to include in a partial response.
1259
+ # @param [String] quota_user
1260
+ # Available to use for quota purposes for server-side applications. Can be any
1261
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1262
+ # @param [Google::Apis::RequestOptions] options
1263
+ # Request-specific options
1264
+ #
1265
+ # @yield [result, err] Result & error if block supplied
1266
+ # @yieldparam result [Google::Apis::SpannerV1::ListSessionsResponse] parsed result object
1267
+ # @yieldparam err [StandardError] error object if request failed
1268
+ #
1269
+ # @return [Google::Apis::SpannerV1::ListSessionsResponse]
1270
+ #
1271
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1272
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1273
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1274
+ def list_project_instance_database_sessions(database, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1275
+ command = make_simple_command(:get, 'v1/{+database}/sessions', options)
1276
+ command.response_representation = Google::Apis::SpannerV1::ListSessionsResponse::Representation
1277
+ command.response_class = Google::Apis::SpannerV1::ListSessionsResponse
1278
+ command.params['database'] = database unless database.nil?
1279
+ command.query['filter'] = filter unless filter.nil?
1280
+ command.query['pageSize'] = page_size unless page_size.nil?
1281
+ command.query['pageToken'] = page_token unless page_token.nil?
1282
+ command.query['fields'] = fields unless fields.nil?
1283
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1284
+ execute_or_queue_command(command, &block)
1285
+ end
1286
+
1236
1287
  # Reads rows from the database using key lookups and scans, as a
1237
1288
  # simple key/value style alternative to
1238
1289
  # ExecuteSql. This method cannot be used to