google-shopping-merchant-lfp-v1 0.a → 0.1.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.
Files changed (59) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +12 -0
  3. data/AUTHENTICATION.md +122 -0
  4. data/README.md +154 -8
  5. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/client.rb +471 -0
  6. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/credentials.rb +49 -0
  7. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/paths.rb +70 -0
  8. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/rest/client.rb +438 -0
  9. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/rest/service_stub.rb +145 -0
  10. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service/rest.rb +56 -0
  11. data/lib/google/shopping/merchant/lfp/v1/lfp_inventory_service.rb +59 -0
  12. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/client.rb +471 -0
  13. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/credentials.rb +49 -0
  14. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/paths.rb +52 -0
  15. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/rest/client.rb +438 -0
  16. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/rest/service_stub.rb +144 -0
  17. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service/rest.rb +59 -0
  18. data/lib/google/shopping/merchant/lfp/v1/lfp_merchant_state_service.rb +62 -0
  19. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/client.rb +469 -0
  20. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/credentials.rb +49 -0
  21. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/paths.rb +52 -0
  22. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/rest/client.rb +436 -0
  23. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/rest/service_stub.rb +145 -0
  24. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service/rest.rb +56 -0
  25. data/lib/google/shopping/merchant/lfp/v1/lfp_sale_service.rb +59 -0
  26. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/client.rb +771 -0
  27. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/credentials.rb +49 -0
  28. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/paths.rb +68 -0
  29. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/rest/client.rb +717 -0
  30. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/rest/service_stub.rb +328 -0
  31. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service/rest.rb +56 -0
  32. data/lib/google/shopping/merchant/lfp/v1/lfp_store_service.rb +59 -0
  33. data/lib/google/shopping/merchant/lfp/v1/lfpinventory_pb.rb +54 -0
  34. data/lib/google/shopping/merchant/lfp/v1/lfpinventory_services_pb.rb +51 -0
  35. data/lib/google/shopping/merchant/lfp/v1/lfpmerchantstate_pb.rb +56 -0
  36. data/lib/google/shopping/merchant/lfp/v1/lfpmerchantstate_services_pb.rb +52 -0
  37. data/lib/google/shopping/merchant/lfp/v1/lfpsale_pb.rb +55 -0
  38. data/lib/google/shopping/merchant/lfp/v1/lfpsale_services_pb.rb +49 -0
  39. data/lib/google/shopping/merchant/lfp/v1/lfpstore_pb.rb +56 -0
  40. data/lib/google/shopping/merchant/lfp/v1/lfpstore_services_pb.rb +57 -0
  41. data/lib/google/shopping/merchant/lfp/v1/rest.rb +42 -0
  42. data/lib/google/shopping/merchant/lfp/v1/version.rb +7 -2
  43. data/lib/google/shopping/merchant/lfp/v1.rb +50 -0
  44. data/lib/google-shopping-merchant-lfp-v1.rb +21 -0
  45. data/proto_docs/README.md +4 -0
  46. data/proto_docs/google/api/client.rb +473 -0
  47. data/proto_docs/google/api/field_behavior.rb +85 -0
  48. data/proto_docs/google/api/field_info.rb +88 -0
  49. data/proto_docs/google/api/launch_stage.rb +71 -0
  50. data/proto_docs/google/api/resource.rb +227 -0
  51. data/proto_docs/google/protobuf/duration.rb +98 -0
  52. data/proto_docs/google/protobuf/empty.rb +34 -0
  53. data/proto_docs/google/protobuf/timestamp.rb +127 -0
  54. data/proto_docs/google/shopping/merchant/lfp/v1/lfpinventory.rb +113 -0
  55. data/proto_docs/google/shopping/merchant/lfp/v1/lfpmerchantstate.rb +181 -0
  56. data/proto_docs/google/shopping/merchant/lfp/v1/lfpsale.rb +96 -0
  57. data/proto_docs/google/shopping/merchant/lfp/v1/lfpstore.rb +185 -0
  58. data/proto_docs/google/shopping/type/types.rb +210 -0
  59. metadata +117 -9
