google-shopping-merchant-inventories-v1beta 0.4.3 → 0.6.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: fa4dff904dd473f731f4c308e6f5959e90085e1300ce4841bf7ec0f09cd03ded
4
- data.tar.gz: dcb8bd3949b88743c909e4bc43e70aa9472e32866e18531c04429277d7e582af
3
+ metadata.gz: c6f1287086d0e0682a073cfb31f0fc7d524b69f51b028c779402eb028c0b3f32
4
+ data.tar.gz: 34e9dfe4ccb20b8a8bdfa1d3b0f6488b41dc287c3d80ee29c00220b189133153
5
5
  SHA512:
6
- metadata.gz: fffa9875b9374565aa2f1ee40bbcf6233ff4e62e5c21257aef2c31d9dcdbe55a887792307785c279846fe35030bd6dfadd0b22593bf93347d2d1b4a1084d817d
7
- data.tar.gz: 16ac8f26b9b8d7ba952f2a499be9ea0f5468f3c0f7d722fd2d3ec23a4275acb29f740ec2e4535005f41f91a426c589885242a9b07e9351346c7082742b39c4c9
6
+ metadata.gz: 65720b205a45b6bc9bf1b697f026984b2cfb4a2380c688211ffd0fd682f753f9d4dc63dd546871a903adcae8a046dcaec6003eb8ab913ade1351dade024e1a8b
7
+ data.tar.gz: c02da25e9cc01c3141a60b8913c48ca8dcaafb4e41354605bfc4127fad05b91853062921a4b6da0c8e9599289014d0d6fcf47ba265339c888b42856ff2caefb9
data/README.md CHANGED
@@ -42,40 +42,50 @@ for class and method documentation.
42
42
  See also the [Product Documentation](https://developers.google.com/merchant/api)
43
43
  for general usage information.
44
44
 
45
- ## Enabling Logging
46
-
47
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
48
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
49
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
50
- 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)
51
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
52
-
53
- Configuring a Ruby stdlib logger:
45
+ ## Debug Logging
46
+
47
+ This library comes with opt-in Debug Logging that can help you troubleshoot
48
+ your application's integration with the API. When logging is activated, key
49
+ events such as requests and responses, along with data payloads and metadata
50
+ such as headers and client configuration, are logged to the standard error
51
+ stream.
52
+
53
+ **WARNING:** Client Library Debug Logging includes your data payloads in
54
+ plaintext, which could include sensitive data such as PII for yourself or your
55
+ customers, private keys, or other security data that could be compromising if
56
+ leaked. Always practice good data hygiene with your application logs, and follow
57
+ the principle of least access. Google also recommends that Client Library Debug
58
+ Logging be enabled only temporarily during active debugging, and not used
59
+ permanently in production.
60
+
61
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
62
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
63
+ list of client library gem names. This will select the default logging behavior,
64
+ which writes logs to the standard error stream. On a local workstation, this may
65
+ result in logs appearing on the console. When running on a Google Cloud hosting
66
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
67
+ results in logs appearing alongside your application logs in the
68
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
69
+
70
+ You can customize logging by modifying the `logger` configuration when
71
+ constructing a client object. For example:
54
72
 
55
73
  ```ruby
74
+ require "google/shopping/merchant/inventories/v1beta"
56
75
  require "logger"
57
76
 
58
- module MyLogger
59
- LOGGER = Logger.new $stderr, level: Logger::WARN
60
- def logger
61
- LOGGER
62
- end
63
- end
64
-
65
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
66
- module GRPC
67
- extend MyLogger
77
+ client = ::Google::Shopping::Merchant::Inventories::V1beta::LocalInventoryService::Client.new do |config|
78
+ config.logger = Logger.new "my-app.log"
68
79
  end
69
80
  ```
70
81
 
71
-
72
82
  ## Google Cloud Samples
73
83
 
74
84
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
75
85
 
76
86
  ## Supported Ruby Versions
