feat(accounts): Add batch operations for custom regions

Google APIs · copybara-github · commit c4c5ad711c35 · 2025-08-28T10:24:55.000-07:00
Added the following methods to the `RegionsService` in the Merchant API Accounts v1:
- `BatchCreateRegions`: Create multiple regions in a single request.
- `BatchUpdateRegions`: Update multiple regions in a single request.
- `BatchDeleteRegions`: Delete multiple regions in a single request.

These methods allow for more efficient management of custom regions.

PiperOrigin-RevId: 800519608
diff --git a/google/shopping/merchant/accounts/v1/BUILD.bazel b/google/shopping/merchant/accounts/v1/BUILD.bazel
@@ -387,8 +387,8 @@ ruby_cloud_gapic_library(
     name = "accounts_ruby_gapic",
     srcs = [":accounts_proto_with_info"],
     extra_protoc_parameters = [
-        "ruby-cloud-gem-name=google-shopping-merchant-accounts-v1",
         "ruby-cloud-extra-dependencies=google-shopping-type=~>1.0",
+        "ruby-cloud-gem-name=google-shopping-merchant-accounts-v1",
     ],
     grpc_service_config = "accounts_grpc_service_config.json",
     rest_numeric_enums = True,
diff --git a/google/shopping/merchant/accounts/v1/regions.proto b/google/shopping/merchant/accounts/v1/regions.proto
@@ -59,6 +59,16 @@ service RegionsService {
     option (google.api.method_signature) = "parent,region,region_id";
   }
 
+  // Creates one or more regions in your Merchant Center account.
+  // Executing this method requires admin access.
+  rpc BatchCreateRegions(BatchCreateRegionsRequest)
+      returns (BatchCreateRegionsResponse) {
+    option (google.api.http) = {
+      post: "/accounts/v1/{parent=accounts/*}/regions:batchCreate"
+      body: "*"
+    };
+  }
+
   // Updates a region definition in your Merchant Center account.
   // Executing this method requires admin access.
   rpc UpdateRegion(UpdateRegionRequest) returns (Region) {
@@ -69,6 +79,16 @@ service RegionsService {
     option (google.api.method_signature) = "region,update_mask";
   }
 
+  // Updates one or more regions in your Merchant Center account.
+  // Executing this method requires admin access.
+  rpc BatchUpdateRegions(BatchUpdateRegionsRequest)
+      returns (BatchUpdateRegionsResponse) {
+    option (google.api.http) = {
+      post: "/accounts/v1/{parent=accounts/*}/regions:batchUpdate"
+      body: "*"
+    };
+  }
+
   // Deletes a region definition from your Merchant Center account. Executing
   // this method requires admin access.
   rpc DeleteRegion(DeleteRegionRequest) returns (google.protobuf.Empty) {
@@ -78,6 +98,16 @@ service RegionsService {
     option (google.api.method_signature) = "name";
   }
 
+  // Deletes multiple regions by name from your Merchant Center account.
+  // Executing this method requires admin access.
+  rpc BatchDeleteRegions(BatchDeleteRegionsRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      post: "/accounts/v1/{parent=accounts/*}/regions:batchDelete"
+      body: "*"
+    };
+  }
+
   // Lists the regions in your Merchant Center account.
   rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse) {
     option (google.api.http) = {
@@ -118,6 +148,29 @@ message CreateRegionRequest {
   Region region = 3 [(google.api.field_behavior) = REQUIRED];
 }
 
+// Request message for the `BatchCreateRegions` method.
+message BatchCreateRegionsRequest {
+  // Required. The account to create one or more regions for.
+  // Format: `accounts/{account}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "merchantapi.googleapis.com/Account"
+    }
+  ];
+
+  // Required. The region(s) to create.
+  // The maximum number of regions that can be created in a batch is 100.
+  repeated CreateRegionRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for the `BatchCreateRegions` method.
+message BatchCreateRegionsResponse {
+  // The created region(s).
+  repeated Region regions = 1;
+}
+
 // Request message for the `UpdateRegion` method.
 message UpdateRegionRequest {
   // Required. The updated region.
@@ -130,6 +183,29 @@ message UpdateRegionRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
+// Request message for the `BatchUpdateRegions` method.
+message BatchUpdateRegionsRequest {
+  // Required. The account to update one or more regions for.
+  // Format: `accounts/{account}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "merchantapi.googleapis.com/Account"
+    }
+  ];
+
+  // Required. The region(s) to update.
+  // The maximum number of regions that can be updated in a batch is 100.
+  repeated UpdateRegionRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for the `BatchUpdateRegions` method.
+message BatchUpdateRegionsResponse {
+  // The updated region(s).
+  repeated Region regions = 1;
+}
+
 // Request message for the `DeleteRegion` method.
 message DeleteRegionRequest {
   // Required. The name of the region to delete.
@@ -142,6 +218,23 @@ message DeleteRegionRequest {
   ];
 }
 
+// Request message for the `BatchDeleteRegions` method.
+message BatchDeleteRegionsRequest {
+  // Required. The account to delete one or more regions from.
+  // Format: `accounts/{account}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "merchantapi.googleapis.com/Account"
+    }
+  ];
+
+  // Required. The names of the regions to delete.
+  // A maximum of 100 regions can be deleted in a batch.
+  repeated DeleteRegionRequest requests = 2
+      [(google.api.field_behavior) = REQUIRED];
+}
+
 // Request message for the `ListRegions` method.
 message ListRegionsRequest {
   // Required. The account to list regions for.
