google-cloud-bigquery-data_transfer 0.3.0 → 0.3.1

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: dc90505271ff31b135796655d8c8e92c8c3e2e9f3c2a21f32bc8d5525bfd1962
4
- data.tar.gz: 9edae69922aa7e185f59e63cc2bca5c36d66478ce785d894c6c536cd97f3fa2e
3
+ metadata.gz: 7c721724678c3702da3f51949265d87d61c00da8ee8433b3dfed302ed6d25159
4
+ data.tar.gz: b6255efbd28a7003a6d26aba90b2443aba6dc3ca90660460482767d891a0961e
5
5
  SHA512:
6
- metadata.gz: bd0354755bd7183603b23bb85f2c2c08fa5b1f73c0e02c908c481c24eb6b7f1fed0fe66ab8833b1379998e4f769b4928c08503a6930eaf9015f2897b28af0f75
7
- data.tar.gz: 90ff6bd37eaaa3f30ec4dae5d580e3491ad3e5a3522f644d4847f98d4108358335ac46ed95235cd6180622fa5dac34af5d0a295814e8ba71686f9917cf4652fc
6
+ metadata.gz: 4f3b680ebe89d538979c4ec1a1dcd6a6acf91af42ccc97cfa3258d4f34847e7b20b6c9e58becab1e37b3c7fbc5b7c294263cc66b8b3d597d065c765e9edee3ec
7
+ data.tar.gz: 89191078eca609977f71e08ee79048d0046447b523f61fa1a6e54e1e79937324bfd8c2130088045ab1512f7994570f7762b03a7b0cdb2aee05183baca77154de
data/README.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Ruby Client for BigQuery Data Transfer API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
2
2
 
3
3
  [BigQuery Data Transfer API][Product Documentation]:
4
- Transfers data from partner SaaS applications to Google BigQuery on a
5
- scheduled, managed basis.
4
+ Schedule queries or transfer external data from SaaS applications to Google
5
+ BigQuery on a regular basis.
6
6
  - [Client Library Documentation][]
7
7
  - [Product Documentation][]
8
8
 
@@ -25,8 +25,8 @@ module Google
25
25
  # # Ruby Client for BigQuery Data Transfer API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
26
26
  #
27
27
  # [BigQuery Data Transfer API][Product Documentation]:
28
- # Transfers data from partner SaaS applications to Google BigQuery on a
29
- # scheduled, managed basis.
28
+ # Schedule queries or transfer external data from SaaS applications to Google
29
+ # BigQuery on a regular basis.
30
30
  # - [Product Documentation][]
31
31
  #
32
32
  # ## Quick Start
@@ -25,8 +25,8 @@ module Google
25
25
  # # Ruby Client for BigQuery Data Transfer API ([Beta](https://github.com/googleapis/google-cloud-ruby#versioning))
26
26
  #
27
27
  # [BigQuery Data Transfer API][Product Documentation]:
28
- # Transfers data from partner SaaS applications to Google BigQuery on a
29
- # scheduled, managed basis.
28
+ # Schedule queries or transfer external data from SaaS applications to Google
29
+ # BigQuery on a regular basis.
30
30
  # - [Product Documentation][]
31
31
  #
32
32
  # ## Quick Start
@@ -457,7 +457,7 @@ module Google
457
457
  # which can be used for UI rendering.
458
458
  #
459
459
  # @param name [String]
460
- # The field will contain name of the resource requested, for example:
460
+ # Required. The field will contain name of the resource requested, for example:
461
461
  # `projects/{project_id}/dataSources/{data_source_id}`
462
462
  # @param options [Google::Gax::CallOptions]
463
463
  # Overrides the default settings for this call, e.g, timeout,
@@ -489,7 +489,7 @@ module Google
489
489
  # which can be used for UI rendering.
490
490
  #
491
491
  # @param parent [String]
492
- # The BigQuery project id for which data sources should be returned.
492
+ # Required. The BigQuery project id for which data sources should be returned.
493
493
  # Must be in the form: `projects/{project_id}`
494
494
  # @param page_size [Integer]
495
495
  # The maximum number of resources contained in the underlying API
@@ -544,12 +544,12 @@ module Google
544
544
  # Creates a new data transfer configuration.
545
545
  #
546
546
  # @param parent [String]
