feat: Add new method signature parent,online_return_policy to CreateOnlineReturnPolicy (#30431)

docs: Minor updates

Author: gcf-owl-bot[bot]

google-shopping-merchant-accounts-v1beta/lib/google/shopping/merchant/accounts/v1beta/online_return_policy_pb.rb

@@ -405,10 +405,10 @@ def list_online_return_policies request, options = nil
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param parent [::String]
-              #     Required. The merchant account for which to create a return policy.
+              #     Required. The merchant account for which the return policy will be created.
               #     Format: `accounts/{account}`
               #   @param online_return_policy [::Google::Shopping::Merchant::Accounts::V1beta::OnlineReturnPolicy, ::Hash]
-              #     Required. The return policy to create.
+              #     Required. The return policy object to create.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Shopping::Merchant::Accounts::V1beta::OnlineReturnPolicy]
@@ -493,8 +493,24 @@ def create_online_return_policy request, options = nil
               #   the default parameter values, pass an empty Hash as a request object (see above).
               #
               #   @param online_return_policy [::Google::Shopping::Merchant::Accounts::V1beta::OnlineReturnPolicy, ::Hash]
-              #     Required. The return policy to update.
+              #     Required. The online return policy to update.
+              #     The online return policy's `name` field is used to identify the
+              #     online return policy to be updated.
               #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
+              #     Optional. List of fields being updated.
+              #
+              #     The following fields are supported (in both `snake_case` and
+              #     `lowerCamelCase`):
+              #
+              #     - `accept_defective_only`
+              #     - `accept_exchange`
+              #     - `item_conditions`
+              #     - `policy`
+              #     - `process_refund_days`
+              #     - `restocking_fee`
+              #     - `return_methods`
+              #     - `return_policy_uri`
+              #     - `return_shipping_fee`
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Shopping::Merchant::Accounts::V1beta::OnlineReturnPolicy]
@@ -561,7 +577,7 @@ def update_online_return_policy request, options = nil
               end
 
               ##
-              # Deletes an existing return policy for a given merchant.
+              # Deletes an existing return policy.
               #
               # @overload delete_online_return_policy(request, options = nil)
               #   Pass arguments to `delete_online_return_policy` via a request object, either of type