docs: [ShoppingMerchantAccounts] A comment for enum AccessRight is changed (#8736)

* docs: A comment for enum `AccessRight` is changed
docs: A comment for enum value `API_DEVELOPER` in enum `AccessRight` is changed
docs: A comment for method `DeleteAccount` in service `AccountsService` is changed
docs: A comment for field `developer_email` in message `.google.shopping.merchant.accounts.v1.RegisterGcpRequest` is changed
docs: A comment for message `Program` is changed
docs: A comment for message `User` is changed
docs: A comment for enum `State` is changed
feat: A new field `verification_mail_settings` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `account_management` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `comparison_shopping` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `products_management` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `campaigns_management` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `external_account_id` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new message `SetAliasForRelationship` is added
feat: A new field `set_alias` is added to message `.google.shopping.merchant.accounts.v1.CreateAndConfigureAccountRequest`
feat: A new field `comparison_shopping` is added to message `.google.shopping.merchant.accounts.v1.AccountService`
feat: A new message `ComparisonShopping` is added
feat: A new method `GetAccountForGcpRegistration` is added to service `DeveloperRegistrationService`
feat: A new message `GetAccountForGcpRegistrationResponse` is added
feat: A new method `VerifySelf` is added to service `UserService`
feat: A new message `VerifySelfRequest` is added
feat: A new message `VerificationMailSettings` is added

PiperOrigin-RevId: 832226276

Source-Link: googleapis/googleapis@04085e5

Source-Link: googleapis/googleapis-gen@edc9e32
Copy-Tag: eyJwIjoiU2hvcHBpbmdNZXJjaGFudEFjY291bnRzLy5Pd2xCb3QueWFtbCIsImgiOiJlZGM5ZTMyZDAxY2JjNmVlODBhZTk5OWY2NTk2NTM1ZThiZTAxMGY1In0=

* 🦉 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]

ShoppingMerchantAccounts/metadata/V1/Accounts.php

@@ -30,10 +30,13 @@
 /**
  * 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. Executing this method requires admin access.
- * The deletion succeeds only if the account does not provide services
- * to any other account and has no processed offers. You can use the `force`
- * parameter to override this.
+ * of all of its sub-accounts. This also deletes the account's [developer
+ * registration
+ * entity](/merchant/api/reference/rest/accounts_v1/accounts.developerRegistration)
+ * and any associated GCP project to the account. Executing this method
+ * requires admin access. The deletion succeeds only if the account does not
+ * provide services to any other account and has no processed offers. You can
+ * use the `force` parameter to override this.
  *
  * @param string $formattedName The name of the account to delete.
  *                              Format: `accounts/{account}`

ShoppingMerchantAccounts/metadata/V1/Accountservices.php

@@ -0,0 +1,57 @@
+<?php
+/*
+ * Copyright 2025 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
+ *
+ *     https://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.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START merchantapi_v1_generated_DeveloperRegistrationService_GetAccountForGcpRegistration_sync]
+use Google\ApiCore\ApiException;
+use Google\Protobuf\GPBEmpty;
+use Google\Shopping\Merchant\Accounts\V1\Client\DeveloperRegistrationServiceClient;
+use Google\Shopping\Merchant\Accounts\V1\GetAccountForGcpRegistrationResponse;
+
+/**
+ * Retrieves the merchant account that the calling GCP is registered with.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function get_account_for_gcp_registration_sample(): void
+{
+    // Create a client.
+    $developerRegistrationServiceClient = new DeveloperRegistrationServiceClient();
+
+    // Prepare the request message.
+    $request = new GPBEmpty();
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var GetAccountForGcpRegistrationResponse $response */
+        $response = $developerRegistrationServiceClient->getAccountForGcpRegistration($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+// [END merchantapi_v1_generated_DeveloperRegistrationService_GetAccountForGcpRegistration_sync]

ShoppingMerchantAccounts/metadata/V1/Developerregistration.php

@@ -0,0 +1,73 @@
+<?php
+/*
+ * Copyright 2025 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
+ *
+ *     https://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.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START merchantapi_v1_generated_UserService_VerifySelf_sync]
+use Google\ApiCore\ApiException;
+use Google\Shopping\Merchant\Accounts\V1\Client\UserServiceClient;
+use Google\Shopping\Merchant\Accounts\V1\User;
+use Google\Shopping\Merchant\Accounts\V1\VerifySelfRequest;
+
+/**
+ * Updates the user that is represented by the caller from pending to
+ * verified.
+ *
+ * @param string $formattedAccount The name of the account under which the caller is a user.
+ *                                 Format: `accounts/{account}`
+ *                                 Please see {@see UserServiceClient::accountName()} for help formatting this field.
+ */
+function verify_self_sample(string $formattedAccount): void
+{
+    // Create a client.
+    $userServiceClient = new UserServiceClient();
+
+    // Prepare the request message.
+    $request = (new VerifySelfRequest())
+        ->setAccount($formattedAccount);
+
+    // Call the API and handle any network failures.
+    try {
+        /** @var User $response */
+        $response = $userServiceClient->verifySelf($request);
+        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedAccount = UserServiceClient::accountName('[ACCOUNT]');
+
+    verify_self_sample($formattedAccount);
+}
+// [END merchantapi_v1_generated_UserService_VerifySelf_sync]