google-cloud-data_labeling-v1beta1 0.8.1 → 0.9.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: 956a377fddea9ae5cdf9711bfa223512939d331b8f834b53660ef93444d81ff5
4
- data.tar.gz: afbb58a1f1dc9b045857e3a45e599f5a63f9e81db3343c04fbece5fc9d73d6f3
3
+ metadata.gz: 7586f10f2689cd28bbacbee0011e6713c1b3ba3393cb082f9be3984b8feeab03
4
+ data.tar.gz: fa31a3485795afd921ab8df4e0e604d22d58322dff8e0f384346760040da0121
5
5
  SHA512:
6
- metadata.gz: eb5f8e608952865a650a97c8cb1e380ba6186e11179228ec54279ca1081ece85cd499eb8413fe067d1fe61fd77e2f3bf4033a3bb372f8f67dd935bdc965e619d
7
- data.tar.gz: b4b2016c58b051a65468067a2799133a7b4af0ec8540b4971d2d1b144feb67de46697287a131a5d61f3bf28d64f8dbd5a3d95f86ea7929fb9ac3494e878bced1
6
+ metadata.gz: 0255bb0aa821cddfb8aa98fbdaa710549e528fe8c688ff62a6925aa94c0940f190a791c9a95627c7fecd5a81abeb877743b7af18125e55661d6974eecf9f2702
7
+ data.tar.gz: 439d1d21de6c58c1dbd9afef0164c0eb982c7b48395f4e19c632a54671bf5dc74d0f5adbc041dcbda2b3e44a283653cd67ccf52b83b5903582aa1d0134ccd6f4
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/ai-platform/data-labeling/docs)
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/data_labeling/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::DataLabeling::V1beta1::DataLabelingService::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).
@@ -293,8 +293,19 @@ module Google
293
293
  universe_domain: @config.universe_domain,
294
294
  channel_args: @config.channel_args,
295
295
  interceptors: @config.interceptors,
296
- channel_pool_config: @config.channel_pool
296
+ channel_pool_config: @config.channel_pool,
297
+ logger: @config.logger
297
298
  )
299
+
300
+ @data_labeling_service_stub.stub_logger&.info do |entry|
301
+ entry.set_system_name
302
+ entry.set_service
303
+ entry.message = "Created client for #{entry.service}"
304
+ entry.set_credentials_fields credentials
305
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
306
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
307
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
308
+ end
298
309
  end
299
310
 
300
311
  ##
@@ -304,6 +315,15 @@ module Google
304
315
  #
305
316
  attr_reader :operations_client
306
317
 
318
+ ##
319
+ # The logger used for request/response debug logging.
320
+ #
321
+ # @return [Logger]
322
+ #
323
+ def logger
324
+ @data_labeling_service_stub.logger
325
+ end
326
+
307
327
  # Service calls
308
328
 
309
329
  ##
@@ -389,7 +409,6 @@ module Google
389
409
 
390
410
  @data_labeling_service_stub.call_rpc :create_dataset, request, options: options do |response, operation|
391
411
  yield response, operation if block_given?
392
- return response
393
412
  end
394
413
  rescue ::GRPC::BadStatus => e
395
414
  raise ::Google::Cloud::Error.from_error(e)
@@ -476,7 +495,6 @@ module Google
476
495
 
477
496
  @data_labeling_service_stub.call_rpc :get_dataset, request, options: options do |response, operation|
478
497
  yield response, operation if block_given?
479
- return response
480
498
  end
481
499
  rescue ::GRPC::BadStatus => e
482
500
  raise ::Google::Cloud::Error.from_error(e)
@@ -579,7 +597,7 @@ module Google
579
597
  @data_labeling_service_stub.call_rpc :list_datasets, request, options: options do |response, operation|
580
598
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_datasets, request, response, operation, options
581
599
  yield response, operation if block_given?
582
- return response
600
+ throw :response, response
583
601
  end
584
602
  rescue ::GRPC::BadStatus => e
585
603
  raise ::Google::Cloud::Error.from_error(e)
@@ -666,7 +684,6 @@ module Google
666
684
 
667
685
  @data_labeling_service_stub.call_rpc :delete_dataset, request, options: options do |response, operation|
668
686
  yield response, operation if block_given?
669
- return response
670
687
  end
671
688
  rescue ::GRPC::BadStatus => e
672
689
  raise ::Google::Cloud::Error.from_error(e)
