docs: updated documentation for message NetworkInterface (#3792)

* docs: updated documentation for message NetworkInterface
chore: published new fields in service YAML

PiperOrigin-RevId: 496547510

Source-Link: googleapis/googleapis@de57a4d

Source-Link: googleapis/googleapis-gen@b0b063a
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJhdGNoLy5Pd2xCb3QueWFtbCIsImgiOiJiMGIwNjNhNDFjZGQ0NzQ4YmVmYzk3MGY1YjY0MDVmZGFmMWQwNDcwIn0=

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: updated documentation for message NetworkInterface
chore: published new fields in service YAML

PiperOrigin-RevId: 496547521

Source-Link: googleapis/googleapis@cffce73

Source-Link: googleapis/googleapis-gen@b35f4a3
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWJhdGNoLy5Pd2xCb3QueWFtbCIsImgiOiJiMzVmNGEzMWIyOTNlYWNlMDdhZWVkMmEzZmNmMWQyOWRiNzdlOTQ4In0=

* 🦉 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>
Co-authored-by: sofisl <[email protected]>

packages/google-cloud-batch/protos/google/cloud/batch/v1/job.proto

@@ -337,10 +337,20 @@ message AllocationPolicy {
 
   // A network interface.
   message NetworkInterface {
-    // The URL of the network resource.
+    // The URL of an existing network resource.
+    // You can specify the network as a full or partial URL.
+    // For example, the following are all valid URLs:
+    // https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
+    // projects/{project}/global/networks/{network}
+    // global/networks/{network}
     string network = 1;
 
-    // The URL of the Subnetwork resource.
+    // The URL of an existing subnetwork resource in the network.
+    // You can specify the subnetwork as a full or partial URL.
+    // For example, the following are all valid URLs:
+    // https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetwork}
+    // projects/{project}/regions/{region}/subnetworks/{subnetwork}
+    // regions/{region}/subnetworks/{subnetwork}
     string subnetwork = 2;
 
     // Default is false (with an external IP address). Required if

packages/google-cloud-batch/protos/google/cloud/batch/v1alpha/job.proto

@@ -402,10 +402,20 @@ message AllocationPolicy {
 
   // A network interface.
   message NetworkInterface {
-    // The URL of the network resource.
+    // The URL of an existing network resource.
+    // You can specify the network as a full or partial URL.
+    // For example, the following are all valid URLs:
+    // https://www.googleapis.com/compute/v1/projects/{project}/global/networks/{network}
+    // projects/{project}/global/networks/{network}
+    // global/networks/{network}
     string network = 1;
 
-    // The URL of the Subnetwork resource.
+    // The URL of an existing subnetwork resource in the network.
+    // You can specify the subnetwork as a full or partial URL.
+    // For example, the following are all valid URLs:
+    // https://www.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetwork}
+    // projects/{project}/regions/{region}/subnetworks/{subnetwork}
+    // regions/{region}/subnetworks/{subnetwork}
     string subnetwork = 2;
 
     // Default is false (with an external IP address). Required if