77
87
 
78
- This library is supported on Ruby 2.7+.
88
+ This library is supported on Ruby 3.0+.
79
89
 
80
90
  Google provides official support for Ruby versions that are actively supported
81
91
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
@@ -163,8 +163,28 @@ module Google
163
163
  universe_domain: @config.universe_domain,
164
164
  channel_args: @config.channel_args,
165
165
  interceptors: @config.interceptors,
166
- channel_pool_config: @config.channel_pool
166
+ channel_pool_config: @config.channel_pool,
167
+ logger: @config.logger
167
168
  )
169
+
170
+ @local_inventory_service_stub.stub_logger&.info do |entry|
171
+ entry.set_system_name
172
+ entry.set_service
173
+ entry.message = "Created client for #{entry.service}"
174
+ entry.set_credentials_fields credentials
175
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
176
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
177
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
178
+ end
179
+ end
180
+
181
+ ##
182
+ # The logger used for request/response debug logging.
183
+ #
184
+ # @return [Logger]
185
+ #
186
+ def logger
187
+ @local_inventory_service_stub.logger
168
188
  end
169
189
 
170
190
  # Service calls
@@ -275,7 +295,7 @@ module Google
275
295
  @local_inventory_service_stub.call_rpc :list_local_inventories, request, options: options do |response, operation|
276
296
  response = ::Gapic::PagedEnumerable.new @local_inventory_service_stub, :list_local_inventories, request, response, operation, options
277
297
  yield response, operation if block_given?
278
- return response
298
+ throw :response, response
279
299
  end
280
300
  rescue ::GRPC::BadStatus => e
281
301
  raise ::Google::Cloud::Error.from_error(e)
@@ -374,7 +394,6 @@ module Google
374
394
 
375
395
  @local_inventory_service_stub.call_rpc :insert_local_inventory, request, options: options do |response, operation|
376
396
  yield response, operation if block_given?
377
- return response
378
397
  end
379
398
  rescue ::GRPC::BadStatus => e
380
399
  raise ::Google::Cloud::Error.from_error(e)
@@ -466,7 +485,6 @@ module Google
466
485
 
467
486
  @local_inventory_service_stub.call_rpc :delete_local_inventory, request, options: options do |response, operation|
468
487
  yield response, operation if block_given?
469
- return response
470
488
  end
471
489
  rescue ::GRPC::BadStatus => e
472
490
  raise ::Google::Cloud::Error.from_error(e)
@@ -516,6 +534,13 @@ module Google
516
534
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
517
535
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
518
536
  # * (`nil`) indicating no credentials
537
+ #
538
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
539
+ # external source for authentication to Google Cloud, you must validate it before
540
+ # providing it to a Google API client library. Providing an unvalidated credential
541
+ # configuration to Google APIs can compromise the security of your systems and data.
542
+ # For more information, refer to [Validate credential configurations from external
543
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
519
544
  # @return [::Object]
520
545
  # @!attribute [rw] scope
521
546
  # The OAuth scopes
@@ -555,6 +580,11 @@ module Google
555
580
  # default endpoint URL. The default value of nil uses the environment
556
581
  # universe (usually the default "googleapis.com" universe).
557
582
  # @return [::String,nil]
583
+ # @!attribute [rw] logger
584
+ # A custom logger to use for request/response debug logging, or the value
585
+ # `:default` (the default) to construct a default logger, or `nil` to
586
+ # explicitly disable logging.
587
+ # @return [::Logger,:default,nil]
558
588
  #
559
589
  class Configuration
560
590
  extend ::Gapic::Config
@@ -579,6 +609,7 @@ module Google
579
609
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
580
610
  config_attr :quota_project, nil, ::String, nil
581
611
  config_attr :universe_domain, nil, ::String, nil
612
+ config_attr :logger, :default, ::Logger, nil, :default
582
613
 
583
614
  # @private
584
615
  def initialize parent_config = nil