@@ -770,7 +787,7 @@ module Google
770
787
  @data_labeling_service_stub.call_rpc :import_data, request, options: options do |response, operation|
771
788
  response = ::Gapic::Operation.new response, @operations_client, options: options
772
789
  yield response, operation if block_given?
773
- return response
790
+ throw :response, response
774
791
  end
775
792
  rescue ::GRPC::BadStatus => e
776
793
  raise ::Google::Cloud::Error.from_error(e)
@@ -878,7 +895,7 @@ module Google
878
895
  @data_labeling_service_stub.call_rpc :export_data, request, options: options do |response, operation|
879
896
  response = ::Gapic::Operation.new response, @operations_client, options: options
880
897
  yield response, operation if block_given?
881
- return response
898
+ throw :response, response
882
899
  end
883
900
  rescue ::GRPC::BadStatus => e
884
901
  raise ::Google::Cloud::Error.from_error(e)
@@ -966,7 +983,6 @@ module Google
966
983
 
967
984
  @data_labeling_service_stub.call_rpc :get_data_item, request, options: options do |response, operation|
968
985
  yield response, operation if block_given?
969
- return response
970
986
  end
971
987
  rescue ::GRPC::BadStatus => e
972
988
  raise ::Google::Cloud::Error.from_error(e)
@@ -1070,7 +1086,7 @@ module Google
1070
1086
  @data_labeling_service_stub.call_rpc :list_data_items, request, options: options do |response, operation|
1071
1087
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_data_items, request, response, operation, options
1072
1088
  yield response, operation if block_given?
1073
- return response
1089
+ throw :response, response
1074
1090
  end
1075
1091
  rescue ::GRPC::BadStatus => e
1076
1092
  raise ::Google::Cloud::Error.from_error(e)
@@ -1158,7 +1174,6 @@ module Google
1158
1174
 
1159
1175
  @data_labeling_service_stub.call_rpc :get_annotated_dataset, request, options: options do |response, operation|
1160
1176
  yield response, operation if block_given?
1161
- return response
1162
1177
  end
1163
1178
  rescue ::GRPC::BadStatus => e
1164
1179
  raise ::Google::Cloud::Error.from_error(e)
@@ -1261,7 +1276,7 @@ module Google
1261
1276
  @data_labeling_service_stub.call_rpc :list_annotated_datasets, request, options: options do |response, operation|
1262
1277
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_annotated_datasets, request, response, operation, options
1263
1278
  yield response, operation if block_given?
1264
- return response
1279
+ throw :response, response
1265
1280
  end
1266
1281
  rescue ::GRPC::BadStatus => e
1267
1282
  raise ::Google::Cloud::Error.from_error(e)
@@ -1349,7 +1364,6 @@ module Google
1349
1364
 
1350
1365
  @data_labeling_service_stub.call_rpc :delete_annotated_dataset, request, options: options do |response, operation|
1351
1366
  yield response, operation if block_given?
1352
- return response
1353
1367
  end
1354
1368
  rescue ::GRPC::BadStatus => e
1355
1369
  raise ::Google::Cloud::Error.from_error(e)
@@ -1465,7 +1479,7 @@ module Google
1465
1479
  @data_labeling_service_stub.call_rpc :label_image, request, options: options do |response, operation|
1466
1480
  response = ::Gapic::Operation.new response, @operations_client, options: options
1467
1481
  yield response, operation if block_given?
1468
- return response
1482
+ throw :response, response
1469
1483
  end
1470
1484
  rescue ::GRPC::BadStatus => e
1471
1485
  raise ::Google::Cloud::Error.from_error(e)
@@ -1581,7 +1595,7 @@ module Google
1581
1595
  @data_labeling_service_stub.call_rpc :label_video, request, options: options do |response, operation|
1582
1596
  response = ::Gapic::Operation.new response, @operations_client, options: options
1583
1597
  yield response, operation if block_given?
1584
- return response
1598
+ throw :response, response
1585
1599
  end
1586
1600
  rescue ::GRPC::BadStatus => e
1587
1601
  raise ::Google::Cloud::Error.from_error(e)
@@ -1689,7 +1703,7 @@ module Google
1689
1703
  @data_labeling_service_stub.call_rpc :label_text, request, options: options do |response, operation|
1690
1704
  response = ::Gapic::Operation.new response, @operations_client, options: options
1691
1705
  yield response, operation if block_given?
1692
- return response
1706
+ throw :response, response
1693
1707
  end
1694
1708
  rescue ::GRPC::BadStatus => e
1695
1709
  raise ::Google::Cloud::Error.from_error(e)
@@ -1781,7 +1795,6 @@ module Google
1781
1795
 
1782
1796
  @data_labeling_service_stub.call_rpc :get_example, request, options: options do |response, operation|
1783
1797
  yield response, operation if block_given?
1784
- return response
1785
1798
  end
1786
1799
  rescue ::GRPC::BadStatus => e
1787
1800
  raise ::Google::Cloud::Error.from_error(e)
@@ -1886,7 +1899,7 @@ module Google
1886
1899
  @data_labeling_service_stub.call_rpc :list_examples, request, options: options do |response, operation|
1887
1900
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_examples, request, response, operation, options
1888
1901
  yield response, operation if block_given?
1889
- return response
1902
+ throw :response, response
1890
1903
  end
1891
1904
  rescue ::GRPC::BadStatus => e
1892
1905
  raise ::Google::Cloud::Error.from_error(e)
@@ -1977,7 +1990,6 @@ module Google
1977
1990
 
1978
1991
  @data_labeling_service_stub.call_rpc :create_annotation_spec_set, request, options: options do |response, operation|
1979
1992
  yield response, operation if block_given?
1980
- return response
1981
1993
  end
1982
1994
  rescue ::GRPC::BadStatus => e
1983
1995
  raise ::Google::Cloud::Error.from_error(e)
@@ -2064,7 +2076,6 @@ module Google
2064
2076
 
2065
2077
  @data_labeling_service_stub.call_rpc :get_annotation_spec_set, request, options: options do |response, operation|
2066
2078
  yield response, operation if block_given?
2067
- return response
2068
2079
  end
2069
2080
  rescue ::GRPC::BadStatus => e
2070
2081
  raise ::Google::Cloud::Error.from_error(e)
@@ -2167,7 +2178,7 @@ module Google
2167
2178
  @data_labeling_service_stub.call_rpc :list_annotation_spec_sets, request, options: options do |response, operation|
2168
2179
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_annotation_spec_sets, request, response, operation, options
2169
2180
  yield response, operation if block_given?
2170
- return response
2181
+ throw :response, response
2171
2182
  end
2172
2183
  rescue ::GRPC::BadStatus => e
2173
2184
  raise ::Google::Cloud::Error.from_error(e)
@@ -2254,7 +2265,6 @@ module Google
2254
2265
 
2255
2266
  @data_labeling_service_stub.call_rpc :delete_annotation_spec_set, request, options: options do |response, operation|
2256
2267
  yield response, operation if block_given?
2257
- return response
2258
2268
  end
2259
2269
  rescue ::GRPC::BadStatus => e
2260
2270
  raise ::Google::Cloud::Error.from_error(e)
@@ -2351,7 +2361,7 @@ module Google
2351
2361
  @data_labeling_service_stub.call_rpc :create_instruction, request, options: options do |response, operation|
2352
2362
  response = ::Gapic::Operation.new response, @operations_client, options: options
2353
2363
  yield response, operation if block_given?
2354
- return response
2364
+ throw :response, response
2355
2365
  end
2356
2366
  rescue ::GRPC::BadStatus => e
2357
2367
  raise ::Google::Cloud::Error.from_error(e)
@@ -2438,7 +2448,6 @@ module Google
2438
2448
 
2439
2449
  @data_labeling_service_stub.call_rpc :get_instruction, request, options: options do |response, operation|
2440
2450
  yield response, operation if block_given?
2441
- return response
2442
2451
  end
2443
2452
  rescue ::GRPC::BadStatus => e
2444
2453
  raise ::Google::Cloud::Error.from_error(e)
@@ -2541,7 +2550,7 @@ module Google
2541
2550
  @data_labeling_service_stub.call_rpc :list_instructions, request, options: options do |response, operation|
2542
2551
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_instructions, request, response, operation, options
2543
2552
  yield response, operation if block_given?
2544
- return response
2553
+ throw :response, response
2545
2554
  end
2546
2555
  rescue ::GRPC::BadStatus => e
2547
2556
  raise ::Google::Cloud::Error.from_error(e)
@@ -2628,7 +2637,6 @@ module Google
2628
2637
 
