feat: [PubSub] Annotate some resource fields with their corresponding API types (#8663)

* feat: Annotate some resource fields with their corresponding API types
feat: Add AwsKinesisFailureReason.ApiViolationReason
feat: Add tags to Subscription, Topic, and CreateSnapshotRequest messages for use in CreateSubscription, CreateTopic, and CreateSnapshot requests respectively
docs: A comment for field `received_messages` in message `.google.pubsub.v1.StreamingPullResponse` is changed

PiperOrigin-RevId: 820071518

Source-Link: googleapis/googleapis@e938992

Source-Link: googleapis/googleapis-gen@825a3ca
Copy-Tag: eyJwIjoiUHViU3ViLy5Pd2xCb3QueWFtbCIsImgiOiI4MjVhM2NhYTI0ZjBiZjE3MGYxYzU2ZWE1ZjJjZjczNGY4ZjlmYzUxIn0=

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

@@ -129,6 +129,27 @@ private static function getClientDefaults()
         ];
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a crypto_key
+     * resource.
+     *
+     * @param string $project
+     * @param string $location
+     * @param string $keyRing
+     * @param string $cryptoKey
+     *
+     * @return string The formatted crypto_key resource.
+     */
+    public static function cryptoKeyName(string $project, string $location, string $keyRing, string $cryptoKey): string
+    {
+        return self::getPathTemplate('cryptoKey')->render([
+            'project' => $project,
+            'location' => $location,
+            'key_ring' => $keyRing,
+            'crypto_key' => $cryptoKey,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a
      * _deleted-topic_ resource.
@@ -227,6 +248,7 @@ public static function topicName(string $project, string $topic): string
      * Parses a formatted name string and returns an associative array of the components in the name.
      * The following name formats are supported:
      * Template: Pattern
+     * - cryptoKey: projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}
      * - deletedTopic: _deleted-topic_
      * - project: projects/{project}
      * - projectTopic: projects/{project}/topics/{topic}

PubSub/src/V1/Client/PublisherClient.php

@@ -155,6 +155,27 @@ public static function deletedTopicName(): string
         return self::getPathTemplate('deletedTopic')->render([]);
     }
 
+    /**
+     * Formats a string containing the fully-qualified path to represent a listing
+     * resource.
+     *
+     * @param string $project
+     * @param string $location
+     * @param string $dataExchange
+     * @param string $listing
+     *
+     * @return string The formatted listing resource.
+     */
+    public static function listingName(string $project, string $location, string $dataExchange, string $listing): string
+    {
+        return self::getPathTemplate('listing')->render([
+            'project' => $project,
+            'location' => $location,
+            'data_exchange' => $dataExchange,
+            'listing' => $listing,
+        ]);
+    }
+
     /**
      * Formats a string containing the fully-qualified path to represent a project
      * resource.
@@ -243,6 +264,7 @@ public static function topicName(string $project, string $topic): string
      * The following name formats are supported:
      * Template: Pattern
      * - deletedTopic: _deleted-topic_
+     * - listing: projects/{project}/locations/{location}/dataExchanges/{data_exchange}/listings/{listing}
      * - project: projects/{project}
      * - projectTopic: projects/{project}/topics/{topic}
      * - snapshot: projects/{project}/snapshots/{snapshot}