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 (#32251)

PiperOrigin-RevId: 840763233

Source-Link: googleapis/googleapis@d89bb8a

Source-Link: googleapis/googleapis-gen@c7c9072
Copy-Tag: eyJwIjoiZ29vZ2xlLWNsb3VkLXB1YnN1Yi12MS8uT3dsQm90LnlhbWwiLCJoIjoiYzdjOTA3Mjc0ZDYxNjRjZGY4NmVkY2Y4ZGU3MGYzZGI1NzJiMDBhNiJ9

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

google-cloud-pubsub-v1/lib/google/cloud/pubsub/v1/subscription_admin/client.rb

@@ -310,7 +310,7 @@ def logger
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the subscription. It must have the format
+            #     Required. 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 (`~`),
@@ -513,7 +513,7 @@ def create_subscription request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param subscription [::String]
-            #     Required. The name of the subscription to get.
+            #     Required. Identifier. The name of the subscription to get.
             #     Format is `projects/{project}/subscriptions/{sub}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -689,8 +689,8 @@ def update_subscription request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param project [::String]
-            #     Required. The name of the project in which to list subscriptions.
-            #     Format is `projects/{project-id}`.
+            #     Required. Identifier. The name of the project in which to list
+            #     subscriptions. Format is `projects/{project-id}`.
             #   @param page_size [::Integer]
             #     Optional. Maximum number of subscriptions to return.
             #   @param page_token [::String]
@@ -791,7 +791,7 @@ def list_subscriptions request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param subscription [::String]
-            #     Required. The subscription to delete.
+            #     Required. Identifier. The subscription to delete.
             #     Format is `projects/{project}/subscriptions/{sub}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1359,7 +1359,7 @@ def modify_push_config request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param snapshot [::String]
-            #     Required. The name of the snapshot to get.
+            #     Required. Identifier. The name of the snapshot to get.
             #     Format is `projects/{project}/snapshots/{snap}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -1449,7 +1449,7 @@ def get_snapshot request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param project [::String]
-            #     Required. The name of the project in which to list snapshots.
+            #     Required. Identifier. The name of the project in which to list snapshots.
             #     Format is `projects/{project-id}`.
             #   @param page_size [::Integer]
             #     Optional. Maximum number of snapshots to return.
@@ -1562,10 +1562,10 @@ def list_snapshots request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. 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
+            #     Required. 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}`.
             #   @param subscription [::String]
@@ -1771,7 +1771,7 @@ def update_snapshot request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param snapshot [::String]
-            #     Required. The name of the snapshot to delete.
+            #     Required. Identifier. The name of the snapshot to delete.
             #     Format is `projects/{project}/snapshots/{snap}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation

google-cloud-pubsub-v1/lib/google/cloud/pubsub/v1/topic_admin/client.rb

@@ -265,7 +265,7 @@ def logger
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The name of the topic. It must have the format
+            #     Required. 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
@@ -485,8 +485,8 @@ def update_topic request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param topic [::String]
-            #     Required. The messages in the request will be published on this topic.
-            #     Format is `projects/{project}/topics/{topic}`.
+            #     Required. Identifier. The messages in the request will be published on this
+            #     topic. Format is `projects/{project}/topics/{topic}`.
             #   @param messages [::Array<::Google::Cloud::PubSub::V1::PubsubMessage, ::Hash>]
             #     Required. The messages to publish.
             #
@@ -573,7 +573,7 @@ def publish request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param topic [::String]
-            #     Required. The name of the topic to get.
+            #     Required. Identifier. The name of the topic to get.
             #     Format is `projects/{project}/topics/{topic}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
@@ -659,7 +659,7 @@ def get_topic request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param project [::String]
-            #     Required. The name of the project in which to list topics.
+            #     Required. Identifier. The name of the project in which to list topics.
             #     Format is `projects/{project-id}`.
             #   @param page_size [::Integer]
             #     Optional. Maximum number of topics to return.
@@ -949,7 +949,7 @@ def list_topic_snapshots request, options = nil
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param topic [::String]
-            #     Required. Name of the topic to delete.
+            #     Required. Identifier. Name of the topic to delete.
             #     Format is `projects/{project}/topics/{topic}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation

google-cloud-pubsub-v1/lib/google/pubsub/v1/pubsub_pb.rb

@@ -775,7 +775,7 @@ class MessageTransform
         # A topic resource.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the topic. It must have the format
+        #     Required. 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
@@ -922,7 +922,7 @@ class AttributesEntry
         # Request for the GetTopic method.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     Required. The name of the topic to get.
+        #     Required. Identifier. The name of the topic to get.
         #     Format is `projects/{project}/topics/{topic}`.
         class GetTopicRequest
           include ::Google::Protobuf::MessageExts
@@ -948,8 +948,8 @@ class UpdateTopicRequest
         # Request for the Publish method.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     Required. The messages in the request will be published on this topic.
-        #     Format is `projects/{project}/topics/{topic}`.
+        #     Required. Identifier. The messages in the request will be published on this
+        #     topic. Format is `projects/{project}/topics/{topic}`.
         # @!attribute [rw] messages
         #   @return [::Array<::Google::Cloud::PubSub::V1::PubsubMessage>]
         #     Required. The messages to publish.
@@ -972,7 +972,7 @@ class PublishResponse
         # Request for the `ListTopics` method.
         # @!attribute [rw] project
         #   @return [::String]
-        #     Required. The name of the project in which to list topics.
+        #     Required. Identifier. The name of the project in which to list topics.
         #     Format is `projects/{project-id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -1068,7 +1068,7 @@ class ListTopicSnapshotsResponse
         # Request for the `DeleteTopic` method.
         # @!attribute [rw] topic
         #   @return [::String]
-        #     Required. Name of the topic to delete.
+        #     Required. Identifier. Name of the topic to delete.
         #     Format is `projects/{project}/topics/{topic}`.
         class DeleteTopicRequest
           include ::Google::Protobuf::MessageExts
@@ -1097,7 +1097,7 @@ class DetachSubscriptionResponse
         # using API methods. At most one of these fields may be set.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. The name of the subscription. It must have the format
+        #     Required. 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 (`~`),
@@ -1702,7 +1702,7 @@ class ReceivedMessage
         # Request for the GetSubscription method.
         # @!attribute [rw] subscription
         #   @return [::String]
-        #     Required. The name of the subscription to get.
+        #     Required. Identifier. The name of the subscription to get.
         #     Format is `projects/{project}/subscriptions/{sub}`.
         class GetSubscriptionRequest
           include ::Google::Protobuf::MessageExts
@@ -1725,8 +1725,8 @@ class UpdateSubscriptionRequest
         # Request for the `ListSubscriptions` method.
         # @!attribute [rw] project
         #   @return [::String]
-        #     Required. The name of the project in which to list subscriptions.
-        #     Format is `projects/{project-id}`.
+        #     Required. Identifier. The name of the project in which to list
+        #     subscriptions. Format is `projects/{project-id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of subscriptions to return.
@@ -1757,7 +1757,7 @@ class ListSubscriptionsResponse
         # Request for the DeleteSubscription method.
         # @!attribute [rw] subscription
         #   @return [::String]
-        #     Required. The subscription to delete.
+        #     Required. Identifier. The subscription to delete.
         #     Format is `projects/{project}/subscriptions/{sub}`.
         class DeleteSubscriptionRequest
           include ::Google::Protobuf::MessageExts
@@ -2017,10 +2017,10 @@ class SubscriptionProperties
         # Request for the `CreateSnapshot` method.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Required. 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
+        #     Required. 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}`.
         # @!attribute [rw] subscription
@@ -2125,7 +2125,7 @@ class LabelsEntry
         # Request for the GetSnapshot method.
         # @!attribute [rw] snapshot
         #   @return [::String]
-        #     Required. The name of the snapshot to get.
+        #     Required. Identifier. The name of the snapshot to get.
         #     Format is `projects/{project}/snapshots/{snap}`.
         class GetSnapshotRequest
           include ::Google::Protobuf::MessageExts
@@ -2135,7 +2135,7 @@ class GetSnapshotRequest
         # Request for the `ListSnapshots` method.
         # @!attribute [rw] project
         #   @return [::String]
-        #     Required. The name of the project in which to list snapshots.
+        #     Required. Identifier. The name of the project in which to list snapshots.
         #     Format is `projects/{project-id}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
@@ -2167,7 +2167,7 @@ class ListSnapshotsResponse
         # Request for the `DeleteSnapshot` method.
         # @!attribute [rw] snapshot
         #   @return [::String]
-        #     Required. The name of the snapshot to delete.
+        #     Required. Identifier. The name of the snapshot to delete.
         #     Format is `projects/{project}/snapshots/{snap}`.
         class DeleteSnapshotRequest
           include ::Google::Protobuf::MessageExts