547
- # The BigQuery project id where the transfer configuration should be created.
547
+ # Required. The BigQuery project id where the transfer configuration should be created.
548
548
  # Must be in the format projects/\\{project_id}/locations/\\{location_id}
549
549
  # If specified location and location of the destination bigquery dataset
550
550
  # do not match - the request will fail.
551
551
  # @param transfer_config [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig | Hash]
552
- # Data transfer configuration to create.
552
+ # Required. Data transfer configuration to create.
553
553
  # A hash of the same form as `Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig`
554
554
  # can also be provided.
555
555
  # @param authorization_code [String]
@@ -615,11 +615,11 @@ module Google
615
615
  # All fields must be set, even if they are not updated.
616
616
  #
617
617
  # @param transfer_config [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig | Hash]
618
- # Data transfer configuration to create.
618
+ # Required. Data transfer configuration to create.
619
619
  # A hash of the same form as `Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig`
620
620
  # can also be provided.
621
621
  # @param update_mask [Google::Protobuf::FieldMask | Hash]
622
- # Required list of fields to be updated in this request.
622
+ # Required. Required list of fields to be updated in this request.
623
623
  # A hash of the same form as `Google::Protobuf::FieldMask`
624
624
  # can also be provided.
625
625
  # @param authorization_code [String]
@@ -687,7 +687,7 @@ module Google
687
687
  # including any associated transfer runs and logs.
688
688
  #
689
689
  # @param name [String]
690
- # The field will contain name of the resource requested, for example:
690
+ # Required. The field will contain name of the resource requested, for example:
691
691
  # `projects/{project_id}/transferConfigs/{config_id}`
692
692
  # @param options [Google::Gax::CallOptions]
693
693
  # Overrides the default settings for this call, e.g, timeout,
@@ -718,7 +718,7 @@ module Google
718
718
  # Returns information about a data transfer config.
719
719
  #
720
720
  # @param name [String]
721
- # The field will contain name of the resource requested, for example:
721
+ # Required. The field will contain name of the resource requested, for example:
722
722
  # `projects/{project_id}/transferConfigs/{config_id}`
723
723
  # @param options [Google::Gax::CallOptions]
724
724
  # Overrides the default settings for this call, e.g, timeout,
@@ -749,7 +749,7 @@ module Google
749
749
  # Returns information about all data transfers in the project.
750
750
  #
751
751
  # @param parent [String]
752
- # The BigQuery project id for which data sources
752
+ # Required. The BigQuery project id for which data sources
753
753
  # should be returned: `projects/{project_id}`.
754
754
  # @param data_source_ids [Array<String>]
755
755
  # When specified, only configurations of requested data sources are returned.
@@ -812,15 +812,15 @@ module Google
812
812
  # DEPRECATED: use StartManualTransferRuns instead.
813
813
  #
814
814
  # @param parent [String]
815
- # Transfer configuration name in the form:
815
+ # Required. Transfer configuration name in the form:
816
816
  # `projects/{project_id}/transferConfigs/{config_id}`.
817
817
  # @param start_time [Google::Protobuf::Timestamp | Hash]
818
- # Start time of the range of transfer runs. For example,
818
+ # Required. Start time of the range of transfer runs. For example,
819
819
  # `"2017-05-25T00:00:00+00:00"`.
820
820
  # A hash of the same form as `Google::Protobuf::Timestamp`
821
821
  # can also be provided.
822
822
  # @param end_time [Google::Protobuf::Timestamp | Hash]
823
- # End time of the range of transfer runs. For example,
823
+ # Required. End time of the range of transfer runs. For example,
824
824
  # `"2017-05-30T00:00:00+00:00"`.
825
825
  # A hash of the same form as `Google::Protobuf::Timestamp`
826
826
  # can also be provided.
@@ -863,7 +863,7 @@ module Google
863
863
  # Returns information about the particular transfer run.
864
864
  #
865
865
  # @param name [String]
866
- # The field will contain name of the resource requested, for example:
866
+ # Required. The field will contain name of the resource requested, for example:
867
867
  # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}`
868
868
  # @param options [Google::Gax::CallOptions]
869
869
  # Overrides the default settings for this call, e.g, timeout,
@@ -894,7 +894,7 @@ module Google
894
894
  # Deletes the specified transfer run.
895
895
  #
896
896
  # @param name [String]
