google-shopping-merchant-order_tracking-v1beta 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 (27) 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/order_tracking/v1beta/order_tracking_signals_service/client.rb +467 -0
  6. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/credentials.rb +49 -0
  7. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/paths.rb +49 -0
  8. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest/client.rb +434 -0
  9. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest/service_stub.rb +145 -0
  10. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest.rb +54 -0
  11. data/lib/google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service.rb +57 -0
  12. data/lib/google/shopping/merchant/order_tracking/v1beta/rest.rb +39 -0
  13. data/lib/google/shopping/merchant/order_tracking/v1beta/version.rb +7 -2
  14. data/lib/google/shopping/merchant/order_tracking/v1beta.rb +47 -0
  15. data/lib/google/shopping/merchant/ordertracking/v1beta/order_tracking_signals_pb.rb +58 -0
  16. data/lib/google/shopping/merchant/ordertracking/v1beta/order_tracking_signals_services_pb.rb +47 -0
  17. data/lib/google-shopping-merchant-order_tracking-v1beta.rb +21 -0
  18. data/proto_docs/README.md +4 -0
  19. data/proto_docs/google/api/client.rb +473 -0
  20. data/proto_docs/google/api/field_behavior.rb +85 -0
  21. data/proto_docs/google/api/launch_stage.rb +71 -0
  22. data/proto_docs/google/api/resource.rb +227 -0
  23. data/proto_docs/google/protobuf/duration.rb +98 -0
  24. data/proto_docs/google/shopping/merchant/ordertracking/v1beta/order_tracking_signals.rb +211 -0
  25. data/proto_docs/google/shopping/type/types.rb +210 -0
  26. data/proto_docs/google/type/datetime.rb +103 -0
  27. metadata +92 -10
