feat(storage-control): add Ruby delete_folder_recursive sample

Adds a Ruby code sample demonstrating hierarchical namespace recursive folder delete.

Fixes: b/530059259

[Generated-by: AI]

Author: nidhiii-27

google-cloud-storage-control/samples/acceptance/storage_control_folders_test.rb

@@ -18,6 +18,7 @@
 require_relative "../storage_control_list_folders"
 require_relative "../storage_control_rename_folder"
 require_relative "../storage_control_delete_folder"
+require_relative "../storage_control_delete_folder_recursive"
 
 describe "Storage Control Folders" do
   let(:bucket_name) { random_bucket_name }
@@ -64,5 +65,33 @@
     assert_output "Deleted folder: #{new_folder_name}\n" do
       delete_folder bucket_name: bucket_name, folder_name: new_folder_name
     end
+
+    # create parent folder for recursive delete
+    capture_io do
+      create_folder bucket_name: bucket_name, folder_name: folder_name
+    end
+
+    # create a child folder inside parent folder
+    child_folder_name = "#{folder_name}/child-folder"
+    capture_io do
+      create_folder bucket_name: bucket_name, folder_name: child_folder_name
+    end
+
+    # delete parent folder recursively
+    begin
+      assert_output "Deleted folder recursively: #{folder_name}\n" do
+        delete_folder_recursive bucket_name: bucket_name, folder_name: folder_name
+      end
+    rescue Minitest::UnexpectedError => e
+      is_invalid_arg = e.error.is_a? Google::Cloud::InvalidArgumentError
+      is_not_enabled = e.error.message.include? "Recursive folder delete is not enabled for this bucket"
+      raise e unless is_invalid_arg && is_not_enabled
+
+      skip "Skipping recursive delete test because the feature is not enabled for this bucket."
+    rescue Google::Cloud::InvalidArgumentError => e
+      raise e unless e.message.include? "Recursive folder delete is not enabled for this bucket"
+
+      skip "Skipping recursive delete test because the feature is not enabled for this bucket."
+    end
   end
 end

google-cloud-storage-control/samples/storage_control_delete_folder_recursive.rb

@@ -0,0 +1,40 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# [START storage_control_delete_folder_recursive]
+def delete_folder_recursive bucket_name:, folder_name:
+  # The ID of your GCS bucket
+  # bucket_name = "your-unique-bucket-name"
+  #
+  # Name of the folder you want to delete recursively
+  # folder_name = "name-of-the-folder"
+
+  require "google/cloud/storage/control"
+
+  storage_control = Google::Cloud::Storage::Control.storage_control
+
+  # The storage folder path uses the global access pattern, in which the "_"
+  # denotes this bucket exists in the global namespace.
+  folder_path = storage_control.folder_path project: "_", bucket: bucket_name, folder: folder_name
+
+  request = Google::Cloud::Storage::Control::V2::DeleteFolderRecursiveRequest.new name: folder_path
+
+  result = storage_control.delete_folder_recursive request
+  result.wait_until_done! timeout: 60
+
+  puts "Deleted folder recursively: #{folder_name}"
+end
+# [END storage_control_delete_folder_recursive]
+
+delete_folder_recursive bucket_name: ARGV.shift if $PROGRAM_NAME == __FILE__