google-cloud-video-stitcher-v1 1.0.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 630b788b3a0110abba12cfb73442dc1c7e199b828d57aa1ab98142e54662f9c1
4
- data.tar.gz: d54cd3d342f3d3a2ebce1176a687955059cd067ea3c55065c302164c33e46aca
3
+ metadata.gz: ff70f27ad3b342e6cf1d416c105e6cbf5a9e098d34c1c87f7dab60907d4b5002
4
+ data.tar.gz: a3652d29f296a1acb89163bb1865caf23be8408ed335d76aef304454abb41ac3
5
5
  SHA512:
6
- metadata.gz: 0fac2b3d8b5b8ca4f22d1ccb7a854d3ee8666d600a6155058ef6300b02e65bc0a38a719372759f4cc38944e02b8da804df979fd1a6e15daeba553875db4d29d0
7
- data.tar.gz: 46021b58a89bb205378149ff85a4adfaa39118c7c61b31c43484c62172a0583521ece0ad171a39512f08b98c9a4e7741f63ab36320db62bf7898390424ca8dfe
6
+ metadata.gz: 7ad89222a9d089b18244d07851cad1d6ff4547c5cd7684d1eba415812c2594fbdc83f3805e5e5b4a88f3c46874c5dd4f12ea17e50dfdc6abfeeb5f8d7564d41a
7
+ data.tar.gz: 7bfee46701784c49425065d7943cbc08109480e4e95f36f9c10e539736c6bec58ecd1752c7bf64ff545304d43aeeb049d7b0e058c04432e5d220b422e248397e
data/README.md CHANGED
@@ -43,40 +43,50 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/video-stitcher/)
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/video/stitcher/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::Video::Stitcher::V1::VideoStitcherService::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).
76
86
 
77
87
  ## Supported Ruby Versions
78
88
 
79
- This library is supported on Ruby 2.7+.
89
+ This library is supported on Ruby 3.0+.
80
90
 
81
91
  Google provides official support for Ruby versions that are actively supported
82
92
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -22,7 +22,7 @@ module Google
22
22
  module Video
23
23
  module Stitcher
24
24
  module V1
25
- VERSION = "1.0.1"
25
+ VERSION = "1.2.0"
26
26
  end
27
27
  end
28
28
  end
@@ -222,8 +222,19 @@ module Google
222
222
  universe_domain: @config.universe_domain,
223
223
  channel_args: @config.channel_args,
224
224
  interceptors: @config.interceptors,
225
- channel_pool_config: @config.channel_pool
225
+ channel_pool_config: @config.channel_pool,
226
+ logger: @config.logger
226
227
  )
228
+
229
+ @video_stitcher_service_stub.stub_logger&.info do |entry|
230
+ entry.set_system_name
231
+ entry.set_service
232
+ entry.message = "Created client for #{entry.service}"
233
+ entry.set_credentials_fields credentials
234
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
235
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
236
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
237
+ end
227
238
  end
228
239
 
229
240
  ##
@@ -233,6 +244,15 @@ module Google
233
244
  #
234
245
  attr_reader :operations_client
235
246
 
247
+ ##
248
+ # The logger used for request/response debug logging.
249
+ #
250
+ # @return [Logger]
251
+ #
252
+ def logger
253
+ @video_stitcher_service_stub.logger
254
+ end
255
+
236
256
  # Service calls
237
257
 
238
258
  ##
@@ -333,7 +353,7 @@ module Google
333
353
  @video_stitcher_service_stub.call_rpc :create_cdn_key, request, options: options do |response, operation|
334
354
  response = ::Gapic::Operation.new response, @operations_client, options: options
335
355
  yield response, operation if block_given?
336
- return response
356
+ throw :response, response
337
357
  end
338
358
  rescue ::GRPC::BadStatus => e
339
359
  raise ::Google::Cloud::Error.from_error(e)
@@ -434,7 +454,7 @@ module Google
434
454
  @video_stitcher_service_stub.call_rpc :list_cdn_keys, request, options: options do |response, operation|
435
455
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_cdn_keys, request, response, operation, options
436
456
  yield response, operation if block_given?
437
- return response
457
+ throw :response, response
438
458
  end
439
459
  rescue ::GRPC::BadStatus => e