@@ -156,8 +156,28 @@ module Google
156
156
  endpoint: @config.endpoint,
157
157
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
158
158
  universe_domain: @config.universe_domain,
159
- credentials: credentials
159
+ credentials: credentials,
160
+ logger: @config.logger
160
161
  )
162
+
163
+ @local_inventory_service_stub.logger(stub: true)&.info do |entry|
164
+ entry.set_system_name
165
+ entry.set_service
166
+ entry.message = "Created client for #{entry.service}"
167
+ entry.set_credentials_fields credentials
168
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
169
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
170
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
171
+ end
172
+ end
173
+
174
+ ##
175
+ # The logger used for request/response debug logging.
176
+ #
177
+ # @return [Logger]
178
+ #
179
+ def logger
180
+ @local_inventory_service_stub.logger
161
181
  end
162
182
 
163
183
  # Service calls
@@ -261,7 +281,7 @@ module Google
261
281
  @local_inventory_service_stub.list_local_inventories request, options do |result, operation|
262
282
  result = ::Gapic::Rest::PagedEnumerable.new @local_inventory_service_stub, :list_local_inventories, "local_inventories", request, result, options
263
283
  yield result, operation if block_given?
264
- return result
284
+ throw :response, result
265
285
  end
266
286
  rescue ::Gapic::Rest::Error => e
267
287
  raise ::Google::Cloud::Error.from_error(e)
@@ -353,7 +373,6 @@ module Google
353
373
 
354
374
  @local_inventory_service_stub.insert_local_inventory request, options do |result, operation|
355
375
  yield result, operation if block_given?
356
- return result
357
376
  end
358
377
  rescue ::Gapic::Rest::Error => e
359
378
  raise ::Google::Cloud::Error.from_error(e)
@@ -438,7 +457,6 @@ module Google
438
457
 
439
458
  @local_inventory_service_stub.delete_local_inventory request, options do |result, operation|
440
459
  yield result, operation if block_given?
441
- return result
442
460
  end
443
461
  rescue ::Gapic::Rest::Error => e
444
462
  raise ::Google::Cloud::Error.from_error(e)
@@ -486,6 +504,13 @@ module Google
486
504
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
487
505
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
488
506
  # * (`nil`) indicating no credentials
507
+ #
508
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
509
+ # external source for authentication to Google Cloud, you must validate it before
510
+ # providing it to a Google API client library. Providing an unvalidated credential
511
+ # configuration to Google APIs can compromise the security of your systems and data.
512
+ # For more information, refer to [Validate credential configurations from external
513
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
489
514
  # @return [::Object]
490
515
  # @!attribute [rw] scope
491
516
  # The OAuth scopes
@@ -518,6 +543,11 @@ module Google
518
543
  # default endpoint URL. The default value of nil uses the environment
519
544
  # universe (usually the default "googleapis.com" universe).
520
545
  # @return [::String,nil]
546
+ # @!attribute [rw] logger
547
+ # A custom logger to use for request/response debug logging, or the value
548
+ # `:default` (the default) to construct a default logger, or `nil` to
549
+ # explicitly disable logging.
550
+ # @return [::Logger,:default,nil]
521
551
  #
522
552
  class Configuration
523
553
  extend ::Gapic::Config
@@ -539,6 +569,7 @@ module Google
539
569
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
540
570
  config_attr :quota_project, nil, ::String, nil
541
571
  config_attr :universe_domain, nil, ::String, nil
572
+ config_attr :logger, :default, ::Logger, nil, :default
542
573
 
543
574
  # @private
544
575
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the list_local_inventories REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "list_local_inventories",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Shopping::Merchant::Inventories::V1beta::ListLocalInventoriesResponse.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "insert_local_inventory",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Shopping::Merchant::Inventories::V1beta::LocalInventory.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "delete_local_inventory",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -164,8 +164,28 @@ module Google
164
164
  universe_domain: @config.universe_domain,
