google-cloud-bigquery-data_transfer-v1 1.0.3 → 1.2.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d9de95c086dc6cf1b97b05a66174816a996060d40e7e5d077c3dfbe484fb5921
4
- data.tar.gz: 9106a1606e0ecce166aeed417c698a6134d52d4a817e0810c999a10deff8c40e
3
+ metadata.gz: 377cf1942af81576fa35b00e713c46e0bfc57fe5407b43bdfcd5f5d938c3c63b
4
+ data.tar.gz: 27c3295ab715984bd9ad471abd04772aa413c2b54c59691c7fc4b9ddb6a0ea47
5
5
  SHA512:
6
- metadata.gz: 14e911116e8c7363a6013d977f053f8f6a9f79e41858af2dbb23bc3174515fa02fdaeb6108be65e09139a4492d310585c64d29c58eb030a117132a43cc1a8c1e
7
- data.tar.gz: 185b8d5d4e66999042f881e5089ab1f9825a297958c0d7d501d72b1c6e01aa4800e09c86ce724de66950a34144bb11d6d0a6b27963cd8a62a543ccdef9bfec23
6
+ metadata.gz: 2dda68ef56e409bc8aaed8bca330dfdec95ac557e349d0b9fadbd2a518719a6cd838a4a29e94c4ba72f2fc8deb765d57740170cf8974fca4d1df1bf5291e3ed7
7
+ data.tar.gz: 013c125a03eaa2c6ad64a456e52db307a91d1e46d0dc2bb0cecc557c4e1dd601b654faef1c527b50167dc717188e731f6959a40f51bcfb45d0845b1a79e0ae74
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/bigquery/transfer)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/bigquery/data_transfer/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::Bigquery::DataTransfer::V1::DataTransferService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -215,14 +215,26 @@ module Google
215
215
  universe_domain: @config.universe_domain,
216
216
  channel_args: @config.channel_args,
217
217
  interceptors: @config.interceptors,
218
- channel_pool_config: @config.channel_pool
218
+ channel_pool_config: @config.channel_pool,
219
+ logger: @config.logger
219
220
  )
220
221
 
222
+ @data_transfer_service_stub.stub_logger&.info do |entry|
223
+ entry.set_system_name
224
+ entry.set_service
225
+ entry.message = "Created client for #{entry.service}"
226
+ entry.set_credentials_fields credentials
227
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
228
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
229
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
230
+ end
231
+
221
232
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
222
233
  config.credentials = credentials
223
234
  config.quota_project = @quota_project_id
224
235
  config.endpoint = @data_transfer_service_stub.endpoint
225
236
  config.universe_domain = @data_transfer_service_stub.universe_domain
237
+ config.logger = @data_transfer_service_stub.logger if config.respond_to? :logger=
226
238
  end
227
239
  end
228
240
 
@@ -233,6 +245,15 @@ module Google
233
245
  #
234
246
  attr_reader :location_client
235
247
 
248
+ ##
249
+ # The logger used for request/response debug logging.
250
+ #
251
+ # @return [Logger]
252
+ #
253
+ def logger
254
+ @data_transfer_service_stub.logger
255
+ end
256
+
236
257
  # Service calls
237
258
 
238
259
  ##
@@ -317,7 +338,6 @@ module Google
317
338
 
318
339
  @data_transfer_service_stub.call_rpc :get_data_source, request, options: options do |response, operation|
319
340
  yield response, operation if block_given?
320
- return response
321
341
  end
322
342
  rescue ::GRPC::BadStatus => e
323
343
  raise ::Google::Cloud::Error.from_error(e)
@@ -418,7 +438,7 @@ module Google
418
438
  @data_transfer_service_stub.call_rpc :list_data_sources, request, options: options do |response, operation|
419
439
  response = ::Gapic::PagedEnumerable.new @data_transfer_service_stub, :list_data_sources, request, response, operation, options
420
440
  yield response, operation if block_given?
421
- return response
441
+ throw :response, response
422
442
  end
423
443
  rescue ::GRPC::BadStatus => e
424
444
  raise ::Google::Cloud::Error.from_error(e)
@@ -555,7 +575,6 @@ module Google
555
575
 
556
576
  @data_transfer_service_stub.call_rpc :create_transfer_config, request, options: options do |response, operation|
557
577
  yield response, operation if block_given?
558
- return response
559
578
  end
560
579
  rescue ::GRPC::BadStatus => e
561
580
  raise ::Google::Cloud::Error.from_error(e)
@@ -689,7 +708,6 @@ module Google
689
708
 
690
709
  @data_transfer_service_stub.call_rpc :update_transfer_config, request, options: options do |response, operation|
691
710
  yield response, operation if block_given?
692
- return response
693
711
  end
694
712
  rescue ::GRPC::BadStatus => e
695
713
  raise ::Google::Cloud::Error.from_error(e)
@@ -778,7 +796,6 @@ module Google
778
796
 
779
797
  @data_transfer_service_stub.call_rpc :delete_transfer_config, request, options: options do |response, operation|
780
798
  yield response, operation if block_given?
781
- return response
782
799
  end
783
800
  rescue ::GRPC::BadStatus => e
784
801
  raise ::Google::Cloud::Error.from_error(e)
@@ -866,7 +883,6 @@ module Google
866
883
 
867
884
  @data_transfer_service_stub.call_rpc :get_transfer_config, request, options: options do |response, operation|
868
885
  yield response, operation if block_given?
869
- return response
870
886
  end
871
887
  rescue ::GRPC::BadStatus => e
872
888
  raise ::Google::Cloud::Error.from_error(e)
@@ -970,7 +986,7 @@ module Google
970
986
  @data_transfer_service_stub.call_rpc :list_transfer_configs, request, options: options do |response, operation|
971
987
  response = ::Gapic::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_configs, request, response, operation, options
972
988
  yield response, operation if block_given?
973
- return response
989
+ throw :response, response
974
990
  end
975
991
  rescue ::GRPC::BadStatus => e
976
992
  raise ::Google::Cloud::Error.from_error(e)
@@ -1070,7 +1086,6 @@ module Google
1070
1086
 
1071
1087
  @data_transfer_service_stub.call_rpc :schedule_transfer_runs, request, options: options do |response, operation|
