Update docs for 1.4.1 release
diff --git a/docs/dyn/drive_v2.files.html b/docs/dyn/drive_v2.files.html
index 84af4ee..a931d37 100644
--- a/docs/dyn/drive_v2.files.html
+++ b/docs/dyn/drive_v2.files.html
@@ -79,21 +79,21 @@
<p class="firstline">Creates a copy of the specified file.</p>
<p class="toc_element">
<code><a href="#delete">delete(fileId)</a></code></p>
-<p class="firstline">Permanently deletes a file by ID. Skips the trash.</p>
+<p class="firstline">Permanently deletes a file by ID. Skips the trash. The currently authenticated user must own the file.</p>
<p class="toc_element">
<code><a href="#emptyTrash">emptyTrash()</a></code></p>
<p class="firstline">Permanently deletes all of the user's trashed files.</p>
<p class="toc_element">
- <code><a href="#get">get(fileId, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
+ <code><a href="#get">get(fileId, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
<p class="firstline">Gets a file's metadata by ID.</p>
<p class="toc_element">
- <code><a href="#get_media">get_media(fileId, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
+ <code><a href="#get_media">get_media(fileId, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
<p class="firstline">Gets a file's metadata by ID.</p>
<p class="toc_element">
<code><a href="#insert">insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, visibility=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)</a></code></p>
<p class="firstline">Insert a new file.</p>
<p class="toc_element">
- <code><a href="#list">list(q=None, projection=None, pageToken=None, maxResults=None, corpus=None)</a></code></p>
+ <code><a href="#list">list(q=None, projection=None, pageToken=None, maxResults=None, spaces=None, corpus=None)</a></code></p>
<p class="firstline">Lists the user's files.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -114,10 +114,10 @@
<code><a href="#update">update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, addParents=None, removeParents=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</a></code></p>
<p class="firstline">Updates file metadata and/or content.</p>
<p class="toc_element">
- <code><a href="#watch">watch(fileId, body, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
+ <code><a href="#watch">watch(fileId, body, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
<p class="firstline">Subscribe to changes on a file</p>
<p class="toc_element">
- <code><a href="#watch_media">watch_media(fileId, body, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
+ <code><a href="#watch_media">watch_media(fileId, body, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</a></code></p>
<p class="firstline">Subscribe to changes on a file</p>
<h3>Method Details</h3>
<div class="method">
@@ -134,13 +134,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -237,7 +237,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -278,7 +278,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -320,6 +325,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -333,7 +341,7 @@
Allowed values
DEFAULT - The visibility of the new file is determined by the user's default visibility/sharing policies.
PRIVATE - The new file will be visible to only the owner.
- ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
+ ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
timedTextLanguage: string, The language of the timed text.
timedTextTrackName: string, The timed text track name.
@@ -346,13 +354,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -449,7 +457,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -490,7 +498,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -532,6 +545,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -542,7 +558,7 @@
<div class="method">
<code class="details" id="delete">delete(fileId)</code>
- <pre>Permanently deletes a file by ID. Skips the trash.
+ <pre>Permanently deletes a file by ID. Skips the trash. The currently authenticated user must own the file.
Args:
fileId: string, The ID of the file to delete. (required)
@@ -558,7 +574,7 @@
</div>
<div class="method">
- <code class="details" id="get">get(fileId, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
+ <code class="details" id="get">get(fileId, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
<pre>Gets a file's metadata by ID.
Args:
@@ -567,6 +583,7 @@
Allowed values
BASIC - Deprecated
FULL - Deprecated
+ revisionId: string, Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
acknowledgeAbuse: boolean, Whether the user is acknowledging the risk of downloading known malware or other abusive files.
updateViewedDate: boolean, Whether to update the view date after successfully retrieving the file.
@@ -578,13 +595,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -681,7 +698,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -722,7 +739,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -764,6 +786,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -773,7 +798,7 @@
</div>
<div class="method">
- <code class="details" id="get_media">get_media(fileId, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
+ <code class="details" id="get_media">get_media(fileId, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
<pre>Gets a file's metadata by ID.
Args:
@@ -782,6 +807,7 @@
Allowed values
BASIC - Deprecated
FULL - Deprecated
+ revisionId: string, Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
acknowledgeAbuse: boolean, Whether the user is acknowledging the risk of downloading known malware or other abusive files.
updateViewedDate: boolean, Whether to update the view date after successfully retrieving the file.
@@ -804,13 +830,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -907,7 +933,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -948,7 +974,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -990,6 +1021,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -1004,7 +1038,7 @@
Allowed values
DEFAULT - The visibility of the new file is determined by the user's default visibility/sharing policies.
PRIVATE - The new file will be visible to only the owner.
- ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
+ ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
timedTextLanguage: string, The language of the timed text.
timedTextTrackName: string, The timed text track name.
@@ -1018,13 +1052,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -1121,7 +1155,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -1162,7 +1196,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -1204,6 +1243,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -1213,7 +1255,7 @@
</div>
<div class="method">
- <code class="details" id="list">list(q=None, projection=None, pageToken=None, maxResults=None, corpus=None)</code>
+ <code class="details" id="list">list(q=None, projection=None, pageToken=None, maxResults=None, spaces=None, corpus=None)</code>
<pre>Lists the user's files.
Args:
@@ -1224,6 +1266,7 @@
FULL - Deprecated
pageToken: string, Page token for files.
maxResults: integer, Maximum number of files to return.
+ spaces: string, A comma-separated list of spaces to query. Supported values are 'drive' and 'appDataFolder'.
corpus: string, The body of items (files/documents) to which the query applies.
Allowed values
DEFAULT - The items that the user has accessed.
@@ -1241,13 +1284,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -1344,7 +1387,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -1385,7 +1428,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -1427,6 +1475,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -1468,13 +1519,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -1571,7 +1622,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -1612,7 +1663,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -1654,6 +1710,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -1661,9 +1720,9 @@
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision is replaced. If true or not set, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
+ newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision is replaced. If true or not set, a new blob is created as head revision, and previous unpinned revisions are preserved for a short period of time. Pinned revisions are stored indefinitely, using additional storage quota, up to a maximum of 200 revisions.
pinned: boolean, Whether to pin the new revision. A file can have a maximum of 200 pinned revisions.
- ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
+ ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
addParents: string, Comma-separated list of parent IDs to add.
removeParents: string, Comma-separated list of parent IDs to remove.
@@ -1682,13 +1741,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -1785,7 +1844,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -1826,7 +1885,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -1868,6 +1932,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -1891,13 +1958,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -1994,7 +2061,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -2035,7 +2102,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -2077,6 +2149,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -2100,13 +2175,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -2203,7 +2278,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -2244,7 +2319,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -2286,6 +2366,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -2309,13 +2392,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -2412,7 +2495,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -2453,7 +2536,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -2495,6 +2583,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -2517,13 +2608,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -2620,7 +2711,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -2661,7 +2752,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -2703,6 +2799,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -2710,9 +2809,9 @@
"modifiedDate": "A String", # Last time this file was modified by anyone (formatted RFC 3339 timestamp). This is only mutable on update when the setModifiedDate parameter is set.
}
- newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision is replaced. If true or not set, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
+ newRevision: boolean, Whether a blob upload should create a new revision. If false, the blob data in the current head revision is replaced. If true or not set, a new blob is created as head revision, and previous unpinned revisions are preserved for a short period of time. Pinned revisions are stored indefinitely, using additional storage quota, up to a maximum of 200 revisions.
media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
- ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
+ ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are BCP 47 codes.
ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
pinned: boolean, Whether to pin the new revision. A file can have a maximum of 200 pinned revisions.
addParents: string, Comma-separated list of parent IDs to add.
@@ -2732,13 +2831,13 @@
"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
"version": "A String", # A monotonically increasing version number for the file. This reflects every change made to the file on the server, even those not visible to the requesting user.
"appDataContents": True or False, # Whether this file is in the Application Data folder.
- "thumbnailLink": "A String", # A link to the file's thumbnail.
+ "thumbnailLink": "A String", # A short-lived link to the file's thumbnail. Typically lasts on the order of hours.
"labels": { # A group of labels for the file.
"restricted": True or False, # Whether viewers are prevented from downloading this file.
"hidden": True or False, # Deprecated.
"viewed": True or False, # Whether this file has been viewed by this user.
"starred": True or False, # Whether this file is starred by the user.
- "trashed": True or False, # Whether this file has been trashed.
+ "trashed": True or False, # Whether this file has been trashed. This label applies to all users accessing the file; however, only owners are allowed to see and untrash files.
},
"indexableText": { # Indexable text attributes for the file (can only be written)
"text": "A String", # The text to be indexed for this file.
@@ -2835,7 +2934,7 @@
],
"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
"mimeType": "A String", # The MIME type of the thumbnail.
- "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
+ "image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image. It should conform to RFC 4648 section 5.
},
"openWithLinks": { # A map of the id of each of the user's apps to a link to open this file with that app. Only populated when the drive.apps.readonly scope is used.
"a_key": "A String",
@@ -2876,7 +2975,12 @@
"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
"createdDate": "A String", # Create time for this file (formatted RFC 3339 timestamp).
"properties": [ # The list of properties.
- { # A key-value pair that is either public or private to an application.
+ { # A key-value pair attached to a file that is either public or private to an application.
+ # The following limits apply to file properties:
+ # - Maximum of 100 properties total per file
+ # - Maximum of 30 private properties per app
+ # - Maximum of 30 public properties
+ # - Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.
"kind": "drive#property", # This is always drive#property.
"value": "A String", # The value of this property.
"etag": "A String", # ETag of the property.
@@ -2918,6 +3022,9 @@
],
"selfLink": "A String", # A link back to this permission.
},
+ "spaces": [ # The list of spaces which contain the file. Supported values are 'drive' and 'appDataFolder'.
+ "A String",
+ ],
"originalFilename": "A String", # The original filename if the file was uploaded manually, or the original title if the file was inserted through the API. Note that renames of the title will not change the original filename. This will only be populated on files with content stored in Drive.
"fileExtension": "A String", # The file extension used when downloading this file. This field is read only. To set the extension, include it in the title when creating the file. This is only populated for files with content stored in Drive.
"headRevisionId": "A String", # The ID of the file's head revision. This will only be populated for files with content stored in Drive.
@@ -2927,7 +3034,7 @@
</div>
<div class="method">
- <code class="details" id="watch">watch(fileId, body, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
+ <code class="details" id="watch">watch(fileId, body, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
<pre>Subscribe to changes on a file
Args:
@@ -2954,6 +3061,7 @@
Allowed values
BASIC - Deprecated
FULL - Deprecated
+ revisionId: string, Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
acknowledgeAbuse: boolean, Whether the user is acknowledging the risk of downloading known malware or other abusive files.
updateViewedDate: boolean, Whether to update the view date after successfully retrieving the file.
@@ -2977,7 +3085,7 @@
</div>
<div class="method">
- <code class="details" id="watch_media">watch_media(fileId, body, projection=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
+ <code class="details" id="watch_media">watch_media(fileId, body, projection=None, revisionId=None, acknowledgeAbuse=None, updateViewedDate=None)</code>
<pre>Subscribe to changes on a file
Args:
@@ -3004,6 +3112,7 @@
Allowed values
BASIC - Deprecated
FULL - Deprecated
+ revisionId: string, Specifies the Revision ID that should be downloaded. Ignored unless alt=media is specified.
acknowledgeAbuse: boolean, Whether the user is acknowledging the risk of downloading known malware or other abusive files.
updateViewedDate: boolean, Whether to update the view date after successfully retrieving the file.