165
165
  channel_args: @config.channel_args,
166
166
  interceptors: @config.interceptors,
167
- channel_pool_config: @config.channel_pool
167
+ channel_pool_config: @config.channel_pool,
168
+ logger: @config.logger
168
169
  )
170
+
171
+ @regional_inventory_service_stub.stub_logger&.info do |entry|
172
+ entry.set_system_name
173
+ entry.set_service
174
+ entry.message = "Created client for #{entry.service}"
175
+ entry.set_credentials_fields credentials
176
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
177
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
178
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
179
+ end
180
+ end
181
+
182
+ ##
183
+ # The logger used for request/response debug logging.
184
+ #
185
+ # @return [Logger]
186
+ #
187
+ def logger
188
+ @regional_inventory_service_stub.logger
169
189
  end
170
190
 
171
191
  # Service calls
@@ -275,7 +295,7 @@ module Google
275
295
  @regional_inventory_service_stub.call_rpc :list_regional_inventories, request, options: options do |response, operation|
276
296
  response = ::Gapic::PagedEnumerable.new @regional_inventory_service_stub, :list_regional_inventories, request, response, operation, options
277
297
  yield response, operation if block_given?
278
- return response
298
+ throw :response, response
279
299
  end
280
300
  rescue ::GRPC::BadStatus => e
281
301
  raise ::Google::Cloud::Error.from_error(e)
@@ -374,7 +394,6 @@ module Google
374
394
 
375
395
  @regional_inventory_service_stub.call_rpc :insert_regional_inventory, request, options: options do |response, operation|
376
396
  yield response, operation if block_given?
377
- return response
378
397
  end
379
398
  rescue ::GRPC::BadStatus => e
380
399
  raise ::Google::Cloud::Error.from_error(e)
@@ -466,7 +485,6 @@ module Google
466
485
 
467
486
  @regional_inventory_service_stub.call_rpc :delete_regional_inventory, request, options: options do |response, operation|
468
487
  yield response, operation if block_given?
469
- return response
470
488
  end
471
489
  rescue ::GRPC::BadStatus => e
472
490
  raise ::Google::Cloud::Error.from_error(e)
@@ -516,6 +534,13 @@ module Google
516
534
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
517
535
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
518
536
  # * (`nil`) indicating no credentials
537
+ #
538
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
539
+ # external source for authentication to Google Cloud, you must validate it before
540
+ # providing it to a Google API client library. Providing an unvalidated credential
541
+ # configuration to Google APIs can compromise the security of your systems and data.
542
+ # For more information, refer to [Validate credential configurations from external
543
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
519
544
  # @return [::Object]
520
545
  # @!attribute [rw] scope
521
546
  # The OAuth scopes
@@ -555,6 +580,11 @@ module Google
555
580
  # default endpoint URL. The default value of nil uses the environment
556
581
  # universe (usually the default "googleapis.com" universe).
557
582
  # @return [::String,nil]
583
+ # @!attribute [rw] logger
584
+ # A custom logger to use for request/response debug logging, or the value
585
+ # `:default` (the default) to construct a default logger, or `nil` to
586
+ # explicitly disable logging.
587
+ # @return [::Logger,:default,nil]
558
588
  #
559
589
  class Configuration
560
590
  extend ::Gapic::Config
@@ -579,6 +609,7 @@ module Google
579
609
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
580
610
  config_attr :quota_project, nil, ::String, nil
581
611
  config_attr :universe_domain, nil, ::String, nil
612
+ config_attr :logger, :default, ::Logger, nil, :default
582
613
 
583
614
  # @private
584
615
  def initialize parent_config = nil
@@ -157,8 +157,28 @@ module Google
157
157
  endpoint: @config.endpoint,
158
158
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
159
159
  universe_domain: @config.universe_domain,
160
- credentials: credentials
160
+ credentials: credentials,
161
+ logger: @config.logger
161
162
  )