1072
1088
  yield response, operation if block_given?
1073
- return response
1074
1089
  end
1075
1090
  rescue ::GRPC::BadStatus => e
1076
1091
  raise ::Google::Cloud::Error.from_error(e)
@@ -1171,7 +1186,6 @@ module Google
1171
1186
 
1172
1187
  @data_transfer_service_stub.call_rpc :start_manual_transfer_runs, request, options: options do |response, operation|
1173
1188
  yield response, operation if block_given?
1174
- return response
1175
1189
  end
1176
1190
  rescue ::GRPC::BadStatus => e
1177
1191
  raise ::Google::Cloud::Error.from_error(e)
@@ -1260,7 +1274,6 @@ module Google
1260
1274
 
1261
1275
  @data_transfer_service_stub.call_rpc :get_transfer_run, request, options: options do |response, operation|
1262
1276
  yield response, operation if block_given?
1263
- return response
1264
1277
  end
1265
1278
  rescue ::GRPC::BadStatus => e
1266
1279
  raise ::Google::Cloud::Error.from_error(e)
@@ -1349,7 +1362,6 @@ module Google
1349
1362
 
1350
1363
  @data_transfer_service_stub.call_rpc :delete_transfer_run, request, options: options do |response, operation|
1351
1364
  yield response, operation if block_given?
1352
- return response
1353
1365
  end
1354
1366
  rescue ::GRPC::BadStatus => e
1355
1367
  raise ::Google::Cloud::Error.from_error(e)
@@ -1455,7 +1467,7 @@ module Google
1455
1467
  @data_transfer_service_stub.call_rpc :list_transfer_runs, request, options: options do |response, operation|
1456
1468
  response = ::Gapic::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_runs, request, response, operation, options
1457
1469
  yield response, operation if block_given?
1458
- return response
1470
+ throw :response, response
1459
1471
  end
1460
1472
  rescue ::GRPC::BadStatus => e
1461
1473
  raise ::Google::Cloud::Error.from_error(e)
@@ -1559,7 +1571,7 @@ module Google
1559
1571
  @data_transfer_service_stub.call_rpc :list_transfer_logs, request, options: options do |response, operation|
1560
1572
  response = ::Gapic::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_logs, request, response, operation, options
1561
1573
  yield response, operation if block_given?
1562
- return response
1574
+ throw :response, response
1563
1575
  end
1564
1576
  rescue ::GRPC::BadStatus => e
1565
1577
  raise ::Google::Cloud::Error.from_error(e)
@@ -1648,7 +1660,6 @@ module Google
1648
1660
 
1649
1661
  @data_transfer_service_stub.call_rpc :check_valid_creds, request, options: options do |response, operation|
1650
1662
  yield response, operation if block_given?
1651
- return response
1652
1663
  end
1653
1664
  rescue ::GRPC::BadStatus => e
1654
1665
  raise ::Google::Cloud::Error.from_error(e)
@@ -1745,7 +1756,6 @@ module Google
1745
1756
 
1746
1757
  @data_transfer_service_stub.call_rpc :enroll_data_sources, request, options: options do |response, operation|
1747
1758
  yield response, operation if block_given?
1748
- return response
1749
1759
  end
1750
1760
  rescue ::GRPC::BadStatus => e
1751
1761
  raise ::Google::Cloud::Error.from_error(e)
@@ -1839,7 +1849,6 @@ module Google
1839
1849
 
1840
1850
  @data_transfer_service_stub.call_rpc :unenroll_data_sources, request, options: options do |response, operation|
1841
1851
  yield response, operation if block_given?
1842
- return response
1843
1852
  end
1844
1853
  rescue ::GRPC::BadStatus => e
1845
1854
  raise ::Google::Cloud::Error.from_error(e)
@@ -1928,6 +1937,11 @@ module Google
1928
1937
  # default endpoint URL. The default value of nil uses the environment
1929
1938
  # universe (usually the default "googleapis.com" universe).
1930
1939
  # @return [::String,nil]
1940
+ # @!attribute [rw] logger
1941
+ # A custom logger to use for request/response debug logging, or the value
1942
+ # `:default` (the default) to construct a default logger, or `nil` to
1943
+ # explicitly disable logging.
1944
+ # @return [::Logger,:default,nil]
1931
1945
  #
1932
1946
  class Configuration
1933
1947
  extend ::Gapic::Config
@@ -1952,6 +1966,7 @@ module Google
1952
1966
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1953
1967
  config_attr :quota_project, nil, ::String, nil
1954
1968
  config_attr :universe_domain, nil, ::String, nil
1969
+ config_attr :logger, :default, ::Logger, nil, :default
1955
1970
 
1956
1971
  # @private
1957
1972
  def initialize parent_config = nil
@@ -208,15 +208,27 @@ module Google
208
208
  endpoint: @config.endpoint,
209
209
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
210
210
  universe_domain: @config.universe_domain,
211
- credentials: credentials
211
+ credentials: credentials,
212
+ logger: @config.logger
212
213
  )
213
214
 
215
+ @data_transfer_service_stub.logger(stub: true)&.info do |entry|
216
+ entry.set_system_name
217
+ entry.set_service
218
+ entry.message = "Created client for #{entry.service}"
219
+ entry.set_credentials_fields credentials
220
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
221
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
222
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
223
+ end
224
+
214
225
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
215
226
  config.credentials = credentials
216
227
  config.quota_project = @quota_project_id
217
228
  config.endpoint = @data_transfer_service_stub.endpoint
218
229
  config.universe_domain = @data_transfer_service_stub.universe_domain
219
230
  config.bindings_override = @config.bindings_override
231
+ config.logger = @data_transfer_service_stub.logger if config.respond_to? :logger=
220
232
  end
221
233
  end
222
234
 
@@ -227,6 +239,15 @@ module Google
227
239
  #
228
240
  attr_reader :location_client
229
241
 
242
+ ##
243
+ # The logger used for request/response debug logging.
244
+ #
245
+ # @return [Logger]
246
+ #
247
+ def logger
248
+ @data_transfer_service_stub.logger
249
+ end
250
+
230
251
  # Service calls
231
252
 
232
253
  ##
@@ -304,7 +325,6 @@ module Google
304
325
 