440
460
  raise ::Google::Cloud::Error.from_error(e)
@@ -521,7 +541,6 @@ module Google
521
541
 
522
542
  @video_stitcher_service_stub.call_rpc :get_cdn_key, request, options: options do |response, operation|
523
543
  yield response, operation if block_given?
524
- return response
525
544
  end
526
545
  rescue ::GRPC::BadStatus => e
527
546
  raise ::Google::Cloud::Error.from_error(e)
@@ -616,7 +635,7 @@ module Google
616
635
  @video_stitcher_service_stub.call_rpc :delete_cdn_key, request, options: options do |response, operation|
617
636
  response = ::Gapic::Operation.new response, @operations_client, options: options
618
637
  yield response, operation if block_given?
619
- return response
638
+ throw :response, response
620
639
  end
621
640
  rescue ::GRPC::BadStatus => e
622
641
  raise ::Google::Cloud::Error.from_error(e)
@@ -715,7 +734,7 @@ module Google
715
734
  @video_stitcher_service_stub.call_rpc :update_cdn_key, request, options: options do |response, operation|
716
735
  response = ::Gapic::Operation.new response, @operations_client, options: options
717
736
  yield response, operation if block_given?
718
- return response
737
+ throw :response, response
719
738
  end
720
739
  rescue ::GRPC::BadStatus => e
721
740
  raise ::Google::Cloud::Error.from_error(e)
@@ -805,7 +824,6 @@ module Google
805
824
 
806
825
  @video_stitcher_service_stub.call_rpc :create_vod_session, request, options: options do |response, operation|
807
826
  yield response, operation if block_given?
808
- return response
809
827
  end
810
828
  rescue ::GRPC::BadStatus => e
811
829
  raise ::Google::Cloud::Error.from_error(e)
@@ -893,7 +911,6 @@ module Google
893
911
 
894
912
  @video_stitcher_service_stub.call_rpc :get_vod_session, request, options: options do |response, operation|
895
913
  yield response, operation if block_given?
896
- return response
897
914
  end
898
915
  rescue ::GRPC::BadStatus => e
899
916
  raise ::Google::Cloud::Error.from_error(e)
@@ -990,7 +1007,7 @@ module Google
990
1007
  @video_stitcher_service_stub.call_rpc :list_vod_stitch_details, request, options: options do |response, operation|
991
1008
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_vod_stitch_details, request, response, operation, options
992
1009
  yield response, operation if block_given?
993
- return response
1010
+ throw :response, response
994
1011
  end
995
1012
  rescue ::GRPC::BadStatus => e
996
1013
  raise ::Google::Cloud::Error.from_error(e)
@@ -1078,7 +1095,6 @@ module Google
1078
1095
 
1079
1096
  @video_stitcher_service_stub.call_rpc :get_vod_stitch_detail, request, options: options do |response, operation|
1080
1097
  yield response, operation if block_given?
1081
- return response
1082
1098
  end
1083
1099
  rescue ::GRPC::BadStatus => e
1084
1100
  raise ::Google::Cloud::Error.from_error(e)
@@ -1174,7 +1190,7 @@ module Google
1174
1190
  @video_stitcher_service_stub.call_rpc :list_vod_ad_tag_details, request, options: options do |response, operation|
1175
1191
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_vod_ad_tag_details, request, response, operation, options
1176
1192
  yield response, operation if block_given?
1177
- return response
1193
+ throw :response, response
1178
1194
  end
1179
1195
  rescue ::GRPC::BadStatus => e
1180
1196
  raise ::Google::Cloud::Error.from_error(e)
@@ -1262,7 +1278,6 @@ module Google
1262
1278
 
1263
1279
  @video_stitcher_service_stub.call_rpc :get_vod_ad_tag_detail, request, options: options do |response, operation|
1264
1280
  yield response, operation if block_given?
1265
- return response
1266
1281
  end
1267
1282
  rescue ::GRPC::BadStatus => e
1268
1283
  raise ::Google::Cloud::Error.from_error(e)
@@ -1358,7 +1373,7 @@ module Google
1358
1373
  @video_stitcher_service_stub.call_rpc :list_live_ad_tag_details, request, options: options do |response, operation|
