google-cloud-bigquery-data_exchange-v1beta1 0.7.0 → 0.8.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: a75fbe5331ef7a9a88a80f411f79f18dde2cc11627a9c0d73f8abd0da8f0b827
4
- data.tar.gz: 155f92ce0db492467e21433ff1bc8469d53061501da02f9910e133d8d2bf1af4
3
+ metadata.gz: 99ab1c43a2fe3d84a89f0212c2193836a6e0bed30e6f05ed498738f3aebf0d66
4
+ data.tar.gz: c6bda91e578e5d2b1bf8848dbefe4204db03fe0e778a06e90e52dbde2e200c23
5
5
  SHA512:
6
- metadata.gz: ae175d7fc56a4dfeff65057daabeb616df4f3047d730c5dec0b3175e72d48431be5c26cca67e5e579453ecdf33c07760fe4d20f578a6ab86502f2ebc28684582
7
- data.tar.gz: 6609d3a8bd7d50e70958a98f4d6932dcaa19829050bee01463443d809fe8e81316e31222708a07df893a24904dc451f1c210a0e9d476c1fcc719ddf258fd0cf6
6
+ metadata.gz: abedba87cb26d2c791a4aa10dbaccafd571256e84a491152762ea13393e20062657b3a8cdaec03b0ae077734e849015f128c8dac5d7b62c3949f8ef39463cadf
7
+ data.tar.gz: 58ef1a3179a6f572ff9f1b435b7ea90e8923a778be7fac861ad154cff612f546951b3db2b5cfd23db1f7d66fb907f901eec470bbc4fee33011e157248aa02102
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/analytics-hub/)
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_exchange/v1beta1"
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::DataExchange::V1beta1::AnalyticsHubService::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).
@@ -37,6 +37,9 @@ module Google
37
37
  # dataset in your project.
38
38
  #
39
39
  class Client
40
+ # @private
41
+ API_VERSION = ""
42
+
40
43
  # @private
41
44
  DEFAULT_ENDPOINT_TEMPLATE = "analyticshub.$UNIVERSE_DOMAIN$"
42
45
 
@@ -166,14 +169,26 @@ module Google
166
169
  universe_domain: @config.universe_domain,
167
170
  channel_args: @config.channel_args,
168
171
  interceptors: @config.interceptors,
169
- channel_pool_config: @config.channel_pool
172
+ channel_pool_config: @config.channel_pool,
173
+ logger: @config.logger
170
174
  )
171
175
 
176
+ @analytics_hub_service_stub.stub_logger&.info do |entry|
177
+ entry.set_system_name
178
+ entry.set_service
179
+ entry.message = "Created client for #{entry.service}"
180
+ entry.set_credentials_fields credentials
181
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
182
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
183
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
184
+ end
185
+
172
186
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
173
187
  config.credentials = credentials
174
188
  config.quota_project = @quota_project_id
175
189
  config.endpoint = @analytics_hub_service_stub.endpoint
176
190
  config.universe_domain = @analytics_hub_service_stub.universe_domain
191
+ config.logger = @analytics_hub_service_stub.logger if config.respond_to? :logger=
177
192
  end
178
193
  end
179
194
 
@@ -184,6 +199,15 @@ module Google
184
199
  #
185
200
  attr_reader :location_client
186
201
 
202
+ ##
203
+ # The logger used for request/response debug logging.
204
+ #
205
+ # @return [Logger]
206
+ #
207
+ def logger
208
+ @analytics_hub_service_stub.logger
209
+ end
210
+
187
211
  # Service calls
188
212
 
189
213
  ##
@@ -252,10 +276,11 @@ module Google
252
276
  # Customize the options with defaults
253
277
  metadata = @config.rpcs.list_data_exchanges.metadata.to_h
254
278
 
255
- # Set x-goog-api-client and x-goog-user-project headers
279
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
256
280
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
257
281
  lib_name: @config.lib_name, lib_version: @config.lib_version,
