google-cloud-video-stitcher-v1 1.0.1 → 1.2.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: 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: []