@@ -0,0 +1,436 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/shopping/merchant/lfp/v1/lfpsale_pb"
21
+ require "google/shopping/merchant/lfp/v1/lfp_sale_service/rest/service_stub"
22
+
23
+ module Google
24
+ module Shopping
25
+ module Merchant
26
+ module Lfp
27
+ module V1
28
+ module LfpSaleService
29
+ module Rest
30
+ ##
31
+ # REST client for the LfpSaleService service.
32
+ #
33
+ # Service for a [LFP
34
+ # partner](https://support.google.com/merchants/answer/7676652) to submit sales
35
+ # data for a merchant.
36
+ #
37
+ class Client
38
+ # @private
39
+ API_VERSION = ""
40
+
41
+ # @private
42
+ DEFAULT_ENDPOINT_TEMPLATE = "merchantapi.$UNIVERSE_DOMAIN$"
43
+
44
+ include Paths
45
+
46
+ # @private
47
+ attr_reader :lfp_sale_service_stub
48
+
49
+ ##
50
+ # Configure the LfpSaleService Client class.
51
+ #
52
+ # See {::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client::Configuration}
53
+ # for a description of the configuration fields.
54
+ #
55
+ # @example
56
+ #
57
+ # # Modify the configuration for all LfpSaleService clients
58
+ # ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.configure do |config|
59
+ # config.timeout = 10.0
60
+ # end
61
+ #
62
+ # @yield [config] Configure the Client client.
63
+ # @yieldparam config [Client::Configuration]
64
+ #
65
+ # @return [Client::Configuration]
66
+ #
67
+ def self.configure
68
+ @configure ||= begin
69
+ namespace = ["Google", "Shopping", "Merchant", "Lfp", "V1"]
70
+ parent_config = while namespace.any?
71
+ parent_name = namespace.join "::"
72
+ parent_const = const_get parent_name
73
+ break parent_const.configure if parent_const.respond_to? :configure
74
+ namespace.pop
75
+ end
76
+ default_config = Client::Configuration.new parent_config
77
+
78
+ default_config.timeout = 60.0
79
+ default_config.retry_policy = {
80
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
81
+ }
82
+
83
+ default_config
84
+ end
85
+ yield @configure if block_given?
86
+ @configure
87
+ end
88
+
89
+ ##
90
+ # Configure the LfpSaleService Client instance.
91
+ #
92
+ # The configuration is set to the derived mode, meaning that values can be changed,
93
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
94
+ # should be made on {Client.configure}.
95
+ #
96
+ # See {::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client::Configuration}
97
+ # for a description of the configuration fields.
98
+ #
99
+ # @yield [config] Configure the Client client.
100
+ # @yieldparam config [Client::Configuration]
101
+ #
102
+ # @return [Client::Configuration]
103
+ #
104
+ def configure
105
+ yield @config if block_given?
106
+ @config
107
+ end
108
+
109
+ ##
110
+ # The effective universe domain
111
+ #
112
+ # @return [String]
113
+ #
114
+ def universe_domain
115
+ @lfp_sale_service_stub.universe_domain
116
+ end
117
+
118
+ ##
119
+ # Create a new LfpSaleService REST client object.
120
+ #
121
+ # @example
122
+ #
123
+ # # Create a client using the default configuration
124
+ # client = ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.new
125
+ #
126
+ # # Create a client using a custom configuration
127
+ # client = ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.new do |config|
128
+ # config.timeout = 10.0
129
+ # end
130
+ #
131
+ # @yield [config] Configure the LfpSaleService client.
132
+ # @yieldparam config [Client::Configuration]
133
+ #
134
+ def initialize
135
+ # Create the configuration object
136
+ @config = Configuration.new Client.configure
137
+
138
+ # Yield the configuration if needed
139
+ yield @config if block_given?
140
+
141
+ # Create credentials
142
+ credentials = @config.credentials
143
+ # Use self-signed JWT if the endpoint is unchanged from default,
144
+ # but only if the default endpoint does not have a region prefix.
145
+ enable_self_signed_jwt = @config.endpoint.nil? ||
146
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
147
+ !@config.endpoint.split(".").first.include?("-"))
148
+ credentials ||= Credentials.default scope: @config.scope,
149
+ enable_self_signed_jwt: enable_self_signed_jwt
150
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
151
+ credentials = Credentials.new credentials, scope: @config.scope
152
+ end
153
+
154
+ @quota_project_id = @config.quota_project
155
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
156
+
157
+ @lfp_sale_service_stub = ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::ServiceStub.new(
158
+ endpoint: @config.endpoint,
159
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
160
+ universe_domain: @config.universe_domain,
161
+ credentials: credentials,
162
+ logger: @config.logger
163
+ )
164
+
165
+ @lfp_sale_service_stub.logger(stub: true)&.info do |entry|
166
+ entry.set_system_name
167
+ entry.set_service
168
+ entry.message = "Created client for #{entry.service}"
169
+ entry.set_credentials_fields credentials
170
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
171
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
172
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
173
+ end
174
+ end
175
+
176
+ ##
177
+ # The logger used for request/response debug logging.
178
+ #
179
+ # @return [Logger]
180
+ #
181
+ def logger
182
+ @lfp_sale_service_stub.logger
183
+ end
184
+
185
+ # Service calls
186
+
187
+ ##
188
+ # Inserts a `LfpSale` for the given merchant.
189
+ #
190
+ # @overload insert_lfp_sale(request, options = nil)
191
+ # Pass arguments to `insert_lfp_sale` via a request object, either of type
192
+ # {::Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest} or an equivalent Hash.
193
+ #
194
+ # @param request [::Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest, ::Hash]
195
+ # A request object representing the call parameters. Required. To specify no
196
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
197
+ # @param options [::Gapic::CallOptions, ::Hash]
198
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
199
+ #
200
+ # @overload insert_lfp_sale(parent: nil, lfp_sale: nil)
201
+ # Pass arguments to `insert_lfp_sale` via keyword arguments. Note that at
202
+ # least one keyword argument is required. To specify no parameters, or to keep all
203
+ # the default parameter values, pass an empty Hash as a request object (see above).
204
+ #
205
+ # @param parent [::String]
206
+ # Required. The LFP provider account.
207
+ # Format: `accounts/{lfp_partner}`
208
+ # @param lfp_sale [::Google::Shopping::Merchant::Lfp::V1::LfpSale, ::Hash]
209
+ # Required. The sale to insert.
210
+ # @yield [result, operation] Access the result along with the TransportOperation object
211
+ # @yieldparam result [::Google::Shopping::Merchant::Lfp::V1::LfpSale]
212
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
213
+ #
214
+ # @return [::Google::Shopping::Merchant::Lfp::V1::LfpSale]
215
+ #
216
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
217
+ #
218
+ # @example Basic example
219
+ # require "google/shopping/merchant/lfp/v1"
220
+ #
221
+ # # Create a client object. The client can be reused for multiple calls.
222
+ # client = Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.new
223
+ #
224
+ # # Create a request. To set request fields, pass in keyword arguments.
225
+ # request = Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest.new
226
+ #
227
+ # # Call the insert_lfp_sale method.
228
+ # result = client.insert_lfp_sale request
229
+ #
230
+ # # The returned object is of type Google::Shopping::Merchant::Lfp::V1::LfpSale.
231
+ # p result
232
+ #
233
+ def insert_lfp_sale request, options = nil
234
+ raise ::ArgumentError, "request must be provided" if request.nil?
235
+
236
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest
237
+
238
+ # Converts hash and nil to an options object
239
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
240
+
241
+ # Customize the options with defaults
242
+ call_metadata = @config.rpcs.insert_lfp_sale.metadata.to_h
243
+
244
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
245
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
246
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
247
+ gapic_version: ::Google::Shopping::Merchant::Lfp::V1::VERSION,
248
+ transports_version_send: [:rest]
249
+
250
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
251
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
252
+
253
+ options.apply_defaults timeout: @config.rpcs.insert_lfp_sale.timeout,
254
+ metadata: call_metadata,
255
+ retry_policy: @config.rpcs.insert_lfp_sale.retry_policy
256
+
257
+ options.apply_defaults timeout: @config.timeout,
258
+ metadata: @config.metadata,
259
+ retry_policy: @config.retry_policy
260
+
261
+ @lfp_sale_service_stub.insert_lfp_sale request, options do |result, operation|
262
+ yield result, operation if block_given?
263
+ end
264
+ rescue ::Gapic::Rest::Error => e
265
+ raise ::Google::Cloud::Error.from_error(e)
266
+ end
267
+
268
+ ##
269
+ # Configuration class for the LfpSaleService REST API.
270
+ #
271
+ # This class represents the configuration for LfpSaleService REST,
272
+ # providing control over timeouts, retry behavior, logging, transport
273
+ # parameters, and other low-level controls. Certain parameters can also be
274
+ # applied individually to specific RPCs. See
275
+ # {::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client::Configuration::Rpcs}
276
+ # for a list of RPCs that can be configured independently.
277
+ #
278
+ # Configuration can be applied globally to all clients, or to a single client
279
+ # on construction.
280
+ #
281
+ # @example
282
+ #
283
+ # # Modify the global config, setting the timeout for
284
+ # # insert_lfp_sale to 20 seconds,
285
+ # # and all remaining timeouts to 10 seconds.
286
+ # ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.configure do |config|
287
+ # config.timeout = 10.0
288
+ # config.rpcs.insert_lfp_sale.timeout = 20.0
289
+ # end
290
+ #
291
+ # # Apply the above configuration only to a new client.
292
+ # client = ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.new do |config|
293
+ # config.timeout = 10.0
294
+ # config.rpcs.insert_lfp_sale.timeout = 20.0
295
+ # end
296
+ #
297
+ # @!attribute [rw] endpoint
298
+ # A custom service endpoint, as a hostname or hostname:port. The default is
299
+ # nil, indicating to use the default endpoint in the current universe domain.
300
+ # @return [::String,nil]
301
+ # @!attribute [rw] credentials
302
+ # Credentials to send with calls. You may provide any of the following types:
303
+ # * (`String`) The path to a service account key file in JSON format
304
+ # * (`Hash`) A service account key as a Hash
305
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
306
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
307
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
308
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
309
+ # * (`nil`) indicating no credentials
310
+ #
311
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
312
+ # external source for authentication to Google Cloud, you must validate it before
313
+ # providing it to a Google API client library. Providing an unvalidated credential
314
+ # configuration to Google APIs can compromise the security of your systems and data.
315
+ # For more information, refer to [Validate credential configurations from external
316
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
317
+ # @return [::Object]
318
+ # @!attribute [rw] scope
319
+ # The OAuth scopes
320
+ # @return [::Array<::String>]
321
+ # @!attribute [rw] lib_name
322
+ # The library name as recorded in instrumentation and logging
323
+ # @return [::String]
324
+ # @!attribute [rw] lib_version
325
+ # The library version as recorded in instrumentation and logging
326
+ # @return [::String]
327
+ # @!attribute [rw] timeout
328
+ # The call timeout in seconds.
329
+ # @return [::Numeric]
330
+ # @!attribute [rw] metadata
331
+ # Additional headers to be sent with the call.
332
+ # @return [::Hash{::Symbol=>::String}]
333
+ # @!attribute [rw] retry_policy
334
+ # The retry policy. The value is a hash with the following keys:
335
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
336
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
337
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
338
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
339
+ # trigger a retry.
340
+ # @return [::Hash]
341
+ # @!attribute [rw] quota_project
342
+ # A separate project against which to charge quota.
343
+ # @return [::String]
344
+ # @!attribute [rw] universe_domain
345
+ # The universe domain within which to make requests. This determines the
346
+ # default endpoint URL. The default value of nil uses the environment
347
+ # universe (usually the default "googleapis.com" universe).
348
+ # @return [::String,nil]
349
+ # @!attribute [rw] logger
350
+ # A custom logger to use for request/response debug logging, or the value
351
+ # `:default` (the default) to construct a default logger, or `nil` to
352
+ # explicitly disable logging.
353
+ # @return [::Logger,:default,nil]
354
+ #
355
+ class Configuration
356
+ extend ::Gapic::Config
357
+
358
+ # @private
359
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
360
+ DEFAULT_ENDPOINT = "merchantapi.googleapis.com"
361
+
362
+ config_attr :endpoint, nil, ::String, nil
363
+ config_attr :credentials, nil do |value|
364
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
365
+ allowed.any? { |klass| klass === value }
366
+ end
367
+ config_attr :scope, nil, ::String, ::Array, nil
368
+ config_attr :lib_name, nil, ::String, nil
369
+ config_attr :lib_version, nil, ::String, nil
370
+ config_attr :timeout, nil, ::Numeric, nil
371
+ config_attr :metadata, nil, ::Hash, nil
372
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
373
+ config_attr :quota_project, nil, ::String, nil
374
+ config_attr :universe_domain, nil, ::String, nil
375
+ config_attr :logger, :default, ::Logger, nil, :default
376
+
377
+ # @private
378
+ def initialize parent_config = nil
379
+ @parent_config = parent_config unless parent_config.nil?
380
+
381
+ yield self if block_given?
382
+ end
383
+
384
+ ##
385
+ # Configurations for individual RPCs
386
+ # @return [Rpcs]
387
+ #
388
+ def rpcs
389
+ @rpcs ||= begin
390
+ parent_rpcs = nil
391
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
392
+ Rpcs.new parent_rpcs
393
+ end
394
+ end
395
+
396
+ ##
397
+ # Configuration RPC class for the LfpSaleService API.
398
+ #
399
+ # Includes fields providing the configuration for each RPC in this service.
400
+ # Each configuration object is of type `Gapic::Config::Method` and includes
401
+ # the following configuration fields:
402
+ #
403
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
404
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
405
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
406
+ # include the following keys:
407
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
408
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
409
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
410
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
411
+ # trigger a retry.
412
+ #
413
+ class Rpcs
414
+ ##
415
+ # RPC-specific configuration for `insert_lfp_sale`
416
+ # @return [::Gapic::Config::Method]
417
+ #
418
+ attr_reader :insert_lfp_sale
419
+
420
+ # @private
421
+ def initialize parent_rpcs = nil
422
+ insert_lfp_sale_config = parent_rpcs.insert_lfp_sale if parent_rpcs.respond_to? :insert_lfp_sale
423
+ @insert_lfp_sale = ::Gapic::Config::Method.new insert_lfp_sale_config
424
+
425
+ yield self if block_given?
426
+ end
427
+ end
428
+ end
429
+ end
430
+ end
431
+ end
432
+ end
433
+ end
434
+ end
435
+ end
436
+ end
@@ -0,0 +1,145 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/shopping/merchant/lfp/v1/lfpsale_pb"
20
+
21
+ module Google
22
+ module Shopping
23
+ module Merchant
24
+ module Lfp
25
+ module V1
26
+ module LfpSaleService
27
+ module Rest
28
+ ##
29
+ # REST service stub for the LfpSaleService service.
30
+ # Service stub contains baseline method implementations
31
+ # including transcoding, making the REST call, and deserialing the response.
32
+ #
33
+ class ServiceStub
34
+ # @private
35
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
36
+ # These require statements are intentionally placed here to initialize
37
+ # the REST modules only when it's required.
38
+ require "gapic/rest"
39
+
40
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint,
41
+ endpoint_template: endpoint_template,
42
+ universe_domain: universe_domain,
43
+ credentials: credentials,
44
+ numeric_enums: true,
45
+ service_name: self.class,
46
+ raise_faraday_errors: false,
47
+ logger: logger
48
+ end
49
+
50
+ ##
51
+ # The effective universe domain
52
+ #
53
+ # @return [String]
54
+ #
55
+ def universe_domain
56
+ @client_stub.universe_domain
57
+ end
58
+
59
+ ##
60
+ # The effective endpoint
61
+ #
62
+ # @return [String]
63
+ #
64
+ def endpoint
65
+ @client_stub.endpoint
66
+ end
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
+
77
+ ##
78
+ # Baseline implementation for the insert_lfp_sale REST call
79
+ #
80
+ # @param request_pb [::Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest]
81
+ # A request object representing the call parameters. Required.
82
+ # @param options [::Gapic::CallOptions]
83
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
84
+ #
85
+ # @yield [result, operation] Access the result along with the TransportOperation object
86
+ # @yieldparam result [::Google::Shopping::Merchant::Lfp::V1::LfpSale]
87
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
88
+ #
89
+ # @return [::Google::Shopping::Merchant::Lfp::V1::LfpSale]
90
+ # A result object deserialized from the server's reply
91
+ def insert_lfp_sale request_pb, options = nil
92
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
93
+
94
+ verb, uri, query_string_params, body = ServiceStub.transcode_insert_lfp_sale_request request_pb
95
+ query_string_params = if query_string_params.any?
96
+ query_string_params.to_h { |p| p.split "=", 2 }
97
+ else
98
+ {}
99
+ end
100
+
101
+ response = @client_stub.make_http_request(
102
+ verb,
103
+ uri: uri,
104
+ body: body || "",
105
+ params: query_string_params,
106
+ method_name: "insert_lfp_sale",
107
+ options: options
108
+ )
109
+ operation = ::Gapic::Rest::TransportOperation.new response
110
+ result = ::Google::Shopping::Merchant::Lfp::V1::LfpSale.decode_json response.body, ignore_unknown_fields: true
111
+ catch :response do
112
+ yield result, operation if block_given?
113
+ result
114
+ end
115
+ end
116
+
117
+ ##
118
+ # @private
119
+ #
120
+ # GRPC transcoding helper method for the insert_lfp_sale REST call
121
+ #
122
+ # @param request_pb [::Google::Shopping::Merchant::Lfp::V1::InsertLfpSaleRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @return [Array(String, [String, nil], Hash{String => String})]
125
+ # Uri, Body, Query string parameters
126
+ def self.transcode_insert_lfp_sale_request request_pb
127
+ transcoder = Gapic::Rest::GrpcTranscoder.new
128
+ .with_bindings(
129
+ uri_method: :post,
130
+ uri_template: "/lfp/v1/{parent}/lfpSales:insert",
131
+ body: "lfp_sale",
132
+ matches: [
133
+ ["parent", %r{^accounts/[^/]+/?$}, false]
134
+ ]
135
+ )
136
+ transcoder.transcode request_pb
137
+ end
138
+ end
139
+ end
140
+ end
141
+ end
142
+ end
143
+ end
144
+ end
145
+ end
@@ -0,0 +1,56 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "gapic/rest"
20
+ require "gapic/config"
21
+ require "gapic/config/method"
22
+
23
+ require "google/shopping/merchant/lfp/v1/version"
24
+
25
+ require "google/shopping/merchant/lfp/v1/lfp_sale_service/credentials"
26
+ require "google/shopping/merchant/lfp/v1/lfp_sale_service/paths"
27
+ require "google/shopping/merchant/lfp/v1/lfp_sale_service/rest/client"
28
+
29
+ module Google
30
+ module Shopping
31
+ module Merchant
32
+ module Lfp
33
+ module V1
34
+ ##
35
+ # Service for a [LFP
36
+ # partner](https://support.google.com/merchants/answer/7676652) to submit sales
37
+ # data for a merchant.
38
+ #
39
+ # To load this service and instantiate a REST client:
40
+ #
41
+ # require "google/shopping/merchant/lfp/v1/lfp_sale_service/rest"
42
+ # client = ::Google::Shopping::Merchant::Lfp::V1::LfpSaleService::Rest::Client.new
43
+ #
44
+ module LfpSaleService
45
+ # Client for the REST transport
46
+ module Rest
47
+ end
48
+ end
49
+ end
50
+ end
51
+ end
52
+ end
53
+ end
54
+
55
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
56
+ require "google/shopping/merchant/lfp/v1/lfp_sale_service/rest/helpers" if ::File.file? helper_path