258
282
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
283
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
259
284
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
260
285
 
261
286
  header_params = {}
@@ -277,7 +302,7 @@ module Google
277
302
  @analytics_hub_service_stub.call_rpc :list_data_exchanges, request, options: options do |response, operation|
278
303
  response = ::Gapic::PagedEnumerable.new @analytics_hub_service_stub, :list_data_exchanges, request, response, operation, options
279
304
  yield response, operation if block_given?
280
- return response
305
+ throw :response, response
281
306
  end
282
307
  rescue ::GRPC::BadStatus => e
283
308
  raise ::Google::Cloud::Error.from_error(e)
@@ -350,10 +375,11 @@ module Google
350
375
  # Customize the options with defaults
351
376
  metadata = @config.rpcs.list_org_data_exchanges.metadata.to_h
352
377
 
353
- # Set x-goog-api-client and x-goog-user-project headers
378
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
354
379
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
355
380
  lib_name: @config.lib_name, lib_version: @config.lib_version,
356
381
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
382
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
357
383
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
358
384
 
359
385
  header_params = {}
@@ -375,7 +401,7 @@ module Google
375
401
  @analytics_hub_service_stub.call_rpc :list_org_data_exchanges, request, options: options do |response, operation|
376
402
  response = ::Gapic::PagedEnumerable.new @analytics_hub_service_stub, :list_org_data_exchanges, request, response, operation, options
377
403
  yield response, operation if block_given?
378
- return response
404
+ throw :response, response
379
405
  end
380
406
  rescue ::GRPC::BadStatus => e
381
407
  raise ::Google::Cloud::Error.from_error(e)
@@ -437,10 +463,11 @@ module Google
437
463
  # Customize the options with defaults
438
464
  metadata = @config.rpcs.get_data_exchange.metadata.to_h
439
465
 
440
- # Set x-goog-api-client and x-goog-user-project headers
466
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
441
467
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
442
468
  lib_name: @config.lib_name, lib_version: @config.lib_version,
443
469
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
470
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
444
471
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
445
472
 
446
473
  header_params = {}
@@ -461,7 +488,6 @@ module Google
461
488
 
462
489
  @analytics_hub_service_stub.call_rpc :get_data_exchange, request, options: options do |response, operation|
463
490
  yield response, operation if block_given?
464
- return response
465
491
  end
466
492
  rescue ::GRPC::BadStatus => e
467
493
  raise ::Google::Cloud::Error.from_error(e)
@@ -531,10 +557,11 @@ module Google
531
557
  # Customize the options with defaults
532
558
  metadata = @config.rpcs.create_data_exchange.metadata.to_h
533
559
 
534
- # Set x-goog-api-client and x-goog-user-project headers
560
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
535
561
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
536
562
  lib_name: @config.lib_name, lib_version: @config.lib_version,
537
563
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
564
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
538
565
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
539
566
 
540
567
  header_params = {}
@@ -555,7 +582,6 @@ module Google
555
582
 
556
583
  @analytics_hub_service_stub.call_rpc :create_data_exchange, request, options: options do |response, operation|
557
584
  yield response, operation if block_given?
558
- return response
559
585
  end
560
586
  rescue ::GRPC::BadStatus => e
561
587
  raise ::Google::Cloud::Error.from_error(e)
@@ -620,10 +646,11 @@ module Google
620
646
  # Customize the options with defaults
621
647
  metadata = @config.rpcs.update_data_exchange.metadata.to_h
622
648
 
623
- # Set x-goog-api-client and x-goog-user-project headers
649
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
624
650
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
625
651
  lib_name: @config.lib_name, lib_version: @config.lib_version,
626
652
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
653
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
627
654
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
628
655
 
629
656
  header_params = {}
@@ -644,7 +671,6 @@ module Google
644
671
 
