feat: Add CreateTestAccount RPC to Accounts service for creating test-only Merchant Center accounts

Google APIs · copybara-github · commit e68f10a40c8a · 2026-03-17T01:51:47.000-07:00
docs: Update Account.account_name documentation for naming restrictions
docs: Clarify CheckoutSettings.eligible_destinations usage
docs: Refine DeveloperRegistration.developer_email behavior description
docs: Add product-ratings to Program documentation
docs: Update Region to support radius_area and clarify area type exclusivity
docs: Improve TermsOfServiceKind.MERCHANT_CENTER comment
docs: Update DeleteUser method description

PiperOrigin-RevId: 884882604
diff --git a/google/shopping/merchant/accounts/v1/accessright.proto b/google/shopping/merchant/accounts/v1/accessright.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/accountissue.proto b/google/shopping/merchant/accounts/v1/accountissue.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/accountrelationships.proto b/google/shopping/merchant/accounts/v1/accountrelationships.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/accounts.proto b/google/shopping/merchant/accounts/v1/accounts.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -60,6 +60,28 @@ service AccountsService {
     };
   }
 
+  // Creates a Merchant Center test account.
+  //
+  // Test accounts are intended for development and testing purposes, such as
+  // validating API integrations or new feature behavior.
+  //
+  // Key characteristics and limitations of test accounts:
+  // - Immutable Type: A test account cannot be converted into a regular
+  //   (live) Merchant Center account. Likewise, a regular account cannot be
+  //   converted into a test account.
+  // - Non-Serving Products: Any products, offers, or data created within a
+  //   test account will not be published or made visible to end-users on any
+  //   Google surfaces. They are strictly for testing environments.
+  // - Separate Environment: Test accounts operate in a sandbox-like manner,
+  //   isolated from live serving and real user traffic.
+  rpc CreateTestAccount(CreateTestAccountRequest) returns (Account) {
+    option (google.api.http) = {
+      post: "/accounts/v1/{parent=accounts/*}:createTestAccount"
+      body: "account"
+    };
+    option (google.api.method_signature) = "parent,account";
+  }
+
   // Deletes the specified account regardless of its type: standalone, advanced
   // account or sub-account. Deleting an advanced account leads to the deletion
   // of all of its sub-accounts. This also deletes the account's [developer