1359
1374
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_live_ad_tag_details, request, response, operation, options
1360
1375
  yield response, operation if block_given?
1361
- return response
1376
+ throw :response, response
1362
1377
  end
1363
1378
  rescue ::GRPC::BadStatus => e
1364
1379
  raise ::Google::Cloud::Error.from_error(e)
@@ -1445,7 +1460,6 @@ module Google
1445
1460
 
1446
1461
  @video_stitcher_service_stub.call_rpc :get_live_ad_tag_detail, request, options: options do |response, operation|
1447
1462
  yield response, operation if block_given?
1448
- return response
1449
1463
  end
1450
1464
  rescue ::GRPC::BadStatus => e
1451
1465
  raise ::Google::Cloud::Error.from_error(e)
@@ -1561,7 +1575,7 @@ module Google
1561
1575
  @video_stitcher_service_stub.call_rpc :create_slate, request, options: options do |response, operation|
1562
1576
  response = ::Gapic::Operation.new response, @operations_client, options: options
1563
1577
  yield response, operation if block_given?
1564
- return response
1578
+ throw :response, response
1565
1579
  end
1566
1580
  rescue ::GRPC::BadStatus => e
1567
1581
  raise ::Google::Cloud::Error.from_error(e)
@@ -1662,7 +1676,7 @@ module Google
1662
1676
  @video_stitcher_service_stub.call_rpc :list_slates, request, options: options do |response, operation|
1663
1677
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_slates, request, response, operation, options
1664
1678
  yield response, operation if block_given?
1665
- return response
1679
+ throw :response, response
1666
1680
  end
1667
1681
  rescue ::GRPC::BadStatus => e
1668
1682
  raise ::Google::Cloud::Error.from_error(e)
@@ -1749,7 +1763,6 @@ module Google
1749
1763
 
1750
1764
  @video_stitcher_service_stub.call_rpc :get_slate, request, options: options do |response, operation|
1751
1765
  yield response, operation if block_given?
1752
- return response
1753
1766
  end
1754
1767
  rescue ::GRPC::BadStatus => e
1755
1768
  raise ::Google::Cloud::Error.from_error(e)
@@ -1845,7 +1858,7 @@ module Google
1845
1858
  @video_stitcher_service_stub.call_rpc :update_slate, request, options: options do |response, operation|
1846
1859
  response = ::Gapic::Operation.new response, @operations_client, options: options
1847
1860
  yield response, operation if block_given?
1848
- return response
1861
+ throw :response, response
1849
1862
  end
1850
1863
  rescue ::GRPC::BadStatus => e
1851
1864
  raise ::Google::Cloud::Error.from_error(e)
@@ -1940,7 +1953,7 @@ module Google
1940
1953
  @video_stitcher_service_stub.call_rpc :delete_slate, request, options: options do |response, operation|
1941
1954
  response = ::Gapic::Operation.new response, @operations_client, options: options
1942
1955
  yield response, operation if block_given?
1943
- return response
1956
+ throw :response, response
1944
1957
  end
1945
1958
  rescue ::GRPC::BadStatus => e
1946
1959
  raise ::Google::Cloud::Error.from_error(e)
@@ -2029,7 +2042,6 @@ module Google
2029
2042
 
2030
2043
  @video_stitcher_service_stub.call_rpc :create_live_session, request, options: options do |response, operation|
2031
2044
  yield response, operation if block_given?
2032
- return response
2033
2045
  end
2034
2046
  rescue ::GRPC::BadStatus => e
2035
2047
  raise ::Google::Cloud::Error.from_error(e)
@@ -2116,7 +2128,6 @@ module Google
2116
2128
 
2117
2129
  @video_stitcher_service_stub.call_rpc :get_live_session, request, options: options do |response, operation|
2118
2130
  yield response, operation if block_given?
2119
- return response
2120
2131
  end
2121
2132
  rescue ::GRPC::BadStatus => e
2122
2133
  raise ::Google::Cloud::Error.from_error(e)
@@ -2230,7 +2241,7 @@ module Google
2230
2241
  @video_stitcher_service_stub.call_rpc :create_live_config, request, options: options do |response, operation|
2231
2242
  response = ::Gapic::Operation.new response, @operations_client, options: options
2232
2243
  yield response, operation if block_given?