897
- # The field will contain name of the resource requested, for example:
897
+ # Required. The field will contain name of the resource requested, for example:
898
898
  # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}`
899
899
  # @param options [Google::Gax::CallOptions]
900
900
  # Overrides the default settings for this call, e.g, timeout,
@@ -925,7 +925,7 @@ module Google
925
925
  # Returns information about running and completed jobs.
926
926
  #
927
927
  # @param parent [String]
928
- # Name of transfer configuration for which transfer runs should be retrieved.
928
+ # Required. Name of transfer configuration for which transfer runs should be retrieved.
929
929
  # Format of transfer configuration resource name is:
930
930
  # `projects/{project_id}/transferConfigs/{config_id}`.
931
931
  # @param states [Array<Google::Cloud::Bigquery::Datatransfer::V1::TransferState>]
@@ -989,7 +989,7 @@ module Google
989
989
  # Returns user facing log messages for the data transfer run.
990
990
  #
991
991
  # @param parent [String]
992
- # Transfer run name in the form:
992
+ # Required. Transfer run name in the form:
993
993
  # `projects/{project_id}/transferConfigs/{config_Id}/runs/{run_id}`.
994
994
  # @param page_size [Integer]
995
995
  # The maximum number of resources contained in the underlying API
@@ -1054,7 +1054,7 @@ module Google
1054
1054
  # create a transfer config.
1055
1055
  #
1056
1056
  # @param name [String]
1057
- # The data source in the form:
1057
+ # Required. The data source in the form:
1058
1058
  # `projects/{project_id}/dataSources/{data_source_id}`
1059
1059
  # @param options [Google::Gax::CallOptions]
1060
1060
  # Overrides the default settings for this call, e.g, timeout,
@@ -206,14 +206,14 @@ module Google
206
206
  # A request to get data source info.
207
207
  # @!attribute [rw] name
208
208
  # @return [String]
209
- # The field will contain name of the resource requested, for example:
209
+ # Required. The field will contain name of the resource requested, for example:
210
210
  # `projects/{project_id}/dataSources/{data_source_id}`
211
211
  class GetDataSourceRequest; end
212
212
 
213
213
  # Request to list supported data sources and their data transfer settings.
214
214
  # @!attribute [rw] parent
215
215
  # @return [String]
216
- # The BigQuery project id for which data sources should be returned.
216
+ # Required. The BigQuery project id for which data sources should be returned.
217
217
  # Must be in the form: `projects/{project_id}`
218
218
  # @!attribute [rw] page_token
219
219
  # @return [String]
@@ -247,13 +247,13 @@ module Google
247
247
  # with the calling user.
248
248
  # @!attribute [rw] parent
249
249
  # @return [String]
250
- # The BigQuery project id where the transfer configuration should be created.
250
+ # Required. The BigQuery project id where the transfer configuration should be created.
251
251
  # Must be in the format projects/\\{project_id}/locations/\\{location_id}
252
252
  # If specified location and location of the destination bigquery dataset
253
253
  # do not match - the request will fail.
254
254
  # @!attribute [rw] transfer_config
255
255
  # @return [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig]
256
- # Data transfer configuration to create.
256
+ # Required. Data transfer configuration to create.
257
257
  # @!attribute [rw] authorization_code
258
258
  # @return [String]
259
259
  # Optional OAuth2 authorization code to use with this transfer configuration.
@@ -286,7 +286,7 @@ module Google
286
286
  # transfer configuration, an authorization code needs to be provided.
287
287
  # @!attribute [rw] transfer_config
288
288
  # @return [Google::Cloud::Bigquery::Datatransfer::V1::TransferConfig]
289
- # Data transfer configuration to create.
289
+ # Required. Data transfer configuration to create.
290
290
  # @!attribute [rw] authorization_code
291
291
  # @return [String]
292
292
  # Optional OAuth2 authorization code to use with this transfer configuration.
@@ -307,7 +307,7 @@ module Google
307
307
  # the user to copy the code and paste it in the application.
308
308
  # @!attribute [rw] update_mask
309
309
  # @return [Google::Protobuf::FieldMask]
310
- # Required list of fields to be updated in this request.
310
+ # Required. Required list of fields to be updated in this request.
311
311
  # @!attribute [rw] version_info
312
312
  # @return [String]