305
326
  @data_transfer_service_stub.get_data_source request, options do |result, operation|
306
327
  yield result, operation if block_given?
307
- return result
308
328
  end
309
329
  rescue ::Gapic::Rest::Error => e
310
330
  raise ::Google::Cloud::Error.from_error(e)
@@ -398,7 +418,7 @@ module Google
398
418
  @data_transfer_service_stub.list_data_sources request, options do |result, operation|
399
419
  result = ::Gapic::Rest::PagedEnumerable.new @data_transfer_service_stub, :list_data_sources, "data_sources", request, result, options
400
420
  yield result, operation if block_given?
401
- return result
421
+ throw :response, result
402
422
  end
403
423
  rescue ::Gapic::Rest::Error => e
404
424
  raise ::Google::Cloud::Error.from_error(e)
@@ -528,7 +548,6 @@ module Google
528
548
 
529
549
  @data_transfer_service_stub.create_transfer_config request, options do |result, operation|
530
550
  yield result, operation if block_given?
531
- return result
532
551
  end
533
552
  rescue ::Gapic::Rest::Error => e
534
553
  raise ::Google::Cloud::Error.from_error(e)
@@ -655,7 +674,6 @@ module Google
655
674
 
656
675
  @data_transfer_service_stub.update_transfer_config request, options do |result, operation|
657
676
  yield result, operation if block_given?
658
- return result
659
677
  end
660
678
  rescue ::Gapic::Rest::Error => e
661
679
  raise ::Google::Cloud::Error.from_error(e)
@@ -737,7 +755,6 @@ module Google
737
755
 
738
756
  @data_transfer_service_stub.delete_transfer_config request, options do |result, operation|
739
757
  yield result, operation if block_given?
740
- return result
741
758
  end
742
759
  rescue ::Gapic::Rest::Error => e
743
760
  raise ::Google::Cloud::Error.from_error(e)
@@ -818,7 +835,6 @@ module Google
818
835
 
819
836
  @data_transfer_service_stub.get_transfer_config request, options do |result, operation|
820
837
  yield result, operation if block_given?
821
- return result
822
838
  end
823
839
  rescue ::Gapic::Rest::Error => e
824
840
  raise ::Google::Cloud::Error.from_error(e)
@@ -915,7 +931,7 @@ module Google
915
931
  @data_transfer_service_stub.list_transfer_configs request, options do |result, operation|
916
932
  result = ::Gapic::Rest::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_configs, "transfer_configs", request, result, options
917
933
  yield result, operation if block_given?
918
- return result
934
+ throw :response, result
919
935
  end
920
936
  rescue ::Gapic::Rest::Error => e
921
937
  raise ::Google::Cloud::Error.from_error(e)
@@ -1006,7 +1022,6 @@ module Google
1006
1022
 
1007
1023
  @data_transfer_service_stub.schedule_transfer_runs request, options do |result, operation|
1008
1024
  yield result, operation if block_given?
1009
- return result
1010
1025
  end
1011
1026
  rescue ::Gapic::Rest::Error => e
1012
1027
  raise ::Google::Cloud::Error.from_error(e)
@@ -1100,7 +1115,6 @@ module Google
1100
1115
 
1101
1116
  @data_transfer_service_stub.start_manual_transfer_runs request, options do |result, operation|
1102
1117
  yield result, operation if block_given?
1103
- return result
1104
1118
  end
1105
1119
  rescue ::Gapic::Rest::Error => e
1106
1120
  raise ::Google::Cloud::Error.from_error(e)
@@ -1182,7 +1196,6 @@ module Google
1182
1196
 
1183
1197
  @data_transfer_service_stub.get_transfer_run request, options do |result, operation|
1184
1198
  yield result, operation if block_given?
1185
- return result
1186
1199
  end
1187
1200
  rescue ::Gapic::Rest::Error => e
1188
1201
  raise ::Google::Cloud::Error.from_error(e)
@@ -1264,7 +1277,6 @@ module Google
1264
1277
 
1265
1278
  @data_transfer_service_stub.delete_transfer_run request, options do |result, operation|
1266
1279
  yield result, operation if block_given?
1267
- return result
1268
1280
  end
1269
1281
  rescue ::Gapic::Rest::Error => e
1270
1282
  raise ::Google::Cloud::Error.from_error(e)
@@ -1363,7 +1375,7 @@ module Google
1363
1375
  @data_transfer_service_stub.list_transfer_runs request, options do |result, operation|
1364
1376
  result = ::Gapic::Rest::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_runs, "transfer_runs", request, result, options
1365
1377
  yield result, operation if block_given?
1366
- return result
1378
+ throw :response, result
1367
1379
  end
1368
1380
  rescue ::Gapic::Rest::Error => e
1369
1381
  raise ::Google::Cloud::Error.from_error(e)
@@ -1460,7 +1472,7 @@ module Google
1460
1472
  @data_transfer_service_stub.list_transfer_logs request, options do |result, operation|
1461
1473
  result = ::Gapic::Rest::PagedEnumerable.new @data_transfer_service_stub, :list_transfer_logs, "transfer_messages", request, result, options
1462
1474
  yield result, operation if block_given?
1463
- return result
1475
+ throw :response, result
1464
1476
  end
1465
1477
  rescue ::Gapic::Rest::Error => e
1466
1478
  raise ::Google::Cloud::Error.from_error(e)
@@ -1542,7 +1554,6 @@ module Google
1542
1554
 
1543
1555
  @data_transfer_service_stub.check_valid_creds request, options do |result, operation|
1544
1556
  yield result, operation if block_given?
1545
- return result
1546
1557
  end
1547
1558
  rescue ::Gapic::Rest::Error => e
1548
1559
  raise ::Google::Cloud::Error.from_error(e)
@@ -1632,7 +1643,6 @@ module Google
1632
1643
 
1633
1644
  @data_transfer_service_stub.enroll_data_sources request, options do |result, operation|
1634
1645
  yield result, operation if block_given?
1635
- return result
1636
1646
  end
1637
1647
  rescue ::Gapic::Rest::Error => e
1638
1648
  raise ::Google::Cloud::Error.from_error(e)
@@ -1719,7 +1729,6 @@ module Google
1719
1729
 