@@ -0,0 +1,434 @@
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/ordertracking/v1beta/order_tracking_signals_pb"
21
+ require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest/service_stub"
22
+
23
+ module Google
24
+ module Shopping
25
+ module Merchant
26
+ module OrderTracking
27
+ module V1beta
28
+ module OrderTrackingSignalsService
29
+ module Rest
30
+ ##
31
+ # REST client for the OrderTrackingSignalsService service.
32
+ #
33
+ # Service to serve order tracking signals public API.
34
+ #
35
+ class Client
36
+ # @private
37
+ API_VERSION = ""
38
+
39
+ # @private
40
+ DEFAULT_ENDPOINT_TEMPLATE = "merchantapi.$UNIVERSE_DOMAIN$"
41
+
42
+ include Paths
43
+
44
+ # @private
45
+ attr_reader :order_tracking_signals_service_stub
46
+
47
+ ##
48
+ # Configure the OrderTrackingSignalsService Client class.
49
+ #
50
+ # See {::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client::Configuration}
51
+ # for a description of the configuration fields.
52
+ #
53
+ # @example
54
+ #
55
+ # # Modify the configuration for all OrderTrackingSignalsService clients
56
+ # ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.configure do |config|
57
+ # config.timeout = 10.0
58
+ # end
59
+ #
60
+ # @yield [config] Configure the Client client.
61
+ # @yieldparam config [Client::Configuration]
62
+ #
63
+ # @return [Client::Configuration]
64
+ #
65
+ def self.configure
66
+ @configure ||= begin
67
+ namespace = ["Google", "Shopping", "Merchant", "OrderTracking", "V1beta"]
68
+ parent_config = while namespace.any?
69
+ parent_name = namespace.join "::"
70
+ parent_const = const_get parent_name
71
+ break parent_const.configure if parent_const.respond_to? :configure
72
+ namespace.pop
73
+ end
74
+ default_config = Client::Configuration.new parent_config
75
+
76
+ default_config.timeout = 60.0
77
+ default_config.retry_policy = {
78
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [14]
79
+ }
80
+
81
+ default_config
82
+ end
83
+ yield @configure if block_given?
84
+ @configure
85
+ end
86
+
87
+ ##
88
+ # Configure the OrderTrackingSignalsService Client instance.
89
+ #
90
+ # The configuration is set to the derived mode, meaning that values can be changed,
91
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
92
+ # should be made on {Client.configure}.
93
+ #
94
+ # See {::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client::Configuration}
95
+ # for a description of the configuration fields.
96
+ #
97
+ # @yield [config] Configure the Client client.
98
+ # @yieldparam config [Client::Configuration]
99
+ #
100
+ # @return [Client::Configuration]
101
+ #
102
+ def configure
103
+ yield @config if block_given?
104
+ @config
105
+ end
106
+
107
+ ##
108
+ # The effective universe domain
109
+ #
110
+ # @return [String]
111
+ #
112
+ def universe_domain
113
+ @order_tracking_signals_service_stub.universe_domain
114
+ end
115
+
116
+ ##
117
+ # Create a new OrderTrackingSignalsService REST client object.
118
+ #
119
+ # @example
120
+ #
121
+ # # Create a client using the default configuration
122
+ # client = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.new
123
+ #
124
+ # # Create a client using a custom configuration
125
+ # client = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.new do |config|
126
+ # config.timeout = 10.0
127
+ # end
128
+ #
129
+ # @yield [config] Configure the OrderTrackingSignalsService client.
130
+ # @yieldparam config [Client::Configuration]
131
+ #
132
+ def initialize
133
+ # Create the configuration object
134
+ @config = Configuration.new Client.configure
135
+
136
+ # Yield the configuration if needed
137
+ yield @config if block_given?
138
+
139
+ # Create credentials
140
+ credentials = @config.credentials
141
+ # Use self-signed JWT if the endpoint is unchanged from default,
142
+ # but only if the default endpoint does not have a region prefix.
143
+ enable_self_signed_jwt = @config.endpoint.nil? ||
144
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
145
+ !@config.endpoint.split(".").first.include?("-"))
146
+ credentials ||= Credentials.default scope: @config.scope,
147
+ enable_self_signed_jwt: enable_self_signed_jwt
148
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
149
+ credentials = Credentials.new credentials, scope: @config.scope
150
+ end
151
+
152
+ @quota_project_id = @config.quota_project
153
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
154
+
155
+ @order_tracking_signals_service_stub = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::ServiceStub.new(
156
+ endpoint: @config.endpoint,
157
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
158
+ universe_domain: @config.universe_domain,
159
+ credentials: credentials,
160
+ logger: @config.logger
161
+ )
162
+
163
+ @order_tracking_signals_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
+ @order_tracking_signals_service_stub.logger
181
+ end
182
+
183
+ # Service calls
184
+
185
+ ##
186
+ # Creates new order tracking signal.
187
+ #
188
+ # @overload create_order_tracking_signal(request, options = nil)
189
+ # Pass arguments to `create_order_tracking_signal` via a request object, either of type
190
+ # {::Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest} or an equivalent Hash.
191
+ #
192
+ # @param request [::Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest, ::Hash]
193
+ # A request object representing the call parameters. Required. To specify no
194
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
195
+ # @param options [::Gapic::CallOptions, ::Hash]
196
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
197
+ #
198
+ # @overload create_order_tracking_signal(parent: nil, order_tracking_signal: nil)
199
+ # Pass arguments to `create_order_tracking_signal` via keyword arguments. Note that at
200
+ # least one keyword argument is required. To specify no parameters, or to keep all
201
+ # the default parameter values, pass an empty Hash as a request object (see above).
202
+ #
203
+ # @param parent [::String]
204
+ # Required. The account of the business for which the order signal is
205
+ # created. Format: accounts/\\{account}
206
+ # @param order_tracking_signal [::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal, ::Hash]
207
+ # Required. The order signal to be created.
208
+ # @yield [result, operation] Access the result along with the TransportOperation object
209
+ # @yieldparam result [::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal]
210
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
211
+ #
212
+ # @return [::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal]
213
+ #
214
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
215
+ #
216
+ # @example Basic example
217
+ # require "google/shopping/merchant/order_tracking/v1beta"
218
+ #
219
+ # # Create a client object. The client can be reused for multiple calls.
220
+ # client = Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.new
221
+ #
222
+ # # Create a request. To set request fields, pass in keyword arguments.
223
+ # request = Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest.new
224
+ #
225
+ # # Call the create_order_tracking_signal method.
226
+ # result = client.create_order_tracking_signal request
227
+ #
228
+ # # The returned object is of type Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal.
229
+ # p result
230
+ #
231
+ def create_order_tracking_signal request, options = nil
232
+ raise ::ArgumentError, "request must be provided" if request.nil?
233
+
234
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest
235
+
236
+ # Converts hash and nil to an options object
237
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
238
+
239
+ # Customize the options with defaults
240
+ call_metadata = @config.rpcs.create_order_tracking_signal.metadata.to_h
241
+
242
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
243
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
244
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
245
+ gapic_version: ::Google::Shopping::Merchant::OrderTracking::V1beta::VERSION,
246
+ transports_version_send: [:rest]
247
+
248
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
249
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
250
+
251
+ options.apply_defaults timeout: @config.rpcs.create_order_tracking_signal.timeout,
252
+ metadata: call_metadata,
253
+ retry_policy: @config.rpcs.create_order_tracking_signal.retry_policy
254
+
255
+ options.apply_defaults timeout: @config.timeout,
256
+ metadata: @config.metadata,
257
+ retry_policy: @config.retry_policy
258
+
259
+ @order_tracking_signals_service_stub.create_order_tracking_signal request, options do |result, operation|
260
+ yield result, operation if block_given?
261
+ end
262
+ rescue ::Gapic::Rest::Error => e
263
+ raise ::Google::Cloud::Error.from_error(e)
264
+ end
265
+
266
+ ##
267
+ # Configuration class for the OrderTrackingSignalsService REST API.
268
+ #
269
+ # This class represents the configuration for OrderTrackingSignalsService REST,
270
+ # providing control over timeouts, retry behavior, logging, transport
271
+ # parameters, and other low-level controls. Certain parameters can also be
272
+ # applied individually to specific RPCs. See
273
+ # {::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client::Configuration::Rpcs}
274
+ # for a list of RPCs that can be configured independently.
275
+ #
276
+ # Configuration can be applied globally to all clients, or to a single client
277
+ # on construction.
278
+ #
279
+ # @example
280
+ #
281
+ # # Modify the global config, setting the timeout for
282
+ # # create_order_tracking_signal to 20 seconds,
283
+ # # and all remaining timeouts to 10 seconds.
284
+ # ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.configure do |config|
285
+ # config.timeout = 10.0
286
+ # config.rpcs.create_order_tracking_signal.timeout = 20.0
287
+ # end
288
+ #
289
+ # # Apply the above configuration only to a new client.
290
+ # client = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.new do |config|
291
+ # config.timeout = 10.0
292
+ # config.rpcs.create_order_tracking_signal.timeout = 20.0
293
+ # end
294
+ #
295
+ # @!attribute [rw] endpoint
296
+ # A custom service endpoint, as a hostname or hostname:port. The default is
297
+ # nil, indicating to use the default endpoint in the current universe domain.
298
+ # @return [::String,nil]
299
+ # @!attribute [rw] credentials
300
+ # Credentials to send with calls. You may provide any of the following types:
301
+ # * (`String`) The path to a service account key file in JSON format
302
+ # * (`Hash`) A service account key as a Hash
303
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
304
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
305
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
306
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
307
+ # * (`nil`) indicating no credentials
308
+ #
309
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
310
+ # external source for authentication to Google Cloud, you must validate it before
311
+ # providing it to a Google API client library. Providing an unvalidated credential
312
+ # configuration to Google APIs can compromise the security of your systems and data.
313
+ # For more information, refer to [Validate credential configurations from external
314
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
315
+ # @return [::Object]
316
+ # @!attribute [rw] scope
317
+ # The OAuth scopes
318
+ # @return [::Array<::String>]
319
+ # @!attribute [rw] lib_name
320
+ # The library name as recorded in instrumentation and logging
321
+ # @return [::String]
322
+ # @!attribute [rw] lib_version
323
+ # The library version as recorded in instrumentation and logging
324
+ # @return [::String]
325
+ # @!attribute [rw] timeout
326
+ # The call timeout in seconds.
327
+ # @return [::Numeric]
328
+ # @!attribute [rw] metadata
329
+ # Additional headers to be sent with the call.
330
+ # @return [::Hash{::Symbol=>::String}]
331
+ # @!attribute [rw] retry_policy
332
+ # The retry policy. The value is a hash with the following keys:
333
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
334
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
335
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
336
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
337
+ # trigger a retry.
338
+ # @return [::Hash]
339
+ # @!attribute [rw] quota_project
340
+ # A separate project against which to charge quota.
341
+ # @return [::String]
342
+ # @!attribute [rw] universe_domain
343
+ # The universe domain within which to make requests. This determines the
344
+ # default endpoint URL. The default value of nil uses the environment
345
+ # universe (usually the default "googleapis.com" universe).
346
+ # @return [::String,nil]
347
+ # @!attribute [rw] logger
348
+ # A custom logger to use for request/response debug logging, or the value
349
+ # `:default` (the default) to construct a default logger, or `nil` to
350
+ # explicitly disable logging.
351
+ # @return [::Logger,:default,nil]
352
+ #
353
+ class Configuration
354
+ extend ::Gapic::Config
355
+
356
+ # @private
357
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
358
+ DEFAULT_ENDPOINT = "merchantapi.googleapis.com"
359
+
360
+ config_attr :endpoint, nil, ::String, nil
361
+ config_attr :credentials, nil do |value|
362
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
363
+ allowed.any? { |klass| klass === value }
364
+ end
365
+ config_attr :scope, nil, ::String, ::Array, nil
366
+ config_attr :lib_name, nil, ::String, nil
367
+ config_attr :lib_version, nil, ::String, nil
368
+ config_attr :timeout, nil, ::Numeric, nil
369
+ config_attr :metadata, nil, ::Hash, nil
370
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
371
+ config_attr :quota_project, nil, ::String, nil
372
+ config_attr :universe_domain, nil, ::String, nil
373
+ config_attr :logger, :default, ::Logger, nil, :default
374
+
375
+ # @private
376
+ def initialize parent_config = nil
377
+ @parent_config = parent_config unless parent_config.nil?
378
+
379
+ yield self if block_given?
380
+ end
381
+
382
+ ##
383
+ # Configurations for individual RPCs
384
+ # @return [Rpcs]
385
+ #
386
+ def rpcs
387
+ @rpcs ||= begin
388
+ parent_rpcs = nil
389
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
390
+ Rpcs.new parent_rpcs
391
+ end
392
+ end
393
+
394
+ ##
395
+ # Configuration RPC class for the OrderTrackingSignalsService API.
396
+ #
397
+ # Includes fields providing the configuration for each RPC in this service.
398
+ # Each configuration object is of type `Gapic::Config::Method` and includes
399
+ # the following configuration fields:
400
+ #
401
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
402
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
403
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
404
+ # include the following keys:
405
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
406
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
407
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
408
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
409
+ # trigger a retry.
410
+ #
411
+ class Rpcs
412
+ ##
413
+ # RPC-specific configuration for `create_order_tracking_signal`
414
+ # @return [::Gapic::Config::Method]
415
+ #
416
+ attr_reader :create_order_tracking_signal
417
+
418
+ # @private
419
+ def initialize parent_rpcs = nil
420
+ create_order_tracking_signal_config = parent_rpcs.create_order_tracking_signal if parent_rpcs.respond_to? :create_order_tracking_signal
421
+ @create_order_tracking_signal = ::Gapic::Config::Method.new create_order_tracking_signal_config
422
+
423
+ yield self if block_given?
424
+ end
425
+ end
426
+ end
427
+ end
428
+ end
429
+ end
430
+ end
431
+ end
432
+ end
433
+ end
434
+ 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/ordertracking/v1beta/order_tracking_signals_pb"
20
+
21
+ module Google
22
+ module Shopping
23
+ module Merchant
24
+ module OrderTracking
25
+ module V1beta
26
+ module OrderTrackingSignalsService
27
+ module Rest
28
+ ##
29
+ # REST service stub for the OrderTrackingSignalsService 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 create_order_tracking_signal REST call
79
+ #
80
+ # @param request_pb [::Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest]
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::OrderTracking::V1beta::OrderTrackingSignal]
87
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
88
+ #
89
+ # @return [::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal]
90
+ # A result object deserialized from the server's reply
91
+ def create_order_tracking_signal 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_create_order_tracking_signal_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: "create_order_tracking_signal",
107
+ options: options
108
+ )
109
+ operation = ::Gapic::Rest::TransportOperation.new response
110
+ result = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignal.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 create_order_tracking_signal REST call
121
+ #
122
+ # @param request_pb [::Google::Shopping::Merchant::OrderTracking::V1beta::CreateOrderTrackingSignalRequest]
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_create_order_tracking_signal_request request_pb
127
+ transcoder = Gapic::Rest::GrpcTranscoder.new
128
+ .with_bindings(
129
+ uri_method: :post,
130
+ uri_template: "/ordertracking/v1beta/{parent}/ordertrackingsignals",
131
+ body: "order_tracking_signal",
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,54 @@
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/order_tracking/v1beta/version"
24
+
25
+ require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/credentials"
26
+ require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/paths"
27
+ require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest/client"
28
+
29
+ module Google
30
+ module Shopping
31
+ module Merchant
32
+ module OrderTracking
33
+ module V1beta
34
+ ##
35
+ # Service to serve order tracking signals public API.
36
+ #
37
+ # To load this service and instantiate a REST client:
38
+ #
39
+ # require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest"
40
+ # client = ::Google::Shopping::Merchant::OrderTracking::V1beta::OrderTrackingSignalsService::Rest::Client.new
41
+ #
42
+ module OrderTrackingSignalsService
43
+ # Client for the REST transport
44
+ module Rest
45
+ end
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
51
+ end
52
+
53
+ helper_path = ::File.join __dir__, "rest", "helpers.rb"
54
+ require "google/shopping/merchant/order_tracking/v1beta/order_tracking_signals_service/rest/helpers" if ::File.file? helper_path