Blame - docs/dyn/drive_v2.files.html - platform/external/python/google-api-python-client

blob: 407b827901ee668975f1e0bd72d44add83cff41c [file] [log] [blame]

Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1	<html><body>
				2	<style>
				3
				4	body, h1, h2, h3, div, span, p, pre, a {
				5	margin: 0;
				6	padding: 0;
				7	border: 0;
				8	font-weight: inherit;
				9	font-style: inherit;
				10	font-size: 100%;
				11	font-family: inherit;
				12	vertical-align: baseline;
				13	}
				14
				15	body {
				16	font-size: 13px;
				17	padding: 1em;
				18	}
				19
				20	h1 {
				21	font-size: 26px;
				22	margin-bottom: 1em;
				23	}
				24
				25	h2 {
				26	font-size: 24px;
				27	margin-bottom: 1em;
				28	}
				29
				30	h3 {
				31	font-size: 20px;
				32	margin-bottom: 1em;
				33	margin-top: 1em;
				34	}
				35
				36	pre, code {
				37	line-height: 1.5;
				38	font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
				39	}
				40
				41	pre {
				42	margin-top: 0.5em;
				43	}
				44
				45	h1, h2, h3, p {
				46	font-family: Arial, sans serif;
				47	}
				48
				49	h1, h2, h3 {
				50	border-bottom: solid #CCC 1px;
				51	}
				52
				53	.toc_element {
				54	margin-top: 0.5em;
				55	}
				56
				57	.firstline {
				58	margin-left: 2 em;
				59	}
				60
				61	.method {
				62	margin-top: 1em;
				63	border: solid 1px #CCC;
				64	padding: 1em;
				65	background: #EEE;
				66	}
				67
				68	.details {
				69	font-weight: bold;
				70	font-size: 14px;
				71	}
				72
				73	</style>
				74
				75	<h1><a href="drive_v2.html">Drive API</a> . <a href="drive_v2.files.html">files</a></h1>
				76	<h2>Instance Methods</h2>
				77	<p class="toc_element">
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	78	<code><a href="#copy">copy(fileId, body, pinned=None, convert=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None)</a></code></p>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	79	<p class="firstline">Creates a copy of the specified file.</p>
				80	<p class="toc_element">
				81	<code><a href="#delete">delete(fileId)</a></code></p>
				82	<p class="firstline">Permanently deletes a file by ID. Skips the trash.</p>
				83	<p class="toc_element">
				84	<code><a href="#get">get(fileId, projection=None, updateViewedDate=None)</a></code></p>
				85	<p class="firstline">Gets a file's metadata by ID.</p>
				86	<p class="toc_element">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	87	<code><a href="#insert">insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)</a></code></p>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	88	<p class="firstline">Insert a new file.</p>
				89	<p class="toc_element">
				90	<code><a href="#list">list(q=None, projection=None, pageToken=None, maxResults=None)</a></code></p>
				91	<p class="firstline">Lists the user's files.</p>
				92	<p class="toc_element">
				93	<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
				94	<p class="firstline">Retrieves the next page of results.</p>
				95	<p class="toc_element">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	96	<code><a href="#patch">patch(fileId, body, newRevision=None, pinned=None, ocrLanguage=None, ocr=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</a></code></p>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	97	<p class="firstline">Updates file metadata and/or content. This method supports patch semantics.</p>
				98	<p class="toc_element">
				99	<code><a href="#touch">touch(fileId)</a></code></p>
				100	<p class="firstline">Set the file's updated time to the current server time.</p>
				101	<p class="toc_element">
				102	<code><a href="#trash">trash(fileId)</a></code></p>
				103	<p class="firstline">Moves a file to the trash.</p>
				104	<p class="toc_element">
				105	<code><a href="#untrash">untrash(fileId)</a></code></p>
				106	<p class="firstline">Restores a file from the trash.</p>
				107	<p class="toc_element">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	108	<code><a href="#update">update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</a></code></p>
				109	<p class="firstline">Updates file metadata and/or content.</p>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	110	<h3>Method Details</h3>
				111	<div class="method">
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	112	<code class="details" id="copy">copy(fileId, body, pinned=None, convert=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None)</code>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	113	<pre>Creates a copy of the specified file.
				114
				115	Args:
				116	fileId: string, The ID of the file to copy. (required)
				117	body: object, The request body. (required)
				118	The object takes the form of:
				119
				120	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	121	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	122	"thumbnailLink": "A String", # A link to the file's thumbnail.
				123	"labels": { # A group of labels for the file.
				124	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				125	"hidden": True or False, # Whether this file is hidden from the user.
				126	"viewed": True or False, # Whether this file has been viewed by this user.
				127	"starred": True or False, # Whether this file is starred by the user.
				128	"trashed": True or False, # Whether this file has been trashed.
				129	},
				130	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	131	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	132	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	133	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	134	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	135	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	136	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	137	"owners": [ # The owner(s) of this file.
				138	{ # The JSON template for a user.
				139	"picture": { # The user's profile picture.
				140	"url": "A String", # A URL that points to a profile picture of this user.
				141	},
				142	"kind": "drive#user", # This is always drive#user.
				143	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				144	"displayName": "A String", # A plain text displayable name for this user.
				145	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				146	},
				147	],
				148	"id": "A String", # The ID of the file.
				149	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				150	"picture": { # The user's profile picture.
				151	"url": "A String", # A URL that points to a profile picture of this user.
				152	},
				153	"kind": "drive#user", # This is always drive#user.
				154	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				155	"displayName": "A String", # A plain text displayable name for this user.
				156	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				157	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	158	"title": "A String", # The title of this file.
				159	"ownerNames": [ # Name(s) of the owner(s) of this file.
				160	"A String",
				161	],
				162	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	163	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	164	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				165	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	166	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	167	{ # A reference to a file's parent.
				168	"selfLink": "A String", # A link back to this reference.
				169	"kind": "drive#parentReference", # This is always drive#parentReference.
				170	"id": "A String", # The ID of the parent.
				171	"isRoot": True or False, # Whether or not the parent is the root folder.
				172	"parentLink": "A String", # A link to the parent.
				173	},
				174	],
				175	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	176	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	177	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	178	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	179	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				180	"mimeType": "A String", # The MIME type of the thumbnail.
				181	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				182	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	183	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	184	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	185	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	186	"editable": True or False, # Whether the file can be edited by the current user.
				187	"kind": "drive#file", # The type of file. This is always drive#file.
				188	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	189	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	190	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	191	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	192	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	193	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	194	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	195	"exposureTime": 3.14, # The length of the exposure, in seconds.
				196	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	197	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	198	"isoSpeed": 42, # The ISO speed used to create the photo.
				199	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	200	"exposureMode": "A String", # The exposure mode used to create the photo.
				201	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	202	"location": { # Geographic location information stored in the image.
				203	"latitude": 3.14, # The latitude stored in the image.
				204	"altitude": 3.14, # The altitude stored in the image.
				205	"longitude": 3.14, # The longitude stored in the image.
				206	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	207	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				208	"height": 42, # The height of the image in pixels.
				209	"lens": "A String", # The lens used to create the photo.
				210	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				211	"width": 42, # The width of the image in pixels.
				212	"meteringMode": "A String", # The metering mode used to create the photo.
				213	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	214	"aperture": 3.14, # The aperture used to create the photo (f-number).
				215	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	216	"sensor": "A String", # The type of sensor used to create the photo.
				217	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	218	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	219	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	220	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	221	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				222	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	223	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				224	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	225	"withLink": True or False, # Whether the link is required for this permission.
				226	"kind": "drive#permission", # This is always drive#permission.
				227	"name": "A String", # The name for this permission.
				228	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				229	"id": "A String", # The ID of the permission.
				230	"authKey": "A String", # The authkey parameter required for this permission.
				231	"etag": "A String", # The ETag of the permission.
				232	"role": "A String", # The primary role for this user. Allowed values are:
				233	# - owner
				234	# - reader
				235	# - writer
				236	"photoLink": "A String", # A link to the profile photo, if available.
				237	"type": "A String", # The account type. Allowed values are:
				238	# - user
				239	# - group
				240	# - domain
				241	# - anyone
				242	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				243	"A String",
				244	],
				245	"selfLink": "A String", # A link back to this permission.
				246	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	247	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	248	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	249	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	250	}
				251
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	252	pinned: boolean, Whether to pin the head revision of the new copy.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	253	convert: boolean, Whether to convert this file to the corresponding Google Docs format.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	254	ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	255	ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	256	timedTextLanguage: string, The language of the timed text.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	257	timedTextTrackName: string, The timed text track name.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	258
				259	Returns:
				260	An object of the form:
				261
				262	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	263	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	264	"thumbnailLink": "A String", # A link to the file's thumbnail.
				265	"labels": { # A group of labels for the file.
				266	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				267	"hidden": True or False, # Whether this file is hidden from the user.
				268	"viewed": True or False, # Whether this file has been viewed by this user.
				269	"starred": True or False, # Whether this file is starred by the user.
				270	"trashed": True or False, # Whether this file has been trashed.
				271	},
				272	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	273	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	274	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	275	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	276	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	277	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	278	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	279	"owners": [ # The owner(s) of this file.
				280	{ # The JSON template for a user.
				281	"picture": { # The user's profile picture.
				282	"url": "A String", # A URL that points to a profile picture of this user.
				283	},
				284	"kind": "drive#user", # This is always drive#user.
				285	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				286	"displayName": "A String", # A plain text displayable name for this user.
				287	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				288	},
				289	],
				290	"id": "A String", # The ID of the file.
				291	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				292	"picture": { # The user's profile picture.
				293	"url": "A String", # A URL that points to a profile picture of this user.
				294	},
				295	"kind": "drive#user", # This is always drive#user.
				296	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				297	"displayName": "A String", # A plain text displayable name for this user.
				298	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				299	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	300	"title": "A String", # The title of this file.
				301	"ownerNames": [ # Name(s) of the owner(s) of this file.
				302	"A String",
				303	],
				304	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	305	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	306	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				307	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	308	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	309	{ # A reference to a file's parent.
				310	"selfLink": "A String", # A link back to this reference.
				311	"kind": "drive#parentReference", # This is always drive#parentReference.
				312	"id": "A String", # The ID of the parent.
				313	"isRoot": True or False, # Whether or not the parent is the root folder.
				314	"parentLink": "A String", # A link to the parent.
				315	},
				316	],
				317	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	318	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	319	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	320	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	321	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				322	"mimeType": "A String", # The MIME type of the thumbnail.
				323	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				324	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	325	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	326	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	327	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	328	"editable": True or False, # Whether the file can be edited by the current user.
				329	"kind": "drive#file", # The type of file. This is always drive#file.
				330	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	331	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	332	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	333	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	334	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	335	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	336	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	337	"exposureTime": 3.14, # The length of the exposure, in seconds.
				338	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	339	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	340	"isoSpeed": 42, # The ISO speed used to create the photo.
				341	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	342	"exposureMode": "A String", # The exposure mode used to create the photo.
				343	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	344	"location": { # Geographic location information stored in the image.
				345	"latitude": 3.14, # The latitude stored in the image.
				346	"altitude": 3.14, # The altitude stored in the image.
				347	"longitude": 3.14, # The longitude stored in the image.
				348	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	349	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				350	"height": 42, # The height of the image in pixels.
				351	"lens": "A String", # The lens used to create the photo.
				352	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				353	"width": 42, # The width of the image in pixels.
				354	"meteringMode": "A String", # The metering mode used to create the photo.
				355	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	356	"aperture": 3.14, # The aperture used to create the photo (f-number).
				357	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	358	"sensor": "A String", # The type of sensor used to create the photo.
				359	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	360	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	361	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	362	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	363	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				364	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	365	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				366	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	367	"withLink": True or False, # Whether the link is required for this permission.
				368	"kind": "drive#permission", # This is always drive#permission.
				369	"name": "A String", # The name for this permission.
				370	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				371	"id": "A String", # The ID of the permission.
				372	"authKey": "A String", # The authkey parameter required for this permission.
				373	"etag": "A String", # The ETag of the permission.
				374	"role": "A String", # The primary role for this user. Allowed values are:
				375	# - owner
				376	# - reader
				377	# - writer
				378	"photoLink": "A String", # A link to the profile photo, if available.
				379	"type": "A String", # The account type. Allowed values are:
				380	# - user
				381	# - group
				382	# - domain
				383	# - anyone
				384	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				385	"A String",
				386	],
				387	"selfLink": "A String", # A link back to this permission.
				388	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	389	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	390	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	391	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	392	}</pre>
				393	</div>
				394
				395	<div class="method">
				396	<code class="details" id="delete">delete(fileId)</code>
				397	<pre>Permanently deletes a file by ID. Skips the trash.
				398
				399	Args:
				400	fileId: string, The ID of the file to delete. (required)
				401	</pre>
				402	</div>
				403
				404	<div class="method">
				405	<code class="details" id="get">get(fileId, projection=None, updateViewedDate=None)</code>
				406	<pre>Gets a file's metadata by ID.
				407
				408	Args:
				409	fileId: string, The ID for the file in question. (required)
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	410	projection: string, This parameter is deprecated and has no function.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	411	Allowed values
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	412	BASIC - Deprecated
				413	FULL - Deprecated
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	414	updateViewedDate: boolean, Whether to update the view date after successfully retrieving the file.
				415
				416	Returns:
				417	An object of the form:
				418
				419	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	420	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	421	"thumbnailLink": "A String", # A link to the file's thumbnail.
				422	"labels": { # A group of labels for the file.
				423	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				424	"hidden": True or False, # Whether this file is hidden from the user.
				425	"viewed": True or False, # Whether this file has been viewed by this user.
				426	"starred": True or False, # Whether this file is starred by the user.
				427	"trashed": True or False, # Whether this file has been trashed.
				428	},
				429	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	430	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	431	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	432	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	433	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	434	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	435	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	436	"owners": [ # The owner(s) of this file.
				437	{ # The JSON template for a user.
				438	"picture": { # The user's profile picture.
				439	"url": "A String", # A URL that points to a profile picture of this user.
				440	},
				441	"kind": "drive#user", # This is always drive#user.
				442	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				443	"displayName": "A String", # A plain text displayable name for this user.
				444	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				445	},
				446	],
				447	"id": "A String", # The ID of the file.
				448	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				449	"picture": { # The user's profile picture.
				450	"url": "A String", # A URL that points to a profile picture of this user.
				451	},
				452	"kind": "drive#user", # This is always drive#user.
				453	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				454	"displayName": "A String", # A plain text displayable name for this user.
				455	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				456	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	457	"title": "A String", # The title of this file.
				458	"ownerNames": [ # Name(s) of the owner(s) of this file.
				459	"A String",
				460	],
				461	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	462	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	463	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				464	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	465	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	466	{ # A reference to a file's parent.
				467	"selfLink": "A String", # A link back to this reference.
				468	"kind": "drive#parentReference", # This is always drive#parentReference.
				469	"id": "A String", # The ID of the parent.
				470	"isRoot": True or False, # Whether or not the parent is the root folder.
				471	"parentLink": "A String", # A link to the parent.
				472	},
				473	],
				474	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	475	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	476	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	477	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	478	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				479	"mimeType": "A String", # The MIME type of the thumbnail.
				480	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				481	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	482	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	483	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	484	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	485	"editable": True or False, # Whether the file can be edited by the current user.
				486	"kind": "drive#file", # The type of file. This is always drive#file.
				487	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	488	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	489	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	490	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	491	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	492	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	493	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	494	"exposureTime": 3.14, # The length of the exposure, in seconds.
				495	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	496	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	497	"isoSpeed": 42, # The ISO speed used to create the photo.
				498	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	499	"exposureMode": "A String", # The exposure mode used to create the photo.
				500	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	501	"location": { # Geographic location information stored in the image.
				502	"latitude": 3.14, # The latitude stored in the image.
				503	"altitude": 3.14, # The altitude stored in the image.
				504	"longitude": 3.14, # The longitude stored in the image.
				505	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	506	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				507	"height": 42, # The height of the image in pixels.
				508	"lens": "A String", # The lens used to create the photo.
				509	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				510	"width": 42, # The width of the image in pixels.
				511	"meteringMode": "A String", # The metering mode used to create the photo.
				512	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	513	"aperture": 3.14, # The aperture used to create the photo (f-number).
				514	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	515	"sensor": "A String", # The type of sensor used to create the photo.
				516	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	517	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	518	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	519	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	520	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				521	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	522	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				523	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	524	"withLink": True or False, # Whether the link is required for this permission.
				525	"kind": "drive#permission", # This is always drive#permission.
				526	"name": "A String", # The name for this permission.
				527	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				528	"id": "A String", # The ID of the permission.
				529	"authKey": "A String", # The authkey parameter required for this permission.
				530	"etag": "A String", # The ETag of the permission.
				531	"role": "A String", # The primary role for this user. Allowed values are:
				532	# - owner
				533	# - reader
				534	# - writer
				535	"photoLink": "A String", # A link to the profile photo, if available.
				536	"type": "A String", # The account type. Allowed values are:
				537	# - user
				538	# - group
				539	# - domain
				540	# - anyone
				541	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				542	"A String",
				543	],
				544	"selfLink": "A String", # A link back to this permission.
				545	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	546	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	547	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	548	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	549	}</pre>
				550	</div>
				551
				552	<div class="method">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	553	<code class="details" id="insert">insert(body=None, media_body=None, convert=None, useContentAsIndexableText=None, ocrLanguage=None, ocr=None, timedTextLanguage=None, timedTextTrackName=None, pinned=None)</code>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	554	<pre>Insert a new file.
				555
				556	Args:
				557	body: object, The request body.
				558	The object takes the form of:
				559
				560	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	561	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	562	"thumbnailLink": "A String", # A link to the file's thumbnail.
				563	"labels": { # A group of labels for the file.
				564	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				565	"hidden": True or False, # Whether this file is hidden from the user.
				566	"viewed": True or False, # Whether this file has been viewed by this user.
				567	"starred": True or False, # Whether this file is starred by the user.
				568	"trashed": True or False, # Whether this file has been trashed.
				569	},
				570	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	571	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	572	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	573	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	574	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	575	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	576	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	577	"owners": [ # The owner(s) of this file.
				578	{ # The JSON template for a user.
				579	"picture": { # The user's profile picture.
				580	"url": "A String", # A URL that points to a profile picture of this user.
				581	},
				582	"kind": "drive#user", # This is always drive#user.
				583	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				584	"displayName": "A String", # A plain text displayable name for this user.
				585	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				586	},
				587	],
				588	"id": "A String", # The ID of the file.
				589	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				590	"picture": { # The user's profile picture.
				591	"url": "A String", # A URL that points to a profile picture of this user.
				592	},
				593	"kind": "drive#user", # This is always drive#user.
				594	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				595	"displayName": "A String", # A plain text displayable name for this user.
				596	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				597	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	598	"title": "A String", # The title of this file.
				599	"ownerNames": [ # Name(s) of the owner(s) of this file.
				600	"A String",
				601	],
				602	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	603	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	604	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				605	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	606	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	607	{ # A reference to a file's parent.
				608	"selfLink": "A String", # A link back to this reference.
				609	"kind": "drive#parentReference", # This is always drive#parentReference.
				610	"id": "A String", # The ID of the parent.
				611	"isRoot": True or False, # Whether or not the parent is the root folder.
				612	"parentLink": "A String", # A link to the parent.
				613	},
				614	],
				615	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	616	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	617	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	618	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	619	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				620	"mimeType": "A String", # The MIME type of the thumbnail.
				621	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				622	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	623	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	624	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	625	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	626	"editable": True or False, # Whether the file can be edited by the current user.
				627	"kind": "drive#file", # The type of file. This is always drive#file.
				628	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	629	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	630	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	631	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	632	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	633	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	634	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	635	"exposureTime": 3.14, # The length of the exposure, in seconds.
				636	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	637	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	638	"isoSpeed": 42, # The ISO speed used to create the photo.
				639	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	640	"exposureMode": "A String", # The exposure mode used to create the photo.
				641	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	642	"location": { # Geographic location information stored in the image.
				643	"latitude": 3.14, # The latitude stored in the image.
				644	"altitude": 3.14, # The altitude stored in the image.
				645	"longitude": 3.14, # The longitude stored in the image.
				646	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	647	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				648	"height": 42, # The height of the image in pixels.
				649	"lens": "A String", # The lens used to create the photo.
				650	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				651	"width": 42, # The width of the image in pixels.
				652	"meteringMode": "A String", # The metering mode used to create the photo.
				653	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	654	"aperture": 3.14, # The aperture used to create the photo (f-number).
				655	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	656	"sensor": "A String", # The type of sensor used to create the photo.
				657	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	658	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	659	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	660	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	661	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				662	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	663	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				664	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	665	"withLink": True or False, # Whether the link is required for this permission.
				666	"kind": "drive#permission", # This is always drive#permission.
				667	"name": "A String", # The name for this permission.
				668	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				669	"id": "A String", # The ID of the permission.
				670	"authKey": "A String", # The authkey parameter required for this permission.
				671	"etag": "A String", # The ETag of the permission.
				672	"role": "A String", # The primary role for this user. Allowed values are:
				673	# - owner
				674	# - reader
				675	# - writer
				676	"photoLink": "A String", # A link to the profile photo, if available.
				677	"type": "A String", # The account type. Allowed values are:
				678	# - user
				679	# - group
				680	# - domain
				681	# - anyone
				682	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				683	"A String",
				684	],
				685	"selfLink": "A String", # A link back to this permission.
				686	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	687	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	688	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	689	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	690	}
				691
				692	media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
				693	convert: boolean, Whether to convert this file to the corresponding Google Docs format.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	694	useContentAsIndexableText: boolean, Whether to use the content as indexable text.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	695	ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	696	ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	697	timedTextLanguage: string, The language of the timed text.
				698	timedTextTrackName: string, The timed text track name.
				699	pinned: boolean, Whether to pin the head revision of the uploaded file.
				700
				701	Returns:
				702	An object of the form:
				703
				704	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	705	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	706	"thumbnailLink": "A String", # A link to the file's thumbnail.
				707	"labels": { # A group of labels for the file.
				708	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				709	"hidden": True or False, # Whether this file is hidden from the user.
				710	"viewed": True or False, # Whether this file has been viewed by this user.
				711	"starred": True or False, # Whether this file is starred by the user.
				712	"trashed": True or False, # Whether this file has been trashed.
				713	},
				714	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	715	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	716	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	717	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	718	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	719	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	720	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	721	"owners": [ # The owner(s) of this file.
				722	{ # The JSON template for a user.
				723	"picture": { # The user's profile picture.
				724	"url": "A String", # A URL that points to a profile picture of this user.
				725	},
				726	"kind": "drive#user", # This is always drive#user.
				727	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				728	"displayName": "A String", # A plain text displayable name for this user.
				729	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				730	},
				731	],
				732	"id": "A String", # The ID of the file.
				733	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				734	"picture": { # The user's profile picture.
				735	"url": "A String", # A URL that points to a profile picture of this user.
				736	},
				737	"kind": "drive#user", # This is always drive#user.
				738	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				739	"displayName": "A String", # A plain text displayable name for this user.
				740	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				741	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	742	"title": "A String", # The title of this file.
				743	"ownerNames": [ # Name(s) of the owner(s) of this file.
				744	"A String",
				745	],
				746	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	747	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	748	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				749	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	750	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	751	{ # A reference to a file's parent.
				752	"selfLink": "A String", # A link back to this reference.
				753	"kind": "drive#parentReference", # This is always drive#parentReference.
				754	"id": "A String", # The ID of the parent.
				755	"isRoot": True or False, # Whether or not the parent is the root folder.
				756	"parentLink": "A String", # A link to the parent.
				757	},
				758	],
				759	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	760	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	761	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	762	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	763	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				764	"mimeType": "A String", # The MIME type of the thumbnail.
				765	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				766	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	767	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	768	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	769	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	770	"editable": True or False, # Whether the file can be edited by the current user.
				771	"kind": "drive#file", # The type of file. This is always drive#file.
				772	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	773	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	774	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	775	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	776	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	777	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	778	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	779	"exposureTime": 3.14, # The length of the exposure, in seconds.
				780	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	781	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	782	"isoSpeed": 42, # The ISO speed used to create the photo.
				783	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	784	"exposureMode": "A String", # The exposure mode used to create the photo.
				785	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	786	"location": { # Geographic location information stored in the image.
				787	"latitude": 3.14, # The latitude stored in the image.
				788	"altitude": 3.14, # The altitude stored in the image.
				789	"longitude": 3.14, # The longitude stored in the image.
				790	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	791	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				792	"height": 42, # The height of the image in pixels.
				793	"lens": "A String", # The lens used to create the photo.
				794	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				795	"width": 42, # The width of the image in pixels.
				796	"meteringMode": "A String", # The metering mode used to create the photo.
				797	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	798	"aperture": 3.14, # The aperture used to create the photo (f-number).
				799	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	800	"sensor": "A String", # The type of sensor used to create the photo.
				801	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	802	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	803	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	804	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	805	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				806	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	807	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				808	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	809	"withLink": True or False, # Whether the link is required for this permission.
				810	"kind": "drive#permission", # This is always drive#permission.
				811	"name": "A String", # The name for this permission.
				812	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				813	"id": "A String", # The ID of the permission.
				814	"authKey": "A String", # The authkey parameter required for this permission.
				815	"etag": "A String", # The ETag of the permission.
				816	"role": "A String", # The primary role for this user. Allowed values are:
				817	# - owner
				818	# - reader
				819	# - writer
				820	"photoLink": "A String", # A link to the profile photo, if available.
				821	"type": "A String", # The account type. Allowed values are:
				822	# - user
				823	# - group
				824	# - domain
				825	# - anyone
				826	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				827	"A String",
				828	],
				829	"selfLink": "A String", # A link back to this permission.
				830	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	831	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	832	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	833	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	834	}</pre>
				835	</div>
				836
				837	<div class="method">
				838	<code class="details" id="list">list(q=None, projection=None, pageToken=None, maxResults=None)</code>
				839	<pre>Lists the user's files.
				840
				841	Args:
				842	q: string, Query string for searching files.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	843	projection: string, This parameter is deprecated and has no function.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	844	Allowed values
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	845	BASIC - Deprecated
				846	FULL - Deprecated
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	847	pageToken: string, Page token for files.
				848	maxResults: integer, Maximum number of files to return.
				849
				850	Returns:
				851	An object of the form:
				852
				853	{ # A list of files.
				854	"nextPageToken": "A String", # The page token for the next page of files.
				855	"kind": "drive#fileList", # This is always drive#fileList.
				856	"items": [ # The actual list of files.
				857	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	858	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	859	"thumbnailLink": "A String", # A link to the file's thumbnail.
				860	"labels": { # A group of labels for the file.
				861	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				862	"hidden": True or False, # Whether this file is hidden from the user.
				863	"viewed": True or False, # Whether this file has been viewed by this user.
				864	"starred": True or False, # Whether this file is starred by the user.
				865	"trashed": True or False, # Whether this file has been trashed.
				866	},
				867	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	868	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	869	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	870	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	871	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	872	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	873	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	874	"owners": [ # The owner(s) of this file.
				875	{ # The JSON template for a user.
				876	"picture": { # The user's profile picture.
				877	"url": "A String", # A URL that points to a profile picture of this user.
				878	},
				879	"kind": "drive#user", # This is always drive#user.
				880	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				881	"displayName": "A String", # A plain text displayable name for this user.
				882	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				883	},
				884	],
				885	"id": "A String", # The ID of the file.
				886	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				887	"picture": { # The user's profile picture.
				888	"url": "A String", # A URL that points to a profile picture of this user.
				889	},
				890	"kind": "drive#user", # This is always drive#user.
				891	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				892	"displayName": "A String", # A plain text displayable name for this user.
				893	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				894	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	895	"title": "A String", # The title of this file.
				896	"ownerNames": [ # Name(s) of the owner(s) of this file.
				897	"A String",
				898	],
				899	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	900	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	901	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				902	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	903	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	904	{ # A reference to a file's parent.
				905	"selfLink": "A String", # A link back to this reference.
				906	"kind": "drive#parentReference", # This is always drive#parentReference.
				907	"id": "A String", # The ID of the parent.
				908	"isRoot": True or False, # Whether or not the parent is the root folder.
				909	"parentLink": "A String", # A link to the parent.
				910	},
				911	],
				912	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	913	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	914	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	915	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	916	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				917	"mimeType": "A String", # The MIME type of the thumbnail.
				918	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				919	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	920	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	921	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	922	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	923	"editable": True or False, # Whether the file can be edited by the current user.
				924	"kind": "drive#file", # The type of file. This is always drive#file.
				925	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	926	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	927	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	928	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	929	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	930	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	931	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	932	"exposureTime": 3.14, # The length of the exposure, in seconds.
				933	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	934	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	935	"isoSpeed": 42, # The ISO speed used to create the photo.
				936	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	937	"exposureMode": "A String", # The exposure mode used to create the photo.
				938	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	939	"location": { # Geographic location information stored in the image.
				940	"latitude": 3.14, # The latitude stored in the image.
				941	"altitude": 3.14, # The altitude stored in the image.
				942	"longitude": 3.14, # The longitude stored in the image.
				943	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	944	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				945	"height": 42, # The height of the image in pixels.
				946	"lens": "A String", # The lens used to create the photo.
				947	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				948	"width": 42, # The width of the image in pixels.
				949	"meteringMode": "A String", # The metering mode used to create the photo.
				950	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	951	"aperture": 3.14, # The aperture used to create the photo (f-number).
				952	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	953	"sensor": "A String", # The type of sensor used to create the photo.
				954	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	955	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	956	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	957	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	958	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				959	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	960	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				961	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	962	"withLink": True or False, # Whether the link is required for this permission.
				963	"kind": "drive#permission", # This is always drive#permission.
				964	"name": "A String", # The name for this permission.
				965	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				966	"id": "A String", # The ID of the permission.
				967	"authKey": "A String", # The authkey parameter required for this permission.
				968	"etag": "A String", # The ETag of the permission.
				969	"role": "A String", # The primary role for this user. Allowed values are:
				970	# - owner
				971	# - reader
				972	# - writer
				973	"photoLink": "A String", # A link to the profile photo, if available.
				974	"type": "A String", # The account type. Allowed values are:
				975	# - user
				976	# - group
				977	# - domain
				978	# - anyone
				979	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				980	"A String",
				981	],
				982	"selfLink": "A String", # A link back to this permission.
				983	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	984	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	985	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	986	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	987	},
				988	],
				989	"nextLink": "A String", # A link to the next page of files.
				990	"etag": "A String", # The ETag of the list.
				991	"selfLink": "A String", # A link back to this list.
				992	}</pre>
				993	</div>
				994
				995	<div class="method">
				996	<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
				997	<pre>Retrieves the next page of results.
				998
				999	Args:
				1000	previous_request: The request for the previous page. (required)
				1001	previous_response: The response from the request for the previous page. (required)
				1002
				1003	Returns:
				1004	A request object that you can call 'execute()' on to request the next
				1005	page. Returns None if there are no more items in the collection.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1006	</pre>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1007	</div>
				1008
				1009	<div class="method">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1010	<code class="details" id="patch">patch(fileId, body, newRevision=None, pinned=None, ocrLanguage=None, ocr=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</code>
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1011	<pre>Updates file metadata and/or content. This method supports patch semantics.
				1012
				1013	Args:
				1014	fileId: string, The ID of the file to update. (required)
				1015	body: object, The request body. (required)
				1016	The object takes the form of:
				1017
				1018	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1019	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1020	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1021	"labels": { # A group of labels for the file.
				1022	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1023	"hidden": True or False, # Whether this file is hidden from the user.
				1024	"viewed": True or False, # Whether this file has been viewed by this user.
				1025	"starred": True or False, # Whether this file is starred by the user.
				1026	"trashed": True or False, # Whether this file has been trashed.
				1027	},
				1028	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1029	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1030	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1031	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1032	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1033	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1034	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1035	"owners": [ # The owner(s) of this file.
				1036	{ # The JSON template for a user.
				1037	"picture": { # The user's profile picture.
				1038	"url": "A String", # A URL that points to a profile picture of this user.
				1039	},
				1040	"kind": "drive#user", # This is always drive#user.
				1041	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1042	"displayName": "A String", # A plain text displayable name for this user.
				1043	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1044	},
				1045	],
				1046	"id": "A String", # The ID of the file.
				1047	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1048	"picture": { # The user's profile picture.
				1049	"url": "A String", # A URL that points to a profile picture of this user.
				1050	},
				1051	"kind": "drive#user", # This is always drive#user.
				1052	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1053	"displayName": "A String", # A plain text displayable name for this user.
				1054	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1055	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1056	"title": "A String", # The title of this file.
				1057	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1058	"A String",
				1059	],
				1060	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1061	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1062	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1063	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1064	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1065	{ # A reference to a file's parent.
				1066	"selfLink": "A String", # A link back to this reference.
				1067	"kind": "drive#parentReference", # This is always drive#parentReference.
				1068	"id": "A String", # The ID of the parent.
				1069	"isRoot": True or False, # Whether or not the parent is the root folder.
				1070	"parentLink": "A String", # A link to the parent.
				1071	},
				1072	],
				1073	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1074	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1075	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1076	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1077	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1078	"mimeType": "A String", # The MIME type of the thumbnail.
				1079	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1080	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1081	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1082	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1083	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1084	"editable": True or False, # Whether the file can be edited by the current user.
				1085	"kind": "drive#file", # The type of file. This is always drive#file.
				1086	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1087	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1088	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1089	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1090	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1091	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1092	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1093	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1094	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1095	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1096	"isoSpeed": 42, # The ISO speed used to create the photo.
				1097	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1098	"exposureMode": "A String", # The exposure mode used to create the photo.
				1099	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1100	"location": { # Geographic location information stored in the image.
				1101	"latitude": 3.14, # The latitude stored in the image.
				1102	"altitude": 3.14, # The altitude stored in the image.
				1103	"longitude": 3.14, # The longitude stored in the image.
				1104	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1105	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1106	"height": 42, # The height of the image in pixels.
				1107	"lens": "A String", # The lens used to create the photo.
				1108	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1109	"width": 42, # The width of the image in pixels.
				1110	"meteringMode": "A String", # The metering mode used to create the photo.
				1111	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1112	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1113	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1114	"sensor": "A String", # The type of sensor used to create the photo.
				1115	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1116	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1117	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1118	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1119	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1120	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1121	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1122	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1123	"withLink": True or False, # Whether the link is required for this permission.
				1124	"kind": "drive#permission", # This is always drive#permission.
				1125	"name": "A String", # The name for this permission.
				1126	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1127	"id": "A String", # The ID of the permission.
				1128	"authKey": "A String", # The authkey parameter required for this permission.
				1129	"etag": "A String", # The ETag of the permission.
				1130	"role": "A String", # The primary role for this user. Allowed values are:
				1131	# - owner
				1132	# - reader
				1133	# - writer
				1134	"photoLink": "A String", # A link to the profile photo, if available.
				1135	"type": "A String", # The account type. Allowed values are:
				1136	# - user
				1137	# - group
				1138	# - domain
				1139	# - anyone
				1140	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1141	"A String",
				1142	],
				1143	"selfLink": "A String", # A link back to this permission.
				1144	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1145	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1146	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1147	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1148	}
				1149
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1150	newRevision: boolean, Whether a blob upload should create a new revision. If not set or false, the blob data in the current head revision is replaced. If true, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1151	pinned: boolean, Whether to pin the new revision.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1152	ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1153	ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1154	updateViewedDate: boolean, Whether to update the view date after successfully updating the file.
				1155	timedTextTrackName: string, The timed text track name.
				1156	convert: boolean, Whether to convert this file to the corresponding Google Docs format.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1157	useContentAsIndexableText: boolean, Whether to use the content as indexable text.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1158	setModifiedDate: boolean, Whether to set the modified date with the supplied modified date.
				1159	timedTextLanguage: string, The language of the timed text.
				1160
				1161	Returns:
				1162	An object of the form:
				1163
				1164	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1165	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1166	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1167	"labels": { # A group of labels for the file.
				1168	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1169	"hidden": True or False, # Whether this file is hidden from the user.
				1170	"viewed": True or False, # Whether this file has been viewed by this user.
				1171	"starred": True or False, # Whether this file is starred by the user.
				1172	"trashed": True or False, # Whether this file has been trashed.
				1173	},
				1174	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1175	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1176	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1177	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1178	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1179	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1180	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1181	"owners": [ # The owner(s) of this file.
				1182	{ # The JSON template for a user.
				1183	"picture": { # The user's profile picture.
				1184	"url": "A String", # A URL that points to a profile picture of this user.
				1185	},
				1186	"kind": "drive#user", # This is always drive#user.
				1187	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1188	"displayName": "A String", # A plain text displayable name for this user.
				1189	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1190	},
				1191	],
				1192	"id": "A String", # The ID of the file.
				1193	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1194	"picture": { # The user's profile picture.
				1195	"url": "A String", # A URL that points to a profile picture of this user.
				1196	},
				1197	"kind": "drive#user", # This is always drive#user.
				1198	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1199	"displayName": "A String", # A plain text displayable name for this user.
				1200	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1201	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1202	"title": "A String", # The title of this file.
				1203	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1204	"A String",
				1205	],
				1206	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1207	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1208	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1209	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1210	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1211	{ # A reference to a file's parent.
				1212	"selfLink": "A String", # A link back to this reference.
				1213	"kind": "drive#parentReference", # This is always drive#parentReference.
				1214	"id": "A String", # The ID of the parent.
				1215	"isRoot": True or False, # Whether or not the parent is the root folder.
				1216	"parentLink": "A String", # A link to the parent.
				1217	},
				1218	],
				1219	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1220	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1221	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1222	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1223	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1224	"mimeType": "A String", # The MIME type of the thumbnail.
				1225	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1226	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1227	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1228	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1229	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1230	"editable": True or False, # Whether the file can be edited by the current user.
				1231	"kind": "drive#file", # The type of file. This is always drive#file.
				1232	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1233	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1234	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1235	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1236	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1237	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1238	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1239	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1240	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1241	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1242	"isoSpeed": 42, # The ISO speed used to create the photo.
				1243	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1244	"exposureMode": "A String", # The exposure mode used to create the photo.
				1245	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1246	"location": { # Geographic location information stored in the image.
				1247	"latitude": 3.14, # The latitude stored in the image.
				1248	"altitude": 3.14, # The altitude stored in the image.
				1249	"longitude": 3.14, # The longitude stored in the image.
				1250	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1251	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1252	"height": 42, # The height of the image in pixels.
				1253	"lens": "A String", # The lens used to create the photo.
				1254	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1255	"width": 42, # The width of the image in pixels.
				1256	"meteringMode": "A String", # The metering mode used to create the photo.
				1257	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1258	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1259	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1260	"sensor": "A String", # The type of sensor used to create the photo.
				1261	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1262	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1263	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1264	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1265	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1266	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1267	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1268	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1269	"withLink": True or False, # Whether the link is required for this permission.
				1270	"kind": "drive#permission", # This is always drive#permission.
				1271	"name": "A String", # The name for this permission.
				1272	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1273	"id": "A String", # The ID of the permission.
				1274	"authKey": "A String", # The authkey parameter required for this permission.
				1275	"etag": "A String", # The ETag of the permission.
				1276	"role": "A String", # The primary role for this user. Allowed values are:
				1277	# - owner
				1278	# - reader
				1279	# - writer
				1280	"photoLink": "A String", # A link to the profile photo, if available.
				1281	"type": "A String", # The account type. Allowed values are:
				1282	# - user
				1283	# - group
				1284	# - domain
				1285	# - anyone
				1286	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1287	"A String",
				1288	],
				1289	"selfLink": "A String", # A link back to this permission.
				1290	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1291	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1292	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1293	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1294	}</pre>
				1295	</div>
				1296
				1297	<div class="method">
				1298	<code class="details" id="touch">touch(fileId)</code>
				1299	<pre>Set the file's updated time to the current server time.
				1300
				1301	Args:
				1302	fileId: string, The ID of the file to update. (required)
				1303
				1304	Returns:
				1305	An object of the form:
				1306
				1307	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1308	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1309	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1310	"labels": { # A group of labels for the file.
				1311	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1312	"hidden": True or False, # Whether this file is hidden from the user.
				1313	"viewed": True or False, # Whether this file has been viewed by this user.
				1314	"starred": True or False, # Whether this file is starred by the user.
				1315	"trashed": True or False, # Whether this file has been trashed.
				1316	},
				1317	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1318	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1319	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1320	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1321	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1322	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1323	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1324	"owners": [ # The owner(s) of this file.
				1325	{ # The JSON template for a user.
				1326	"picture": { # The user's profile picture.
				1327	"url": "A String", # A URL that points to a profile picture of this user.
				1328	},
				1329	"kind": "drive#user", # This is always drive#user.
				1330	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1331	"displayName": "A String", # A plain text displayable name for this user.
				1332	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1333	},
				1334	],
				1335	"id": "A String", # The ID of the file.
				1336	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1337	"picture": { # The user's profile picture.
				1338	"url": "A String", # A URL that points to a profile picture of this user.
				1339	},
				1340	"kind": "drive#user", # This is always drive#user.
				1341	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1342	"displayName": "A String", # A plain text displayable name for this user.
				1343	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1344	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1345	"title": "A String", # The title of this file.
				1346	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1347	"A String",
				1348	],
				1349	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1350	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1351	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1352	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1353	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1354	{ # A reference to a file's parent.
				1355	"selfLink": "A String", # A link back to this reference.
				1356	"kind": "drive#parentReference", # This is always drive#parentReference.
				1357	"id": "A String", # The ID of the parent.
				1358	"isRoot": True or False, # Whether or not the parent is the root folder.
				1359	"parentLink": "A String", # A link to the parent.
				1360	},
				1361	],
				1362	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1363	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1364	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1365	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1366	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1367	"mimeType": "A String", # The MIME type of the thumbnail.
				1368	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1369	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1370	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1371	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1372	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1373	"editable": True or False, # Whether the file can be edited by the current user.
				1374	"kind": "drive#file", # The type of file. This is always drive#file.
				1375	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1376	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1377	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1378	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1379	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1380	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1381	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1382	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1383	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1384	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1385	"isoSpeed": 42, # The ISO speed used to create the photo.
				1386	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1387	"exposureMode": "A String", # The exposure mode used to create the photo.
				1388	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1389	"location": { # Geographic location information stored in the image.
				1390	"latitude": 3.14, # The latitude stored in the image.
				1391	"altitude": 3.14, # The altitude stored in the image.
				1392	"longitude": 3.14, # The longitude stored in the image.
				1393	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1394	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1395	"height": 42, # The height of the image in pixels.
				1396	"lens": "A String", # The lens used to create the photo.
				1397	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1398	"width": 42, # The width of the image in pixels.
				1399	"meteringMode": "A String", # The metering mode used to create the photo.
				1400	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1401	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1402	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1403	"sensor": "A String", # The type of sensor used to create the photo.
				1404	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1405	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1406	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1407	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1408	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1409	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1410	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1411	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1412	"withLink": True or False, # Whether the link is required for this permission.
				1413	"kind": "drive#permission", # This is always drive#permission.
				1414	"name": "A String", # The name for this permission.
				1415	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1416	"id": "A String", # The ID of the permission.
				1417	"authKey": "A String", # The authkey parameter required for this permission.
				1418	"etag": "A String", # The ETag of the permission.
				1419	"role": "A String", # The primary role for this user. Allowed values are:
				1420	# - owner
				1421	# - reader
				1422	# - writer
				1423	"photoLink": "A String", # A link to the profile photo, if available.
				1424	"type": "A String", # The account type. Allowed values are:
				1425	# - user
				1426	# - group
				1427	# - domain
				1428	# - anyone
				1429	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1430	"A String",
				1431	],
				1432	"selfLink": "A String", # A link back to this permission.
				1433	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1434	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1435	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1436	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1437	}</pre>
				1438	</div>
				1439
				1440	<div class="method">
				1441	<code class="details" id="trash">trash(fileId)</code>
				1442	<pre>Moves a file to the trash.
				1443
				1444	Args:
				1445	fileId: string, The ID of the file to trash. (required)
				1446
				1447	Returns:
				1448	An object of the form:
				1449
				1450	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1451	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1452	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1453	"labels": { # A group of labels for the file.
				1454	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1455	"hidden": True or False, # Whether this file is hidden from the user.
				1456	"viewed": True or False, # Whether this file has been viewed by this user.
				1457	"starred": True or False, # Whether this file is starred by the user.
				1458	"trashed": True or False, # Whether this file has been trashed.
				1459	},
				1460	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1461	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1462	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1463	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1464	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1465	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1466	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1467	"owners": [ # The owner(s) of this file.
				1468	{ # The JSON template for a user.
				1469	"picture": { # The user's profile picture.
				1470	"url": "A String", # A URL that points to a profile picture of this user.
				1471	},
				1472	"kind": "drive#user", # This is always drive#user.
				1473	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1474	"displayName": "A String", # A plain text displayable name for this user.
				1475	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1476	},
				1477	],
				1478	"id": "A String", # The ID of the file.
				1479	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1480	"picture": { # The user's profile picture.
				1481	"url": "A String", # A URL that points to a profile picture of this user.
				1482	},
				1483	"kind": "drive#user", # This is always drive#user.
				1484	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1485	"displayName": "A String", # A plain text displayable name for this user.
				1486	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1487	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1488	"title": "A String", # The title of this file.
				1489	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1490	"A String",
				1491	],
				1492	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1493	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1494	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1495	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1496	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1497	{ # A reference to a file's parent.
				1498	"selfLink": "A String", # A link back to this reference.
				1499	"kind": "drive#parentReference", # This is always drive#parentReference.
				1500	"id": "A String", # The ID of the parent.
				1501	"isRoot": True or False, # Whether or not the parent is the root folder.
				1502	"parentLink": "A String", # A link to the parent.
				1503	},
				1504	],
				1505	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1506	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1507	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1508	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1509	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1510	"mimeType": "A String", # The MIME type of the thumbnail.
				1511	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1512	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1513	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1514	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1515	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1516	"editable": True or False, # Whether the file can be edited by the current user.
				1517	"kind": "drive#file", # The type of file. This is always drive#file.
				1518	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1519	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1520	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1521	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1522	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1523	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1524	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1525	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1526	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1527	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1528	"isoSpeed": 42, # The ISO speed used to create the photo.
				1529	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1530	"exposureMode": "A String", # The exposure mode used to create the photo.
				1531	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1532	"location": { # Geographic location information stored in the image.
				1533	"latitude": 3.14, # The latitude stored in the image.
				1534	"altitude": 3.14, # The altitude stored in the image.
				1535	"longitude": 3.14, # The longitude stored in the image.
				1536	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1537	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1538	"height": 42, # The height of the image in pixels.
				1539	"lens": "A String", # The lens used to create the photo.
				1540	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1541	"width": 42, # The width of the image in pixels.
				1542	"meteringMode": "A String", # The metering mode used to create the photo.
				1543	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1544	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1545	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1546	"sensor": "A String", # The type of sensor used to create the photo.
				1547	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1548	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1549	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1550	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1551	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1552	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1553	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1554	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1555	"withLink": True or False, # Whether the link is required for this permission.
				1556	"kind": "drive#permission", # This is always drive#permission.
				1557	"name": "A String", # The name for this permission.
				1558	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1559	"id": "A String", # The ID of the permission.
				1560	"authKey": "A String", # The authkey parameter required for this permission.
				1561	"etag": "A String", # The ETag of the permission.
				1562	"role": "A String", # The primary role for this user. Allowed values are:
				1563	# - owner
				1564	# - reader
				1565	# - writer
				1566	"photoLink": "A String", # A link to the profile photo, if available.
				1567	"type": "A String", # The account type. Allowed values are:
				1568	# - user
				1569	# - group
				1570	# - domain
				1571	# - anyone
				1572	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1573	"A String",
				1574	],
				1575	"selfLink": "A String", # A link back to this permission.
				1576	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1577	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1578	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1579	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1580	}</pre>
				1581	</div>
				1582
				1583	<div class="method">
				1584	<code class="details" id="untrash">untrash(fileId)</code>
				1585	<pre>Restores a file from the trash.
				1586
				1587	Args:
				1588	fileId: string, The ID of the file to untrash. (required)
				1589
				1590	Returns:
				1591	An object of the form:
				1592
				1593	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1594	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1595	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1596	"labels": { # A group of labels for the file.
				1597	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1598	"hidden": True or False, # Whether this file is hidden from the user.
				1599	"viewed": True or False, # Whether this file has been viewed by this user.
				1600	"starred": True or False, # Whether this file is starred by the user.
				1601	"trashed": True or False, # Whether this file has been trashed.
				1602	},
				1603	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1604	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1605	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1606	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1607	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1608	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1609	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1610	"owners": [ # The owner(s) of this file.
				1611	{ # The JSON template for a user.
				1612	"picture": { # The user's profile picture.
				1613	"url": "A String", # A URL that points to a profile picture of this user.
				1614	},
				1615	"kind": "drive#user", # This is always drive#user.
				1616	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1617	"displayName": "A String", # A plain text displayable name for this user.
				1618	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1619	},
				1620	],
				1621	"id": "A String", # The ID of the file.
				1622	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1623	"picture": { # The user's profile picture.
				1624	"url": "A String", # A URL that points to a profile picture of this user.
				1625	},
				1626	"kind": "drive#user", # This is always drive#user.
				1627	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1628	"displayName": "A String", # A plain text displayable name for this user.
				1629	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1630	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1631	"title": "A String", # The title of this file.
				1632	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1633	"A String",
				1634	],
				1635	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1636	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1637	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1638	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1639	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1640	{ # A reference to a file's parent.
				1641	"selfLink": "A String", # A link back to this reference.
				1642	"kind": "drive#parentReference", # This is always drive#parentReference.
				1643	"id": "A String", # The ID of the parent.
				1644	"isRoot": True or False, # Whether or not the parent is the root folder.
				1645	"parentLink": "A String", # A link to the parent.
				1646	},
				1647	],
				1648	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1649	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1650	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1651	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1652	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1653	"mimeType": "A String", # The MIME type of the thumbnail.
				1654	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1655	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1656	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1657	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1658	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1659	"editable": True or False, # Whether the file can be edited by the current user.
				1660	"kind": "drive#file", # The type of file. This is always drive#file.
				1661	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1662	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1663	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1664	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1665	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1666	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1667	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1668	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1669	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1670	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1671	"isoSpeed": 42, # The ISO speed used to create the photo.
				1672	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1673	"exposureMode": "A String", # The exposure mode used to create the photo.
				1674	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1675	"location": { # Geographic location information stored in the image.
				1676	"latitude": 3.14, # The latitude stored in the image.
				1677	"altitude": 3.14, # The altitude stored in the image.
				1678	"longitude": 3.14, # The longitude stored in the image.
				1679	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1680	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1681	"height": 42, # The height of the image in pixels.
				1682	"lens": "A String", # The lens used to create the photo.
				1683	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1684	"width": 42, # The width of the image in pixels.
				1685	"meteringMode": "A String", # The metering mode used to create the photo.
				1686	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1687	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1688	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1689	"sensor": "A String", # The type of sensor used to create the photo.
				1690	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1691	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1692	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1693	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1694	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1695	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1696	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1697	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1698	"withLink": True or False, # Whether the link is required for this permission.
				1699	"kind": "drive#permission", # This is always drive#permission.
				1700	"name": "A String", # The name for this permission.
				1701	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1702	"id": "A String", # The ID of the permission.
				1703	"authKey": "A String", # The authkey parameter required for this permission.
				1704	"etag": "A String", # The ETag of the permission.
				1705	"role": "A String", # The primary role for this user. Allowed values are:
				1706	# - owner
				1707	# - reader
				1708	# - writer
				1709	"photoLink": "A String", # A link to the profile photo, if available.
				1710	"type": "A String", # The account type. Allowed values are:
				1711	# - user
				1712	# - group
				1713	# - domain
				1714	# - anyone
				1715	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1716	"A String",
				1717	],
				1718	"selfLink": "A String", # A link back to this permission.
				1719	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1720	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1721	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1722	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1723	}</pre>
				1724	</div>
				1725
				1726	<div class="method">
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1727	<code class="details" id="update">update(fileId, body=None, newRevision=None, media_body=None, ocrLanguage=None, ocr=None, pinned=None, updateViewedDate=None, timedTextTrackName=None, convert=None, useContentAsIndexableText=None, setModifiedDate=None, timedTextLanguage=None)</code>
				1728	<pre>Updates file metadata and/or content.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1729
				1730	Args:
				1731	fileId: string, The ID of the file to update. (required)
				1732	body: object, The request body.
				1733	The object takes the form of:
				1734
				1735	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1736	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1737	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1738	"labels": { # A group of labels for the file.
				1739	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1740	"hidden": True or False, # Whether this file is hidden from the user.
				1741	"viewed": True or False, # Whether this file has been viewed by this user.
				1742	"starred": True or False, # Whether this file is starred by the user.
				1743	"trashed": True or False, # Whether this file has been trashed.
				1744	},
				1745	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1746	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1747	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1748	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1749	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1750	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1751	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1752	"owners": [ # The owner(s) of this file.
				1753	{ # The JSON template for a user.
				1754	"picture": { # The user's profile picture.
				1755	"url": "A String", # A URL that points to a profile picture of this user.
				1756	},
				1757	"kind": "drive#user", # This is always drive#user.
				1758	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1759	"displayName": "A String", # A plain text displayable name for this user.
				1760	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1761	},
				1762	],
				1763	"id": "A String", # The ID of the file.
				1764	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1765	"picture": { # The user's profile picture.
				1766	"url": "A String", # A URL that points to a profile picture of this user.
				1767	},
				1768	"kind": "drive#user", # This is always drive#user.
				1769	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1770	"displayName": "A String", # A plain text displayable name for this user.
				1771	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1772	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1773	"title": "A String", # The title of this file.
				1774	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1775	"A String",
				1776	],
				1777	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1778	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1779	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1780	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1781	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1782	{ # A reference to a file's parent.
				1783	"selfLink": "A String", # A link back to this reference.
				1784	"kind": "drive#parentReference", # This is always drive#parentReference.
				1785	"id": "A String", # The ID of the parent.
				1786	"isRoot": True or False, # Whether or not the parent is the root folder.
				1787	"parentLink": "A String", # A link to the parent.
				1788	},
				1789	],
				1790	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1791	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1792	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1793	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1794	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1795	"mimeType": "A String", # The MIME type of the thumbnail.
				1796	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1797	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1798	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1799	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1800	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1801	"editable": True or False, # Whether the file can be edited by the current user.
				1802	"kind": "drive#file", # The type of file. This is always drive#file.
				1803	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1804	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1805	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1806	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1807	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1808	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1809	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1810	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1811	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1812	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1813	"isoSpeed": 42, # The ISO speed used to create the photo.
				1814	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1815	"exposureMode": "A String", # The exposure mode used to create the photo.
				1816	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1817	"location": { # Geographic location information stored in the image.
				1818	"latitude": 3.14, # The latitude stored in the image.
				1819	"altitude": 3.14, # The altitude stored in the image.
				1820	"longitude": 3.14, # The longitude stored in the image.
				1821	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1822	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1823	"height": 42, # The height of the image in pixels.
				1824	"lens": "A String", # The lens used to create the photo.
				1825	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1826	"width": 42, # The width of the image in pixels.
				1827	"meteringMode": "A String", # The metering mode used to create the photo.
				1828	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1829	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1830	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1831	"sensor": "A String", # The type of sensor used to create the photo.
				1832	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1833	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1834	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1835	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1836	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1837	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1838	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1839	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1840	"withLink": True or False, # Whether the link is required for this permission.
				1841	"kind": "drive#permission", # This is always drive#permission.
				1842	"name": "A String", # The name for this permission.
				1843	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1844	"id": "A String", # The ID of the permission.
				1845	"authKey": "A String", # The authkey parameter required for this permission.
				1846	"etag": "A String", # The ETag of the permission.
				1847	"role": "A String", # The primary role for this user. Allowed values are:
				1848	# - owner
				1849	# - reader
				1850	# - writer
				1851	"photoLink": "A String", # A link to the profile photo, if available.
				1852	"type": "A String", # The account type. Allowed values are:
				1853	# - user
				1854	# - group
				1855	# - domain
				1856	# - anyone
				1857	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				1858	"A String",
				1859	],
				1860	"selfLink": "A String", # A link back to this permission.
				1861	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1862	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1863	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1864	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1865	}
				1866
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1867	newRevision: boolean, Whether a blob upload should create a new revision. If not set or false, the blob data in the current head revision is replaced. If true, a new blob is created as head revision, and previous revisions are preserved (causing increased use of the user's data storage quota).
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1868	media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1869	ocrLanguage: string, If ocr is true, hints at the language to use. Valid values are ISO 639-1 codes.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1870	ocr: boolean, Whether to attempt OCR on .jpg, .png, .gif, or .pdf uploads.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1871	pinned: boolean, Whether to pin the new revision.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1872	updateViewedDate: boolean, Whether to update the view date after successfully updating the file.
				1873	timedTextTrackName: string, The timed text track name.
				1874	convert: boolean, Whether to convert this file to the corresponding Google Docs format.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1875	useContentAsIndexableText: boolean, Whether to use the content as indexable text.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1876	setModifiedDate: boolean, Whether to set the modified date with the supplied modified date.
				1877	timedTextLanguage: string, The language of the timed text.
				1878
				1879	Returns:
				1880	An object of the form:
				1881
				1882	{ # The metadata for a file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1883	"mimeType": "A String", # The MIME type of the file. This is only mutable on update when uploading new content. This field can be left blank, and the mimetype will be determined from the uploaded content's MIME type.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1884	"thumbnailLink": "A String", # A link to the file's thumbnail.
				1885	"labels": { # A group of labels for the file.
				1886	"restricted": True or False, # Whether viewers are prevented from downloading this file.
				1887	"hidden": True or False, # Whether this file is hidden from the user.
				1888	"viewed": True or False, # Whether this file has been viewed by this user.
				1889	"starred": True or False, # Whether this file is starred by the user.
				1890	"trashed": True or False, # Whether this file has been trashed.
				1891	},
				1892	"indexableText": { # Indexable text attributes for the file (can only be written)
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1893	"text": "A String", # The text to be indexed for this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1894	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1895	"explicitlyTrashed": True or False, # Whether this file has been explicitly trashed, as opposed to recursively trashed. This will only be populated if the file is trashed.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1896	"etag": "A String", # ETag of the file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1897	"lastModifyingUserName": "A String", # Name of the last user to modify this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1898	"writersCanShare": True or False, # Whether writers can share the document with other users.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1899	"owners": [ # The owner(s) of this file.
				1900	{ # The JSON template for a user.
				1901	"picture": { # The user's profile picture.
				1902	"url": "A String", # A URL that points to a profile picture of this user.
				1903	},
				1904	"kind": "drive#user", # This is always drive#user.
				1905	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1906	"displayName": "A String", # A plain text displayable name for this user.
				1907	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1908	},
				1909	],
				1910	"id": "A String", # The ID of the file.
				1911	"lastModifyingUser": { # The JSON template for a user. # The last user to modify this file.
				1912	"picture": { # The user's profile picture.
				1913	"url": "A String", # A URL that points to a profile picture of this user.
				1914	},
				1915	"kind": "drive#user", # This is always drive#user.
				1916	"isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
				1917	"displayName": "A String", # A plain text displayable name for this user.
				1918	"permissionId": "A String", # The user's ID as visible in the permissions collection.
				1919	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1920	"title": "A String", # The title of this file.
				1921	"ownerNames": [ # Name(s) of the owner(s) of this file.
				1922	"A String",
				1923	],
				1924	"sharedWithMeDate": "A String", # Time at which this file was shared with the user (formatted RFC 3339 timestamp).
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1925	"webViewLink": "A String", # A link only available on public folders for viewing their static web assets (HTML, CSS, JS, etc) via Google Drive's Website Hosting.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1926	"lastViewedByMeDate": "A String", # Last time this file was viewed by the user (formatted RFC 3339 timestamp).
				1927	"parents": [ # Collection of parent folders which contain this file.
Joe Gregorio	e7a0c47	2012-07-12 11:46:04 -0400	[diff] [blame]	1928	# Setting this field will put the file in all of the provided folders. On insert, if no folders are provided, the file will be placed in the default root folder.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1929	{ # A reference to a file's parent.
				1930	"selfLink": "A String", # A link back to this reference.
				1931	"kind": "drive#parentReference", # This is always drive#parentReference.
				1932	"id": "A String", # The ID of the parent.
				1933	"isRoot": True or False, # Whether or not the parent is the root folder.
				1934	"parentLink": "A String", # A link to the parent.
				1935	},
				1936	],
				1937	"exportLinks": { # Links for exporting Google Docs to specific formats.
Joe Gregorio	fa08c2e	2012-07-23 16:52:03 -0400	[diff] [blame]	1938	"a_key": "A String", # A mapping from export format to URL
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1939	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1940	"shared": True or False, # Whether the file has been shared.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1941	"thumbnail": { # Thumbnail for the file. Only accepted on upload and for files that are not already thumbnailed by Google.
				1942	"mimeType": "A String", # The MIME type of the thumbnail.
				1943	"image": "A String", # The URL-safe Base64 encoded bytes of the thumbnail image.
				1944	},
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1945	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1946	"description": "A String", # A short description of the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1947	"webContentLink": "A String", # A link for downloading the content of the file in a browser using cookie based authentication. In cases where the content is shared publicly, the content can be downloaded without any credentials.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1948	"editable": True or False, # Whether the file can be edited by the current user.
				1949	"kind": "drive#file", # The type of file. This is always drive#file.
				1950	"quotaBytesUsed": "A String", # The number of quota bytes used by this file.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1951	"fileSize": "A String", # The size of the file in bytes. This is only populated for files with content stored in Drive.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1952	"createdDate": "A String", # Create time for this file (formatted ISO8601 timestamp).
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1953	"md5Checksum": "A String", # An MD5 checksum for the content of this file. This is populated only for files with content stored in Drive.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1954	"iconLink": "A String", # A link to the file's icon.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1955	"imageMediaMetadata": { # Metadata about image media. This will only be present for image types, and its contents will depend on what can be parsed from the image content.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1956	"exposureBias": 3.14, # The exposure bias of the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1957	"exposureTime": 3.14, # The length of the exposure, in seconds.
				1958	"cameraMake": "A String", # The make of the camera used to create the photo.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1959	"maxApertureValue": 3.14, # The smallest f-number of the lens at the focal length used to create the photo (APEX value).
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1960	"isoSpeed": 42, # The ISO speed used to create the photo.
				1961	"focalLength": 3.14, # The focal length used to create the photo, in millimeters.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1962	"exposureMode": "A String", # The exposure mode used to create the photo.
				1963	"colorSpace": "A String", # The color space of the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1964	"location": { # Geographic location information stored in the image.
				1965	"latitude": 3.14, # The latitude stored in the image.
				1966	"altitude": 3.14, # The altitude stored in the image.
				1967	"longitude": 3.14, # The longitude stored in the image.
				1968	},
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1969	"subjectDistance": 42, # The distance to the subject of the photo, in meters.
				1970	"height": 42, # The height of the image in pixels.
				1971	"lens": "A String", # The lens used to create the photo.
				1972	"date": "A String", # The date and time the photo was taken (EXIF format timestamp).
				1973	"width": 42, # The width of the image in pixels.
				1974	"meteringMode": "A String", # The metering mode used to create the photo.
				1975	"flashUsed": True or False, # Whether a flash was used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1976	"aperture": 3.14, # The aperture used to create the photo (f-number).
				1977	"rotation": 42, # The rotation in clockwise degrees from the image's original orientation.
Joe Gregorio	52a5c53	2013-01-24 16:19:07 -0500	[diff] [blame]	1978	"sensor": "A String", # The type of sensor used to create the photo.
				1979	"whiteBalance": "A String", # The white balance mode used to create the photo.
Joe Gregorio	d67010d	2012-11-05 08:57:06 -0500	[diff] [blame]	1980	"cameraModel": "A String", # The model of the camera used to create the photo.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1981	},
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1982	"embedLink": "A String", # A link for embedding the file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	1983	"alternateLink": "A String", # A link for opening the file in using a relevant Google editor or viewer.
				1984	"modifiedByMeDate": "A String", # Last time this file was modified by the user (formatted RFC 3339 timestamp). Note that setting modifiedDate will also update the modifiedByMe date for the user which set the date.
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	1985	"downloadUrl": "A String", # Short lived download URL for the file. This is only populated for files with content stored in Drive.
				1986	"userPermission": { # A permission for a file. # The permissions for the authenticated user on this file.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	1987	"withLink": True or False, # Whether the link is required for this permission.
				1988	"kind": "drive#permission", # This is always drive#permission.
				1989	"name": "A String", # The name for this permission.
				1990	"value": "A String", # The email address or domain name for the entity. This is not populated in responses.
				1991	"id": "A String", # The ID of the permission.
				1992	"authKey": "A String", # The authkey parameter required for this permission.
				1993	"etag": "A String", # The ETag of the permission.
				1994	"role": "A String", # The primary role for this user. Allowed values are:
				1995	# - owner
				1996	# - reader
				1997	# - writer
				1998	"photoLink": "A String", # A link to the profile photo, if available.
				1999	"type": "A String", # The account type. Allowed values are:
				2000	# - user
				2001	# - group
				2002	# - domain
				2003	# - anyone
				2004	"additionalRoles": [ # Additional roles for this user. Only commenter is currently allowed.
				2005	"A String",
				2006	],
				2007	"selfLink": "A String", # A link back to this permission.
				2008	},
Joe Gregorio	41be8e8	2013-03-07 10:31:47 -0500	[diff] [blame]	2009	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	2010	"selfLink": "A String", # A link back to this file.
Joe Gregorio	ad8013f	2012-08-03 08:44:02 -0400	[diff] [blame]	2011	"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.
Joe Gregorio	075572b	2012-07-09 16:53:09 -0400	[diff] [blame]	2012	}</pre>
				2013	</div>
				2014
				2015	</body></html>