1720
1730
  @data_transfer_service_stub.unenroll_data_sources request, options do |result, operation|
1721
1731
  yield result, operation if block_given?
1722
- return result
1723
1732
  end
1724
1733
  rescue ::Gapic::Rest::Error => e
1725
1734
  raise ::Google::Cloud::Error.from_error(e)
@@ -1799,6 +1808,11 @@ module Google
1799
1808
  # default endpoint URL. The default value of nil uses the environment
1800
1809
  # universe (usually the default "googleapis.com" universe).
1801
1810
  # @return [::String,nil]
1811
+ # @!attribute [rw] logger
1812
+ # A custom logger to use for request/response debug logging, or the value
1813
+ # `:default` (the default) to construct a default logger, or `nil` to
1814
+ # explicitly disable logging.
1815
+ # @return [::Logger,:default,nil]
1802
1816
  #
1803
1817
  class Configuration
1804
1818
  extend ::Gapic::Config
@@ -1827,6 +1841,7 @@ module Google
1827
1841
  # by the host service.
1828
1842
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1829
1843
  config_attr :bindings_override, {}, ::Hash, nil
1844
+ config_attr :logger, :default, ::Logger, nil, :default
1830
1845
 
1831
1846
  # @private
1832
1847
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the get_data_source REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "get_data_source",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::DataSource.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "list_data_sources",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::ListDataSourcesResponse.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "create_transfer_config",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -202,16 +220,18 @@ module Google
202
220
 
203
221
  response = @client_stub.make_http_request(
204
222
  verb,
205
- uri: uri,
206
- body: body || "",
207
- params: query_string_params,
223
+ uri: uri,
224
+ body: body || "",
225
+ params: query_string_params,
226
+ method_name: "update_transfer_config",
208
227
  options: options
209
228
  )
210
229
  operation = ::Gapic::Rest::TransportOperation.new response
211
230
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig.decode_json response.body, ignore_unknown_fields: true
212
-
213
- yield result, operation if block_given?
214
- result
231
+ catch :response do
232
+ yield result, operation if block_given?
233
+ result
234
+ end
215
235
  end
216
236
 
217
237
  ##
@@ -240,16 +260,18 @@ module Google
240
260
 
241
261
  response = @client_stub.make_http_request(
242
262
  verb,
243
- uri: uri,
244
- body: body || "",
245
- params: query_string_params,
263
+ uri: uri,
264
+ body: body || "",
265
+ params: query_string_params,
266
+ method_name: "delete_transfer_config",
246
267
  options: options
247
268
  )
248
269
  operation = ::Gapic::Rest::TransportOperation.new response
249
270
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
250
-
251
- yield result, operation if block_given?
252
- result
271
+ catch :response do
272
+ yield result, operation if block_given?
273
+ result
274
+ end
253
275
  end
254
276
 
255
277
  ##
@@ -278,16 +300,18 @@ module Google
278
300
 
279
301
  response = @client_stub.make_http_request(
280
302
  verb,
281
- uri: uri,
282
- body: body || "",
283
- params: query_string_params,
303
+ uri: uri,
304
+ body: body || "",
305
+ params: query_string_params,
306
+ method_name: "get_transfer_config",
284
307
  options: options
285
308
  )
286
309
  operation = ::Gapic::Rest::TransportOperation.new response
287
310
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::TransferConfig.decode_json response.body, ignore_unknown_fields: true
288
-
289
- yield result, operation if block_given?
290
- result
311
+ catch :response do
312
+ yield result, operation if block_given?
313
+ result
314
+ end
291
315
  end
292
316
 
293
317
  ##
@@ -316,16 +340,18 @@ module Google
316
340
 
317
341
  response = @client_stub.make_http_request(
318
342
  verb,
319
- uri: uri,
320
- body: body || "",
321
- params: query_string_params,
343
+ uri: uri,
344
+ body: body || "",
345
+ params: query_string_params,
346
+ method_name: "list_transfer_configs",
322
347
  options: options
323
348
  )
324
349
  operation = ::Gapic::Rest::TransportOperation.new response
325
350
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferConfigsResponse.decode_json response.body, ignore_unknown_fields: true
326
-
327
- yield result, operation if block_given?
328
- result
351
+ catch :response do
352
+ yield result, operation if block_given?
353
+ result
354
+ end
329
355
  end
330
356
 
331
357
  ##
@@ -354,16 +380,18 @@ module Google
354
380
 
355
381
  response = @client_stub.make_http_request(
356
382
  verb,
357
- uri: uri,
358
- body: body || "",
359
- params: query_string_params,
383
+ uri: uri,
384
+ body: body || "",
385
+ params: query_string_params,
386
+ method_name: "schedule_transfer_runs",
360
387
  options: options
361
388
  )
362
389
  operation = ::Gapic::Rest::TransportOperation.new response
363
390
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleTransferRunsResponse.decode_json response.body, ignore_unknown_fields: true
364
-
365
- yield result, operation if block_given?
366
- result
391
+ catch :response do
392
+ yield result, operation if block_given?
393
+ result
394
+ end
367
395
  end
368
396
 
369
397
  ##
@@ -392,16 +420,18 @@ module Google
392
420
 
393
421
  response = @client_stub.make_http_request(
394
422
  verb,
395
- uri: uri,
396
- body: body || "",
397
- params: query_string_params,
423
+ uri: uri,
424
+ body: body || "",
425
+ params: query_string_params,
426
+ method_name: "start_manual_transfer_runs",
398
427
  options: options
399
428
  )
400
429
  operation = ::Gapic::Rest::TransportOperation.new response
401
430
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::StartManualTransferRunsResponse.decode_json response.body, ignore_unknown_fields: true
402
-
403
- yield result, operation if block_given?
404
- result
431
+ catch :response do
432
+ yield result, operation if block_given?
433
+ result
434
+ end
405
435
  end
406
436
 
407
437
  ##
@@ -430,16 +460,18 @@ module Google
430
460
 
431
461
  response = @client_stub.make_http_request(
432
462
  verb,
433
- uri: uri,
434
- body: body || "",
435
- params: query_string_params,
463
+ uri: uri,
464
+ body: body || "",
465
+ params: query_string_params,
466
+ method_name: "get_transfer_run",
436
467
  options: options
437
468
  )
