feat: [SecurityPrivateCa] add allow_requester_specified_not_before_time and requested_not_before_time fields to PrivateCA v1 API (#9215)

* feat: add allow_requester_specified_not_before_time and requested_not_before_time fields to PrivateCA v1 API
docs: update comments for backdate_duration field in CaPool
docs: update comments for parent field in ListCertificatesRequest

PiperOrigin-RevId: 921762720

Source-Link: googleapis/googleapis@ec2e510

Source-Link: googleapis/googleapis-gen@b8da48e
Copy-Tag: eyJwIjoiU2VjdXJpdHlQcml2YXRlQ2EvLk93bEJvdC55YW1sIiwiaCI6ImI4ZGE0OGU4YThhYWFiZDdmNmZjMzllZDJmNWNmZDE4MDRjN2UyNTUifQ==

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

SecurityPrivateCa/metadata/V1/Resources.php

@@ -32,10 +32,19 @@
 /**
  * Lists [Certificates][google.cloud.security.privateca.v1.Certificate].
  *
- * @param string $formattedParent The resource name of the location associated with the
+ * @param string $formattedParent The resource name of the parent associated with the
  *                                [Certificates][google.cloud.security.privateca.v1.Certificate], in the
- *                                format `projects/*/locations/*/caPools/*`. Please see
- *                                {@see CertificateAuthorityServiceClient::caPoolName()} for help formatting this field.
+ *                                format `projects/*/locations/*/caPools/*`. The parent resource name can be
+ *                                in one of two forms:
+ *
+ *                                1.  **Specific CA Pool:** To list certificates within a single CA Pool:
+ *                                `projects/*/locations/*/caPools/*`
+ *
+ *                                2.  **All CA Pools in a Location:** To list certificates across *all* CA
+ *                                Pools in a given project and location, use the wildcard character (`-`)
+ *                                in place of the CA Pool ID.
+ *                                Example: `projects/*/locations/*/caPools/-`
+ *                                Please see {@see CertificateAuthorityServiceClient::caPoolName()} for help formatting this field.
  */
 function list_certificates_sample(string $formattedParent): void
 {

SecurityPrivateCa/samples/V1/CertificateAuthorityServiceClient/list_certificates.php

@@ -31,6 +31,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: