feat(drive): update the api

#### drive:v2 The following keys were added: - resources.files.methods.generateIds.parameters.type (Total Keys: 3) - schemas.File.properties.exportLinks.readOnly (Total Keys: 1) #### drive:v3 The following keys were added: - resources.files.methods.generateIds.parameters.type (Total Keys: 3) - schemas.File.properties.exportLinks.readOnly (Total Keys: 1)
googleapis · May 15, 2021 · 8788823 · 8788823
1 parent 5e38240
commit 8788823
Show file tree

Hide file tree

Showing 5 changed files with 35 additions and 19 deletions.
diff --git a/docs/dyn/drive_v2.files.html b/docs/dyn/drive_v2.files.html
@@ -93,7 +93,7 @@ <h2>Instance Methods</h2>
   <code><a href="#export_media">export_media(fileId, mimeType)</a></code></p>
 <p class="firstline">Exports a Google Doc to the requested MIME type and returns the exported content. Please note that the exported content is limited to 10MB.</p>
 <p class="toc_element">
-  <code><a href="#generateIds">generateIds(maxResults=None, space=None)</a></code></p>
+  <code><a href="#generateIds">generateIds(maxResults=None, space=None, type=None)</a></code></p>
 <p class="firstline">Generates a set of file IDs which can be provided in insert or copy requests.</p>
 <p class="toc_element">
   <code><a href="#get">get(fileId, acknowledgeAbuse=None, includePermissionsForView=None, projection=None, revisionId=None, supportsAllDrives=None, supportsTeamDrives=None, updateViewedDate=None)</a></code></p>
@@ -941,12 +941,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="generateIds">generateIds(maxResults=None, space=None)</code>
+    <code class="details" id="generateIds">generateIds(maxResults=None, space=None, type=None)</code>
   <pre>Generates a set of file IDs which can be provided in insert or copy requests.
 
 Args:
   maxResults: integer, Maximum number of IDs to return.
-  space: string, The space in which the IDs can be used to create new files. Supported values are &#x27;drive&#x27; and &#x27;appDataFolder&#x27;.
+  space: string, The space in which the IDs can be used to create new files. Supported values are &#x27;drive&#x27; and &#x27;appDataFolder&#x27;. (Default: &#x27;drive&#x27;)
+  type: string, The type of items which the IDs can be used for. Supported values are &#x27;files&#x27; and &#x27;shortcuts&#x27;. Note that &#x27;shortcuts&#x27; are only supported in the drive &#x27;space&#x27;. (Default: &#x27;files&#x27;)
 
 Returns:
   An object of the form:

diff --git a/docs/dyn/drive_v2.revisions.html b/docs/dyn/drive_v2.revisions.html
@@ -146,7 +146,7 @@ <h3>Method Details</h3>
   &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
   &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
   &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
   &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
   &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
   &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.
@@ -194,7 +194,7 @@ <h3>Method Details</h3>
       &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
       &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
       &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-      &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+      &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
       &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
       &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
       &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.
@@ -256,7 +256,7 @@ <h3>Method Details</h3>
   &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
   &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
   &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
   &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
   &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
   &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.
@@ -292,7 +292,7 @@ <h3>Method Details</h3>
   &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
   &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
   &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
   &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
   &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
   &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.
@@ -335,7 +335,7 @@ <h3>Method Details</h3>
   &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
   &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
   &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
   &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
   &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
   &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.
@@ -371,7 +371,7 @@ <h3>Method Details</h3>
   &quot;mimeType&quot;: &quot;A String&quot;, # The MIME type of the revision.
   &quot;modifiedDate&quot;: &quot;A String&quot;, # Last time this revision was modified (formatted RFC 3339 timestamp).
   &quot;originalFilename&quot;: &quot;A String&quot;, # The original filename when this revision was created. This will only be populated on files with content stored in Drive.
-  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
+  &quot;pinned&quot;: True or False, # Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.
   &quot;publishAuto&quot;: True or False, # Whether subsequent revisions will be automatically republished. This is only populated and can only be modified for Docs Editors files.
   &quot;published&quot;: True or False, # Whether this revision is published. This is only populated and can only be modified for Docs Editors files.
   &quot;publishedLink&quot;: &quot;A String&quot;, # A link to the published revision. This is only populated for Google Sites files.

diff --git a/docs/dyn/drive_v3.files.html b/docs/dyn/drive_v3.files.html
@@ -96,7 +96,7 @@ <h2>Instance Methods</h2>
   <code><a href="#export_media">export_media(fileId, mimeType)</a></code></p>
 <p class="firstline">Exports a Google Doc to the requested MIME type and returns the exported content. Please note that the exported content is limited to 10MB.</p>
 <p class="toc_element">