2629
2638
  @data_labeling_service_stub.call_rpc :delete_instruction, request, options: options do |response, operation|
2630
2639
  yield response, operation if block_given?
2631
- return response
2632
2640
  end
2633
2641
  rescue ::GRPC::BadStatus => e
2634
2642
  raise ::Google::Cloud::Error.from_error(e)
@@ -2717,7 +2725,6 @@ module Google
2717
2725
 
2718
2726
  @data_labeling_service_stub.call_rpc :get_evaluation, request, options: options do |response, operation|
2719
2727
  yield response, operation if block_given?
2720
- return response
2721
2728
  end
2722
2729
  rescue ::GRPC::BadStatus => e
2723
2730
  raise ::Google::Cloud::Error.from_error(e)
@@ -2852,7 +2859,7 @@ module Google
2852
2859
  @data_labeling_service_stub.call_rpc :search_evaluations, request, options: options do |response, operation|
2853
2860
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :search_evaluations, request, response, operation, options
2854
2861
  yield response, operation if block_given?
2855
- return response
2862
+ throw :response, response
2856
2863
  end
2857
2864
  rescue ::GRPC::BadStatus => e
2858
2865
  raise ::Google::Cloud::Error.from_error(e)
@@ -2959,7 +2966,7 @@ module Google
2959
2966
  @data_labeling_service_stub.call_rpc :search_example_comparisons, request, options: options do |response, operation|
2960
2967
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :search_example_comparisons, request, response, operation, options
2961
2968
  yield response, operation if block_given?
2962
- return response
2969
+ throw :response, response
2963
2970
  end
2964
2971
  rescue ::GRPC::BadStatus => e
2965
2972
  raise ::Google::Cloud::Error.from_error(e)
@@ -3048,7 +3055,6 @@ module Google
3048
3055
 
3049
3056
  @data_labeling_service_stub.call_rpc :create_evaluation_job, request, options: options do |response, operation|
3050
3057
  yield response, operation if block_given?
3051
- return response
3052
3058
  end
3053
3059
  rescue ::GRPC::BadStatus => e
3054
3060
  raise ::Google::Cloud::Error.from_error(e)
@@ -3149,7 +3155,6 @@ module Google
3149
3155
 
3150
3156
  @data_labeling_service_stub.call_rpc :update_evaluation_job, request, options: options do |response, operation|
3151
3157
  yield response, operation if block_given?
3152
- return response
3153
3158
  end
3154
3159
  rescue ::GRPC::BadStatus => e
3155
3160
  raise ::Google::Cloud::Error.from_error(e)
@@ -3237,7 +3242,6 @@ module Google
3237
3242
 
3238
3243
  @data_labeling_service_stub.call_rpc :get_evaluation_job, request, options: options do |response, operation|
3239
3244
  yield response, operation if block_given?
3240
- return response
3241
3245
  end
3242
3246
  rescue ::GRPC::BadStatus => e
3243
3247
  raise ::Google::Cloud::Error.from_error(e)
@@ -3326,7 +3330,6 @@ module Google
3326
3330
 
3327
3331
  @data_labeling_service_stub.call_rpc :pause_evaluation_job, request, options: options do |response, operation|
3328
3332
  yield response, operation if block_given?
3329
- return response
3330
3333
  end
3331
3334
  rescue ::GRPC::BadStatus => e
3332
3335
  raise ::Google::Cloud::Error.from_error(e)
@@ -3415,7 +3418,6 @@ module Google
3415
3418
 
3416
3419
  @data_labeling_service_stub.call_rpc :resume_evaluation_job, request, options: options do |response, operation|
3417
3420
  yield response, operation if block_given?
3418
- return response
3419
3421
  end
3420
3422
  rescue ::GRPC::BadStatus => e
3421
3423
  raise ::Google::Cloud::Error.from_error(e)
@@ -3503,7 +3505,6 @@ module Google
3503
3505
 
3504
3506
  @data_labeling_service_stub.call_rpc :delete_evaluation_job, request, options: options do |response, operation|
3505
3507
  yield response, operation if block_given?
3506
- return response
3507
3508
  end
3508
3509
  rescue ::GRPC::BadStatus => e
3509
3510
  raise ::Google::Cloud::Error.from_error(e)
@@ -3614,7 +3615,7 @@ module Google
3614
3615
  @data_labeling_service_stub.call_rpc :list_evaluation_jobs, request, options: options do |response, operation|
3615
3616
  response = ::Gapic::PagedEnumerable.new @data_labeling_service_stub, :list_evaluation_jobs, request, response, operation, options
3616
3617
  yield response, operation if block_given?
3617
- return response
3618
+ throw :response, response
3618
3619
  end
3619
3620
  rescue ::GRPC::BadStatus => e
3620
3621
  raise ::Google::Cloud::Error.from_error(e)
@@ -3703,6 +3704,11 @@ module Google
3703
3704
  # default endpoint URL. The default value of nil uses the environment
3704
3705
  # universe (usually the default "googleapis.com" universe).
3705
3706
  # @return [::String,nil]
3707
+ # @!attribute [rw] logger
3708
+ # A custom logger to use for request/response debug logging, or the value
3709
+ # `:default` (the default) to construct a default logger, or `nil` to
3710
+ # explicitly disable logging.
3711
+ # @return [::Logger,:default,nil]
3706
3712
  #
3707
3713
  class Configuration
3708
3714
  extend ::Gapic::Config
@@ -3727,6 +3733,7 @@ module Google
3727
3733
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3728
3734
  config_attr :quota_project, nil, ::String, nil
3729
3735
  config_attr :universe_domain, nil, ::String, nil
3736
+ config_attr :logger, :default, ::Logger, nil, :default
3730
3737
 
3731
3738
  # @private
3732
3739
  def initialize parent_config = nil
@@ -124,14 +124,6 @@ module Google
124
124
  # Lists operations that match the specified filter in the request. If the
125
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
126
126
  #
127
- # NOTE: the `name` binding allows API services to override the binding
128
- # to use different resource name schemes, such as `users/*/operations`. To
129
- # override the binding, API services can add a binding such as
130
- # `"/v1/{name=users/*}/operations"` to their service configuration.
131
- # For backwards compatibility, the default name includes the operations
132
- # collection id, however overriding users must ensure the name binding
133
- # is the parent resource, without the operations collection id.
134
- #
135
127
  # @overload list_operations(request, options = nil)
136
128
  # Pass arguments to `list_operations` via a request object, either of type
137
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -221,7 +213,7 @@ module Google
221
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
222
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
223
215
  yield response, operation if block_given?
224
- return response
216
+ throw :response, response
225
217
  end
226
218
  rescue ::GRPC::BadStatus => e
227
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -317,7 +309,7 @@ module Google
317
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
318
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
319
311
  yield response, operation if block_given?
320
- return response
312
+ throw :response, response
321
313
  end
322
314
  rescue ::GRPC::BadStatus => e
323
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -406,7 +398,6 @@ module Google
406
398
 
407
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
408
400
  yield response, operation if block_given?
409
- return response
410
401
  end
411
402
  rescue ::GRPC::BadStatus => e
412
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -421,8 +412,9 @@ module Google
421
412
  # other methods to check whether the cancellation succeeded or whether the
422
413
  # operation completed despite cancellation. On successful cancellation,
423
414
  # the operation is not deleted; instead, it becomes an operation with
424
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
425
- # corresponding to `Code.CANCELLED`.
415
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
416
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
417
+ # `Code.CANCELLED`.
426
418
  #
427
419
  # @overload cancel_operation(request, options = nil)
428
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -501,7 +493,6 @@ module Google
501
493
 
502
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
503
495
  yield response, operation if block_given?
504
- return response
505
496
  end
506
497
  rescue ::GRPC::BadStatus => e
507
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -599,7 +590,7 @@ module Google
599
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
600
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
601
592
  yield response, operation if block_given?
602
- return response
593
+ throw :response, response
603
594
  end
604
595
  rescue ::GRPC::BadStatus => e
605
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -688,6 +679,11 @@ module Google
688
679
  # default endpoint URL. The default value of nil uses the environment
689
680
  # universe (usually the default "googleapis.com" universe).
690
681
  # @return [::String,nil]
682
+ # @!attribute [rw] logger
683
+ # A custom logger to use for request/response debug logging, or the value
684
+ # `:default` (the default) to construct a default logger, or `nil` to
685
+ # explicitly disable logging.
686
+ # @return [::Logger,:default,nil]
691
687
  #
692
688
  class Configuration
693
689
  extend ::Gapic::Config
@@ -712,6 +708,7 @@ module Google
712
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
709
  config_attr :quota_project, nil, ::String, nil
714
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
715
712
 