645
672
  @analytics_hub_service_stub.call_rpc :update_data_exchange, request, options: options do |response, operation|
646
673
  yield response, operation if block_given?
647
- return response
648
674
  end
649
675
  rescue ::GRPC::BadStatus => e
650
676
  raise ::Google::Cloud::Error.from_error(e)
@@ -706,10 +732,11 @@ module Google
706
732
  # Customize the options with defaults
707
733
  metadata = @config.rpcs.delete_data_exchange.metadata.to_h
708
734
 
709
- # Set x-goog-api-client and x-goog-user-project headers
735
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
710
736
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
711
737
  lib_name: @config.lib_name, lib_version: @config.lib_version,
712
738
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
739
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
713
740
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
714
741
 
715
742
  header_params = {}
@@ -730,7 +757,6 @@ module Google
730
757
 
731
758
  @analytics_hub_service_stub.call_rpc :delete_data_exchange, request, options: options do |response, operation|
732
759
  yield response, operation if block_given?
733
- return response
734
760
  end
735
761
  rescue ::GRPC::BadStatus => e
736
762
  raise ::Google::Cloud::Error.from_error(e)
@@ -802,10 +828,11 @@ module Google
802
828
  # Customize the options with defaults
803
829
  metadata = @config.rpcs.list_listings.metadata.to_h
804
830
 
805
- # Set x-goog-api-client and x-goog-user-project headers
831
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
806
832
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
807
833
  lib_name: @config.lib_name, lib_version: @config.lib_version,
808
834
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
835
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
809
836
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
810
837
 
811
838
  header_params = {}
@@ -827,7 +854,7 @@ module Google
827
854
  @analytics_hub_service_stub.call_rpc :list_listings, request, options: options do |response, operation|
828
855
  response = ::Gapic::PagedEnumerable.new @analytics_hub_service_stub, :list_listings, request, response, operation, options
829
856
  yield response, operation if block_given?
830
- return response
857
+ throw :response, response
831
858
  end
832
859
  rescue ::GRPC::BadStatus => e
833
860
  raise ::Google::Cloud::Error.from_error(e)
@@ -889,10 +916,11 @@ module Google
889
916
  # Customize the options with defaults
890
917
  metadata = @config.rpcs.get_listing.metadata.to_h
891
918
 
892
- # Set x-goog-api-client and x-goog-user-project headers
919
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
893
920
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
894
921
  lib_name: @config.lib_name, lib_version: @config.lib_version,
895
922
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
923
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
896
924
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
897
925
 
898
926
  header_params = {}
@@ -913,7 +941,6 @@ module Google
913
941
 
914
942
  @analytics_hub_service_stub.call_rpc :get_listing, request, options: options do |response, operation|
915
943
  yield response, operation if block_given?
916
- return response
917
944
  end
918
945
  rescue ::GRPC::BadStatus => e
919
946
  raise ::Google::Cloud::Error.from_error(e)
@@ -983,10 +1010,11 @@ module Google
983
1010
  # Customize the options with defaults
984
1011
  metadata = @config.rpcs.create_listing.metadata.to_h
985
1012
 
986
- # Set x-goog-api-client and x-goog-user-project headers
1013
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
987
1014
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
988
1015
  lib_name: @config.lib_name, lib_version: @config.lib_version,
989
1016
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1017
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
990
1018
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
991
1019
 
992
1020
  header_params = {}
@@ -1007,7 +1035,6 @@ module Google
1007
1035
 
1008
1036
  @analytics_hub_service_stub.call_rpc :create_listing, request, options: options do |response, operation|
1009
1037
  yield response, operation if block_given?
1010
- return response
1011
1038
  end
1012
1039
  rescue ::GRPC::BadStatus => e
1013
1040
  raise ::Google::Cloud::Error.from_error(e)
@@ -1072,10 +1099,11 @@ module Google
1072
1099
  # Customize the options with defaults