2233
- return response
2244
+ throw :response, response
2234
2245
  end
2235
2246
  rescue ::GRPC::BadStatus => e
2236
2247
  raise ::Google::Cloud::Error.from_error(e)
@@ -2334,7 +2345,7 @@ module Google
2334
2345
  @video_stitcher_service_stub.call_rpc :list_live_configs, request, options: options do |response, operation|
2335
2346
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_live_configs, request, response, operation, options
2336
2347
  yield response, operation if block_given?
2337
- return response
2348
+ throw :response, response
2338
2349
  end
2339
2350
  rescue ::GRPC::BadStatus => e
2340
2351
  raise ::Google::Cloud::Error.from_error(e)
@@ -2423,7 +2434,6 @@ module Google
2423
2434
 
2424
2435
  @video_stitcher_service_stub.call_rpc :get_live_config, request, options: options do |response, operation|
2425
2436
  yield response, operation if block_given?
2426
- return response
2427
2437
  end
2428
2438
  rescue ::GRPC::BadStatus => e
2429
2439
  raise ::Google::Cloud::Error.from_error(e)
@@ -2518,7 +2528,7 @@ module Google
2518
2528
  @video_stitcher_service_stub.call_rpc :delete_live_config, request, options: options do |response, operation|
2519
2529
  response = ::Gapic::Operation.new response, @operations_client, options: options
2520
2530
  yield response, operation if block_given?
2521
- return response
2531
+ throw :response, response
2522
2532
  end
2523
2533
  rescue ::GRPC::BadStatus => e
2524
2534
  raise ::Google::Cloud::Error.from_error(e)
@@ -2618,7 +2628,7 @@ module Google
2618
2628
  @video_stitcher_service_stub.call_rpc :update_live_config, request, options: options do |response, operation|
2619
2629
  response = ::Gapic::Operation.new response, @operations_client, options: options
2620
2630
  yield response, operation if block_given?
2621
- return response
2631
+ throw :response, response
2622
2632
  end
2623
2633
  rescue ::GRPC::BadStatus => e
2624
2634
  raise ::Google::Cloud::Error.from_error(e)
@@ -2732,7 +2742,7 @@ module Google
2732
2742
  @video_stitcher_service_stub.call_rpc :create_vod_config, request, options: options do |response, operation|
2733
2743
  response = ::Gapic::Operation.new response, @operations_client, options: options
2734
2744
  yield response, operation if block_given?
2735
- return response
2745
+ throw :response, response
2736
2746
  end
2737
2747
  rescue ::GRPC::BadStatus => e
2738
2748
  raise ::Google::Cloud::Error.from_error(e)
@@ -2837,7 +2847,7 @@ module Google
2837
2847
  @video_stitcher_service_stub.call_rpc :list_vod_configs, request, options: options do |response, operation|
2838
2848
  response = ::Gapic::PagedEnumerable.new @video_stitcher_service_stub, :list_vod_configs, request, response, operation, options
2839
2849
  yield response, operation if block_given?
2840
- return response
2850
+ throw :response, response
2841
2851
  end
2842
2852
  rescue ::GRPC::BadStatus => e
2843
2853
  raise ::Google::Cloud::Error.from_error(e)
@@ -2925,7 +2935,6 @@ module Google
2925
2935
 
2926
2936
  @video_stitcher_service_stub.call_rpc :get_vod_config, request, options: options do |response, operation|
2927
2937
  yield response, operation if block_given?
2928
- return response
2929
2938
  end
2930
2939
  rescue ::GRPC::BadStatus => e
2931
2940
  raise ::Google::Cloud::Error.from_error(e)
@@ -3020,7 +3029,7 @@ module Google
3020
3029
  @video_stitcher_service_stub.call_rpc :delete_vod_config, request, options: options do |response, operation|
3021
3030
  response = ::Gapic::Operation.new response, @operations_client, options: options
3022
3031
  yield response, operation if block_given?
3023
- return response
3032
+ throw :response, response
3024
3033
  end
3025
3034
  rescue ::GRPC::BadStatus => e
3026
3035
  raise ::Google::Cloud::Error.from_error(e)
@@ -3120,7 +3129,7 @@ module Google
3120
3129
  @video_stitcher_service_stub.call_rpc :update_vod_config, request, options: options do |response, operation|
