google-api-client 0.14.1 → 0.14.2

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 (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