google-cloud-data_labeling-v1beta1 0.8.1 → 0.9.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: 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.