1073
1100
  metadata = @config.rpcs.update_listing.metadata.to_h
1074
1101
 
1075
- # Set x-goog-api-client and x-goog-user-project headers
1102
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1076
1103
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1077
1104
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1078
1105
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1106
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1079
1107
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1080
1108
 
1081
1109
  header_params = {}
@@ -1096,7 +1124,6 @@ module Google
1096
1124
 
1097
1125
  @analytics_hub_service_stub.call_rpc :update_listing, request, options: options do |response, operation|
1098
1126
  yield response, operation if block_given?
1099
- return response
1100
1127
  end
1101
1128
  rescue ::GRPC::BadStatus => e
1102
1129
  raise ::Google::Cloud::Error.from_error(e)
@@ -1158,10 +1185,11 @@ module Google
1158
1185
  # Customize the options with defaults
1159
1186
  metadata = @config.rpcs.delete_listing.metadata.to_h
1160
1187
 
1161
- # Set x-goog-api-client and x-goog-user-project headers
1188
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1162
1189
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1163
1190
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1164
1191
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1192
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1165
1193
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1166
1194
 
1167
1195
  header_params = {}
@@ -1182,7 +1210,6 @@ module Google
1182
1210
 
1183
1211
  @analytics_hub_service_stub.call_rpc :delete_listing, request, options: options do |response, operation|
1184
1212
  yield response, operation if block_given?
1185
- return response
1186
1213
  end
1187
1214
  rescue ::GRPC::BadStatus => e
1188
1215
  raise ::Google::Cloud::Error.from_error(e)
@@ -1251,10 +1278,11 @@ module Google
1251
1278
  # Customize the options with defaults
1252
1279
  metadata = @config.rpcs.subscribe_listing.metadata.to_h
1253
1280
 
1254
- # Set x-goog-api-client and x-goog-user-project headers
1281
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1255
1282
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1256
1283
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1257
1284
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1285
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1258
1286
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1259
1287
 
1260
1288
  header_params = {}
@@ -1275,7 +1303,6 @@ module Google
1275
1303
 
1276
1304
  @analytics_hub_service_stub.call_rpc :subscribe_listing, request, options: options do |response, operation|
1277
1305
  yield response, operation if block_given?
1278
- return response
1279
1306
  end
1280
1307
  rescue ::GRPC::BadStatus => e
1281
1308
  raise ::Google::Cloud::Error.from_error(e)
@@ -1340,10 +1367,11 @@ module Google
1340
1367
  # Customize the options with defaults
1341
1368
  metadata = @config.rpcs.get_iam_policy.metadata.to_h
1342
1369
 
1343
- # Set x-goog-api-client and x-goog-user-project headers
1370
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1344
1371
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1345
1372
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1346
1373
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1374
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1347
1375
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1348
1376
 
1349
1377
  header_params = {}
@@ -1364,7 +1392,6 @@ module Google
1364
1392
 
1365
1393
  @analytics_hub_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
1366
1394
  yield response, operation if block_given?
1367
- return response
1368
1395
  end
1369
1396
  rescue ::GRPC::BadStatus => e
1370
1397
  raise ::Google::Cloud::Error.from_error(e)
@@ -1437,10 +1464,11 @@ module Google
1437
1464
  # Customize the options with defaults
1438
1465
  metadata = @config.rpcs.set_iam_policy.metadata.to_h
1439
1466
 
1440
- # Set x-goog-api-client and x-goog-user-project headers
1467
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1441
1468
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1442
1469
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1443
1470
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1471
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1444
1472
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1445
1473
 
1446
1474
  header_params = {}
@@ -1461,7 +1489,6 @@ module Google
1461
1489
 
1462
1490
  @analytics_hub_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
1463
1491
  yield response, operation if block_given?
1464
- return response
1465
1492
  end
1466
1493
  rescue ::GRPC::BadStatus => e
1467
1494
  raise ::Google::Cloud::Error.from_error(e)
