google-apis-merchantapi_products_v1beta 0.22.0 → 0.23.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: 7c88e68f1b6a930336902a1edb5c5d61e668c106ef5075e02c29cf8b0f5acb2b
4
- data.tar.gz: 0c4be4d9bb5b22db11fd9768c75c9c7702b4fecbeea12c24dd73b42697ce30bd
3
+ metadata.gz: 7b7c56b1ffc205d13b06d8000618c7d0b47e657117e17a6aeab5894d19207cec
4
+ data.tar.gz: 73e1f9ea56b5260acca83ef3e9556c7d52ec7e701cccb9429699f5d20f0006d8
5
5
  SHA512:
6
- metadata.gz: 554fd86214115acbca8b5bc400477eeb7d9f3e5fec7cebe3f50a0603f43b3b63c9e5ab51d43d73e2bd5b03d7aa634484f2079e73ae7f516de186469eecf7de7a
7
- data.tar.gz: dbbfe1f5bcedd7807308b76bf45e9fdc060a9c32a5bddf4e048201e995166872f965739aeefd0d34ce119aab75f8a180ba40c7082968943e1255f818d089197e
6
+ metadata.gz: fae6496326afc0ea1935cb8834df9ecb27cc1d7856af8a433f2e876e114fc9f8d2ff26e7cb3c25f407f7f65453f350a296ca61920619bac594cea1641e175991
7
+ data.tar.gz: '049ee40aaa6cd8bc841c4f0bc98941762f267cd0381d2677d420d3775628576cce425636dab541d87f7d331f1d060bbfc933b52b02b57fb2a065f12315da9073'
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-merchantapi_products_v1beta
2
2
 
3
+ ### v0.23.0 (2025-11-23)
4
+
5
+ * Regenerated from discovery document revision 20251118
6
+
3
7
  ### v0.22.0 (2025-11-16)
4
8
 
5
9
  * Regenerated from discovery document revision 20251109
@@ -1143,7 +1143,7 @@ module Google
1143
1143
  end
1144
1144
  end
1145
1145
 
1146
- # A message that represents loyalty program.
1146
+ # LINT.IfChange(LoyaltyProgram) A message that represents loyalty program.
1147
1147
  class LoyaltyProgram
1148
1148
  include Google::Apis::Core::Hashable
1149
1149
 
@@ -1510,14 +1510,31 @@ module Google
1510
1510
  # @return [String]
1511
1511
  attr_accessor :feed_label
1512
1512
 
1513
- # Identifier. The name of the product input. Format: `accounts/`account`/
1514
- # productInputs/`productinput`` where the last section `productinput` consists
1515
- # of: `content_language~feed_label~offer_id` example for product input name is `
1516
- # accounts/123/productInputs/en~US~sku123`. A legacy local product input name
1517
- # would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to
1518
- # the v1beta version, the `productInput` section consists of: `channel~
1519
- # content_language~feed_label~offer_id`, for example: `accounts/123/
1520
- # productInputs/online~en~US~sku123`.
1513
+ # Identifier. The name of the product. Format: `accounts/`account`/productInputs/
1514
+ # `productinput`` The `productinput` segment is a unique identifier for the
1515
+ # product. This identifier must be unique within a merchant account and
1516
+ # generally follows the structure: `content_language~feed_label~offer_id`.
1517
+ # Example: `en~US~sku123` For legacy local products, the structure is: `local~
1518
+ # content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The
1519
+ # format of the `productinput` segment in the URL is automatically detected by
1520
+ # the server, supporting two options: 1. **Encoded Format**: The ``productinput``
1521
+ # segment is an unpadded base64url encoded string (RFC 4648 Section 5). The
1522
+ # decoded string must result in the `content_language~feed_label~offer_id`
1523
+ # structure. This encoding MUST be used if any part of the product identifier (
1524
+ # like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To
1525
+ # represent the product ID `en~US~sku/123`, the ``productinput`` segment must be
1526
+ # the base64url encoding of this string, which is `ZW5-VVMtc2t1LzEyMw`. The full
1527
+ # resource name for the product would be `accounts/123/productinputs/ZW5-
1528
+ # VVMtc2t1LzEyMw`. 2. **Plain Format**: The ``productinput`` segment is the
1529
+ # tilde-separated string `content_language~feed_label~offer_id`. This format is
1530
+ # suitable only when `content_language`, `feed_label`, and `offer_id` do not
1531
+ # contain URL-problematic characters like `/`, `%`, or `~`. We recommend using
1532
+ # the **Encoded Format** for all product IDs to ensure correct parsing,
1533
+ # especially those containing special characters. The presence of tilde (`~`)
1534
+ # characters in the ``productinput`` segment is used to differentiate between
1535
+ # the two formats. Note: For calls to the v1beta version, the plain format is `
1536
+ # channel~content_language~feed_label~offer_id`, for example: `accounts/123/
1537
+ # productinputs/online~en~US~sku123`.
1521
1538
  # Corresponds to the JSON property `name`