163
+
164
+ @regional_inventory_service_stub.logger(stub: true)&.info do |entry|
165
+ entry.set_system_name
166
+ entry.set_service
167
+ entry.message = "Created client for #{entry.service}"
168
+ entry.set_credentials_fields credentials
169
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
170
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
171
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
172
+ end
173
+ end
174
+
175
+ ##
176
+ # The logger used for request/response debug logging.
177
+ #
178
+ # @return [Logger]
179
+ #
180
+ def logger
181
+ @regional_inventory_service_stub.logger
162
182
  end
163
183
 
164
184
  # Service calls
@@ -261,7 +281,7 @@ module Google
261
281
  @regional_inventory_service_stub.list_regional_inventories request, options do |result, operation|
262
282
  result = ::Gapic::Rest::PagedEnumerable.new @regional_inventory_service_stub, :list_regional_inventories, "regional_inventories", request, result, options
263
283
  yield result, operation if block_given?
264
- return result
284
+ throw :response, result
265
285
  end
266
286
  rescue ::Gapic::Rest::Error => e
267
287
  raise ::Google::Cloud::Error.from_error(e)
@@ -353,7 +373,6 @@ module Google
353
373
 
354
374
  @regional_inventory_service_stub.insert_regional_inventory request, options do |result, operation|
355
375
  yield result, operation if block_given?
356
- return result
357
376
  end
358
377
  rescue ::Gapic::Rest::Error => e
359
378
  raise ::Google::Cloud::Error.from_error(e)
@@ -438,7 +457,6 @@ module Google
438
457
 
439
458
  @regional_inventory_service_stub.delete_regional_inventory request, options do |result, operation|
440
459
  yield result, operation if block_given?
441
- return result
442
460
  end
443
461
  rescue ::Gapic::Rest::Error => e
444
462
  raise ::Google::Cloud::Error.from_error(e)
@@ -486,6 +504,13 @@ module Google
486
504
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
487
505
  # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
488
506
  # * (`nil`) indicating no credentials
507
+ #
508
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
509
+ # external source for authentication to Google Cloud, you must validate it before
510
+ # providing it to a Google API client library. Providing an unvalidated credential
511
+ # configuration to Google APIs can compromise the security of your systems and data.
512
+ # For more information, refer to [Validate credential configurations from external
513
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
489
514
  # @return [::Object]
490
515
  # @!attribute [rw] scope
491
516
  # The OAuth scopes
@@ -518,6 +543,11 @@ module Google
518
543
  # default endpoint URL. The default value of nil uses the environment
519
544
  # universe (usually the default "googleapis.com" universe).
520
545
  # @return [::String,nil]
546
+ # @!attribute [rw] logger
547
+ # A custom logger to use for request/response debug logging, or the value
548
+ # `:default` (the default) to construct a default logger, or `nil` to
549
+ # explicitly disable logging.
550
+ # @return [::Logger,:default,nil]
521
551
  #
522
552
  class Configuration
523
553
  extend ::Gapic::Config
@@ -539,6 +569,7 @@ module Google
539
569
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
540
570
  config_attr :quota_project, nil, ::String, nil
541
571
  config_attr :universe_domain, nil, ::String, nil
572
+ config_attr :logger, :default, ::Logger, nil, :default
542
573
 
543
574
  # @private
544
575
  def initialize parent_config = nil
@@ -31,7 +31,8 @@ module Google
31
31
  # including transcoding, making the REST call, and deserialing the response.
32
32
  #
33
33
  class ServiceStub
34
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
35
36
  # These require statements are intentionally placed here to initialize
36
37
  # the REST modules only when it's required.
37
38
  require "gapic/rest"
@@ -41,7 +42,9 @@ module Google
41
42
  universe_domain: universe_domain,
42
43
  credentials: credentials,
43
44
  numeric_enums: true,
44
- raise_faraday_errors: false
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
45
48
  end
46
49
 
47
50
  ##
@@ -62,6 +65,15 @@ module Google
62
65
  @client_stub.endpoint
63
66
  end
64
67
 
68
+ ##
69
+ # The logger used for request/response debug logging.
70
+ #
71
+ # @return [Logger]
72
+ #
73
+ def logger stub: false
74
+ stub ? @client_stub.stub_logger : @client_stub.logger
75
+ end
76
+
65
77
  ##
66
78
  # Baseline implementation for the list_regional_inventories REST call
67
79
  #
@@ -88,16 +100,18 @@ module Google
88
100
 
89
101
  response = @client_stub.make_http_request(
90
102
  verb,
91
- uri: uri,
92
- body: body || "",
93
- params: query_string_params,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "list_regional_inventories",
94
107
  options: options
95
108
  )
96
109
  operation = ::Gapic::Rest::TransportOperation.new response
97
110
  result = ::Google::Shopping::Merchant::Inventories::V1beta::ListRegionalInventoriesResponse.decode_json response.body, ignore_unknown_fields: true
98
-
99
- yield result, operation if block_given?
100
- result
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
101
115
  end
102
116
 
103
117
  ##
@@ -126,16 +140,18 @@ module Google
126
140
 
127
141
  response = @client_stub.make_http_request(
128
142
  verb,
129
- uri: uri,
130
- body: body || "",
131
- params: query_string_params,
143
+ uri: uri,
144
+ body: body || "",
145
+ params: query_string_params,
146
+ method_name: "insert_regional_inventory",
132
147
  options: options
133
148
  )
134
149
  operation = ::Gapic::Rest::TransportOperation.new response
135
150
  result = ::Google::Shopping::Merchant::Inventories::V1beta::RegionalInventory.decode_json response.body, ignore_unknown_fields: true
136
-
137
- yield result, operation if block_given?
138
- result
151
+ catch :response do
152
+ yield result, operation if block_given?
153
+ result
154
+ end
139
155
  end
140
156
 
141
157
  ##
@@ -164,16 +180,18 @@ module Google
164
180
 
165
181
  response = @client_stub.make_http_request(
166
182
  verb,
167
- uri: uri,
168
- body: body || "",
169
- params: query_string_params,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ method_name: "delete_regional_inventory",
170
187
  options: options
171
188
  )
172
189
  operation = ::Gapic::Rest::TransportOperation.new response
173
190
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
174
-
175
- yield result, operation if block_given?
176
- result
191
+ catch :response do
192
+ yield result, operation if block_given?
193
+ result
194
+ end
177
195
  end
178
196
 
179
197
  ##
@@ -22,7 +22,7 @@ module Google
22
22
  module Merchant
23
23
  module Inventories
24
24
  module V1beta
25
- VERSION = "0.4.3"
25
+ VERSION = "0.6.0"
26
26
  end
27
27
  end
28
28
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -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
metadata CHANGED
@@ -1,14 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-shopping-merchant-inventories-v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.3
4
+ version: 0.6.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
@@ -115,7 +114,6 @@ homepage: https://github.com/googleapis/google-cloud-ruby
115
114
  licenses:
116
115
  - Apache-2.0
117
116
  metadata: {}
118
- post_install_message:
119
117
  rdoc_options: []
120
118
  require_paths:
121
119
  - lib
@@ -123,15 +121,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
123
121
  requirements:
124
122
  - - ">="
125
123
  - !ruby/object:Gem::Version
126
- version: '2.7'
124
+ version: '3.0'
127
125
  required_rubygems_version: !ruby/object:Gem::Requirement
128
126
  requirements:
129
127
  - - ">="
130
128
  - !ruby/object:Gem::Version
131
129
  version: '0'
132
130
  requirements: []
133
- rubygems_version: 3.5.6
134
- signing_key:
131
+ rubygems_version: 3.6.2
135
132
  specification_version: 4
136
133
  summary: Programmatically manage your Merchant Center accounts.
137
134
  test_files: []