716
713
  # @private
717
714
  def initialize parent_config = nil
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module DataLabeling
23
23
  module V1beta1
24
- VERSION = "0.8.1"
24
+ VERSION = "0.9.0"
25
25
  end
26
26
  end
27
27
  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
@@ -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
@@ -42,7 +42,7 @@ module Google
42
42
  # The error result of the operation in case of failure or cancellation.
43
43
  # @!attribute [rw] response
44
44
  # @return [::Google::Protobuf::Any]
45
- # The normal response of the operation in case of success. If the original
45
+ # The normal, successful response of the operation. If the original
46
46
  # method returns no data on success, such as `Delete`, the response is
47
47
  # `google.protobuf.Empty`. If the original method is standard
48
48
  # `Get`/`Create`/`Update`, the response should be the resource. For other
@@ -55,7 +55,8 @@ module Google
55
55
  extend ::Google::Protobuf::MessageExts::ClassMethods
56
56
  end
57
57
 
58
- # The request message for Operations.GetOperation.
58
+ # The request message for
59
+ # Operations.GetOperation.
59
60
  # @!attribute [rw] name
60
61
  # @return [::String]
61
62
  # The name of the operation resource.
@@ -64,7 +65,8 @@ module Google
64
65
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
66
  end
66
67
 
67
- # The request message for Operations.ListOperations.
68
+ # The request message for
69
+ # Operations.ListOperations.
68
70
  # @!attribute [rw] name
69
71
  # @return [::String]
70
72
  # The name of the operation's parent resource.
@@ -82,7 +84,8 @@ module Google
82
84
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
85
  end
84
86
 
85
- # The response message for Operations.ListOperations.
87
+ # The response message for
88
+ # Operations.ListOperations.
86
89
  # @!attribute [rw] operations
87
90
  # @return [::Array<::Google::Longrunning::Operation>]
88
91
  # A list of operations that matches the specified filter in the request.
@@ -94,7 +97,8 @@ module Google
94
97
  extend ::Google::Protobuf::MessageExts::ClassMethods
95
98
  end
96
99
 
97
- # The request message for Operations.CancelOperation.
100
+ # The request message for
101
+ # Operations.CancelOperation.
98
102
  # @!attribute [rw] name
99
103
  # @return [::String]
100
104
  # The name of the operation resource to be cancelled.
@@ -103,7 +107,8 @@ module Google
103
107
  extend ::Google::Protobuf::MessageExts::ClassMethods
104
108
  end
105
109
 
106
- # The request message for Operations.DeleteOperation.
110
+ # The request message for
111
+ # Operations.DeleteOperation.
107
112
  # @!attribute [rw] name
108
113
  # @return [::String]
109
114
  # The name of the operation resource to be deleted.
@@ -112,7 +117,8 @@ module Google
112
117
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
118
  end
114
119
 
115
- # The request message for Operations.WaitOperation.
120
+ # The request message for
121
+ # Operations.WaitOperation.
116
122
  # @!attribute [rw] name
117
123
  # @return [::String]
118
124
  # The name of the operation resource to wait on.
@@ -130,13 +136,12 @@ module Google
130
136
  #
131
137
  # Example:
132
138
  #
133
- # rpc LongRunningRecognize(LongRunningRecognizeRequest)
134
- # returns (google.longrunning.Operation) {
135
- # option (google.longrunning.operation_info) = {
136
- # response_type: "LongRunningRecognizeResponse"
137
- # metadata_type: "LongRunningRecognizeMetadata"
138
- # };
139
- # }
139
+ # rpc Export(ExportRequest) returns (google.longrunning.Operation) {
140
+ # option (google.longrunning.operation_info) = {
141
+ # response_type: "ExportResponse"
142
+ # metadata_type: "ExportMetadata"
143
+ # };
144
+ # }
140
145
  # @!attribute [rw] response_type
141
146
  # @return [::String]
142
147
  # Required. The message name of the primary return type for this
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-data_labeling-v1beta1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.8.1
4
+ version: 0.9.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-08-30 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
@@ -118,7 +118,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
118
118
  - !ruby/object:Gem::Version
119
119
  version: '0'
120
120
  requirements: []
121
- rubygems_version: 3.5.6
121
+ rubygems_version: 3.5.23
122
122
  signing_key:
123
123
  specification_version: 4
124
124
  summary: Public API for Google Cloud AI Data Labeling Service.