1522
1539
  # @return [String]
1523
1540
  attr_accessor :name
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module MerchantapiProductsV1beta
18
18
  # Version of the google-apis-merchantapi_products_v1beta gem
19
- GEM_VERSION = "0.22.0"
19
+ GEM_VERSION = "0.23.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20251109"
25
+ REVISION = "20251118"
26
26
  end
27
27
  end
28
28
  end
@@ -55,24 +55,35 @@ module Google
55
55
  # updating, or deleting a product input, it may take several minutes before the
56
56
  # processed product can be retrieved.
57
57
  # @param [String] name
58
- # Required. The name of the product input resource to delete. Format: `accounts/`
59
- # account`/productInputs/`product`` where the last section `product` consists of:
60
- # `content_language~feed_label~offer_id` example for product name is `accounts/
61
- # 123/productInputs/en~US~sku123`.
58
+ # Required. The name of the product input to delete. Format: `accounts/`account`/
59
+ # productInputs/`productInput`` The `productInput` segment is a unique
60
+ # identifier for the product. This identifier must be unique within a merchant
61
+ # account and generally follows the structure: `content_language~feed_label~
62
+ # offer_id`. Example: `en~US~sku123` For legacy local products, the structure is:
63
+ # `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123`
64
+ # The format of the `productInput` segment in the URL is automatically detected
65
+ # by the server, supporting two options: 1. **Encoded Format**: The ``
66
+ # productInput`` segment is an unpadded base64url encoded string (RFC 4648
67
+ # Section 5). The decoded string must result in the `content_language~feed_label~
68
+ # offer_id` structure. This encoding MUST be used if any part of the product
69
+ # identifier (like `offer_id`) contains characters such as `/`, `%`, or `~`. *
70
+ # Example: To represent the product ID `en~US~sku/123`, the ``productInput``
71
+ # segment must be the base64url encoding of this string, which is `ZW5-
72
+ # VVMtc2t1LzEyMw`. The full resource name for the product would be `accounts/123/
73
+ # productInputs/ZW5-VVMtc2t1LzEyMw`. 2. **Plain Format**: The ``productInput``
74
+ # segment is the tilde-separated string `content_language~feed_label~offer_id`.
75
+ # This format is suitable only when `content_language`, `feed_label`, and `
76
+ # offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We
77
+ # recommend using the **Encoded Format** for all product IDs to ensure correct
78
+ # parsing, especially those containing special characters. The presence of tilde
79
+ # (`~`) characters in the ``productInput`` segment is used to differentiate
80
+ # between the two formats. Note: For calls to the v1beta version, the plain
81
+ # format is `channel~content_language~feed_label~offer_id`, for example: `
82
+ # accounts/123/productinputs/online~en~US~sku123`.
62
83
  # @param [String] data_source
63
84
  # Required. The primary or supplemental data source from which the product input
64
85
  # should be deleted. Format: `accounts/`account`/dataSources/`datasource``. For
65
86
  # example, `accounts/123456/dataSources/104628`.