@@ -1528,10 +1555,11 @@ module Google
1528
1555
  # Customize the options with defaults
1529
1556
  metadata = @config.rpcs.test_iam_permissions.metadata.to_h
1530
1557
 
1531
- # Set x-goog-api-client and x-goog-user-project headers
1558
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1532
1559
  metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1533
1560
  lib_name: @config.lib_name, lib_version: @config.lib_version,
1534
1561
  gapic_version: ::Google::Cloud::Bigquery::DataExchange::V1beta1::VERSION
1562
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1535
1563
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1536
1564
 
1537
1565
  header_params = {}
@@ -1552,7 +1580,6 @@ module Google
1552
1580
 
1553
1581
  @analytics_hub_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
1554
1582
  yield response, operation if block_given?
1555
- return response
1556
1583
  end
1557
1584
  rescue ::GRPC::BadStatus => e
1558
1585
  raise ::Google::Cloud::Error.from_error(e)
@@ -1641,6 +1668,11 @@ module Google
1641
1668
  # default endpoint URL. The default value of nil uses the environment
1642
1669
  # universe (usually the default "googleapis.com" universe).
1643
1670
  # @return [::String,nil]
1671
+ # @!attribute [rw] logger
1672
+ # A custom logger to use for request/response debug logging, or the value
1673
+ # `:default` (the default) to construct a default logger, or `nil` to
1674
+ # explicitly disable logging.
1675
+ # @return [::Logger,:default,nil]
1644
1676
  #
1645
1677
  class Configuration
1646
1678
  extend ::Gapic::Config
@@ -1665,6 +1697,7 @@ module Google
1665
1697
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1666
1698
  config_attr :quota_project, nil, ::String, nil
1667
1699
  config_attr :universe_domain, nil, ::String, nil
1700
+ config_attr :logger, :default, ::Logger, nil, :default
1668
1701
 
1669
1702
  # @private
1670
1703
  def initialize parent_config = nil
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module DataExchange
24
24
  module V1beta1
25
- VERSION = "0.7.0"
25
+ VERSION = "0.8.0"
26
26
  end
27
27
  end
28
28
  end
@@ -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
@@ -118,6 +121,10 @@ module Google
118
121
  # @return [::String]
119
122
  # Optional link to proto reference documentation. Example:
120
123
  # https://cloud.google.com/pubsub/lite/docs/reference/rpc
124
+ # @!attribute [rw] rest_reference_documentation_uri
125
+ # @return [::String]
126
+ # Optional link to REST reference documentation. Example:
127
+ # https://cloud.google.com/pubsub/lite/docs/reference/rest
121
128
  class Publishing
122
129
  include ::Google::Protobuf::MessageExts
123
130
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -192,9 +199,32 @@ module Google
192
199
  # @!attribute [rw] common
193
200
  # @return [::Google::Api::CommonLanguageSettings]
194
201
  # Some settings.
202
+ # @!attribute [rw] experimental_features
203
+ # @return [::Google::Api::PythonSettings::ExperimentalFeatures]
204
+ # Experimental features to be included during client library generation.
195
205
  class PythonSettings
196
206
  include ::Google::Protobuf::MessageExts
197
207
  extend ::Google::Protobuf::MessageExts::ClassMethods
208
+
209
+ # Experimental features to be included during client library generation.
210
+ # These fields will be deprecated once the feature graduates and is enabled
211
+ # by default.
212
+ # @!attribute [rw] rest_async_io_enabled
213
+ # @return [::Boolean]
214
+ # Enables generation of asynchronous REST clients if `rest` transport is
215
+ # enabled. By default, asynchronous REST clients will not be generated.
216
+ # This feature will be enabled by default 1 month after launching the
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.
224
+ class ExperimentalFeatures
225
+ include ::Google::Protobuf::MessageExts
226
+ extend ::Google::Protobuf::MessageExts::ClassMethods
227
+ end
198
228
  end