-  <code><a href="#generateIds">generateIds(count=None, space=None)</a></code></p>
+  <code><a href="#generateIds">generateIds(count=None, space=None, type=None)</a></code></p>
 <p class="firstline">Generates a set of file IDs which can be provided in create or copy requests.</p>
 <p class="toc_element">
   <code><a href="#get">get(fileId, acknowledgeAbuse=None, includePermissionsForView=None, supportsAllDrives=None, supportsTeamDrives=None)</a></code></p>
@@ -1227,12 +1227,13 @@ <h3>Method Details</h3>
 </div>
 
 <div class="method">
-    <code class="details" id="generateIds">generateIds(count=None, space=None)</code>
+    <code class="details" id="generateIds">generateIds(count=None, space=None, type=None)</code>
   <pre>Generates a set of file IDs which can be provided in create or copy requests.
 
 Args:
   count: integer, The number of IDs to return.
-  space: string, The space in which the IDs can be used to create new files. Supported values are &#x27;drive&#x27; and &#x27;appDataFolder&#x27;.
+  space: string, The space in which the IDs can be used to create new files. Supported values are &#x27;drive&#x27; and &#x27;appDataFolder&#x27;. (Default: &#x27;drive&#x27;)
+  type: string, The type of items which the IDs can be used for. Supported values are &#x27;files&#x27; and &#x27;shortcuts&#x27;. Note that &#x27;shortcuts&#x27; are only supported in the drive &#x27;space&#x27;. (Default: &#x27;files&#x27;)
 
 Returns:
   An object of the form:

diff --git a/googleapiclient/discovery_cache/documents/drive.v2.json b/googleapiclient/discovery_cache/documents/drive.v2.json
@@ -38,7 +38,7 @@
   "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.",
   "discoveryVersion": "v1",
   "documentationLink": "https://developers.google.com/drive/",
-  "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/KIpWWHp2AAnVeDI5Q-eU9p19Y8M\"",
+  "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/xWq4REeLMQgpY35RBRyMF_22olo\"",
   "icons": {
     "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png",
     "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png"
@@ -1325,7 +1325,13 @@
             },
             "space": {
               "default": "drive",
-              "description": "The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'.",
+              "description": "The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive')",
+              "location": "query",
+              "type": "string"
+            },
+            "type": {
+              "default": "files",
+              "description": "The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the drive 'space'. (Default: 'files')",
               "location": "query",
               "type": "string"
             }
@@ -3521,7 +3527,7 @@
       }
     }
   },
-  "revision": "20210426",
+  "revision": "20210509",
   "rootUrl": "https://www.googleapis.com/",
   "schemas": {
     "About": {
@@ -4827,6 +4833,7 @@
             "type": "string"
           },
           "description": "Links for exporting Docs Editors files to specific formats.",
+          "readOnly": true,
           "type": "object"
         },
         "fileExtension": {
@@ -5704,7 +5711,7 @@
           "type": "string"
         },
         "pinned": {
-          "description": "Whether this revision is pinned to prevent automatic purging. This will only be populated and can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.",
+          "description": "Whether this revision is pinned to prevent automatic purging. If not set, the revision is automatically purged 30 days after newer content is uploaded. This field can only be modified on files with content stored in Drive, excluding Docs Editors files. Revisions can also be pinned when they are created through the drive.files.insert/update/copy by using the pinned query parameter. Pinned revisions are stored indefinitely using additional storage quota, up to a maximum of 200 revisions.",
           "type": "boolean"
         },
         "publishAuto": {

diff --git a/googleapiclient/discovery_cache/documents/drive.v3.json b/googleapiclient/discovery_cache/documents/drive.v3.json
@@ -35,7 +35,7 @@
   "description": "Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.",
   "discoveryVersion": "v1",
   "documentationLink": "https://developers.google.com/drive/",
-  "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/ZirnHyy4ccpvvaD5gWRKtW6Grhc\"",
+  "etag": "\"uWj2hSb4GVjzdDlAnRd2gbM1ZQ8/Feg8gV_ME3xYqXxzychzT-zuDJk\"",
   "icons": {
     "x16": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_16.png",
     "x32": "https://ssl.gstatic.com/docs/doclist/images/drive_icon_32.png"
@@ -1027,7 +1027,13 @@
             },
             "space": {
               "default": "drive",
-              "description": "The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'.",
+              "description": "The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive')",
+              "location": "query",
+              "type": "string"
+            },
+            "type": {
+              "default": "files",
+              "description": "The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the drive 'space'. (Default: 'files')",
               "location": "query",
               "type": "string"
             }
@@ -2185,7 +2191,7 @@
       }
     }
   },
-  "revision": "20210426",
+  "revision": "20210509",
   "rootUrl": "https://www.googleapis.com/",
   "schemas": {
     "About": {
@@ -2986,6 +2992,7 @@
             "type": "string"
           },
           "description": "Links for exporting Docs Editors files to specific formats.",
+          "readOnly": true,
           "type": "object"
         },
         "fileExtension": {