Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 418995467f1b5792ffb2c6f362e569f30cf5526b / . / docs / dyn / bigquery.v2.datasets.html
blob: 5f961a423677a50959e5d8b55004072b0b9b44d6 [file] [log] [blame]
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame^]1
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
3<html><head><title>Python: class Resource</title>
4</head><body bgcolor="#f0f0f8">
5<p>
6<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
7<tr bgcolor="#ffc8d8">
8<td colspan=3 valign=bottom>&nbsp;<br>
9<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>
10
11<tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
12<td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
13<tr><td>&nbsp;</td>
14<td width="100%">Methods defined here:<br>
15<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>
16
17<dl><dt><a name="Resource-delete"><strong>delete</strong></a> = method(self, **kwargs)</dt><dd><tt>Deletes&nbsp;the&nbsp;dataset&nbsp;specified&nbsp;by&nbsp;datasetId&nbsp;value.&nbsp;Before&nbsp;you&nbsp;can&nbsp;delete&nbsp;a&nbsp;dataset,&nbsp;you&nbsp;must&nbsp;delete&nbsp;all&nbsp;its&nbsp;tables,&nbsp;either&nbsp;manually&nbsp;or&nbsp;by&nbsp;specifying&nbsp;deleteContents.&nbsp;Immediately&nbsp;after&nbsp;deletion,&nbsp;you&nbsp;can&nbsp;create&nbsp;another&nbsp;dataset&nbsp;with&nbsp;the&nbsp;same&nbsp;name.<br>
18&nbsp;<br>
19Args:<br>
20&nbsp;&nbsp;deleteContents:&nbsp;boolean,&nbsp;If&nbsp;True,&nbsp;delete&nbsp;all&nbsp;the&nbsp;tables&nbsp;in&nbsp;the&nbsp;dataset.&nbsp;If&nbsp;False&nbsp;and&nbsp;the&nbsp;dataset&nbsp;contains&nbsp;tables,&nbsp;the&nbsp;request&nbsp;will&nbsp;fail.&nbsp;Default&nbsp;is&nbsp;False<br>
21&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;deleted&nbsp;(required)<br>
22&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;dataset&nbsp;being&nbsp;deleted&nbsp;(required)</tt></dd></dl>
23
24<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Returns&nbsp;the&nbsp;dataset&nbsp;specified&nbsp;by&nbsp;datasetID.<br>
25&nbsp;<br>
26Args:<br>
27&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;requested&nbsp;dataset&nbsp;(required)<br>
28&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;requested&nbsp;dataset&nbsp;(required)<br>
29&nbsp;<br>
30Returns:<br>
31&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
32&nbsp;<br>
33&nbsp;&nbsp;&nbsp;&nbsp;{<br>
34&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
35&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
36&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
37&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
38&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
39&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
40&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
41&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
42&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
43&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
44&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
45&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
46&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
47&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
48&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
49&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
50&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
51&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
52&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
53&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
54&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
55&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
56&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
57&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
58&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
59&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
60
61<dl><dt><a name="Resource-insert"><strong>insert</strong></a> = method(self, **kwargs)</dt><dd><tt>Creates&nbsp;a&nbsp;new&nbsp;empty&nbsp;dataset.<br>
62&nbsp;<br>
63Args:<br>
64&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
65&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
66&nbsp;<br>
67{<br>
68&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
69&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
70&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
71&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
72&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
73&nbsp;&nbsp;&nbsp;&nbsp;},<br>
74&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
75&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
76&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
77&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
78&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
79&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
80&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
81&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
82&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
83&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
84&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
85&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
86&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
87&nbsp;&nbsp;&nbsp;&nbsp;],<br>
88&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
89&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
90&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
91&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
92&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
93&nbsp;&nbsp;}<br>
94&nbsp;<br>
95&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;new&nbsp;dataset&nbsp;(required)<br>
96&nbsp;<br>
97Returns:<br>
98&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
99&nbsp;<br>
100&nbsp;&nbsp;&nbsp;&nbsp;{<br>
101&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
102&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
103&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
104&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
105&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
106&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
107&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
108&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
109&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
110&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
111&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
112&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
113&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
114&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
115&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
116&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
117&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
118&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
119&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
120&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
121&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
122&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
123&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
124&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
125&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
126&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
127
128<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Lists&nbsp;all&nbsp;the&nbsp;datasets&nbsp;in&nbsp;the&nbsp;specified&nbsp;project&nbsp;to&nbsp;which&nbsp;the&nbsp;caller&nbsp;has&nbsp;read&nbsp;access;&nbsp;however,&nbsp;a&nbsp;project&nbsp;owner&nbsp;can&nbsp;list&nbsp;(but&nbsp;not&nbsp;necessarily&nbsp;get)&nbsp;all&nbsp;datasets&nbsp;in&nbsp;his&nbsp;project.<br>
129&nbsp;<br>
130Args:<br>
131&nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;Page&nbsp;token,&nbsp;returned&nbsp;by&nbsp;a&nbsp;previous&nbsp;call,&nbsp;to&nbsp;request&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results<br>
132&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;The&nbsp;maximum&nbsp;number&nbsp;of&nbsp;results&nbsp;to&nbsp;return<br>
133&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;datasets&nbsp;to&nbsp;be&nbsp;listed&nbsp;(required)<br>
134&nbsp;<br>
135Returns:<br>
136&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
137&nbsp;<br>
138&nbsp;&nbsp;&nbsp;&nbsp;{<br>
139&nbsp;&nbsp;&nbsp;&nbsp;"nextPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;token&nbsp;to&nbsp;request&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.&nbsp;Present&nbsp;only&nbsp;when&nbsp;there&nbsp;is&nbsp;more&nbsp;than&nbsp;one&nbsp;page&nbsp;of&nbsp;results.*&nbsp;See&nbsp;Paging&nbsp;Through&nbsp;Results&nbsp;in&nbsp;the&nbsp;developer's&nbsp;guide.<br>
140&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#datasetList",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;list.<br>
141&nbsp;&nbsp;&nbsp;&nbsp;"datasets":&nbsp;[&nbsp;#&nbsp;An&nbsp;array&nbsp;of&nbsp;one&nbsp;or&nbsp;more&nbsp;summarized&nbsp;dataset&nbsp;resources.&nbsp;Absent&nbsp;when&nbsp;there&nbsp;are&nbsp;no&nbsp;datasets&nbsp;in&nbsp;the&nbsp;specified&nbsp;project.<br>
142&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
143&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;if&nbsp;one&nbsp;exists.<br>
144&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;The&nbsp;resource&nbsp;type.<br>
145&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.<br>
146&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
147&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
148&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
149&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
150&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
151&nbsp;&nbsp;&nbsp;&nbsp;],<br>
152&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;page&nbsp;of&nbsp;results.&nbsp;See&nbsp;Paging&nbsp;Through&nbsp;Results&nbsp;in&nbsp;the&nbsp;developer's&nbsp;guide.<br>
153&nbsp;&nbsp;}</tt></dd></dl>
154
155<dl><dt><a name="Resource-list_next"><strong>list_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.<br>
156&nbsp;<br>
157Args:<br>
158&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
159&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
160&nbsp;<br>
161Returns:<br>
162&nbsp;&nbsp;A&nbsp;request&nbsp;object&nbsp;that&nbsp;you&nbsp;can&nbsp;call&nbsp;'execute()'&nbsp;on&nbsp;to&nbsp;request&nbsp;the&nbsp;next<br>
163&nbsp;&nbsp;page.&nbsp;Returns&nbsp;None&nbsp;if&nbsp;there&nbsp;are&nbsp;no&nbsp;more&nbsp;items&nbsp;in&nbsp;the&nbsp;collection.</tt></dd></dl>
164
165<dl><dt><a name="Resource-patch"><strong>patch</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;information&nbsp;in&nbsp;an&nbsp;existing&nbsp;dataset,&nbsp;specified&nbsp;by&nbsp;datasetId.&nbsp;Properties&nbsp;not&nbsp;included&nbsp;in&nbsp;the&nbsp;submitted&nbsp;resource&nbsp;will&nbsp;not&nbsp;be&nbsp;changed.&nbsp;If&nbsp;you&nbsp;include&nbsp;the&nbsp;access&nbsp;property&nbsp;without&nbsp;any&nbsp;values&nbsp;assigned,&nbsp;the&nbsp;request&nbsp;will&nbsp;fail&nbsp;as&nbsp;you&nbsp;must&nbsp;specify&nbsp;at&nbsp;least&nbsp;one&nbsp;owner&nbsp;for&nbsp;a&nbsp;dataset.&nbsp;This&nbsp;method&nbsp;supports&nbsp;patch&nbsp;semantics.<br>
166&nbsp;<br>
167Args:<br>
168&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
169&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
170&nbsp;<br>
171{<br>
172&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
173&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
174&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
175&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
176&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
177&nbsp;&nbsp;&nbsp;&nbsp;},<br>
178&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
179&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
180&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
181&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
182&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
183&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
184&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
185&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
186&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
187&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
188&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
189&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
190&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
191&nbsp;&nbsp;&nbsp;&nbsp;],<br>
192&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
193&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
194&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
195&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
196&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
197&nbsp;&nbsp;}<br>
198&nbsp;<br>
199&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
200&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
201&nbsp;<br>
202Returns:<br>
203&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
204&nbsp;<br>
205&nbsp;&nbsp;&nbsp;&nbsp;{<br>
206&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
207&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
208&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
209&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
210&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
211&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
212&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
213&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
214&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
215&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
216&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
217&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
218&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
219&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
220&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
221&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
222&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
223&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
224&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
225&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
226&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
227&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
228&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
229&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
230&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
231&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
232
233<dl><dt><a name="Resource-update"><strong>update</strong></a> = method(self, **kwargs)</dt><dd><tt>Updates&nbsp;information&nbsp;in&nbsp;an&nbsp;existing&nbsp;dataset,&nbsp;specified&nbsp;by&nbsp;datasetId.&nbsp;Properties&nbsp;not&nbsp;included&nbsp;in&nbsp;the&nbsp;submitted&nbsp;resource&nbsp;will&nbsp;not&nbsp;be&nbsp;changed.&nbsp;If&nbsp;you&nbsp;include&nbsp;the&nbsp;access&nbsp;property&nbsp;without&nbsp;any&nbsp;values&nbsp;assigned,&nbsp;the&nbsp;request&nbsp;will&nbsp;fail&nbsp;as&nbsp;you&nbsp;must&nbsp;specify&nbsp;at&nbsp;least&nbsp;one&nbsp;owner&nbsp;for&nbsp;a&nbsp;dataset.<br>
234&nbsp;<br>
235Args:<br>
236&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
237&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
238&nbsp;<br>
239{<br>
240&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
241&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
242&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
243&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
244&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
245&nbsp;&nbsp;&nbsp;&nbsp;},<br>
246&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
247&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
248&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
249&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
250&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
251&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
252&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
253&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
254&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
255&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
256&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
257&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
258&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
259&nbsp;&nbsp;&nbsp;&nbsp;],<br>
260&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
261&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
262&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
263&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
264&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
265&nbsp;&nbsp;}<br>
266&nbsp;<br>
267&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
268&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
269&nbsp;<br>
270Returns:<br>
271&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
272&nbsp;<br>
273&nbsp;&nbsp;&nbsp;&nbsp;{<br>
274&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
275&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;user-friendly&nbsp;string&nbsp;description&nbsp;for&nbsp;the&nbsp;dataset.&nbsp;This&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;BigQuery&nbsp;UI&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.<br>
276&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
277&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"projectId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;container&nbsp;project.<br>
278&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetId":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;A&nbsp;unique&nbsp;ID&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;without&nbsp;the&nbsp;project&nbsp;name.<br>
279&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
280&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"creationTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;time&nbsp;when&nbsp;this&nbsp;dataset&nbsp;was&nbsp;created,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
281&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"access":&nbsp;[&nbsp;#&nbsp;[Optional]&nbsp;Describes&nbsp;users'&nbsp;rights&nbsp;on&nbsp;the&nbsp;dataset.&nbsp;You&nbsp;can&nbsp;assign&nbsp;the&nbsp;same&nbsp;role&nbsp;to&nbsp;multiple&nbsp;users,&nbsp;and&nbsp;assign&nbsp;multiple&nbsp;roles&nbsp;to&nbsp;the&nbsp;same&nbsp;user.<br>
282&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Default&nbsp;values&nbsp;assigned&nbsp;to&nbsp;a&nbsp;new&nbsp;dataset&nbsp;are&nbsp;as&nbsp;follows:&nbsp;OWNER&nbsp;-&nbsp;Project&nbsp;owners,&nbsp;dataset&nbsp;creator&nbsp;READ&nbsp;-&nbsp;Project&nbsp;readers&nbsp;WRITE&nbsp;-&nbsp;Project&nbsp;writers<br>
283&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;See&nbsp;ACLs&nbsp;and&nbsp;Rights&nbsp;for&nbsp;a&nbsp;description&nbsp;of&nbsp;these&nbsp;rights.&nbsp;If&nbsp;you&nbsp;specify&nbsp;any&nbsp;of&nbsp;these&nbsp;roles&nbsp;when&nbsp;creating&nbsp;a&nbsp;dataset,&nbsp;the&nbsp;assigned&nbsp;roles&nbsp;will&nbsp;overwrite&nbsp;the&nbsp;defaults&nbsp;listed&nbsp;above.<br>
284&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;To&nbsp;revoke&nbsp;rights&nbsp;to&nbsp;a&nbsp;dataset,&nbsp;call&nbsp;datasets.<a href="#Resource-update">update</a>()&nbsp;and&nbsp;omit&nbsp;the&nbsp;names&nbsp;of&nbsp;anyone&nbsp;whose&nbsp;rights&nbsp;you&nbsp;wish&nbsp;to&nbsp;revoke.&nbsp;However,&nbsp;every&nbsp;dataset&nbsp;must&nbsp;have&nbsp;at&nbsp;least&nbsp;one&nbsp;entity&nbsp;granted&nbsp;OWNER&nbsp;role.<br>
285&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;Each&nbsp;access&nbsp;object&nbsp;can&nbsp;have&nbsp;only&nbsp;one&nbsp;of&nbsp;the&nbsp;following&nbsp;members:&nbsp;userByEmail,&nbsp;groupByEmail,&nbsp;domain,&nbsp;or&nbsp;allAuthenticatedUsers.<br>
286&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
287&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"specialGroup":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;special&nbsp;group&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;The&nbsp;valid&nbsp;values&nbsp;are:&nbsp;projectOwners:&nbsp;Owners&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectReaders:&nbsp;Readers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;projectWriters:&nbsp;Writers&nbsp;of&nbsp;the&nbsp;enclosing&nbsp;project.&nbsp;allAuthenticatedUsers:&nbsp;All&nbsp;authenticated&nbsp;BigQuery&nbsp;users.<br>
288&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"domain":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;domain&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;Any&nbsp;users&nbsp;signed&nbsp;in&nbsp;with&nbsp;the&nbsp;domain&nbsp;specified&nbsp;will&nbsp;be&nbsp;granted&nbsp;the&nbsp;specified&nbsp;access.&nbsp;Example:&nbsp;"example.com".<br>
289&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"role":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Required]&nbsp;Describes&nbsp;the&nbsp;rights&nbsp;granted&nbsp;to&nbsp;the&nbsp;user&nbsp;specified&nbsp;by&nbsp;the&nbsp;other&nbsp;member&nbsp;of&nbsp;the&nbsp;access&nbsp;object.&nbsp;The&nbsp;following&nbsp;string&nbsp;values&nbsp;are&nbsp;supported:&nbsp;READ&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;<a href="#Resource-list">list</a>()&nbsp;or&nbsp;<a href="#Resource-get">get</a>()&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;or&nbsp;resource.&nbsp;WRITE&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method&nbsp;on&nbsp;any&nbsp;collection&nbsp;except&nbsp;for&nbsp;datasets,&nbsp;on&nbsp;which&nbsp;they&nbsp;can&nbsp;call&nbsp;<a href="#Resource-list">list</a>()&nbsp;and&nbsp;<a href="#Resource-get">get</a>().&nbsp;OWNER&nbsp;-&nbsp;User&nbsp;can&nbsp;call&nbsp;any&nbsp;method.&nbsp;The&nbsp;dataset&nbsp;creator&nbsp;is&nbsp;granted&nbsp;this&nbsp;role&nbsp;by&nbsp;default.<br>
290&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"groupByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully-qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;mailing&nbsp;list&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;This&nbsp;must&nbsp;be&nbsp;either&nbsp;a&nbsp;Google&nbsp;Groups&nbsp;mailing&nbsp;list&nbsp;(ends&nbsp;in&nbsp;@googlegroups.com)&nbsp;or&nbsp;a&nbsp;group&nbsp;managed&nbsp;by&nbsp;an&nbsp;enterprise&nbsp;version&nbsp;of&nbsp;Google&nbsp;Groups.<br>
291&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"userByEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Pick&nbsp;one]&nbsp;A&nbsp;fully&nbsp;qualified&nbsp;email&nbsp;address&nbsp;of&nbsp;a&nbsp;user&nbsp;to&nbsp;grant&nbsp;access&nbsp;to.&nbsp;For&nbsp;example:&nbsp;fred@example.com.<br>
292&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
293&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
294&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
295&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"friendlyName":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Optional]&nbsp;A&nbsp;descriptive&nbsp;name&nbsp;for&nbsp;this&nbsp;dataset,&nbsp;which&nbsp;might&nbsp;be&nbsp;shown&nbsp;in&nbsp;any&nbsp;BigQuery&nbsp;user&nbsp;interfaces&nbsp;for&nbsp;browsing&nbsp;the&nbsp;dataset.&nbsp;Use&nbsp;datasetId&nbsp;for&nbsp;making&nbsp;API&nbsp;calls.<br>
296&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"lastModifiedTime":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;date&nbsp;when&nbsp;this&nbsp;dataset&nbsp;or&nbsp;any&nbsp;of&nbsp;its&nbsp;tables&nbsp;was&nbsp;last&nbsp;modified,&nbsp;in&nbsp;milliseconds&nbsp;since&nbsp;the&nbsp;epoch.<br>
297&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;fully-qualified&nbsp;unique&nbsp;name&nbsp;of&nbsp;this&nbsp;dataset&nbsp;in&nbsp;the&nbsp;format&nbsp;projectId:datasetId.&nbsp;The&nbsp;dataset&nbsp;name&nbsp;without&nbsp;the&nbsp;project&nbsp;name&nbsp;is&nbsp;given&nbsp;in&nbsp;the&nbsp;datasetId&nbsp;field.&nbsp;When&nbsp;creating&nbsp;a&nbsp;new&nbsp;dataset,&nbsp;leave&nbsp;this&nbsp;field&nbsp;blank,&nbsp;and&nbsp;instead&nbsp;specify&nbsp;the&nbsp;datasetId&nbsp;field.<br>
298&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"selfLink":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;An&nbsp;URL&nbsp;that&nbsp;can&nbsp;be&nbsp;used&nbsp;to&nbsp;access&nbsp;this&nbsp;resource&nbsp;again.&nbsp;You&nbsp;can&nbsp;use&nbsp;this&nbsp;URL&nbsp;in&nbsp;Get&nbsp;or&nbsp;Update&nbsp;requests&nbsp;to&nbsp;this&nbsp;resource.<br>
299&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
300
301<hr>
302Data descriptors defined here:<br>
303<dl><dt><strong>__dict__</strong></dt>
304<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
305</dl>
306<dl><dt><strong>__weakref__</strong></dt>
307<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
308</dl>
309</td></tr></table>
310</body></html>