docs: A comment for field name in message .google.shopping.merchant.products.v1.LocalInventory is changed (#33825)

* docs: A comment for field `name` in message `.google.shopping.merchant.products.v1.LocalInventory` is changed
docs: A comment for field `name` in message `.google.shopping.merchant.products.v1.RegionalInventory` is changed
feat: a new field `base64_encoded_name` is added to the `LocalInventory` message
feat: new field `base64_encoded_name` is added to the `RegionalInventory` message

PiperOrigin-RevId: 897575741

Source-Link: googleapis/googleapis@6db5d2e

Source-Link: googleapis/googleapis-gen@6203224
Copy-Tag: eyJwIjoiZ29vZ2xlLXNob3BwaW5nLW1lcmNoYW50LWludmVudG9yaWVzLXYxLy5Pd2xCb3QueWFtbCIsImgiOiI2MjAzMjI0MDMwM2ExOTcwN2I0Y2UwYWRlNjAyOGI1OGVmOWY3NGNjIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google-shopping-merchant-inventories-v1/lib/google/shopping/merchant/inventories/v1/inventories_common_pb.rb

@@ -216,6 +216,36 @@ def logger
               #     Required. The `name` of the parent product to list local inventories for.
               #     Format:
               #     `accounts/{account}/products/{product}`
+              #
+              #     The `{product}` segment is a unique identifier for the product.
+              #     This identifier must be unique within a merchant account and generally
+              #     follows the structure: `content_language~feed_label~offer_id`. Example:
+              #     `en~US~sku123` For legacy local products, the structure is:
+              #     `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123`
+              #
+              #     The format of the `{product}` segment in the URL is automatically detected
+              #     by the server, supporting two options:
+              #
+              #     1.  **Encoded Format**: The `{product}` segment is an unpadded base64url
+              #         encoded string (RFC 4648 Section 5). The decoded string must result
+              #         in the `content_language~feed_label~offer_id` structure. This encoding
+              #         MUST be used if any part of the product identifier (like `offer_id`)
+              #         contains characters such as `/`, `%`, or `~`.
+              #         *   Example: To represent the product ID `en~US~sku/123`, the
+              #             `{product}` segment must be the unpadded base64url encoding of this
+              #             string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name
+              #             for the product would be
+              #             `accounts/123/products/ZW5-VVN-c2t1LzEyMw`.
+              #
+              #     2.  **Plain Format**: The `{product}` segment is the tilde-separated string
+              #         `content_language~feed_label~offer_id`. This format is suitable only
+              #         when `content_language`, `feed_label`, and `offer_id` do not contain
+              #         URL-problematic characters like `/`, `%`, or `~`.
+              #
+              #     We recommend using the **Encoded Format** for all product IDs to ensure
+              #     correct parsing, especially those containing special characters. The
+              #     presence of tilde (`~`) characters in the `{product}` segment is used to
+              #     differentiate between the two formats.
               #   @param page_size [::Integer]
               #     The maximum number of `LocalInventory` resources for the given
               #     product to return. The service returns fewer than this value if the number
@@ -330,6 +360,36 @@ def list_local_inventories request, options = nil
               #   @param parent [::String]
               #     Required. The account and product where this inventory will be inserted.
               #     Format: `accounts/{account}/products/{product}`
+              #
+              #     The `{product}` segment is a unique identifier for the product.
+              #     This identifier must be unique within a merchant account and generally
+              #     follows the structure: `content_language~feed_label~offer_id`. Example:
+              #     `en~US~sku123` For legacy local products, the structure is:
+              #     `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123`
+              #
+              #     The format of the `{product}` segment in the URL is automatically detected
+              #     by the server, supporting two options:
+              #
+              #     1.  **Encoded Format**: The `{product}` segment is an unpadded base64url
+              #         encoded string (RFC 4648 Section 5). The decoded string must result
+              #         in the `content_language~feed_label~offer_id` structure. This encoding
+              #         MUST be used if any part of the product identifier (like `offer_id`)
+              #         contains characters such as `/`, `%`, or `~`.
+              #         *   Example: To represent the product ID `en~US~sku/123`, the
+              #             `{product}` segment must be the unpadded base64url encoding of this
+              #             string, which is `ZW5-VVN-c2t1LzEyMw`. The full resource name
+              #             for the product would be
+              #             `accounts/123/products/ZW5-VVN-c2t1LzEyMw`.
+              #
+              #     2.  **Plain Format**: The `{product}` segment is the tilde-separated string
+              #         `content_language~feed_label~offer_id`. This format is suitable only
+              #         when `content_language`, `feed_label`, and `offer_id` do not contain
+              #         URL-problematic characters like `/`, `%`, or `~`.
+              #
+              #     We recommend using the **Encoded Format** for all product IDs to ensure
+              #     correct parsing, especially those containing special characters. The
+              #     presence of tilde (`~`) characters in the `{product}` segment is used to
+              #     differentiate between the two formats.
               #   @param local_inventory [::Google::Shopping::Merchant::Inventories::V1::LocalInventory, ::Hash]
               #     Required. Local inventory information of the product. If the product
               #     already has a `LocalInventory` resource for the same `storeCode`, full
@@ -426,6 +486,37 @@ def insert_local_inventory request, options = nil
               #     Format:
               #     `accounts/{account}/products/{product}/localInventories/{store_code}`
               #
+              #     The `{product}` segment is a unique identifier for the product.
+              #     This identifier must be unique within a merchant account and generally
+              #     follows the structure: `content_language~feed_label~offer_id`. Example:
+              #     `en~US~sku123` For legacy local products, the structure is:
+              #     `local~content_language~feed_label~offer_id`. Example: `local~en~US~sku123`
+              #
+              #     The format of the `{product}` segment in the URL is automatically detected
+              #     by the server, supporting two options:
+              #
+              #     1.  **Encoded Format**: The `{product}` segment is an unpadded base64url
+              #         encoded string (RFC 4648 Section 5). The decoded string must result
+              #         in the `content_language~feed_label~offer_id` structure. This encoding
+              #         MUST be used if any part of the product identifier (like `offer_id`)
+              #         contains characters such as `/`, `%`, or `~`.
+              #         *   Example: To represent the product ID `en~US~sku/123` for
+              #             `store_code` "store123", the `{product}` segment must be the
+              #             unpadded base64url encoding of this string, which is
+              #             `ZW5-VVN-c2t1LzEyMw`. The full resource name for the local
+              #             inventory would be
+              #             `accounts/123/products/ZW5-VVN-c2t1LzEyMw/localInventories/store123`.
+              #
+              #     2.  **Plain Format**: The `{product}` segment is the tilde-separated string
+              #         `content_language~feed_label~offer_id`. This format is suitable only
+              #         when `content_language`, `feed_label`, and `offer_id` do not contain
+              #         URL-problematic characters like `/`, `%`, or `~`.
+              #
+              #     We recommend using the **Encoded Format** for all product IDs to ensure
+              #     correct parsing, especially those containing special characters. The
+              #     presence of tilde (`~`) characters in the `{product}` segment is used to
+              #     differentiate between the two formats.
+              #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Protobuf::Empty]
               # @yieldparam operation [::GRPC::ActiveCall::Operation]