3121
3130
  response = ::Gapic::Operation.new response, @operations_client, options: options
3122
3131
  yield response, operation if block_given?
3123
- return response
3132
+ throw :response, response
3124
3133
  end
3125
3134
  rescue ::GRPC::BadStatus => e
3126
3135
  raise ::Google::Cloud::Error.from_error(e)
@@ -3170,6 +3179,13 @@ module Google
3170
3179
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
3171
3180
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
3172
3181
  # * (`nil`) indicating no credentials
3182
+ #
3183
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
3184
+ # external source for authentication to Google Cloud, you must validate it before
3185
+ # providing it to a Google API client library. Providing an unvalidated credential
3186
+ # configuration to Google APIs can compromise the security of your systems and data.
3187
+ # For more information, refer to [Validate credential configurations from external
3188
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
3173
3189
  # @return [::Object]
3174
3190
  # @!attribute [rw] scope
3175
3191
  # The OAuth scopes
@@ -3209,6 +3225,11 @@ module Google
3209
3225
  # default endpoint URL. The default value of nil uses the environment
3210
3226
  # universe (usually the default "googleapis.com" universe).
3211
3227
  # @return [::String,nil]
3228
+ # @!attribute [rw] logger
3229
+ # A custom logger to use for request/response debug logging, or the value
3230
+ # `:default` (the default) to construct a default logger, or `nil` to
3231
+ # explicitly disable logging.
3232
+ # @return [::Logger,:default,nil]
3212
3233
  #
3213
3234
  class Configuration
3214
3235
  extend ::Gapic::Config
@@ -3233,6 +3254,7 @@ module Google
3233
3254
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3234
3255
  config_attr :quota_project, nil, ::String, nil
3235
3256
  config_attr :universe_domain, nil, ::String, nil
3257
+ config_attr :logger, :default, ::Logger, nil, :default
3236
3258
 
3237
3259
  # @private
3238
3260
  def initialize parent_config = nil
@@ -125,14 +125,6 @@ module Google
125
125
  # Lists operations that match the specified filter in the request. If the
126
126
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
127
127
  #
128
- # NOTE: the `name` binding allows API services to override the binding
129
- # to use different resource name schemes, such as `users/*/operations`. To
130
- # override the binding, API services can add a binding such as
131
- # `"/v1/{name=users/*}/operations"` to their service configuration.
132
- # For backwards compatibility, the default name includes the operations
133
- # collection id, however overriding users must ensure the name binding
134
- # is the parent resource, without the operations collection id.
135
- #
136
128
  # @overload list_operations(request, options = nil)
137
129
  # Pass arguments to `list_operations` via a request object, either of type
138
130
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -222,7 +214,7 @@ module Google
222
214
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
223
215
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
224
216
  yield response, operation if block_given?
225
- return response
217
+ throw :response, response
226
218
  end
227
219
  rescue ::GRPC::BadStatus => e
228
220
  raise ::Google::Cloud::Error.from_error(e)
@@ -318,7 +310,7 @@ module Google
318
310
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
319
311
  response = ::Gapic::Operation.new response, @operations_client, options: options
320
312
  yield response, operation if block_given?
321
- return response
313
+ throw :response, response
322
314
  end
323
315
  rescue ::GRPC::BadStatus => e
324
316
  raise ::Google::Cloud::Error.from_error(e)
@@ -407,7 +399,6 @@ module Google
407
399
 
408
400
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
409
401
  yield response, operation if block_given?
410
- return response
411
402
  end
412
403
  rescue ::GRPC::BadStatus => e
413
404
  raise ::Google::Cloud::Error.from_error(e)
@@ -422,8 +413,9 @@ module Google
422
413
  # other methods to check whether the cancellation succeeded or whether the
423
414
  # operation completed despite cancellation. On successful cancellation,
424
415
  # the operation is not deleted; instead, it becomes an operation with
425
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
426
- # corresponding to `Code.CANCELLED`.
416
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
417
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
418
+ # `Code.CANCELLED`.
427
419
  #
428
420
  # @overload cancel_operation(request, options = nil)
429
421
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -502,7 +494,6 @@ module Google
502
494
 
503
495
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
504
496
  yield response, operation if block_given?
