docs: [Batch] restrict allowed_locations region or zone values to the same region where the job is created

Batch/samples/V1/BatchServiceClient/list_locations.php

@@ -32,6 +32,21 @@
 /**
  * Lists information about the supported locations for this service.
  *
+ * This method lists locations based on the resource scope provided in
+ * the [ListLocationsRequest.name][google.cloud.location.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:
  *  - It may require correct/in-range values for request initialization.

Batch/src/V1/Client/BatchServiceClient.php

@@ -581,6 +581,21 @@ 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][google.cloud.location.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 BatchServiceClient::listLocationsAsync()} .
      *
      * @example samples/V1/BatchServiceClient/list_locations.php