google-cloud-bigquery-data_exchange-v1beta1 0.7.0 → 0.8.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: 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.