199
229
 
200
230
  # Settings for Node client libraries.
@@ -276,9 +306,28 @@ module Google
276
306
  # @!attribute [rw] common
277
307
  # @return [::Google::Api::CommonLanguageSettings]
278
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
279
319
  class GoSettings
280
320
  include ::Google::Protobuf::MessageExts
281
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
282
331
  end
283
332
 
284
333
  # Describes the generator configuration for a method.
@@ -286,6 +335,13 @@ module Google
286
335
  # @return [::String]
287
336
  # The fully qualified name of the method, for which the options below apply.
288
337
  # This is used to find the method to apply the options.
338
+ #
339
+ # Example:
340
+ #
341
+ # publishing:
342
+ # method_settings:
343
+ # - selector: google.storage.control.v2.StorageControl.CreateFolder
344
+ # # method settings for CreateFolder...
289
345
  # @!attribute [rw] long_running
290
346
  # @return [::Google::Api::MethodSettings::LongRunning]
291
347
  # Describes settings to use for long-running operations when generating
@@ -294,17 +350,14 @@ module Google
294
350
  #
295
351
  # Example of a YAML configuration::
296
352
  #
297
- # publishing:
298
- # method_settings:
353
+ # publishing:
354
+ # method_settings:
299
355
  # - selector: google.cloud.speech.v2.Speech.BatchRecognize
300
356
  # long_running:
301
- # initial_poll_delay:
302
- # seconds: 60 # 1 minute
357
+ # initial_poll_delay: 60s # 1 minute
303
358
  # poll_delay_multiplier: 1.5
304
- # max_poll_delay:
305
- # seconds: 360 # 6 minutes
306
- # total_poll_timeout:
307
- # seconds: 54000 # 90 minutes
359
+ # max_poll_delay: 360s # 6 minutes
360
+ # total_poll_timeout: 54000s # 90 minutes
308
361
  # @!attribute [rw] auto_populated_fields
309
362
  # @return [::Array<::String>]
310
363
  # List of top-level fields of the request message, that should be
@@ -313,8 +366,8 @@ module Google
313
366
  #
314
367
  # Example of a YAML configuration:
315
368
  #
316
- # publishing:
317
- # method_settings:
369
+ # publishing:
370
+ # method_settings:
318
371
  # - selector: google.example.v1.ExampleService.CreateExample
319
372
  # auto_populated_fields:
320
373
  # - request_id
@@ -350,6 +403,17 @@ module Google
350
403
  end
351
404
  end
352
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
+
353
417
  # The organization for which the client libraries are being published.
354
418
  # Affects the url where generated docs are published, etc.
355
419
  module ClientLibraryOrganization
@@ -124,8 +124,13 @@ module Google
124
124
  # @return [::String]
125
125
  # The plural name used in the resource name and permission names, such as
126
126
  # 'projects' for the resource name of 'projects/\\{project}' and the permission
127
- # name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
128
- # concept of the `plural` field in k8s CRD spec
127
+ # name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
128
+ # to this is for Nested Collections that have stuttering names, as defined
129
+ # in [AIP-122](https://google.aip.dev/122#nested-collections), where the
130
+ # collection ID in the resource name pattern does not necessarily directly
131
+ # match the `plural` value.
132
+ #
133
+ # It is the same concept of the `plural` field in k8s CRD spec
129
134
  # https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
130
135
  #
131
136
  # Note: The plural form is required even for singleton resources. See
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-data_exchange-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.7.0
4
+ version: 0.8.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-02-26 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
@@ -137,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
137
137
  - !ruby/object:Gem::Version
138
138
  version: '0'
139
139
  requirements: []
140
- rubygems_version: 3.5.6
140
+ rubygems_version: 3.5.23
141
141
  signing_key:
142
142
  specification_version: 4
143
143
  summary: Exchange data and analytics assets securely and efficiently.