docs: [PubSub] Add the IDENTIFIER field behavior annotation to fields of Cloud Pub/Sub methods that represent a specific identity and need to be sourced with additional care (#8780)

* docs: Add the IDENTIFIER field behavior annotation to fields of Cloud Pub/Sub methods that represent a specific identity and need to be sourced with additional care

PiperOrigin-RevId: 840763233

Source-Link: googleapis/googleapis@d89bb8a

Source-Link: googleapis/googleapis-gen@c7c9072
Copy-Tag: eyJwIjoiUHViU3ViLy5Pd2xCb3QueWFtbCIsImgiOiJjN2M5MDcyNzRkNjE2NGNkZjg2ZWRjZjhkZTcwZjNkYjU3MmIwMGE2In0=

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

PubSub/metadata/V1/Pubsub.php

@@ -31,7 +31,7 @@
  * Creates the given topic with the given name. See the [resource name rules]
  * (https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
  *
- * @param string $name The name of the topic. It must have the format
+ * @param string $name Identifier. The name of the topic. It must have the format
  *                     `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
  *                     and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
  *                     underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent

PubSub/samples/V1/PublisherClient/create_topic.php

@@ -34,7 +34,7 @@
  * configuration or subscriptions. Existing subscriptions to this topic are
  * not deleted, but their `topic` field is set to `_deleted-topic_`.
  *
- * @param string $formattedTopic Name of the topic to delete.
+ * @param string $formattedTopic Identifier. Name of the topic to delete.
  *                               Format is `projects/{project}/topics/{topic}`. Please see
  *                               {@see PublisherClient::topicName()} for help formatting this field.
  */

PubSub/samples/V1/PublisherClient/delete_topic.php

@@ -31,7 +31,7 @@
 /**
  * Gets the configuration of a topic.
  *
- * @param string $formattedTopic The name of the topic to get.
+ * @param string $formattedTopic Identifier. The name of the topic to get.
  *                               Format is `projects/{project}/topics/{topic}`. Please see
  *                               {@see PublisherClient::topicName()} for help formatting this field.
  */

PubSub/samples/V1/PublisherClient/get_topic.php

@@ -32,7 +32,7 @@
 /**
  * Lists matching topics.
  *
- * @param string $formattedProject The name of the project in which to list topics.
+ * @param string $formattedProject Identifier. The name of the project in which to list topics.
  *                                 Format is `projects/{project-id}`. Please see
  *                                 {@see PublisherClient::projectName()} for help formatting this field.
  */

PubSub/samples/V1/PublisherClient/list_topics.php

@@ -33,8 +33,8 @@
  * Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
  * does not exist.
  *
- * @param string $formattedTopic The messages in the request will be published on this topic.
- *                               Format is `projects/{project}/topics/{topic}`. Please see
+ * @param string $formattedTopic Identifier. The messages in the request will be published on this
+ *                               topic. Format is `projects/{project}/topics/{topic}`. Please see
  *                               {@see PublisherClient::topicName()} for help formatting this field.
  */
 function publish_sample(string $formattedTopic): void

PubSub/samples/V1/PublisherClient/publish.php

@@ -33,7 +33,7 @@
  * Updates an existing topic by updating the fields specified in the update
  * mask. Note that certain properties of a topic are not modifiable.
  *
- * @param string $topicName The name of the topic. It must have the format
+ * @param string $topicName Identifier. The name of the topic. It must have the format
  *                          `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter,
  *                          and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
  *                          underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent

PubSub/samples/V1/PublisherClient/update_topic.php

@@ -46,10 +46,10 @@
  * generated name is populated in the returned Snapshot object. Note that for
  * REST API requests, you must specify a name in the request.
  *
- * @param string $formattedName         User-provided name for this snapshot. If the name is not provided
- *                                      in the request, the server will assign a random name for this snapshot on
- *                                      the same project as the subscription. Note that for REST API requests, you
- *                                      must specify a name.  See the [resource name
+ * @param string $formattedName         Identifier. User-provided name for this snapshot. If the name is
+ *                                      not provided in the request, the server will assign a random name for this
+ *                                      snapshot on the same project as the subscription. Note that for REST API
+ *                                      requests, you must specify a name.  See the [resource name
  *                                      rules](https://cloud.google.com/pubsub/docs/pubsub-basics#resource_names).
  *                                      Format is `projects/{project}/snapshots/{snap}`. Please see
  *                                      {@see SubscriberClient::snapshotName()} for help formatting this field.

PubSub/samples/V1/SubscriberClient/create_snapshot.php

@@ -40,7 +40,7 @@
  * generated name is populated in the returned Subscription object. Note that
  * for REST API requests, you must specify a name in the request.
  *
- * @param string $name           The name of the subscription. It must have the format
+ * @param string $name           Identifier. The name of the subscription. It must have the format
  *                               `"projects/{project}/subscriptions/{subscription}"`. `{subscription}` must
  *                               start with a letter, and contain only letters (`[A-Za-z]`), numbers
  *                               (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),

PubSub/samples/V1/SubscriberClient/create_subscription.php

@@ -38,7 +38,7 @@
  * created with the same name, but the new one has no association with the old
  * snapshot or its subscription, unless the same subscription is specified.
  *
- * @param string $formattedSnapshot The name of the snapshot to delete.
+ * @param string $formattedSnapshot Identifier. The name of the snapshot to delete.
  *                                  Format is `projects/{project}/snapshots/{snap}`. Please see
  *                                  {@see SubscriberClient::snapshotName()} for help formatting this field.
  */