313
313
  # Optional version info. If users want to find a very recent access token,
@@ -321,7 +321,7 @@ module Google
321
321
  # A request to get data transfer information.
322
322
  # @!attribute [rw] name
323
323
  # @return [String]
324
- # The field will contain name of the resource requested, for example:
324
+ # Required. The field will contain name of the resource requested, for example:
325
325
  # `projects/{project_id}/transferConfigs/{config_id}`
326
326
  class GetTransferConfigRequest; end
327
327
 
@@ -329,28 +329,28 @@ module Google
329
329
  # and log messages will be deleted as well.
330
330
  # @!attribute [rw] name
331
331
  # @return [String]
332
- # The field will contain name of the resource requested, for example:
332
+ # Required. The field will contain name of the resource requested, for example:
333
333
  # `projects/{project_id}/transferConfigs/{config_id}`
334
334
  class DeleteTransferConfigRequest; end
335
335
 
336
336
  # A request to get data transfer run information.
337
337
  # @!attribute [rw] name
338
338
  # @return [String]
339
- # The field will contain name of the resource requested, for example:
339
+ # Required. The field will contain name of the resource requested, for example:
340
340
  # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}`
341
341
  class GetTransferRunRequest; end
342
342
 
343
343
  # A request to delete data transfer run information.
344
344
  # @!attribute [rw] name
345
345
  # @return [String]
346
- # The field will contain name of the resource requested, for example:
346
+ # Required. The field will contain name of the resource requested, for example:
347
347
  # `projects/{project_id}/transferConfigs/{config_id}/runs/{run_id}`
348
348
  class DeleteTransferRunRequest; end
349
349
 
350
350
  # A request to list data transfers configured for a BigQuery project.
351
351
  # @!attribute [rw] parent
352
352
  # @return [String]
353
- # The BigQuery project id for which data sources
353
+ # Required. The BigQuery project id for which data sources
354
354
  # should be returned: `projects/{project_id}`.
355
355
  # @!attribute [rw] data_source_ids
356
356
  # @return [Array<String>]
@@ -384,7 +384,7 @@ module Google
384
384
  # all scheduled transfer runs.
385
385
  # @!attribute [rw] parent
386
386
  # @return [String]
387
- # Name of transfer configuration for which transfer runs should be retrieved.
387
+ # Required. Name of transfer configuration for which transfer runs should be retrieved.
388
388
  # Format of transfer configuration resource name is:
389
389
  # `projects/{project_id}/transferConfigs/{config_id}`.
390
390
  # @!attribute [rw] states
@@ -429,7 +429,7 @@ module Google
429
429
  # A request to get user facing log messages associated with data transfer run.
430
430
  # @!attribute [rw] parent
431
431
  # @return [String]
432
- # Transfer run name in the form:
432
+ # Required. Transfer run name in the form:
433
433
  # `projects/{project_id}/transferConfigs/{config_Id}/runs/{run_id}`.
434
434
  # @!attribute [rw] page_token
435
435
  # @return [String]
@@ -467,7 +467,7 @@ module Google
467
467
  # already valid merely based on the user id.
468
468
  # @!attribute [rw] name
469
469
  # @return [String]
470
- # The data source in the form:
470
+ # Required. The data source in the form:
471
471
  # `projects/{project_id}/dataSources/{data_source_id}`
472
472
  class CheckValidCredsRequest; end
473
473
 
@@ -480,15 +480,15 @@ module Google
480
480
  # A request to schedule transfer runs for a time range.
481
481
  # @!attribute [rw] parent
482
482
  # @return [String]
483
- # Transfer configuration name in the form:
483
+ # Required. Transfer configuration name in the form:
484
484
  # `projects/{project_id}/transferConfigs/{config_id}`.
485
485
  # @!attribute [rw] start_time
486
486
  # @return [Google::Protobuf::Timestamp]
487
- # Start time of the range of transfer runs. For example,
487
+ # Required. Start time of the range of transfer runs. For example,
488
488
  # `"2017-05-25T00:00:00+00:00"`.
489
489
  # @!attribute [rw] end_time
490
490
  # @return [Google::Protobuf::Timestamp]
491
- # End time of the range of transfer runs. For example,
491
+ # Required. End time of the range of transfer runs. For example,
492
492
  # `"2017-05-30T00:00:00+00:00"`.
