chore: add new client surface (#6256)

PiperOrigin-RevId: 534084593
Source-Link: googleapis/googleapis@aa4559a
Source-Link: googleapis/googleapis-gen@370325a
Copy-Tag: eyJwIjoiU2VjcmV0TWFuYWdlci8uT3dsQm90LnlhbWwiLCJoIjoiMzcwMzI1YWY4MjM2NzMyZjU4ODVmNTk0MGUwZWY0ODFmZWU4MzAwMyJ9
Copy-Tag: eyJwIjoiU2VjdXJpdHlDZW50ZXIvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU2VjdXJpdHlQcml2YXRlQ2EvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU2VydmljZUNvbnRyb2wvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU2VydmljZU1hbmFnZW1lbnQvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU2VydmljZVVzYWdlLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiU2hlbGwvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU3Bhbm5lci8uT3dsQm90LnlhbWwiLCJoIjoiMzcwMzI1YWY4MjM2NzMyZjU4ODVmNTk0MGUwZWY0ODFmZWU4MzAwMyJ9
Copy-Tag: eyJwIjoiU3BlZWNoLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiU3FsQWRtaW4vLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiU3RvcmFnZUluc2lnaHRzLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiU3RvcmFnZVRyYW5zZmVyLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiU3VwcG9ydC8uT3dsQm90LnlhbWwiLCJoIjoiMzcwMzI1YWY4MjM2NzMyZjU4ODVmNTk0MGUwZWY0ODFmZWU4MzAwMyJ9
Copy-Tag: eyJwIjoiVGFsZW50Ly5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiVGFza3MvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiVGV4dFRvU3BlZWNoLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiVHB1Ly5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiVHJhY2UvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==
Copy-Tag: eyJwIjoiVHJhbnNsYXRlLy5Pd2xCb3QueWFtbCIsImgiOiIzNzAzMjVhZjgyMzY3MzJmNTg4NWY1OTQwZTBlZjQ4MWZlZTgzMDAzIn0=
Copy-Tag: eyJwIjoiVmlkZW9JbnRlbGxpZ2VuY2UvLk93bEJvdC55YW1sIiwiaCI6IjM3MDMyNWFmODIzNjczMmY1ODg1ZjU5NDBlMGVmNDgxZmVlODMwMDMifQ==

SecretManager/samples/V1/SecretManagerServiceClient/add_secret_version.php

@@ -41,7 +41,7 @@ function add_secret_version_sample(string $formattedParent): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $payload = new SecretPayload();
 
     // Call the API and handle any network failures.

SecretManager/samples/V1/SecretManagerServiceClient/create_secret.php

@@ -45,7 +45,7 @@ function create_secret_sample(string $formattedParent, string $secretId): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $secretReplication = new Replication();
     $secret = (new Secret())
         ->setReplication($secretReplication);

SecretManager/samples/V1/SecretManagerServiceClient/set_iam_policy.php

@@ -42,7 +42,7 @@ function set_iam_policy_sample(string $resource): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $policy = new Policy();
 
     // Call the API and handle any network failures.

SecretManager/samples/V1/SecretManagerServiceClient/test_iam_permissions.php

@@ -48,7 +48,7 @@ function test_iam_permissions_sample(string $resource, string $permissionsElemen
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $permissions = [$permissionsElement,];
 
     // Call the API and handle any network failures.

SecretManager/samples/V1/SecretManagerServiceClient/update_secret.php

@@ -43,7 +43,7 @@ function update_secret_sample(): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $secretReplication = new Replication();
     $secret = (new Secret())
         ->setReplication($secretReplication);

SecretManager/samples/V1beta1/SecretManagerServiceClient/add_secret_version.php

@@ -41,7 +41,7 @@ function add_secret_version_sample(string $formattedParent): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $payload = new SecretPayload();
 
     // Call the API and handle any network failures.

SecretManager/samples/V1beta1/SecretManagerServiceClient/create_secret.php

@@ -45,7 +45,7 @@ function create_secret_sample(string $formattedParent, string $secretId): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $secretReplication = new Replication();
     $secret = (new Secret())
         ->setReplication($secretReplication);

SecretManager/samples/V1beta1/SecretManagerServiceClient/set_iam_policy.php

@@ -42,7 +42,7 @@ function set_iam_policy_sample(string $resource): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $policy = new Policy();
 
     // Call the API and handle any network failures.

SecretManager/samples/V1beta1/SecretManagerServiceClient/test_iam_permissions.php

@@ -48,7 +48,7 @@ function test_iam_permissions_sample(string $resource, string $permissionsElemen
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $permissions = [$permissionsElement,];
 
     // Call the API and handle any network failures.

SecretManager/samples/V1beta1/SecretManagerServiceClient/update_secret.php

@@ -43,7 +43,7 @@ function update_secret_sample(): void
     // Create a client.
     $secretManagerServiceClient = new SecretManagerServiceClient();
 
-    // Prepare the request message.
+    // Prepare any non-scalar elements to be passed along with the request.
     $secretReplication = new Replication();
     $secret = (new Secret())
         ->setReplication($secretReplication);