66
- # @param [Boolean] product_id_base64_url_encoded
67
- # Optional. If true, the ``productInput`` in the `name` field of the request
68
- # will be interpreted as unpadded base64url-encoded and decoded during request
69
- # processing to match the decoded value. Default value is `false`. Use this if
70
- # your ``productInput`` contains special characters, such as forward slash `/`
71
- # or other characters that are unpadded base64url-encoded (as per RFC 7515:
72
- # https://datatracker.ietf.org/doc/html/rfc7515#section-2). Note that future
73
- # versions of the API will only accept unpadded base64url-encoded product ids,
74
- # so we strongly recommend proactively setting this to `true` and encoding the
75
- # product ids.
76
87
  # @param [String] fields
77
88
  # Selector specifying which fields to include in a partial response.
78
89
  # @param [String] quota_user
@@ -90,13 +101,12 @@ module Google
90
101
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
91
102
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
92
103
  # @raise [Google::Apis::AuthorizationError] Authorization is required
93
- def delete_account_product_input(name, data_source: nil, product_id_base64_url_encoded: nil, fields: nil, quota_user: nil, options: nil, &block)
104
+ def delete_account_product_input(name, data_source: nil, fields: nil, quota_user: nil, options: nil, &block)
94
105
  command = make_simple_command(:delete, 'products/v1beta/{+name}', options)
95
106
  command.response_representation = Google::Apis::MerchantapiProductsV1beta::Empty::Representation
96
107
  command.response_class = Google::Apis::MerchantapiProductsV1beta::Empty
97
108
  command.params['name'] = name unless name.nil?
98
109
  command.query['dataSource'] = data_source unless data_source.nil?
99
- command.query['productIdBase64UrlEncoded'] = product_id_base64_url_encoded unless product_id_base64_url_encoded.nil?
100
110
  command.query['fields'] = fields unless fields.nil?
101
111
  command.query['quotaUser'] = quota_user unless quota_user.nil?
102
112
  execute_or_queue_command(command, &block)
@@ -152,34 +162,42 @@ module Google
152
162
  execute_or_queue_command(command, &block)
153
163
  end
154
164
 
155
- # Updates the existing product input in your Merchant Center account. After
156
- # inserting, updating, or deleting a product input, it may take several minutes
157
- # before the processed product can be retrieved.
165
+ # Updates the existing product input in your Merchant Center account. The name
166
+ # of the product input to update is taken from the `name` field within the `
167
+ # ProductInput` resource. After inserting, updating, or deleting a product input,
168
+ # it may take several minutes before the processed product can be retrieved.
158
169
  # @param [String] name
159
- # Identifier. The name of the product input. Format: `accounts/`account`/
160
- # productInputs/`productinput`` where the last section `productinput` consists
161
- # of: `content_language~feed_label~offer_id` example for product input name is `
162
- # accounts/123/productInputs/en~US~sku123`. A legacy local product input name
163
- # would be `accounts/123/productInputs/local~en~US~sku123`. Note: For calls to
164
- # the v1beta version, the `productInput` section consists of: `channel~
165
- # content_language~feed_label~offer_id`, for example: `accounts/123/
166
- # productInputs/online~en~US~sku123`.
170
+ # Identifier. The name of the product. Format: `accounts/`account`/productInputs/
171
+ # `productinput`` The `productinput` segment is a unique identifier for the
172
+ # product. This identifier must be unique within a merchant account and
173
+ # generally follows the structure: `content_language~feed_label~offer_id`.
174
+ # Example: `en~US~sku123` For legacy local products, the structure is: `local~
175
+ # content_language~feed_label~offer_id`. Example: `local~en~US~sku123` The
176
+ # format of the `productinput` segment in the URL is automatically detected by
177
+ # the server, supporting two options: 1. **Encoded Format**: The ``productinput``
178
+ # segment is an unpadded base64url encoded string (RFC 4648 Section 5). The
179
+ # decoded string must result in the `content_language~feed_label~offer_id`
180
+ # structure. This encoding MUST be used if any part of the product identifier (
181
+ # like `offer_id`) contains characters such as `/`, `%`, or `~`. * Example: To
182
+ # represent the product ID `en~US~sku/123`, the ``productinput`` segment must be
183
+ # the base64url encoding of this string, which is `ZW5-VVMtc2t1LzEyMw`. The full
184
+ # resource name for the product would be `accounts/123/productinputs/ZW5-
185
+ # VVMtc2t1LzEyMw`. 2. **Plain Format**: The ``productinput`` segment is the
186
+ # tilde-separated string `content_language~feed_label~offer_id`. This format is
187
+ # suitable only when `content_language`, `feed_label`, and `offer_id` do not
188
+ # contain URL-problematic characters like `/`, `%`, or `~`. We recommend using
189
+ # the **Encoded Format** for all product IDs to ensure correct parsing,
190
+ # especially those containing special characters. The presence of tilde (`~`)
191
+ # characters in the ``productinput`` segment is used to differentiate between
192
+ # the two formats. Note: For calls to the v1beta version, the plain format is `
193
+ # channel~content_language~feed_label~offer_id`, for example: `accounts/123/
194
+ # productinputs/online~en~US~sku123`.
167
195
  # @param [Google::Apis::MerchantapiProductsV1beta::ProductInput] product_input_object