@@ -139,10 +161,12 @@ message Account {
   // Output only. The ID of the account.
   int64 account_id = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-  // Required. A human-readable name of the account. See
-  // [store name](https://support.google.com/merchants/answer/160556) and
-  // [business name](https://support.google.com/merchants/answer/12159159) for
-  // more information.
+  // Required. A human-readable name of the account. Don't use punctuation,
+  // capitalization, or non-alphanumeric symbols such as the "/" or "_" symbols.
+  // See
+  // [Adding a business
+  // name](https://support.google.com/merchants/answer/12159159) for more
+  // information.
   string account_name = 3 [(google.api.field_behavior) = REQUIRED];
 
   // Optional. Whether this account contains adult content.
@@ -277,7 +301,7 @@ message CreateAndConfigureAccountRequest {
   // `account_aggregation` and `accounts.createAndConfigure` method can be
   // used to create a sub-account under an existing advanced account through
   // this method. Additional `account_management` or
-  // `product_management` services may be provided.
+  // `products_management` services may be provided.
   repeated AddAccountService service = 4
       [(google.api.field_behavior) = REQUIRED];
 
@@ -288,6 +312,21 @@ message CreateAndConfigureAccountRequest {
       [(google.api.field_behavior) = OPTIONAL];
 }
 
+// Request message for the CreateTestAccount RPC
+message CreateTestAccountRequest {
+  // Required. The account resource name to create the test account under.
+  // Format: accounts/{account}
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "merchantapi.googleapis.com/Account"
+    }
+  ];
+
+  // Required. The account to be created.
+  Account account = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
 // Request message for the `DeleteAccount` method.
 message DeleteAccountRequest {
   // Required. The name of the account to delete.
diff --git a/google/shopping/merchant/accounts/v1/accountservices.proto b/google/shopping/merchant/accounts/v1/accountservices.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/autofeedsettings.proto b/google/shopping/merchant/accounts/v1/autofeedsettings.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/automaticimprovements.proto b/google/shopping/merchant/accounts/v1/automaticimprovements.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/businessidentity.proto b/google/shopping/merchant/accounts/v1/businessidentity.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/businessinfo.proto b/google/shopping/merchant/accounts/v1/businessinfo.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/checkoutsettings.proto b/google/shopping/merchant/accounts/v1/checkoutsettings.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -188,10 +188,11 @@ message CheckoutSettings {
   // URI settings for cart or checkout URL.
   optional UriSettings uri_settings = 2;
 
-  // Optional. The destinations (also known as [Marketing
+  // Optional. Required for the create operation. The destinations (also known
+  // as [Marketing
   // methods](https://support.google.com/merchants/answer/15130232)) to which
-  // the checkout program applies, valid destination values are `SHOPPING_ADS`,
-  // `FREE_LISTINGS`
+  // the checkout program applies. Valid destination values are `SHOPPING_ADS`
+  // and `FREE_LISTINGS`.
   repeated google.shopping.type.Destination.DestinationEnum
       eligible_destinations = 8 [(google.api.field_behavior) = OPTIONAL];
 
diff --git a/google/shopping/merchant/accounts/v1/customerservice.proto b/google/shopping/merchant/accounts/v1/customerservice.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/developerregistration.proto b/google/shopping/merchant/accounts/v1/developerregistration.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -104,15 +104,16 @@ message RegisterGcpRequest {
     }
   ];
 
-  // Immutable. If the developer email provided is associated with a user in the
-  // merchant account provided, the user will be updated to have "API developer"
-  // access type and the email preference corresponding to that user will be
-  // updated to have the new "API notifications" preference. If the developer
-  // email provided is not associated with any user we will just add it as a
-  // contact. The email preference corresponding to that contact will have the
-  // new "API notifications" preference. Make sure the email used is associated
-  // with a Google Account (Google Workspace account or Gmail account)
-  // and is not a service account as service accounts can't receive emails.
+  // Immutable. Optional field. Developer role can be also added by using
+  // `users.update` method. If the developer email provided is associated with a
+  // user in the provided merchant account, the user will be updated to have
+  // `API_DEVELOPER` `access_rights` and the email preference corresponding to
+  // that user will be updated to have the new API notifications preference. If
+  // the developer email provided is not associated with any user, it is added
+  // as a contact. The email preference corresponding to that contact will have
+  // the new API notifications preference. Make sure the email used is
+  // associated with a Google Account and is not a service account as service
+  // accounts can't receive emails.
   string developer_email = 2 [(google.api.field_behavior) = IMMUTABLE];
 }
 
diff --git a/google/shopping/merchant/accounts/v1/emailpreferences.proto b/google/shopping/merchant/accounts/v1/emailpreferences.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/gbpaccounts.proto b/google/shopping/merchant/accounts/v1/gbpaccounts.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/homepage.proto b/google/shopping/merchant/accounts/v1/homepage.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/lfpproviders.proto b/google/shopping/merchant/accounts/v1/lfpproviders.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/omnichannelsettings.proto b/google/shopping/merchant/accounts/v1/omnichannelsettings.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/online_return_policy.proto b/google/shopping/merchant/accounts/v1/online_return_policy.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/phoneverificationstate.proto b/google/shopping/merchant/accounts/v1/phoneverificationstate.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/programs.proto b/google/shopping/merchant/accounts/v1/programs.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -92,6 +92,7 @@ service ProgramsService {
 //
 // * `checkout`
 // * `free-listings`
+// * `product-ratings`
 // * `shopping-ads`
 // * `youtube-shopping-checkout`
 message Program {
diff --git a/google/shopping/merchant/accounts/v1/regions.proto b/google/shopping/merchant/accounts/v1/regions.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -273,8 +273,13 @@ message ListRegionsResponse {
 
 // Represents a geographic region that you can use as a target with both the
 // `RegionalInventory` and `ShippingSettings` services. You can define regions
-// as collections of either postal codes or, in some countries, using predefined
-// geotargets. For more information, see [Set up regions
+// as collections of either postal codes, radius areas or, in some countries,
+// using predefined geotargets.
+//
+// A region must be defined by specifying exactly one of `postal_code_area`,
+// `geotarget_area`, or `radius_area`.
+//
+// For more information, see [Set up regions
 // ](https://support.google.com/merchants/answer/7410946#zippy=%2Ccreate-a-new-region)
 // for more information.
 message Region {
diff --git a/google/shopping/merchant/accounts/v1/shippingsettings.proto b/google/shopping/merchant/accounts/v1/shippingsettings.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/termsofservice.proto b/google/shopping/merchant/accounts/v1/termsofservice.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/termsofserviceagreementstate.proto b/google/shopping/merchant/accounts/v1/termsofserviceagreementstate.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
diff --git a/google/shopping/merchant/accounts/v1/termsofservicekind.proto b/google/shopping/merchant/accounts/v1/termsofservicekind.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -29,6 +29,6 @@ enum TermsOfServiceKind {
   // Default value. This value is unused.
   TERMS_OF_SERVICE_KIND_UNSPECIFIED = 0;
 
-  // Merchant Center application.
+  // Terms of service for the Merchant Center application.
   MERCHANT_CENTER = 1;
 }
diff --git a/google/shopping/merchant/accounts/v1/user.proto b/google/shopping/merchant/accounts/v1/user.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.
@@ -57,8 +57,7 @@ service UserService {
 
   // Deletes a Merchant Center account user. Executing this method requires
   // admin access. The user to be deleted can't be the last admin user of that
-  // account. Also a user is protected from deletion if it
-  // is managed by Business Manager"
+  // account.
   rpc DeleteUser(DeleteUserRequest) returns (google.protobuf.Empty) {
     option (google.api.http) = {
       delete: "/accounts/v1/{name=accounts/*/users/*}"
diff --git a/google/shopping/merchant/accounts/v1/verificationmailsettings.proto b/google/shopping/merchant/accounts/v1/verificationmailsettings.proto
@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// 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.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-// Copyright 2025 Google LLC`
	`1`	`+// Copyright 2026 Google LLC`
`2`	`2`	`//`
`3`	`3`	`// Licensed under the Apache License, Version 2.0 (the "License");`
`4`	`4`	`// you may not use this file except in compliance with the License.`