feat: [SecureSourceManager] Add CustomHostConfig to configure custom hostnames for private instances (#9053)

* feat: Add CustomHostConfig to configure custom hostnames for private instances
feat: Add option to require code owner approval in branch rules
feat: Add force option to DeleteInstance request
docs: Improve documentation for labels, pagination, and ListLocations

PiperOrigin-RevId: 889991858

Source-Link: googleapis/googleapis@10ac207

Source-Link: googleapis/googleapis-gen@26a9c81
Copy-Tag: eyJwIjoiU2VjdXJlU291cmNlTWFuYWdlci8uT3dsQm90LnlhbWwiLCJoIjoiMjZhOWM4MTM3MmI1MGNjNTAwOWYxMjUxNzVjM2M0ZTQzYmJhOGY5NyJ9

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

SecureSourceManager/metadata/V1/SecureSourceManager.php

@@ -36,7 +36,7 @@
  * Batch creates pull request comments. This function is used to create
  * multiple PullRequestComments for code review. There needs to be exactly one
  * PullRequestComment of type Review, and at most 100 PullRequestComments of
- * type Code per request. The Postition of the code comments must be unique
+ * type Code per request. The Position of the code comments must be unique
  * within the request.
  *
  * @param string $formattedParent         The pull request in which to create the pull request comments.

SecureSourceManager/samples/V1/SecureSourceManagerClient/batch_create_pull_request_comments.php

@@ -31,6 +31,22 @@
 
 /**
  * Lists information about the supported locations for this service.
+
+This method lists locations based on the resource scope provided in
+the [ListLocationsRequest.name] field:
+
+* **Global locations**: If `name` is empty, the method lists the
+public locations available to all projects. * **Project-specific
+locations**: If `name` follows the format
+`projects/{project}`, the method lists locations visible to that
+specific project. This includes public, private, or other
+project-specific locations enabled for the project.
+
+For gRPC and client library implementations, the resource name is
+passed as the `name` field. For direct service calls, the resource
+name is
+incorporated into the request path based on the specific service
+implementation and version.
  *
  * This sample has been automatically generated and should be regarded as a code
  * template only. It will require modifications to work:

SecureSourceManager/samples/V1/SecureSourceManagerClient/list_locations.php

@@ -28,7 +28,6 @@
 use Google\Cloud\SecureSourceManager\V1\BranchRule;
 use Google\Cloud\SecureSourceManager\V1\Client\SecureSourceManagerClient;
 use Google\Cloud\SecureSourceManager\V1\UpdateBranchRuleRequest;
-use Google\Protobuf\FieldMask;
 use Google\Rpc\Status;
 
 /**
@@ -47,10 +46,8 @@ function update_branch_rule_sample(): void
 
     // Prepare the request message.
     $branchRule = new BranchRule();
-    $updateMask = new FieldMask();
     $request = (new UpdateBranchRuleRequest())
-        ->setBranchRule($branchRule)
-        ->setUpdateMask($updateMask);
+        ->setBranchRule($branchRule);
 
     // Call the API and handle any network failures.
     try {

SecureSourceManager/samples/V1/SecureSourceManagerClient/update_branch_rule.php

@@ -28,7 +28,6 @@
 use Google\Cloud\SecureSourceManager\V1\Client\SecureSourceManagerClient;
 use Google\Cloud\SecureSourceManager\V1\Hook;
 use Google\Cloud\SecureSourceManager\V1\UpdateHookRequest;
-use Google\Protobuf\FieldMask;
 use Google\Rpc\Status;
 
 /**
@@ -42,11 +41,9 @@ function update_hook_sample(string $hookTargetUri): void
     $secureSourceManagerClient = new SecureSourceManagerClient();
 
     // Prepare the request message.
-    $updateMask = new FieldMask();
     $hook = (new Hook())
         ->setTargetUri($hookTargetUri);
     $request = (new UpdateHookRequest())
-        ->setUpdateMask($updateMask)
         ->setHook($hook);
 
     // Call the API and handle any network failures.

SecureSourceManager/samples/V1/SecureSourceManagerClient/update_hook.php

@@ -663,7 +663,7 @@ public function __call($method, $args)
      * Batch creates pull request comments. This function is used to create
      * multiple PullRequestComments for code review. There needs to be exactly one
      * PullRequestComment of type Review, and at most 100 PullRequestComments of
-     * type Code per request. The Postition of the code comments must be unique
+     * type Code per request. The Position of the code comments must be unique
      * within the request.
      *
      * The async variant is
@@ -2188,6 +2188,22 @@ public function getLocation(GetLocationRequest $request, array $callOptions = []
 
     /**
      * Lists information about the supported locations for this service.
+
+    This method lists locations based on the resource scope provided in
+    the [ListLocationsRequest.name] field:
+
+    * **Global locations**: If `name` is empty, the method lists the
+    public locations available to all projects. * **Project-specific
+    locations**: If `name` follows the format
+    `projects/{project}`, the method lists locations visible to that
+    specific project. This includes public, private, or other
+    project-specific locations enabled for the project.
+
+    For gRPC and client library implementations, the resource name is
+    passed as the `name` field. For direct service calls, the resource
+    name is
+    incorporated into the request path based on the specific service
+    implementation and version.
      *
      * The async variant is {@see SecureSourceManagerClient::listLocationsAsync()} .
      *