505
- return response
506
497
  end
507
498
  rescue ::GRPC::BadStatus => e
508
499
  raise ::Google::Cloud::Error.from_error(e)
@@ -600,7 +591,7 @@ module Google
600
591
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
601
592
  response = ::Gapic::Operation.new response, @operations_client, options: options
602
593
  yield response, operation if block_given?
603
- return response
594
+ throw :response, response
604
595
  end
605
596
  rescue ::GRPC::BadStatus => e
606
597
  raise ::Google::Cloud::Error.from_error(e)
@@ -650,6 +641,13 @@ module Google
650
641
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
651
642
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
652
643
  # * (`nil`) indicating no credentials
644
+ #
645
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
646
+ # external source for authentication to Google Cloud, you must validate it before
647
+ # providing it to a Google API client library. Providing an unvalidated credential
648
+ # configuration to Google APIs can compromise the security of your systems and data.
649
+ # For more information, refer to [Validate credential configurations from external
650
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
653
651
  # @return [::Object]
654
652
  # @!attribute [rw] scope
655
653
  # The OAuth scopes
@@ -689,6 +687,11 @@ module Google
689
687
  # default endpoint URL. The default value of nil uses the environment
690
688
  # universe (usually the default "googleapis.com" universe).
691
689
  # @return [::String,nil]
690
+ # @!attribute [rw] logger
691
+ # A custom logger to use for request/response debug logging, or the value
692
+ # `:default` (the default) to construct a default logger, or `nil` to
693
+ # explicitly disable logging.
694
+ # @return [::Logger,:default,nil]
692
695
  #
693
696
  class Configuration
694
697
  extend ::Gapic::Config
@@ -713,6 +716,7 @@ module Google
713
716
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
714
717
  config_attr :quota_project, nil, ::String, nil
715
718
  config_attr :universe_domain, nil, ::String, nil
719
+ config_attr :logger, :default, ::Logger, nil, :default
716
720
 
717
721
  # @private
718
722
  def initialize parent_config = nil
@@ -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
@@ -28,12 +28,18 @@ module Google
28
28
  # @!attribute [rw] google_cdn_key
29
29
  # @return [::Google::Cloud::Video::Stitcher::V1::GoogleCdnKey]
30
30
  # The configuration for a Google Cloud CDN key.
31
+ #
32
+ # Note: The following fields are mutually exclusive: `google_cdn_key`, `akamai_cdn_key`, `media_cdn_key`. If a field in that set is populated, all other fields in the set will automatically be cleared.
31
33
  # @!attribute [rw] akamai_cdn_key
32
34
  # @return [::Google::Cloud::Video::Stitcher::V1::AkamaiCdnKey]
33
35
  # The configuration for an Akamai CDN key.
36
+ #
37
+ # Note: The following fields are mutually exclusive: `akamai_cdn_key`, `google_cdn_key`, `media_cdn_key`. If a field in that set is populated, all other fields in the set will automatically be cleared.
34
38
  # @!attribute [rw] media_cdn_key
35
39
  # @return [::Google::Cloud::Video::Stitcher::V1::MediaCdnKey]
36
40
  # The configuration for a Media CDN key.
41
+ #
42
+ # Note: The following fields are mutually exclusive: `media_cdn_key`, `google_cdn_key`, `akamai_cdn_key`. If a field in that set is populated, all other fields in the set will automatically be cleared.
37
43
  # @!attribute [rw] name
38
44
  # @return [::String]
39
45
  # The resource name of the CDN key, in the form of
@@ -53,12 +53,18 @@ module Google
53
53
  # @!attribute [rw] iframe_ad_resource
54
54
  # @return [::Google::Cloud::Video::Stitcher::V1::IframeAdResource]
55
55
  # The IFrame ad resource associated with the companion ad.
56
+ #
57
+ # Note: The following fields are mutually exclusive: `iframe_ad_resource`, `static_ad_resource`, `html_ad_resource`. If a field in that set is populated, all other fields in the set will automatically be cleared.
56
58
  # @!attribute [rw] static_ad_resource
57
59
  # @return [::Google::Cloud::Video::Stitcher::V1::StaticAdResource]
58
60
  # The static ad resource associated with the companion ad.
61
+ #
62
+ # Note: The following fields are mutually exclusive: `static_ad_resource`, `iframe_ad_resource`, `html_ad_resource`. If a field in that set is populated, all other fields in the set will automatically be cleared.
59
63
  # @!attribute [rw] html_ad_resource
60
64
  # @return [::Google::Cloud::Video::Stitcher::V1::HtmlAdResource]
61
65
  # The HTML ad resource associated with the companion ad.
66
+ #
67
+ # Note: The following fields are mutually exclusive: `html_ad_resource`, `iframe_ad_resource`, `static_ad_resource`. If a field in that set is populated, all other fields in the set will automatically be cleared.
62
68
  # @!attribute [rw] api_framework
63
69
  # @return [::String]
64
70
  # The API necessary to communicate with the creative if available.
@@ -40,9 +40,11 @@ module Google
40
40
  # @!attribute [rw] error
41
41
  # @return [::Google::Rpc::Status]
42
42
  # The error result of the operation in case of failure or cancellation.
43
+ #
44
+ # Note: The following fields are mutually exclusive: `error`, `response`. If a field in that set is populated, all other fields in the set will automatically be cleared.
43
45
  # @!attribute [rw] response
44
46
  # @return [::Google::Protobuf::Any]
45
- # The normal response of the operation in case of success. If the original
47
+ # The normal, successful response of the operation. If the original
46
48
  # method returns no data on success, such as `Delete`, the response is
47
49
  # `google.protobuf.Empty`. If the original method is standard
48
50
  # `Get`/`Create`/`Update`, the response should be the resource. For other
@@ -50,12 +52,15 @@ module Google
50
52
  # is the original method name. For example, if the original method name
51
53
  # is `TakeSnapshot()`, the inferred response type is
52
54
  # `TakeSnapshotResponse`.
55
+ #
56
+ # Note: The following fields are mutually exclusive: `response`, `error`. If a field in that set is populated, all other fields in the set will automatically be cleared.
53
57
  class Operation
54
58
  include ::Google::Protobuf::MessageExts
55
59
  extend ::Google::Protobuf::MessageExts::ClassMethods
56
60
  end
57
61
 
58
- # The request message for Operations.GetOperation.
62
+ # The request message for
63
+ # Operations.GetOperation.
59
64
  # @!attribute [rw] name
60
65
  # @return [::String]
61
66
  # The name of the operation resource.
@@ -64,7 +69,8 @@ module Google
64
69
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
70
  end
66
71
 
67
- # The request message for Operations.ListOperations.
72
+ # The request message for
73
+ # Operations.ListOperations.
68
74
  # @!attribute [rw] name
69
75
  # @return [::String]
70
76
  # The name of the operation's parent resource.
@@ -82,7 +88,8 @@ module Google
82
88
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
89
  end
84
90
 
85
- # The response message for Operations.ListOperations.
91
+ # The response message for
92
+ # Operations.ListOperations.
86
93
  # @!attribute [rw] operations
87
94
  # @return [::Array<::Google::Longrunning::Operation>]
88
95
  # A list of operations that matches the specified filter in the request.
@@ -94,7 +101,8 @@ module Google
94
101
  extend ::Google::Protobuf::MessageExts::ClassMethods
95
102
  end
96
103
 
97
- # The request message for Operations.CancelOperation.
104
+ # The request message for
105
+ # Operations.CancelOperation.
98
106
  # @!attribute [rw] name
99
107
  # @return [::String]
100
108
  # The name of the operation resource to be cancelled.
@@ -103,7 +111,8 @@ module Google
103
111
  extend ::Google::Protobuf::MessageExts::ClassMethods
104
112
  end
105
113
 
106
- # The request message for Operations.DeleteOperation.
114
+ # The request message for
115
+ # Operations.DeleteOperation.
107
116
  # @!attribute [rw] name
108
117
  # @return [::String]
109
118
  # The name of the operation resource to be deleted.
@@ -112,7 +121,8 @@ module Google
112
121
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
122
  end
114
123
 
115
- # The request message for Operations.WaitOperation.
124
+ # The request message for
125
+ # Operations.WaitOperation.
116
126
  # @!attribute [rw] name
117
127
  # @return [::String]
118
128
  # The name of the operation resource to wait on.
@@ -130,13 +140,12 @@ module Google
130
140
  #
131
141
  # Example:
132
142
  #
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
- # }
143
+ # rpc Export(ExportRequest) returns (google.longrunning.Operation) {
144
+ # option (google.longrunning.operation_info) = {
145
+ # response_type: "ExportResponse"
146
+ # metadata_type: "ExportMetadata"
147
+ # };
148
+ # }
140
149
  # @!attribute [rw] response_type
141
150
  # @return [::String]
142
151
  # Required. The message name of the primary return type for this
@@ -53,21 +53,33 @@ module Google
53
53
  # @!attribute [rw] null_value
54
54
  # @return [::Google::Protobuf::NullValue]
55
55
  # Represents a null value.
56
+ #
57
+ # Note: The following fields are mutually exclusive: `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
56
58
  # @!attribute [rw] number_value
57
59
  # @return [::Float]
58
60
  # Represents a double value.
61
+ #
62
+ # Note: The following fields are mutually exclusive: `number_value`, `null_value`, `string_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
59
63
  # @!attribute [rw] string_value
60
64
  # @return [::String]
61
65
  # Represents a string value.
66
+ #
67
+ # Note: The following fields are mutually exclusive: `string_value`, `null_value`, `number_value`, `bool_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
62
68
  # @!attribute [rw] bool_value
63
69
  # @return [::Boolean]
64
70
  # Represents a boolean value.
71
+ #
72
+ # Note: The following fields are mutually exclusive: `bool_value`, `null_value`, `number_value`, `string_value`, `struct_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
65
73
  # @!attribute [rw] struct_value
66
74
  # @return [::Google::Protobuf::Struct]
67
75
  # Represents a structured value.
76
+ #
77
+ # Note: The following fields are mutually exclusive: `struct_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `list_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
68
78
  # @!attribute [rw] list_value
69
79
  # @return [::Google::Protobuf::ListValue]
70
80
  # Represents a repeated `Value`.
81
+ #
82
+ # Note: The following fields are mutually exclusive: `list_value`, `null_value`, `number_value`, `string_value`, `bool_value`, `struct_value`. If a field in that set is populated, all other fields in the set will automatically be cleared.
71
83
  class Value
72
84
  include ::Google::Protobuf::MessageExts
73
85
  extend ::Google::Protobuf::MessageExts::ClassMethods
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-video-stitcher-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
- autorequire:
9
8
  bindir: bin
10
9
  cert_chain: []
11
- date: 2024-08-30 00:00:00.000000000 Z
10
+ date: 2025-01-29 00:00:00.000000000 Z
12
11
  dependencies:
13
12
  - !ruby/object:Gem::Dependency
14
13
  name: gapic-common
@@ -16,7 +15,7 @@ dependencies:
16
15
  requirements:
17
16
  - - ">="
18
17
  - !ruby/object:Gem::Version
19
- version: 0.21.1
18
+ version: 0.25.0
20
19
  - - "<"
21
20
  - !ruby/object:Gem::Version
22
21
  version: 2.a
@@ -26,7 +25,7 @@ dependencies:
26
25
  requirements:
27
26
  - - ">="
28
27
  - !ruby/object:Gem::Version
29
- version: 0.21.1
28
+ version: 0.25.0
30
29
  - - "<"
31
30
  - !ruby/object:Gem::Version
32
31
  version: 2.a
@@ -108,7 +107,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
108
107
  licenses:
109
108
  - Apache-2.0
110
109
  metadata: {}
111
- post_install_message:
112
110
  rdoc_options: []
113
111
  require_paths:
114
112
  - lib
@@ -116,15 +114,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
116
114
  requirements:
117
115
  - - ">="
118
116
  - !ruby/object:Gem::Version
119
- version: '2.7'
117
+ version: '3.0'
120
118
  required_rubygems_version: !ruby/object:Gem::Requirement
121
119
  requirements:
122
120
  - - ">="
123
121
  - !ruby/object:Gem::Version
124
122
  version: '0'
125
123
  requirements: []
126
- rubygems_version: 3.5.6
127
- signing_key:
124
+ rubygems_version: 3.6.2
128
125
  specification_version: 4
129
126
  summary: API Client library for the Video Stitcher V1 API
130
127
  test_files: []