493
493
  class ScheduleTransferRunsRequest; end
494
494
 
@@ -88,11 +88,13 @@ module Google
88
88
  # 01:30 UTC on January 15, 2017.
89
89
  #
90
90
  # In JavaScript, one can convert a Date object to this format using the
91
- # standard [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
91
+ # standard
92
+ # [toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString)
92
93
  # method. In Python, a standard `datetime.datetime` object can be converted
93
- # to this format using [`strftime`](https://docs.python.org/2/library/time.html#time.strftime)
94
- # with the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one
95
- # can use the Joda Time's [`ISODateTimeFormat.dateTime()`](
94
+ # to this format using
95
+ # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
96
+ # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
97
+ # the Joda Time's [`ISODateTimeFormat.dateTime()`](
96
98
  # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
97
99
  # ) to obtain a formatter capable of generating timestamps in this format.
98
100
  # @!attribute [rw] seconds
@@ -17,7 +17,7 @@ module Google
17
17
  module Cloud
18
18
  module Bigquery
19
19
  module DataTransfer
20
- VERSION = "0.3.0".freeze
20
+ VERSION = "0.3.1".freeze
21
21
  end
22
22
  end
23
23
  end
@@ -5,13 +5,15 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
10
+ require 'google/api/resource_pb'
8
11
  require 'google/cloud/bigquery/datatransfer/v1/transfer_pb'
9
12
  require 'google/protobuf/duration_pb'
10
13
  require 'google/protobuf/empty_pb'
11
14
  require 'google/protobuf/field_mask_pb'
12
15
  require 'google/protobuf/timestamp_pb'
13
16
  require 'google/protobuf/wrappers_pb'
14
- require 'google/api/client_pb'
15
17
  Google::Protobuf::DescriptorPool.generated_pool.build do
16
18
  add_message "google.cloud.bigquery.datatransfer.v1.DataSourceParameter" do
17
19
  optional :param_id, :string, 1
@@ -4,7 +4,8 @@
4
4
 
5
5
  require 'google/protobuf'
6
6
 
7
- require 'google/api/annotations_pb'
7
+ require 'google/api/field_behavior_pb'
8
+ require 'google/api/resource_pb'
8
9
  require 'google/protobuf/struct_pb'
9
10
  require 'google/protobuf/timestamp_pb'
10
11
  require 'google/rpc/status_pb'
@@ -16,7 +17,6 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
16
17
  end
17
18
  add_message "google.cloud.bigquery.datatransfer.v1.TransferConfig" do
18
19
  optional :name, :string, 1
19
- optional :destination_dataset_id, :string, 2
20
20
  optional :display_name, :string, 3
21
21
  optional :data_source_id, :string, 5
22
22
  optional :params, :message, 9, "google.protobuf.Struct"
@@ -29,6 +29,9 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
29
29
  optional :state, :enum, 10, "google.cloud.bigquery.datatransfer.v1.TransferState"
30
30
  optional :user_id, :int64, 11
31
31
  optional :dataset_region, :string, 14
32
+ oneof :destination do
33
+ optional :destination_dataset_id, :string, 2
34
+ end
32
35
  end
33
36
  add_message "google.cloud.bigquery.datatransfer.v1.TransferRun" do
34
37
  optional :name, :string, 1
@@ -39,11 +42,13 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
39
42
  optional :end_time, :message, 5, "google.protobuf.Timestamp"
40
43
  optional :update_time, :message, 6, "google.protobuf.Timestamp"
41
44
  optional :params, :message, 9, "google.protobuf.Struct"
42
- optional :destination_dataset_id, :string, 2
43
45
  optional :data_source_id, :string, 7
44
46
  optional :state, :enum, 8, "google.cloud.bigquery.datatransfer.v1.TransferState"
45
47
  optional :user_id, :int64, 11
46
48
  optional :schedule, :string, 12
49
+ oneof :destination do
50
+ optional :destination_dataset_id, :string, 2
51
+ end
47
52
  end
48
53
  add_message "google.cloud.bigquery.datatransfer.v1.TransferMessage" do
49
54
  optional :message_time, :message, 1, "google.protobuf.Timestamp"
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-data_transfer
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.0
4
+ version: 0.3.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-08-23 00:00:00.000000000 Z
11
+ date: 2019-10-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-gax