168
196
  # @param [String] data_source
169
197
  # Required. The primary or supplemental product data source where `data_source`
170
198
  # name identifies the product input to be updated. Only API data sources are
171
199
  # supported. Format: `accounts/`account`/dataSources/`datasource``. For example,
172
200
  # `accounts/123456/dataSources/104628`.
173
- # @param [Boolean] product_id_base64_url_encoded
174
- # Optional. If true, the ``productInput`` in the `name` field of the request
175
- # will be interpreted as unpadded base64url-encoded and decoded during request
176
- # processing to match the decoded value. Default value is `false`. Use this if
177
- # your ``productInput`` contains special characters, such as forward slash `/`
178
- # or other characters that are unpadded base64url-encoded (as per RFC 7515:
179
- # https://datatracker.ietf.org/doc/html/rfc7515#section-2). Note that future
180
- # versions of the API will only accept unpadded base64url-encoded product ids,
181
- # so we strongly recommend proactively setting this to `true` and encoding the
182
- # product ids.
183
201
  # @param [String] update_mask
184
202
  # Optional. The list of product attributes to be updated. If the update mask is
185
203
  # omitted, then it is treated as implied field mask equivalent to all fields
@@ -206,7 +224,7 @@ module Google
206
224
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
207
225
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
208
226
  # @raise [Google::Apis::AuthorizationError] Authorization is required
