Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 708388c41ae3a2cb759c33dfda1159a837a49d7c / . / docs / dyn / drive.v1.files.html
blob: 1e8dd14c6fce7f6884a295aa44ef429dd7db6e89 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><title>Python: class Resource</title>
</head><body bgcolor="#f0f0f8">
<p>
<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
<tr bgcolor="#ffc8d8">
<td colspan=3 valign=bottom>&nbsp;<br>
<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>
<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
<td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
<tr><td>&nbsp;</td>
<td width="100%">Methods defined here:<br>
<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>
<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Gets&nbsp;a&nbsp;file's&nbsp;metadata&nbsp;by&nbsp;id.<br>
&nbsp;<br>
Args:<br>
&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;projection:&nbsp;string,&nbsp;Restrict&nbsp;information&nbsp;returned&nbsp;for&nbsp;simplicity&nbsp;and&nbsp;optimization.<br>
&nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;BASIC&nbsp;-&nbsp;Includes&nbsp;only&nbsp;the&nbsp;basic&nbsp;metadata&nbsp;fields<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;FULL&nbsp;-&nbsp;Includes&nbsp;all&nbsp;metadata&nbsp;fields<br>
&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;updateViewedDate:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;update&nbsp;the&nbsp;view&nbsp;date&nbsp;after&nbsp;successfully&nbsp;retrieving&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;id:&nbsp;string,&nbsp;The&nbsp;id&nbsp;for&nbsp;the&nbsp;file&nbsp;in&nbsp;question.&nbsp;(required)<br>
&nbsp;<br>
Returns:<br>
&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
<dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Inserts&nbsp;a&nbsp;file,&nbsp;and&nbsp;any&nbsp;settable&nbsp;metadata&nbsp;or&nbsp;blob&nbsp;content&nbsp;sent&nbsp;with&nbsp;the&nbsp;request.<br>
&nbsp;<br>
Args:<br>
&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.<br>
&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
&nbsp;<br>
{<br>
&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;}<br>
&nbsp;<br>
&nbsp;&nbsp;media_body:&nbsp;string,&nbsp;The&nbsp;filename&nbsp;of&nbsp;the&nbsp;media&nbsp;request&nbsp;body.<br>
&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;<br>
Returns:<br>
&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
<dl><dt><a name="Resource-patch"><strong>patch</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;file&nbsp;metadata&nbsp;and/or&nbsp;content.&nbsp;This&nbsp;method&nbsp;supports&nbsp;patch&nbsp;semantics.<br>
&nbsp;<br>
Args:<br>
&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
&nbsp;<br>
{<br>
&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;}<br>
&nbsp;<br>
&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;newRevision:&nbsp;boolean,&nbsp;Whether&nbsp;a&nbsp;blob&nbsp;upload&nbsp;should&nbsp;create&nbsp;a&nbsp;new&nbsp;revision.&nbsp;If&nbsp;not&nbsp;set&nbsp;or&nbsp;false,&nbsp;the&nbsp;blob&nbsp;data&nbsp;in&nbsp;the&nbsp;current&nbsp;head&nbsp;revision&nbsp;will&nbsp;be&nbsp;replaced.<br>
&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;updateViewedDate:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;update&nbsp;the&nbsp;view&nbsp;date&nbsp;after&nbsp;successfully&nbsp;updating&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;updateModifiedDate:&nbsp;boolean,&nbsp;Controls&nbsp;updating&nbsp;the&nbsp;modified&nbsp;date&nbsp;of&nbsp;the&nbsp;file.&nbsp;If&nbsp;true,&nbsp;the&nbsp;modified&nbsp;date&nbsp;will&nbsp;be&nbsp;updated&nbsp;to&nbsp;the&nbsp;current&nbsp;time,&nbsp;regardless&nbsp;of&nbsp;whether&nbsp;other&nbsp;changes&nbsp;are&nbsp;being&nbsp;made.&nbsp;If&nbsp;false,&nbsp;the&nbsp;modified&nbsp;date&nbsp;will&nbsp;only&nbsp;be&nbsp;updated&nbsp;to&nbsp;the&nbsp;current&nbsp;time&nbsp;if&nbsp;other&nbsp;changes&nbsp;are&nbsp;also&nbsp;being&nbsp;made&nbsp;(changing&nbsp;the&nbsp;title,&nbsp;for&nbsp;example).<br>
&nbsp;&nbsp;id:&nbsp;string,&nbsp;The&nbsp;id&nbsp;for&nbsp;the&nbsp;file&nbsp;in&nbsp;question.&nbsp;(required)<br>
&nbsp;<br>
Returns:<br>
&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
<dl><dt><a name="Resource-update"><strong>update</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;file&nbsp;metadata&nbsp;and/or&nbsp;content<br>
&nbsp;<br>
Args:<br>
&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.<br>
&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
&nbsp;<br>
{<br>
&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;}<br>
&nbsp;<br>
&nbsp;&nbsp;media_body:&nbsp;string,&nbsp;The&nbsp;filename&nbsp;of&nbsp;the&nbsp;media&nbsp;request&nbsp;body.<br>
&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;newRevision:&nbsp;boolean,&nbsp;Whether&nbsp;a&nbsp;blob&nbsp;upload&nbsp;should&nbsp;create&nbsp;a&nbsp;new&nbsp;revision.&nbsp;If&nbsp;not&nbsp;set&nbsp;or&nbsp;false,&nbsp;the&nbsp;blob&nbsp;data&nbsp;in&nbsp;the&nbsp;current&nbsp;head&nbsp;revision&nbsp;will&nbsp;be&nbsp;replaced.<br>
&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
&nbsp;&nbsp;updateViewedDate:&nbsp;boolean,&nbsp;Whether&nbsp;to&nbsp;update&nbsp;the&nbsp;view&nbsp;date&nbsp;after&nbsp;successfully&nbsp;updating&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;updateModifiedDate:&nbsp;boolean,&nbsp;Controls&nbsp;updating&nbsp;the&nbsp;modified&nbsp;date&nbsp;of&nbsp;the&nbsp;file.&nbsp;If&nbsp;true,&nbsp;the&nbsp;modified&nbsp;date&nbsp;will&nbsp;be&nbsp;updated&nbsp;to&nbsp;the&nbsp;current&nbsp;time,&nbsp;regardless&nbsp;of&nbsp;whether&nbsp;other&nbsp;changes&nbsp;are&nbsp;being&nbsp;made.&nbsp;If&nbsp;false,&nbsp;the&nbsp;modified&nbsp;date&nbsp;will&nbsp;only&nbsp;be&nbsp;updated&nbsp;to&nbsp;the&nbsp;current&nbsp;time&nbsp;if&nbsp;other&nbsp;changes&nbsp;are&nbsp;also&nbsp;being&nbsp;made&nbsp;(changing&nbsp;the&nbsp;title,&nbsp;for&nbsp;example).<br>
&nbsp;&nbsp;id:&nbsp;string,&nbsp;The&nbsp;id&nbsp;for&nbsp;the&nbsp;file&nbsp;in&nbsp;question.&nbsp;(required)<br>
&nbsp;<br>
Returns:<br>
&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
&nbsp;<br>
&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mimeType":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;mimetype&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;back&nbsp;to&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#file",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;file.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;short&nbsp;description&nbsp;of&nbsp;the&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"title":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;title&nbsp;of&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedByMeDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;the&nbsp;user&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"labels":&nbsp;{&nbsp;#&nbsp;Labels&nbsp;for&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"hidden":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;hidden&nbsp;from&nbsp;the&nbsp;user<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"starred":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;is&nbsp;starred&nbsp;by&nbsp;the&nbsp;user.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"trashed":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Whether&nbsp;this&nbsp;file&nbsp;has&nbsp;been&nbsp;trashed.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"indexableText":&nbsp;{&nbsp;#&nbsp;Indexable&nbsp;text&nbsp;attributes&nbsp;for&nbsp;the&nbsp;file&nbsp;(can&nbsp;only&nbsp;be&nbsp;written)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"text":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;text&nbsp;to&nbsp;be&nbsp;indexed&nbsp;for&nbsp;this&nbsp;file<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentsCollection":&nbsp;[&nbsp;#&nbsp;Collection&nbsp;of&nbsp;parent&nbsp;folders&nbsp;which&nbsp;contain&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;On&nbsp;insert,&nbsp;setting&nbsp;this&nbsp;field&nbsp;will&nbsp;put&nbsp;the&nbsp;file&nbsp;in&nbsp;all&nbsp;of&nbsp;the&nbsp;provided&nbsp;folders.&nbsp;If&nbsp;no&nbsp;folders&nbsp;are&nbsp;provided,&nbsp;the&nbsp;file&nbsp;will&nbsp;be&nbsp;placed&nbsp;in&nbsp;the&nbsp;default&nbsp;root&nbsp;folder.&nbsp;On&nbsp;update,&nbsp;this&nbsp;field&nbsp;is&nbsp;ignored.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"parentLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;link&nbsp;to&nbsp;get&nbsp;the&nbsp;metadata&nbsp;for&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;this&nbsp;parent<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"downloadUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Short&nbsp;term&nbsp;download&nbsp;URL&nbsp;for&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userPermission":&nbsp;{&nbsp;#&nbsp;The&nbsp;permissions&nbsp;for&nbsp;the&nbsp;authenticated&nbsp;user&nbsp;on&nbsp;this&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;permission&nbsp;(For&nbsp;example:&nbsp;user,&nbsp;group&nbsp;etc).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"drive#permission",&nbsp;#&nbsp;The&nbsp;kind&nbsp;of&nbsp;this&nbsp;permission.&nbsp;This&nbsp;is&nbsp;always&nbsp;drive#permission<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;etag&nbsp;for&nbsp;this&nbsp;permission.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;role&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.&nbsp;(For&nbsp;example:&nbsp;reader,&nbsp;writer,&nbsp;owner)<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"additionalRoles":&nbsp;[&nbsp;#&nbsp;Any&nbsp;additional&nbsp;roles&nbsp;that&nbsp;this&nbsp;permission&nbsp;describes.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"A&nbsp;String",<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;ETag&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileSize":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;size&nbsp;of&nbsp;the&nbsp;file&nbsp;in&nbsp;bytes.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"createdDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Create&nbsp;time&nbsp;for&nbsp;this&nbsp;file&nbsp;(formatted&nbsp;ISO8601&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"fileExtension":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;file&nbsp;extension&nbsp;used&nbsp;when&nbsp;downloading&nbsp;this&nbsp;file.&nbsp;This&nbsp;field&nbsp;is&nbsp;read&nbsp;only.&nbsp;To&nbsp;set&nbsp;the&nbsp;extension,&nbsp;include&nbsp;it&nbsp;on&nbsp;title&nbsp;when&nbsp;creating&nbsp;the&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastViewedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;viewed&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;id&nbsp;of&nbsp;the&nbsp;file.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"md5Checksum":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;An&nbsp;MD5&nbsp;checksum&nbsp;for&nbsp;the&nbsp;content&nbsp;of&nbsp;this&nbsp;file.&nbsp;This&nbsp;will&nbsp;only&nbsp;be&nbsp;populated&nbsp;on&nbsp;files&nbsp;with&nbsp;content&nbsp;stored&nbsp;in&nbsp;Drive.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"modifiedDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Last&nbsp;time&nbsp;this&nbsp;file&nbsp;was&nbsp;modified&nbsp;by&nbsp;anyone&nbsp;(formatted&nbsp;<a href="http://www.rfc-editor.org/rfc/rfc3339.txt">RFC&nbsp;3339</a>&nbsp;timestamp).<br>
&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
<hr>
Data descriptors defined here:<br>
<dl><dt><strong>__dict__</strong></dt>
<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
<dl><dt><strong>__weakref__</strong></dt>
<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
</dl>
</td></tr></table>
</body></html>