Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 708388c41ae3a2cb759c33dfda1159a837a49d7c / . / docs / dyn / bigquery.v2.datasets.html
blob: 20182f28d0e8287e9c79202e50cd9a76ac6857ae [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>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]21&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
22&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
23&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]24&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;deleted&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]25&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]26&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;dataset&nbsp;being&nbsp;deleted&nbsp;(required)</tt></dd></dl>
27
28<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>
29&nbsp;<br>
30Args:<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]31&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
32&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]33&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;requested&nbsp;dataset&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]34&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
35&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]36&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;requested&nbsp;dataset&nbsp;(required)<br>
37&nbsp;<br>
38Returns:<br>
39&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
40&nbsp;<br>
41&nbsp;&nbsp;&nbsp;&nbsp;{<br>
42&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
43&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>
44&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
45&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>
46&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>
47&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
48&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>
49&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>
50&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>
51&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>
52&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>
53&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>
54&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
55&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>
56&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>
57&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>
58&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>
59&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>
60&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
61&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
62&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>
63&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>
64&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>
65&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>
66&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>
67&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
68
69<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>
70&nbsp;<br>
71Args:<br>
72&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
73&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
74&nbsp;<br>
75{<br>
76&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
77&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>
78&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
79&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>
80&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>
81&nbsp;&nbsp;&nbsp;&nbsp;},<br>
82&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>
83&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>
84&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>
85&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>
86&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>
87&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>
88&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
89&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>
90&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>
91&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>
92&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>
93&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>
94&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
95&nbsp;&nbsp;&nbsp;&nbsp;],<br>
96&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
97&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>
98&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>
99&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>
100&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>
101&nbsp;&nbsp;}<br>
102&nbsp;<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]103&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
104&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]105&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;new&nbsp;dataset&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]106&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
107&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]108&nbsp;<br>
109Returns:<br>
110&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
111&nbsp;<br>
112&nbsp;&nbsp;&nbsp;&nbsp;{<br>
113&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
114&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>
115&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
116&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>
117&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>
118&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
119&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>
120&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>
121&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>
122&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>
123&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>
124&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>
125&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
126&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>
127&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>
128&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>
129&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>
130&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>
131&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
132&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
133&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>
134&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>
135&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>
136&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>
137&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>
138&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
139
140<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>
141&nbsp;<br>
142Args:<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]143&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
144&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]145&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>
146&nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;The&nbsp;maximum&nbsp;number&nbsp;of&nbsp;results&nbsp;to&nbsp;return<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]147&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]148&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;datasets&nbsp;to&nbsp;be&nbsp;listed&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]149&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]150&nbsp;<br>
151Returns:<br>
152&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
153&nbsp;<br>
154&nbsp;&nbsp;&nbsp;&nbsp;{<br>
155&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>
156&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#datasetList",&nbsp;#&nbsp;The&nbsp;type&nbsp;of&nbsp;list.<br>
157&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>
158&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
159&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>
160&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;The&nbsp;resource&nbsp;type.<br>
161&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>
162&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
163&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>
164&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>
165&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
166&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
167&nbsp;&nbsp;&nbsp;&nbsp;],<br>
168&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>
169&nbsp;&nbsp;}</tt></dd></dl>
170
171<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>
172&nbsp;<br>
173Args:<br>
174&nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
175&nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
176&nbsp;<br>
177Returns:<br>
178&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>
179&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>
180
181<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>
182&nbsp;<br>
183Args:<br>
184&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
185&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
186&nbsp;<br>
187{<br>
188&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
189&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>
190&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
191&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>
192&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>
193&nbsp;&nbsp;&nbsp;&nbsp;},<br>
194&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>
195&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>
196&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>
197&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>
198&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>
199&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>
200&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
201&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>
202&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>
203&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>
204&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>
205&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>
206&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
207&nbsp;&nbsp;&nbsp;&nbsp;],<br>
208&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
209&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>
210&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>
211&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>
212&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>
213&nbsp;&nbsp;}<br>
214&nbsp;<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]215&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
216&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]217&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]218&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
219&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]220&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
221&nbsp;<br>
222Returns:<br>
223&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
224&nbsp;<br>
225&nbsp;&nbsp;&nbsp;&nbsp;{<br>
226&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
227&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>
228&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
229&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>
230&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>
231&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
232&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>
233&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>
234&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>
235&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>
236&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>
237&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>
238&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
239&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>
240&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>
241&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>
242&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>
243&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>
244&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
245&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
246&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>
247&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>
248&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>
249&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>
250&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>
251&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
252
253<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>
254&nbsp;<br>
255Args:<br>
256&nbsp;&nbsp;body:&nbsp;object,&nbsp;The&nbsp;request&nbsp;body.&nbsp;(required)<br>
257&nbsp;&nbsp;&nbsp;&nbsp;The&nbsp;object&nbsp;takes&nbsp;the&nbsp;form&nbsp;of:<br>
258&nbsp;<br>
259{<br>
260&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
261&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>
262&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
263&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>
264&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>
265&nbsp;&nbsp;&nbsp;&nbsp;},<br>
266&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>
267&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>
268&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>
269&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>
270&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>
271&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>
272&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
273&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>
274&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>
275&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>
276&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>
277&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>
278&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
279&nbsp;&nbsp;&nbsp;&nbsp;],<br>
280&nbsp;&nbsp;&nbsp;&nbsp;"etag":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;[Output-only]&nbsp;A&nbsp;hash&nbsp;of&nbsp;this&nbsp;resource.<br>
281&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>
282&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>
283&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>
284&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>
285&nbsp;&nbsp;}<br>
286&nbsp;<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]287&nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
288&nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]289&nbsp;&nbsp;projectId:&nbsp;string,&nbsp;Project&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
Joe Gregorio66212032012-06-14 09:10:14 -0400[diff] [blame]290&nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
291&nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
Joe Gregorio41899542012-04-23 09:02:05 -0400[diff] [blame]292&nbsp;&nbsp;datasetId:&nbsp;string,&nbsp;Dataset&nbsp;ID&nbsp;of&nbsp;the&nbsp;dataset&nbsp;being&nbsp;updated&nbsp;(required)<br>
293&nbsp;<br>
294Returns:<br>
295&nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
296&nbsp;<br>
297&nbsp;&nbsp;&nbsp;&nbsp;{<br>
298&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"bigquery#dataset",&nbsp;#&nbsp;[Output-only]&nbsp;The&nbsp;resource&nbsp;type.<br>
299&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>
300&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"datasetReference":&nbsp;{&nbsp;#&nbsp;[Required]&nbsp;Reference&nbsp;identifying&nbsp;dataset.<br>
301&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>
302&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>
303&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
304&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>
305&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>
306&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>
307&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>
308&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>
309&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>
310&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{<br>
311&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>
312&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>
313&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>
314&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>
315&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>
316&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
317&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;],<br>
318&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>
319&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>
320&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>
321&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>
322&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>
323&nbsp;&nbsp;&nbsp;&nbsp;}</tt></dd></dl>
324
325<hr>
326Data descriptors defined here:<br>
327<dl><dt><strong>__dict__</strong></dt>
328<dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
329</dl>
330<dl><dt><strong>__weakref__</strong></dt>
331<dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
332</dl>
333</td></tr></table>
334</body></html>