209
- def patch_account_product_input(name, product_input_object = nil, data_source: nil, product_id_base64_url_encoded: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
227
+ def patch_account_product_input(name, product_input_object = nil, data_source: nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
210
228
  command = make_simple_command(:patch, 'products/v1beta/{+name}', options)
211
229
  command.request_representation = Google::Apis::MerchantapiProductsV1beta::ProductInput::Representation
212
230
  command.request_object = product_input_object
@@ -214,7 +232,6 @@ module Google
214
232
  command.response_class = Google::Apis::MerchantapiProductsV1beta::ProductInput
215
233
  command.params['name'] = name unless name.nil?
216
234
  command.query['dataSource'] = data_source unless data_source.nil?
217
- command.query['productIdBase64UrlEncoded'] = product_id_base64_url_encoded unless product_id_base64_url_encoded.nil?
218
235
  command.query['updateMask'] = update_mask unless update_mask.nil?
219
236
  command.query['fields'] = fields unless fields.nil?
220
237
  command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -225,23 +242,30 @@ module Google
225
242
  # inserting, updating, or deleting a product input, it may take several minutes
226
243
  # before the updated final product can be retrieved.
227
244
  # @param [String] name
228
- # Required. The name of the product to retrieve. Format: `accounts/`account`/
229
- # products/`product`` where the last section `product` consists of: `
230
- # content_language~feed_label~offer_id` example for product name is `accounts/
231
- # 123/products/en~US~sku123`. A legacy local product name would be `accounts/123/
232
- # products/local~en~US~sku123`. Note: For calls to the v1beta version, the `
233
- # product` section consists of: `channel~content_language~feed_label~offer_id`,
234
- # for example: `accounts/123/products/online~en~US~sku123`.
235
- # @param [Boolean] product_id_base64_url_encoded
236
- # Optional. If true, the ``product`` in the `name` field of the request will be
237
- # interpreted as unpadded base64url-encoded and decoded during request
238
- # processing to match the decoded value. Default value is `false`. Use this if
239
- # your ``product`` contains special characters, such as forward slash `/` or
240
- # other characters that are unpadded base64url-encoded (as per RFC 7515: https://
241
- # datatracker.ietf.org/doc/html/rfc7515#section-2). Note that future versions of
242
- # the API will only accept unpadded base64url-encoded product ids, so we
243
- # strongly recommend proactively setting this to `true` and encoding the product
244
- # ids.
245
+ # Required. The name of the product. Format: `accounts/`account`/products/`
246
+ # product`` The ``product`` segment is a unique identifier for the product. This
247
+ # identifier must be unique within a merchant account and generally follows the
248
+ # structure: `content_language~feed_label~offer_id`. Example: `en~US~sku123` For
249
+ # legacy local products, the structure is: `local~content_language~feed_label~
250
+ # offer_id`. Example: `local~en~US~sku123` The format of the ``product`` segment
251
+ # in the URL is automatically detected by the server, supporting two options: 1.
252
+ # **Encoded Format**: The ``product`` segment is an unpadded base64url encoded
253
+ # string (RFC 4648 Section 5). The decoded string must result in the `
254
+ # content_language~feed_label~offer_id` structure. This encoding MUST be used if
255
+ # any part of the product identifier (like `offer_id`) contains characters such
256
+ # as `/`, `%`, or `~`. * Example: To represent the product ID `en~US~sku/123`,
257
+ # the ``product`` segment must be the base64url encoding of this string, which
258
+ # is `ZW5-VVMtc2t1LzEyMw`. The full resource name for the product would be `
259
+ # accounts/123/products/ZW5-VVMtc2t1LzEyMw`. 2. **Plain Format**: The ``product``
260
+ # segment is the tilde-separated string `content_language~feed_label~offer_id`.
261
+ # This format is suitable only when `content_language`, `feed_label`, and `
262
+ # offer_id` do not contain URL-problematic characters like `/`, `%`, or `~`. We
263
+ # recommend using the **Encoded Format** for all product IDs to ensure correct
264
+ # parsing, especially those containing special characters. The presence of tilde
265
+ # (`~`) characters in the ``product`` segment is used to differentiate between
266
+ # the two formats. Note: For calls to the v1beta version, the plain format is `
267
+ # channel~content_language~feed_label~offer_id`, for example: `accounts/123/
268
+ # products/online~en~US~sku123`.
245
269
  # @param [String] fields
246
270
  # Selector specifying which fields to include in a partial response.
247
271
  # @param [String] quota_user
@@ -259,12 +283,11 @@ module Google
259
283
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
260
284
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
261
285
  # @raise [Google::Apis::AuthorizationError] Authorization is required
262
- def get_account_product(name, product_id_base64_url_encoded: nil, fields: nil, quota_user: nil, options: nil, &block)
286
+ def get_account_product(name, fields: nil, quota_user: nil, options: nil, &block)
263
287
  command = make_simple_command(:get, 'products/v1beta/{+name}', options)
264
288
  command.response_representation = Google::Apis::MerchantapiProductsV1beta::Product::Representation
265
289
  command.response_class = Google::Apis::MerchantapiProductsV1beta::Product
266
290
  command.params['name'] = name unless name.nil?
267
- command.query['productIdBase64UrlEncoded'] = product_id_base64_url_encoded unless product_id_base64_url_encoded.nil?
268
291
  command.query['fields'] = fields unless fields.nil?
269
292
  command.query['quotaUser'] = quota_user unless quota_user.nil?
270
293
  execute_or_queue_command(command, &block)
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-merchantapi_products_v1beta
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.22.0
4
+ version: 0.23.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -57,7 +57,7 @@ licenses:
57
57
  metadata:
58
58
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
59
59
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-merchantapi_products_v1beta/CHANGELOG.md
60
- documentation_uri: https://googleapis.dev/ruby/google-apis-merchantapi_products_v1beta/v0.22.0
60
+ documentation_uri: https://googleapis.dev/ruby/google-apis-merchantapi_products_v1beta/v0.23.0
61
61
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-merchantapi_products_v1beta
62
62
  rdoc_options: []
63
63
  require_paths: