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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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