438
469
  operation = ::Gapic::Rest::TransportOperation.new response
439
470
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::TransferRun.decode_json response.body, ignore_unknown_fields: true
440
-
441
- yield result, operation if block_given?
442
- result
471
+ catch :response do
472
+ yield result, operation if block_given?
473
+ result
474
+ end
443
475
  end
444
476
 
445
477
  ##
@@ -468,16 +500,18 @@ module Google
468
500
 
469
501
  response = @client_stub.make_http_request(
470
502
  verb,
471
- uri: uri,
472
- body: body || "",
473
- params: query_string_params,
503
+ uri: uri,
504
+ body: body || "",
505
+ params: query_string_params,
506
+ method_name: "delete_transfer_run",
474
507
  options: options
475
508
  )
476
509
  operation = ::Gapic::Rest::TransportOperation.new response
477
510
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
478
-
479
- yield result, operation if block_given?
480
- result
511
+ catch :response do
512
+ yield result, operation if block_given?
513
+ result
514
+ end
481
515
  end
482
516
 
483
517
  ##
@@ -506,16 +540,18 @@ module Google
506
540
 
507
541
  response = @client_stub.make_http_request(
508
542
  verb,
509
- uri: uri,
510
- body: body || "",
511
- params: query_string_params,
543
+ uri: uri,
544
+ body: body || "",
545
+ params: query_string_params,
546
+ method_name: "list_transfer_runs",
512
547
  options: options
513
548
  )
514
549
  operation = ::Gapic::Rest::TransportOperation.new response
515
550
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferRunsResponse.decode_json response.body, ignore_unknown_fields: true
516
-
517
- yield result, operation if block_given?
518
- result
551
+ catch :response do
552
+ yield result, operation if block_given?
553
+ result
554
+ end
519
555
  end
520
556
 
521
557
  ##
@@ -544,16 +580,18 @@ module Google
544
580
 
545
581
  response = @client_stub.make_http_request(
546
582
  verb,
547
- uri: uri,
548
- body: body || "",
549
- params: query_string_params,
583
+ uri: uri,
584
+ body: body || "",
585
+ params: query_string_params,
586
+ method_name: "list_transfer_logs",
550
587
  options: options
551
588
  )
552
589
  operation = ::Gapic::Rest::TransportOperation.new response
553
590
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::ListTransferLogsResponse.decode_json response.body, ignore_unknown_fields: true
554
-
555
- yield result, operation if block_given?
556
- result
591
+ catch :response do
592
+ yield result, operation if block_given?
593
+ result
594
+ end
557
595
  end
558
596
 
559
597
  ##
@@ -582,16 +620,18 @@ module Google
582
620
 
583
621
  response = @client_stub.make_http_request(
584
622
  verb,
585
- uri: uri,
586
- body: body || "",
587
- params: query_string_params,
623
+ uri: uri,
624
+ body: body || "",
625
+ params: query_string_params,
626
+ method_name: "check_valid_creds",
588
627
  options: options
589
628
  )
590
629
  operation = ::Gapic::Rest::TransportOperation.new response
591
630
  result = ::Google::Cloud::Bigquery::DataTransfer::V1::CheckValidCredsResponse.decode_json response.body, ignore_unknown_fields: true
592
-
593
- yield result, operation if block_given?
594
- result
631
+ catch :response do
632
+ yield result, operation if block_given?
633
+ result
634
+ end
595
635
  end
596
636
 
597
637
  ##
@@ -620,16 +660,18 @@ module Google
620
660
 
621
661
  response = @client_stub.make_http_request(
622
662
  verb,
623
- uri: uri,
624
- body: body || "",
625
- params: query_string_params,
663
+ uri: uri,
664
+ body: body || "",
665
+ params: query_string_params,
666
+ method_name: "enroll_data_sources",
626
667
  options: options
627
668
  )
628
669
  operation = ::Gapic::Rest::TransportOperation.new response
629
670
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
630
-
631
- yield result, operation if block_given?
632
- result
671
+ catch :response do
672
+ yield result, operation if block_given?
673
+ result
674
+ end
633
675
  end
634
676
 
635
677
  ##
@@ -658,16 +700,18 @@ module Google
658
700
 
659
701
  response = @client_stub.make_http_request(
660
702
  verb,
661
- uri: uri,
662
- body: body || "",
663
- params: query_string_params,
703
+ uri: uri,
704
+ body: body || "",
705
+ params: query_string_params,
706
+ method_name: "unenroll_data_sources",
664
707
  options: options
665
708
  )
666
709
  operation = ::Gapic::Rest::TransportOperation.new response
667
710
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
668
-
669
- yield result, operation if block_given?
670
- result
711
+ catch :response do
712
+ yield result, operation if block_given?
713
+ result
714
+ end
671
715
  end
672
716
 
673
717
  ##
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module DataTransfer
24
24
  module V1
25
- VERSION = "1.0.3"
25
+ VERSION = "1.2.0"
26
26
  end
27
27
  end
28
28
  end
@@ -12,7 +12,7 @@ require 'google/protobuf/wrappers_pb'
12
12
  require 'google/rpc/status_pb'
13
13
 
14
14
 
15
- descriptor_data = "\n4google/cloud/bigquery/datatransfer/v1/transfer.proto\x12%google.cloud.bigquery.datatransfer.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto\"0\n\x10\x45mailPreferences\x12\x1c\n\x14\x65nable_failure_email\x18\x01 \x01(\x08\"\x90\x01\n\x0fScheduleOptions\x12\x1f\n\x17\x64isable_auto_scheduling\x18\x03 \x01(\x08\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"(\n\x08UserInfo\x12\x12\n\x05\x65mail\x18\x01 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_email\"\x9c\x08\n\x0eTransferConfig\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12 \n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\tH\x00\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x16\n\x0e\x64\x61ta_source_id\x18\x05 \x01(\t\x12\'\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x10\n\x08schedule\x18\x07 \x01(\t\x12P\n\x10schedule_options\x18\x18 \x01(\x0b\x32\x36.google.cloud.bigquery.datatransfer.v1.ScheduleOptions\x12 \n\x18\x64\x61ta_refresh_window_days\x18\x0c \x01(\x05\x12\x10\n\x08\x64isabled\x18\r \x01(\x08\x12\x34\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x36\n\rnext_run_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x05state\x18\n \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferStateB\x03\xe0\x41\x03\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x1b\n\x0e\x64\x61taset_region\x18\x0e \x01(\tB\x03\xe0\x41\x03\x12!\n\x19notification_pubsub_topic\x18\x0f \x01(\t\x12R\n\x11\x65mail_preferences\x18\x12 \x01(\x0b\x32\x37.google.cloud.bigquery.datatransfer.v1.EmailPreferences\x12M\n\nowner_info\x18\x1b \x01(\x0b\x32/.google.cloud.bigquery.datatransfer.v1.UserInfoB\x03\xe0\x41\x03H\x01\x88\x01\x01\x12`\n\x18\x65ncryption_configuration\x18\x1c \x01(\x0b\x32>.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration:\xb9\x01\xea\x41\xb5\x01\n2bigquerydatatransfer.googleapis.com/TransferConfig\x12\x34projects/{project}/transferConfigs/{transfer_config}\x12Iprojects/{project}/locations/{location}/transferConfigs/{transfer_config}B\r\n\x0b\x64\x65stinationB\r\n\x0b_owner_info\"M\n\x17\x45ncryptionConfiguration\x12\x32\n\x0ckms_key_name\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.StringValue\"\xff\x06\n\x0bTransferRun\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x31\n\rschedule_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08run_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12(\n\x0c\x65rror_status\x18\x15 \x01(\x0b\x32\x12.google.rpc.Status\x12\x33\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x31\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12,\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x03\x12%\n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\tB\x03\xe0\x41\x03H\x00\x12\x1b\n\x0e\x64\x61ta_source_id\x18\x07 \x01(\tB\x03\xe0\x41\x03\x12\x43\n\x05state\x18\x08 \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferState\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x15\n\x08schedule\x18\x0c \x01(\tB\x03\xe0\x41\x03\x12&\n\x19notification_pubsub_topic\x18\x17 \x01(\tB\x03\xe0\x41\x03\x12W\n\x11\x65mail_preferences\x18\x19 \x01(\x0b\x32\x37.google.cloud.bigquery.datatransfer.v1.EmailPreferencesB\x03\xe0\x41\x03:\xc4\x01\xea\x41\xc0\x01\n\'bigquerydatatransfer.googleapis.com/Run\x12?projects/{project}/transferConfigs/{transfer_config}/runs/{run}\x12Tprojects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run}B\r\n\x0b\x64\x65stination\"\x8a\x02\n\x0fTransferMessage\x12\x30\n\x0cmessage_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x08severity\x18\x02 \x01(\x0e\x32\x46.google.cloud.bigquery.datatransfer.v1.TransferMessage.MessageSeverity\x12\x14\n\x0cmessage_text\x18\x03 \x01(\t\"U\n\x0fMessageSeverity\x12 \n\x1cMESSAGE_SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03*K\n\x0cTransferType\x12\x1d\n\x19TRANSFER_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41TCH\x10\x01\x12\r\n\tSTREAMING\x10\x02\x1a\x02\x18\x01*s\n\rTransferState\x12\x1e\n\x1aTRANSFER_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x02\x12\x0b\n\x07RUNNING\x10\x03\x12\r\n\tSUCCEEDED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05\x12\r\n\tCANCELLED\x10\x06\x42\x8f\x02\n)com.google.cloud.bigquery.datatransfer.v1B\rTransferProtoP\x01ZMcloud.google.com/go/bigquery/datatransfer/apiv1/datatransferpb;datatransferpb\xa2\x02\x05GCBDT\xaa\x02%Google.Cloud.BigQuery.DataTransfer.V1\xca\x02%Google\\Cloud\\BigQuery\\DataTransfer\\V1\xea\x02)Google::Cloud::Bigquery::DataTransfer::V1b\x06proto3"
15
+ descriptor_data = "\n4google/cloud/bigquery/datatransfer/v1/transfer.proto\x12%google.cloud.bigquery.datatransfer.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1cgoogle/protobuf/struct.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\x1a\x17google/rpc/status.proto\"0\n\x10\x45mailPreferences\x12\x1c\n\x14\x65nable_failure_email\x18\x01 \x01(\x08\"\x90\x01\n\x0fScheduleOptions\x12\x1f\n\x17\x64isable_auto_scheduling\x18\x03 \x01(\x08\x12.\n\nstart_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\xa7\x02\n\x11ScheduleOptionsV2\x12W\n\x13time_based_schedule\x18\x01 \x01(\x0b\x32\x38.google.cloud.bigquery.datatransfer.v1.TimeBasedScheduleH\x00\x12P\n\x0fmanual_schedule\x18\x02 \x01(\x0b\x32\x35.google.cloud.bigquery.datatransfer.v1.ManualScheduleH\x00\x12[\n\x15\x65vent_driven_schedule\x18\x03 \x01(\x0b\x32:.google.cloud.bigquery.datatransfer.v1.EventDrivenScheduleH\x00\x42\n\n\x08schedule\"\x83\x01\n\x11TimeBasedSchedule\x12\x10\n\x08schedule\x18\x01 \x01(\t\x12.\n\nstart_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08\x65nd_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\"\x10\n\x0eManualSchedule\"2\n\x13\x45ventDrivenSchedule\x12\x1b\n\x13pubsub_subscription\x18\x01 \x01(\t\"(\n\x08UserInfo\x12\x12\n\x05\x65mail\x18\x01 \x01(\tH\x00\x88\x01\x01\x42\x08\n\x06_email\"\x9b\t\n\x0eTransferConfig\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12 \n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\tH\x00\x12\x14\n\x0c\x64isplay_name\x18\x03 \x01(\t\x12\x16\n\x0e\x64\x61ta_source_id\x18\x05 \x01(\t\x12\'\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x10\n\x08schedule\x18\x07 \x01(\t\x12P\n\x10schedule_options\x18\x18 \x01(\x0b\x32\x36.google.cloud.bigquery.datatransfer.v1.ScheduleOptions\x12U\n\x13schedule_options_v2\x18\x1f \x01(\x0b\x32\x38.google.cloud.bigquery.datatransfer.v1.ScheduleOptionsV2\x12 \n\x18\x64\x61ta_refresh_window_days\x18\x0c \x01(\x05\x12\x10\n\x08\x64isabled\x18\r \x01(\x08\x12\x34\n\x0bupdate_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x36\n\rnext_run_time\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12H\n\x05state\x18\n \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferStateB\x03\xe0\x41\x03\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x1b\n\x0e\x64\x61taset_region\x18\x0e \x01(\tB\x03\xe0\x41\x03\x12!\n\x19notification_pubsub_topic\x18\x0f \x01(\t\x12R\n\x11\x65mail_preferences\x18\x12 \x01(\x0b\x32\x37.google.cloud.bigquery.datatransfer.v1.EmailPreferences\x12M\n\nowner_info\x18\x1b \x01(\x0b\x32/.google.cloud.bigquery.datatransfer.v1.UserInfoB\x03\xe0\x41\x03H\x01\x88\x01\x01\x12`\n\x18\x65ncryption_configuration\x18\x1c \x01(\x0b\x32>.google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration\x12&\n\x05\x65rror\x18 \x01(\x0b\x32\x12.google.rpc.StatusB\x03\xe0\x41\x03:\xb9\x01\xea\x41\xb5\x01\n2bigquerydatatransfer.googleapis.com/TransferConfig\x12\x34projects/{project}/transferConfigs/{transfer_config}\x12Iprojects/{project}/locations/{location}/transferConfigs/{transfer_config}B\r\n\x0b\x64\x65stinationB\r\n\x0b_owner_info\"M\n\x17\x45ncryptionConfiguration\x12\x32\n\x0ckms_key_name\x18\x01 \x01(\x0b\x32\x1c.google.protobuf.StringValue\"\xff\x06\n\x0bTransferRun\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x31\n\rschedule_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12,\n\x08run_time\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12(\n\x0c\x65rror_status\x18\x15 \x01(\x0b\x32\x12.google.rpc.Status\x12\x33\n\nstart_time\x18\x04 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x31\n\x08\x65nd_time\x18\x05 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12\x34\n\x0bupdate_time\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x12,\n\x06params\x18\t \x01(\x0b\x32\x17.google.protobuf.StructB\x03\xe0\x41\x03\x12%\n\x16\x64\x65stination_dataset_id\x18\x02 \x01(\tB\x03\xe0\x41\x03H\x00\x12\x1b\n\x0e\x64\x61ta_source_id\x18\x07 \x01(\tB\x03\xe0\x41\x03\x12\x43\n\x05state\x18\x08 \x01(\x0e\x32\x34.google.cloud.bigquery.datatransfer.v1.TransferState\x12\x0f\n\x07user_id\x18\x0b \x01(\x03\x12\x15\n\x08schedule\x18\x0c \x01(\tB\x03\xe0\x41\x03\x12&\n\x19notification_pubsub_topic\x18\x17 \x01(\tB\x03\xe0\x41\x03\x12W\n\x11\x65mail_preferences\x18\x19 \x01(\x0b\x32\x37.google.cloud.bigquery.datatransfer.v1.EmailPreferencesB\x03\xe0\x41\x03:\xc4\x01\xea\x41\xc0\x01\n\'bigquerydatatransfer.googleapis.com/Run\x12?projects/{project}/transferConfigs/{transfer_config}/runs/{run}\x12Tprojects/{project}/locations/{location}/transferConfigs/{transfer_config}/runs/{run}B\r\n\x0b\x64\x65stination\"\x8a\x02\n\x0fTransferMessage\x12\x30\n\x0cmessage_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12X\n\x08severity\x18\x02 \x01(\x0e\x32\x46.google.cloud.bigquery.datatransfer.v1.TransferMessage.MessageSeverity\x12\x14\n\x0cmessage_text\x18\x03 \x01(\t\"U\n\x0fMessageSeverity\x12 \n\x1cMESSAGE_SEVERITY_UNSPECIFIED\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03*K\n\x0cTransferType\x12\x1d\n\x19TRANSFER_TYPE_UNSPECIFIED\x10\x00\x12\t\n\x05\x42\x41TCH\x10\x01\x12\r\n\tSTREAMING\x10\x02\x1a\x02\x18\x01*s\n\rTransferState\x12\x1e\n\x1aTRANSFER_STATE_UNSPECIFIED\x10\x00\x12\x0b\n\x07PENDING\x10\x02\x12\x0b\n\x07RUNNING\x10\x03\x12\r\n\tSUCCEEDED\x10\x04\x12\n\n\x06\x46\x41ILED\x10\x05\x12\r\n\tCANCELLED\x10\x06\x42\x8f\x02\n)com.google.cloud.bigquery.datatransfer.v1B\rTransferProtoP\x01ZMcloud.google.com/go/bigquery/datatransfer/apiv1/datatransferpb;datatransferpb\xa2\x02\x05GCBDT\xaa\x02%Google.Cloud.BigQuery.DataTransfer.V1\xca\x02%Google\\Cloud\\BigQuery\\DataTransfer\\V1\xea\x02)Google::Cloud::Bigquery::DataTransfer::V1b\x06proto3"
16
16
 
17
17
  pool = Google::Protobuf::DescriptorPool.generated_pool
18
18
 
@@ -29,8 +29,8 @@ rescue TypeError
29
29
  imports = [
30
30
  ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
31
31
  ["google.protobuf.Struct", "google/protobuf/struct.proto"],
32
- ["google.protobuf.StringValue", "google/protobuf/wrappers.proto"],
33
32
  ["google.rpc.Status", "google/rpc/status.proto"],
33
+ ["google.protobuf.StringValue", "google/protobuf/wrappers.proto"],
34
34
  ]
35
35
  imports.each do |type_name, expected_filename|
36
36
  import_file = pool.lookup(type_name).file_descriptor
@@ -49,6 +49,10 @@ module Google
49
49
  module V1
50
50
  EmailPreferences = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.EmailPreferences").msgclass
51
51
  ScheduleOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ScheduleOptions").msgclass
52
+ ScheduleOptionsV2 = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ScheduleOptionsV2").msgclass
53
+ TimeBasedSchedule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.TimeBasedSchedule").msgclass
54
+ ManualSchedule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.ManualSchedule").msgclass
55
+ EventDrivenSchedule = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.EventDrivenSchedule").msgclass
52
56
  UserInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.UserInfo").msgclass
53
57
  TransferConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.TransferConfig").msgclass
54
58
  EncryptionConfiguration = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.datatransfer.v1.EncryptionConfiguration").msgclass
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -57,6 +57,79 @@ module Google
57
57
  extend ::Google::Protobuf::MessageExts::ClassMethods
58
58
  end
59
59
 
60
+ # V2 options customizing different types of data transfer schedule.
61
+ # This field supports existing time-based and manual transfer schedule. Also
62
+ # supports Event-Driven transfer schedule. ScheduleOptionsV2 cannot be used
63
+ # together with ScheduleOptions/Schedule.
64
+ # @!attribute [rw] time_based_schedule
65
+ # @return [::Google::Cloud::Bigquery::DataTransfer::V1::TimeBasedSchedule]
66
+ # Time based transfer schedule options. This is the default schedule
67
+ # option.
68
+ # @!attribute [rw] manual_schedule
69
+ # @return [::Google::Cloud::Bigquery::DataTransfer::V1::ManualSchedule]
70
+ # Manual transfer schedule. If set, the transfer run will not be
71
+ # auto-scheduled by the system, unless the client invokes
72
+ # StartManualTransferRuns. This is equivalent to
73
+ # disable_auto_scheduling = true.
74
+ # @!attribute [rw] event_driven_schedule
75
+ # @return [::Google::Cloud::Bigquery::DataTransfer::V1::EventDrivenSchedule]
76
+ # Event driven transfer schedule options. If set, the transfer will be
77
+ # scheduled upon events arrial.
78
+ class ScheduleOptionsV2
79
+ include ::Google::Protobuf::MessageExts
80
+ extend ::Google::Protobuf::MessageExts::ClassMethods
81
+ end
82
+
83
+ # Options customizing the time based transfer schedule.
84
+ # Options are migrated from the original ScheduleOptions message.
85
+ # @!attribute [rw] schedule
86
+ # @return [::String]
87
+ # Data transfer schedule.
88
+ # If the data source does not support a custom schedule, this should be
89
+ # empty. If it is empty, the default value for the data source will be used.
90
+ # The specified times are in UTC.
91
+ # Examples of valid format:
92
+ # `1st,3rd monday of month 15:30`,
93
+ # `every wed,fri of jan,jun 13:15`, and
94
+ # `first sunday of quarter 00:00`.
95
+ # See more explanation about the format here:
96
+ # https://cloud.google.com/appengine/docs/flexible/python/scheduling-jobs-with-cron-yaml#the_schedule_format
97
+ #
98
+ # NOTE: The minimum interval time between recurring transfers depends on the
99
+ # data source; refer to the documentation for your data source.
100
+ # @!attribute [rw] start_time
101
+ # @return [::Google::Protobuf::Timestamp]
102
+ # Specifies time to start scheduling transfer runs. The first run will be
103
+ # scheduled at or after the start time according to a recurrence pattern
104
+ # defined in the schedule string. The start time can be changed at any
105
+ # moment.
106
+ # @!attribute [rw] end_time
107
+ # @return [::Google::Protobuf::Timestamp]
108
+ # Defines time to stop scheduling transfer runs. A transfer run cannot be
109
+ # scheduled at or after the end time. The end time can be changed at any
110
+ # moment.
111
+ class TimeBasedSchedule
112
+ include ::Google::Protobuf::MessageExts
113
+ extend ::Google::Protobuf::MessageExts::ClassMethods
114
+ end
115
+
116
+ # Options customizing manual transfers schedule.
117
+ class ManualSchedule
118
+ include ::Google::Protobuf::MessageExts
119
+ extend ::Google::Protobuf::MessageExts::ClassMethods
120
+ end
121
+
122
+ # Options customizing EventDriven transfers schedule.
123
+ # @!attribute [rw] pubsub_subscription
124
+ # @return [::String]
125
+ # Pub/Sub subscription name used to receive events.
126
+ # Only Google Cloud Storage data source support this option.
127
+ # Format: projects/\\{project}/subscriptions/\\{subscription}
128
+ class EventDrivenSchedule
129
+ include ::Google::Protobuf::MessageExts
130
+ extend ::Google::Protobuf::MessageExts::ClassMethods
131
+ end
132
+
60
133
  # Information about a user.
61
134
  # @!attribute [rw] email
62
135
  # @return [::String]
@@ -116,6 +189,11 @@ module Google
116
189
  # @!attribute [rw] schedule_options
117
190
  # @return [::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptions]
118
191
  # Options customizing the data transfer schedule.
192
+ # @!attribute [rw] schedule_options_v2
193
+ # @return [::Google::Cloud::Bigquery::DataTransfer::V1::ScheduleOptionsV2]
194
+ # Options customizing different types of data transfer schedule.
195
+ # This field replaces "schedule" and "schedule_options" fields.
196
+ # ScheduleOptionsV2 cannot be used together with ScheduleOptions/Schedule.
119
197
  # @!attribute [rw] data_refresh_window_days
120
198
  # @return [::Integer]
121
199
  # The number of days to look back to automatically refresh the data.
@@ -166,6 +244,10 @@ module Google
166
244
  # granted permissions to use the key. Read methods will return the key name
167
245
  # applied in effect. Write methods will apply the key if it is present, or
168
246
  # otherwise try to apply project default keys if it is absent.
247
+ # @!attribute [r] error
248
+ # @return [::Google::Rpc::Status]
249
+ # Output only. Error code with detailed information about reason of the
250
+ # latest config failure.
169
251
  class TransferConfig
170
252
  include ::Google::Protobuf::MessageExts
171
253
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-data_transfer-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.3
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-09-11 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -127,7 +127,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
127
127
  - !ruby/object:Gem::Version
128
128
  version: '0'
129
129
  requirements: []
130
- rubygems_version: 3.5.6
130
+ rubygems_version: 3.5.23
131
131
  signing_key:
132
132
  specification_version: 4
133
133
  summary: Schedule queries or transfer external data from SaaS applications to Google