feat(pubsub): update the api

#### pubsub:v1

The following keys were added:
- schemas.Subscription.properties.topicMessageRetentionDuration (Total Keys: 3)
- schemas.Topic.properties.messageRetentionDuration (Total Keys: 2)

Author: yoshi-automation

docs/dyn/pubsub_v1.projects.subscriptions.html

@@ -197,6 +197,7 @@ <h3>Method Details</h3>
     &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
   },
   &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+  &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
 }
 
   x__xgafv: string, V1 error format.
@@ -240,6 +241,7 @@ <h3>Method Details</h3>
     &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
   },
   &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+  &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
 }</pre>
 </div>
 
@@ -326,6 +328,7 @@ <h3>Method Details</h3>
     &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
   },
   &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+  &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
 }</pre>
 </div>
 
@@ -416,6 +419,7 @@ <h3>Method Details</h3>
         &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
       },
       &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+      &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
     },
   ],
 }</pre>
@@ -540,6 +544,7 @@ <h3>Method Details</h3>
       &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
     },
     &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+    &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
   },
   &quot;updateMask&quot;: &quot;A String&quot;, # Required. Indicates which fields in the provided subscription to update. Must be specified and non-empty.
 }
@@ -585,6 +590,7 @@ <h3>Method Details</h3>
     &quot;minimumBackoff&quot;: &quot;A String&quot;, # The minimum delay between consecutive deliveries of a given message. Value should be between 0 and 600 seconds. Defaults to 10 seconds.
   },
   &quot;topic&quot;: &quot;A String&quot;, # Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.
+  &quot;topicMessageRetentionDuration&quot;: &quot;A String&quot;, # Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription&#x27;s topic. If this field is set, messages published to the subscription&#x27;s topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.
 }</pre>
 </div>
 

docs/dyn/pubsub_v1.projects.topics.html

@@ -137,6 +137,7 @@ <h3>Method Details</h3>
   &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
+  &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
   &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
     &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
       &quot;A String&quot;,
@@ -163,6 +164,7 @@ <h3>Method Details</h3>
   &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
+  &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
   &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
     &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
       &quot;A String&quot;,
@@ -214,6 +216,7 @@ <h3>Method Details</h3>
   &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
+  &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
   &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
     &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
       &quot;A String&quot;,
@@ -287,6 +290,7 @@ <h3>Method Details</h3>
       &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
         &quot;a_key&quot;: &quot;A String&quot;,
       },
+      &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
       &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
         &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
           &quot;A String&quot;,
@@ -332,6 +336,7 @@ <h3>Method Details</h3>
     &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
       &quot;a_key&quot;: &quot;A String&quot;,
     },
+    &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
     &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
       &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
         &quot;A String&quot;,
@@ -360,6 +365,7 @@ <h3>Method Details</h3>
   &quot;labels&quot;: { # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).
     &quot;a_key&quot;: &quot;A String&quot;,
   },
+  &quot;messageRetentionDuration&quot;: &quot;A String&quot;, # Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.
   &quot;messageStoragePolicy&quot;: { # A policy constraining the storage of messages published to the topic. # Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect.
     &quot;allowedPersistenceRegions&quot;: [ # A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.
       &quot;A String&quot;,

googleapiclient/discovery_cache/documents/pubsub.v1.json

@@ -1424,7 +1424,7 @@
       }
     }
   },
-  "revision": "20210720",
+  "revision": "20210727",
   "rootUrl": "https://pubsub.googleapis.com/",
   "schemas": {
     "AcknowledgeRequest": {
@@ -2058,6 +2058,12 @@
         "topic": {
           "description": "Required. The name of the topic from which this subscription is receiving messages. Format is `projects/{project}/topics/{topic}`. The value of this field will be `_deleted-topic_` if the topic has been deleted.",
           "type": "string"
+        },
+        "topicMessageRetentionDuration": {
+          "description": "Output only. Indicates the minimum duration for which a message is retained after it is published to the subscription's topic. If this field is set, messages published to the subscription's topic in the last `topic_message_retention_duration` are always available to subscribers. See the `message_retention_duration` field in `Topic`. This field is set only in responses from the server; it is ignored if it is set in any requests.",
+          "format": "google-duration",
+          "readOnly": true,
+          "type": "string"
         }
       },
       "type": "object"
@@ -2105,6 +2111,11 @@
           "description": "See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels).",
           "type": "object"
         },
+        "messageRetentionDuration": {
+          "description": "Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 7 days or less than 10 minutes.",
+          "format": "google-duration",
+          "type": "string"
+        },
         "messageStoragePolicy": {
           "$ref": "MessageStoragePolicy",
           "description": "Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect."

googleapiclient/discovery_cache/documents/pubsub.v1beta1a.json

@@ -457,7 +457,7 @@
       }
     }
   },
-  "revision": "20210720",
+  "revision": "20210727",
   "rootUrl": "https://pubsub.googleapis.com/",
   "schemas": {
     "AcknowledgeRequest": {

googleapiclient/discovery_cache/documents/pubsub.v1beta2.json

@@ -724,7 +724,7 @@
       }
     }
   },
-  "revision": "20210720",
+  "revision": "20210727",
   "rootUrl": "https://pubsub.googleapis.com/",
   "schemas": {
     "AcknowledgeRequest": {