feat(storage): update the api

#### storage:v1

The following keys were added:
- resources.objects.methods.get.parameters.restoreToken (Total Keys: 2)
- resources.objects.methods.restore.parameters.restoreToken (Total Keys: 2)
- schemas.Object.properties.restoreToken.type (Total Keys: 1)

The following keys were changed:
- endpoints (Total Keys: 1)

Author: yoshi-automation

docs/dyn/storage_v1.objects.html

@@ -90,13 +90,13 @@ <h2>Instance Methods</h2>
   <code><a href="#delete">delete(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, userProject=None)</a></code></p>
 <p class="firstline">Deletes an object and its metadata. Deletions are permanent if versioning is not enabled for the bucket, or if the generation parameter is used.</p>
 <p class="toc_element">
-  <code><a href="#get">get(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, softDeleted=None, userProject=None)</a></code></p>
+  <code><a href="#get">get(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, softDeleted=None, userProject=None)</a></code></p>
 <p class="firstline">Retrieves an object or its metadata.</p>
 <p class="toc_element">
   <code><a href="#getIamPolicy">getIamPolicy(bucket, object, generation=None, userProject=None)</a></code></p>
 <p class="firstline">Returns an IAM policy for the specified object.</p>
 <p class="toc_element">
-  <code><a href="#get_media">get_media(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, softDeleted=None, userProject=None)</a></code></p>
+  <code><a href="#get_media">get_media(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, softDeleted=None, userProject=None)</a></code></p>
 <p class="firstline">Retrieves an object or its metadata.</p>
 <p class="toc_element">
   <code><a href="#insert">insert(bucket, body=None, contentEncoding=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, kmsKeyName=None, media_body=None, media_mime_type=None, name=None, predefinedAcl=None, projection=None, userProject=None)</a></code></p>
@@ -111,7 +111,7 @@ <h2>Instance Methods</h2>
   <code><a href="#patch">patch(bucket, object, body=None, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, overrideUnlockedRetention=None, predefinedAcl=None, projection=None, userProject=None)</a></code></p>
 <p class="firstline">Patches an object's metadata.</p>
 <p class="toc_element">
-  <code><a href="#restore">restore(bucket, object, generation, copySourceAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, userProject=None)</a></code></p>
+  <code><a href="#restore">restore(bucket, object, generation, copySourceAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, userProject=None)</a></code></p>
 <p class="firstline">Restores a soft-deleted object.</p>
 <p class="toc_element">
   <code><a href="#rewrite">rewrite(sourceBucket, sourceObject, destinationBucket, destinationObject, body=None, destinationKmsKeyName=None, destinationPredefinedAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, ifSourceGenerationMatch=None, ifSourceGenerationNotMatch=None, ifSourceMetagenerationMatch=None, ifSourceMetagenerationNotMatch=None, maxBytesRewrittenPerCall=None, projection=None, rewriteToken=None, sourceGeneration=None, userProject=None)</a></code></p>
@@ -254,6 +254,7 @@ <h3>Method Details</h3>
       &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
       &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
     },
+    &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
     &quot;retention&quot;: { # A collection of object level retention parameters.
       &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
       &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -360,6 +361,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -452,6 +454,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -558,6 +561,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -592,7 +596,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="get">get(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, softDeleted=None, userProject=None)</code>
+    <code class="details" id="get">get(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, softDeleted=None, userProject=None)</code>
   <pre>Retrieves an object or its metadata.
 
 Args:
@@ -607,6 +611,7 @@ <h3>Method Details</h3>
     Allowed values
       full - Include all properties.
       noAcl - Omit the owner, acl property.
+  restoreToken: string, Restore token used to differentiate soft-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets and if softDeleted is set to true. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.
   softDeleted: boolean, If true, only soft-deleted object versions will be listed. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).
   userProject: string, The project to be billed for this request. Required for Requester Pays buckets.
 
@@ -676,6 +681,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -748,7 +754,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="get_media">get_media(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, softDeleted=None, userProject=None)</code>
+    <code class="details" id="get_media">get_media(bucket, object, generation=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, softDeleted=None, userProject=None)</code>
   <pre>Retrieves an object or its metadata.
 
 Args:
@@ -763,6 +769,7 @@ <h3>Method Details</h3>
     Allowed values
       full - Include all properties.
       noAcl - Omit the owner, acl property.
+  restoreToken: string, Restore token used to differentiate soft-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets and if softDeleted is set to true. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.
   softDeleted: boolean, If true, only soft-deleted object versions will be listed. The default is false. For more information, see [Soft Delete](https://cloud.google.com/storage/docs/soft-delete).
   userProject: string, The project to be billed for this request. Required for Requester Pays buckets.
 
@@ -844,6 +851,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -949,6 +957,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1057,6 +1066,7 @@ <h3>Method Details</h3>
         &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
         &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
       },
+      &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
       &quot;retention&quot;: { # A collection of object level retention parameters.
         &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
         &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1168,6 +1178,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1270,6 +1281,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1288,7 +1300,7 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="restore">restore(bucket, object, generation, copySourceAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, userProject=None)</code>
+    <code class="details" id="restore">restore(bucket, object, generation, copySourceAcl=None, ifGenerationMatch=None, ifGenerationNotMatch=None, ifMetagenerationMatch=None, ifMetagenerationNotMatch=None, projection=None, restoreToken=None, userProject=None)</code>
   <pre>Restores a soft-deleted object.
 
 Args:
@@ -1304,6 +1316,7 @@ <h3>Method Details</h3>
     Allowed values
       full - Include all properties.
       noAcl - Omit the owner, acl property.
+  restoreToken: string, Restore token used to differentiate sof-deleted objects with the same name and generation. Only applicable for hierarchical namespace buckets. This parameter is optional, and is only required in the rare case when there are multiple soft-deleted objects with the same name and generation.
   userProject: string, The project to be billed for this request. Required for Requester Pays buckets.
 
 Returns:
@@ -1372,6 +1385,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1464,6 +1478,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1576,6 +1591,7 @@ <h3>Method Details</h3>
       &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
       &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
     },
+    &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
     &quot;retention&quot;: { # A collection of object level retention parameters.
       &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
       &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1808,6 +1824,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.
@@ -1910,6 +1927,7 @@ <h3>Method Details</h3>
     &quot;entity&quot;: &quot;A String&quot;, # The entity, in the form user-userId.
     &quot;entityId&quot;: &quot;A String&quot;, # The ID for the entity.
   },
+  &quot;restoreToken&quot;: &quot;A String&quot;, # Restore token used to differentiate deleted objects with the same name and generation. This field is only returned for deleted objects in hierarchical namespace buckets.
   &quot;retention&quot;: { # A collection of object level retention parameters.
     &quot;mode&quot;: &quot;A String&quot;, # The bucket&#x27;s object retention mode, can only be Unlocked or Locked.
     &quot;retainUntilTime&quot;: &quot;A String&quot;, # A time in RFC 3339 format until which object retention protects this object.