blob: 04969afacc6a401ea3d4d0289285f84ddb9e9070 [file] [log] [blame]
Craig Citroe633be12015-03-02 13:40:36 -08001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="fusiontables_v2.html">Fusion Tables API</a> . <a href="fusiontables_v2.table.html">table</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#copy">copy(tableId, copyPresentation=None)</a></code></p>
79<p class="firstline">Copies a table.</p>
80<p class="toc_element">
81 <code><a href="#delete">delete(tableId)</a></code></p>
82<p class="firstline">Deletes a table.</p>
83<p class="toc_element">
84 <code><a href="#get">get(tableId)</a></code></p>
Nathaniel Manista4f877e52015-06-15 16:44:50 +000085<p class="firstline">Retrieves a specific table by its ID.</p>
Craig Citroe633be12015-03-02 13:40:36 -080086<p class="toc_element">
87 <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</a></code></p>
Nathaniel Manista4f877e52015-06-15 16:44:50 +000088<p class="firstline">Imports more rows into a table.</p>
Craig Citroe633be12015-03-02 13:40:36 -080089<p class="toc_element">
90 <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</a></code></p>
Nathaniel Manista4f877e52015-06-15 16:44:50 +000091<p class="firstline">Imports a new table.</p>
Craig Citroe633be12015-03-02 13:40:36 -080092<p class="toc_element">
93 <code><a href="#insert">insert(body)</a></code></p>
94<p class="firstline">Creates a new table.</p>
95<p class="toc_element">
96 <code><a href="#list">list(pageToken=None, maxResults=None)</a></code></p>
97<p class="firstline">Retrieves a list of tables a user owns.</p>
98<p class="toc_element">
99 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
100<p class="firstline">Retrieves the next page of results.</p>
101<p class="toc_element">
102 <code><a href="#patch">patch(tableId, body, replaceViewDefinition=None)</a></code></p>
103<p class="firstline">Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.</p>
104<p class="toc_element">
105 <code><a href="#replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</a></code></p>
106<p class="firstline">Replaces rows of an existing table. Current rows remain visible until all replacement rows are ready.</p>
107<p class="toc_element">
108 <code><a href="#update">update(tableId, body, replaceViewDefinition=None)</a></code></p>
109<p class="firstline">Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated.</p>
110<h3>Method Details</h3>
111<div class="method">
112 <code class="details" id="copy">copy(tableId, copyPresentation=None)</code>
113 <pre>Copies a table.
114
115Args:
116 tableId: string, ID of the table that is being copied. (required)
117 copyPresentation: boolean, Whether to also copy tabs, styles, and templates. Default is false.
118
119Returns:
120 An object of the form:
121
122 { # Represents a table.
123 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000124 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800125 "attribution": "A String", # Attribution assigned to the table.
126 "description": "A String", # Description assigned to the table.
127 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
128 "isExportable": True or False, # Variable for whether table is exportable.
129 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
130 "A String",
131 ],
132 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
133 "attributionLink": "A String", # Optional link for attribution.
134 "sql": "A String", # SQL that encodes the table definition for derived tables.
135 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
136 "columns": [ # Columns in the table.
137 { # Specifies the details of a column in a table.
138 "graphPredicate": "A String", # Column graph predicate.
139 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000140 # See W3C Graph-based Data Model.
141 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800142 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
143 "A String",
144 ],
145 "description": "A String", # Column description.
146 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
147 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
148 "columnId": 42, # The id of the column in the base table from which this column is derived.
149 },
150 "name": "A String", # Name of the column.
151 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
152 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000153 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800154 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
155 "type": "A String", # Type of the column.
156 "validateData": True or False, # If true, data entered via the web application is validated.
157 "columnId": 42, # Identifier for the column.
158 },
159 ],
160 "name": "A String", # Name assigned to a table.
161 }</pre>
162</div>
163
164<div class="method">
165 <code class="details" id="delete">delete(tableId)</code>
166 <pre>Deletes a table.
167
168Args:
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000169 tableId: string, ID of the table to be deleted. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800170</pre>
171</div>
172
173<div class="method">
174 <code class="details" id="get">get(tableId)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000175 <pre>Retrieves a specific table by its ID.
Craig Citroe633be12015-03-02 13:40:36 -0800176
177Args:
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000178 tableId: string, Identifier for the table being requested. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800179
180Returns:
181 An object of the form:
182
183 { # Represents a table.
184 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000185 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800186 "attribution": "A String", # Attribution assigned to the table.
187 "description": "A String", # Description assigned to the table.
188 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
189 "isExportable": True or False, # Variable for whether table is exportable.
190 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
191 "A String",
192 ],
193 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
194 "attributionLink": "A String", # Optional link for attribution.
195 "sql": "A String", # SQL that encodes the table definition for derived tables.
196 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
197 "columns": [ # Columns in the table.
198 { # Specifies the details of a column in a table.
199 "graphPredicate": "A String", # Column graph predicate.
200 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000201 # See W3C Graph-based Data Model.
202 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800203 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
204 "A String",
205 ],
206 "description": "A String", # Column description.
207 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
208 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
209 "columnId": 42, # The id of the column in the base table from which this column is derived.
210 },
211 "name": "A String", # Name of the column.
212 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
213 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000214 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800215 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
216 "type": "A String", # Type of the column.
217 "validateData": True or False, # If true, data entered via the web application is validated.
218 "columnId": 42, # Identifier for the column.
219 },
220 ],
221 "name": "A String", # Name assigned to a table.
222 }</pre>
223</div>
224
225<div class="method">
226 <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000227 <pre>Imports more rows into a table.
Craig Citroe633be12015-03-02 13:40:36 -0800228
229Args:
230 tableId: string, The table into which new rows are being imported. (required)
231 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
232 startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000233 isStrict: boolean, Whether the imported CSV must have the same number of values for each row. If false, rows with fewer values will be padded with empty values. Default is true.
234 encoding: string, The encoding of the content. Default is UTF-8. Use auto-detect if you are unsure of the encoding.
235 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
236 endLine: integer, The index of the line up to which data will be imported. Default is to import the entire file. If endLine is negative, it is an offset from the end of the file; the imported content will exclude the last endLine lines.
Craig Citroe633be12015-03-02 13:40:36 -0800237
238Returns:
239 An object of the form:
240
241 { # Represents an import request.
242 "numRowsReceived": "A String", # The number of rows received from the import request.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000243 "kind": "fusiontables#import", # The kind of item this is. For an import, this is always fusiontables#import.
Craig Citroe633be12015-03-02 13:40:36 -0800244 }</pre>
245</div>
246
247<div class="method">
248 <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000249 <pre>Imports a new table.
Craig Citroe633be12015-03-02 13:40:36 -0800250
251Args:
252 name: string, The name to be assigned to the new table. (required)
253 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000254 encoding: string, The encoding of the content. Default is UTF-8. Use auto-detect if you are unsure of the encoding.
255 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
Craig Citroe633be12015-03-02 13:40:36 -0800256
257Returns:
258 An object of the form:
259
260 { # Represents a table.
261 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000262 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800263 "attribution": "A String", # Attribution assigned to the table.
264 "description": "A String", # Description assigned to the table.
265 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
266 "isExportable": True or False, # Variable for whether table is exportable.
267 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
268 "A String",
269 ],
270 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
271 "attributionLink": "A String", # Optional link for attribution.
272 "sql": "A String", # SQL that encodes the table definition for derived tables.
273 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
274 "columns": [ # Columns in the table.
275 { # Specifies the details of a column in a table.
276 "graphPredicate": "A String", # Column graph predicate.
277 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000278 # See W3C Graph-based Data Model.
279 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800280 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
281 "A String",
282 ],
283 "description": "A String", # Column description.
284 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
285 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
286 "columnId": 42, # The id of the column in the base table from which this column is derived.
287 },
288 "name": "A String", # Name of the column.
289 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
290 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000291 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800292 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
293 "type": "A String", # Type of the column.
294 "validateData": True or False, # If true, data entered via the web application is validated.
295 "columnId": 42, # Identifier for the column.
296 },
297 ],
298 "name": "A String", # Name assigned to a table.
299 }</pre>
300</div>
301
302<div class="method">
303 <code class="details" id="insert">insert(body)</code>
304 <pre>Creates a new table.
305
306Args:
307 body: object, The request body. (required)
308 The object takes the form of:
309
310{ # Represents a table.
311 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000312 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800313 "attribution": "A String", # Attribution assigned to the table.
314 "description": "A String", # Description assigned to the table.
315 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
316 "isExportable": True or False, # Variable for whether table is exportable.
317 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
318 "A String",
319 ],
320 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
321 "attributionLink": "A String", # Optional link for attribution.
322 "sql": "A String", # SQL that encodes the table definition for derived tables.
323 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
324 "columns": [ # Columns in the table.
325 { # Specifies the details of a column in a table.
326 "graphPredicate": "A String", # Column graph predicate.
327 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000328 # See W3C Graph-based Data Model.
329 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800330 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
331 "A String",
332 ],
333 "description": "A String", # Column description.
334 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
335 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
336 "columnId": 42, # The id of the column in the base table from which this column is derived.
337 },
338 "name": "A String", # Name of the column.
339 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
340 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000341 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800342 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
343 "type": "A String", # Type of the column.
344 "validateData": True or False, # If true, data entered via the web application is validated.
345 "columnId": 42, # Identifier for the column.
346 },
347 ],
348 "name": "A String", # Name assigned to a table.
349 }
350
351
352Returns:
353 An object of the form:
354
355 { # Represents a table.
356 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000357 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800358 "attribution": "A String", # Attribution assigned to the table.
359 "description": "A String", # Description assigned to the table.
360 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
361 "isExportable": True or False, # Variable for whether table is exportable.
362 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
363 "A String",
364 ],
365 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
366 "attributionLink": "A String", # Optional link for attribution.
367 "sql": "A String", # SQL that encodes the table definition for derived tables.
368 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
369 "columns": [ # Columns in the table.
370 { # Specifies the details of a column in a table.
371 "graphPredicate": "A String", # Column graph predicate.
372 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000373 # See W3C Graph-based Data Model.
374 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800375 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
376 "A String",
377 ],
378 "description": "A String", # Column description.
379 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
380 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
381 "columnId": 42, # The id of the column in the base table from which this column is derived.
382 },
383 "name": "A String", # Name of the column.
384 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
385 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000386 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800387 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
388 "type": "A String", # Type of the column.
389 "validateData": True or False, # If true, data entered via the web application is validated.
390 "columnId": 42, # Identifier for the column.
391 },
392 ],
393 "name": "A String", # Name assigned to a table.
394 }</pre>
395</div>
396
397<div class="method">
398 <code class="details" id="list">list(pageToken=None, maxResults=None)</code>
399 <pre>Retrieves a list of tables a user owns.
400
401Args:
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000402 pageToken: string, Continuation token specifying which result page to return.
403 maxResults: integer, Maximum number of tables to return. Default is 5.
Craig Citroe633be12015-03-02 13:40:36 -0800404
405Returns:
406 An object of the form:
407
408 { # Represents a list of tables.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000409 "nextPageToken": "A String", # Token used to access the next page of this result. No token is displayed if there are no more pages left.
Craig Citroe633be12015-03-02 13:40:36 -0800410 "items": [ # List of all requested tables.
411 { # Represents a table.
412 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000413 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800414 "attribution": "A String", # Attribution assigned to the table.
415 "description": "A String", # Description assigned to the table.
416 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
417 "isExportable": True or False, # Variable for whether table is exportable.
418 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
419 "A String",
420 ],
421 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
422 "attributionLink": "A String", # Optional link for attribution.
423 "sql": "A String", # SQL that encodes the table definition for derived tables.
424 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
425 "columns": [ # Columns in the table.
426 { # Specifies the details of a column in a table.
427 "graphPredicate": "A String", # Column graph predicate.
428 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000429 # See W3C Graph-based Data Model.
430 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800431 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
432 "A String",
433 ],
434 "description": "A String", # Column description.
435 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
436 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
437 "columnId": 42, # The id of the column in the base table from which this column is derived.
438 },
439 "name": "A String", # Name of the column.
440 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
441 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000442 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800443 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
444 "type": "A String", # Type of the column.
445 "validateData": True or False, # If true, data entered via the web application is validated.
446 "columnId": 42, # Identifier for the column.
447 },
448 ],
449 "name": "A String", # Name assigned to a table.
450 },
451 ],
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000452 "kind": "fusiontables#tableList", # The kind of item this is. For table list, this is always fusiontables#tableList.
Craig Citroe633be12015-03-02 13:40:36 -0800453 }</pre>
454</div>
455
456<div class="method">
457 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
458 <pre>Retrieves the next page of results.
459
460Args:
461 previous_request: The request for the previous page. (required)
462 previous_response: The response from the request for the previous page. (required)
463
464Returns:
465 A request object that you can call 'execute()' on to request the next
466 page. Returns None if there are no more items in the collection.
467 </pre>
468</div>
469
470<div class="method">
471 <code class="details" id="patch">patch(tableId, body, replaceViewDefinition=None)</code>
472 <pre>Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.
473
474Args:
475 tableId: string, ID of the table that is being updated. (required)
476 body: object, The request body. (required)
477 The object takes the form of:
478
479{ # Represents a table.
480 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000481 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800482 "attribution": "A String", # Attribution assigned to the table.
483 "description": "A String", # Description assigned to the table.
484 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
485 "isExportable": True or False, # Variable for whether table is exportable.
486 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
487 "A String",
488 ],
489 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
490 "attributionLink": "A String", # Optional link for attribution.
491 "sql": "A String", # SQL that encodes the table definition for derived tables.
492 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
493 "columns": [ # Columns in the table.
494 { # Specifies the details of a column in a table.
495 "graphPredicate": "A String", # Column graph predicate.
496 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000497 # See W3C Graph-based Data Model.
498 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800499 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
500 "A String",
501 ],
502 "description": "A String", # Column description.
503 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
504 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
505 "columnId": 42, # The id of the column in the base table from which this column is derived.
506 },
507 "name": "A String", # Name of the column.
508 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
509 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000510 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800511 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
512 "type": "A String", # Type of the column.
513 "validateData": True or False, # If true, data entered via the web application is validated.
514 "columnId": 42, # Identifier for the column.
515 },
516 ],
517 "name": "A String", # Name assigned to a table.
518 }
519
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000520 replaceViewDefinition: boolean, Whether the view definition is also updated. The specified view definition replaces the existing one. Only a view can be updated with a new definition.
Craig Citroe633be12015-03-02 13:40:36 -0800521
522Returns:
523 An object of the form:
524
525 { # Represents a table.
526 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000527 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800528 "attribution": "A String", # Attribution assigned to the table.
529 "description": "A String", # Description assigned to the table.
530 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
531 "isExportable": True or False, # Variable for whether table is exportable.
532 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
533 "A String",
534 ],
535 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
536 "attributionLink": "A String", # Optional link for attribution.
537 "sql": "A String", # SQL that encodes the table definition for derived tables.
538 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
539 "columns": [ # Columns in the table.
540 { # Specifies the details of a column in a table.
541 "graphPredicate": "A String", # Column graph predicate.
542 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000543 # See W3C Graph-based Data Model.
544 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800545 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
546 "A String",
547 ],
548 "description": "A String", # Column description.
549 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
550 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
551 "columnId": 42, # The id of the column in the base table from which this column is derived.
552 },
553 "name": "A String", # Name of the column.
554 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
555 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000556 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800557 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
558 "type": "A String", # Type of the column.
559 "validateData": True or False, # If true, data entered via the web application is validated.
560 "columnId": 42, # Identifier for the column.
561 },
562 ],
563 "name": "A String", # Name assigned to a table.
564 }</pre>
565</div>
566
567<div class="method">
568 <code class="details" id="replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)</code>
569 <pre>Replaces rows of an existing table. Current rows remain visible until all replacement rows are ready.
570
571Args:
572 tableId: string, Table whose rows will be replaced. (required)
573 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
574 startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000575 isStrict: boolean, Whether the imported CSV must have the same number of column values for each row. If true, throws an exception if the CSV does not have the same number of columns. If false, rows with fewer column values will be padded with empty values. Default is true.
Craig Citroe633be12015-03-02 13:40:36 -0800576 encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000577 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
578 endLine: integer, The index of the line up to which data will be imported. Default is to import the entire file. If endLine is negative, it is an offset from the end of the file; the imported content will exclude the last endLine lines.
Craig Citroe633be12015-03-02 13:40:36 -0800579
580Returns:
581 An object of the form:
582
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000583 { # A background task on a table, initiated for time- or resource-consuming operations such as changing column types or deleting all rows.
584 "started": True or False, # false while the table is busy with some other task. true if this background task is currently running.
Craig Citroe633be12015-03-02 13:40:36 -0800585 "progress": "A String", # Task percentage completion.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000586 "kind": "fusiontables#task", # Type of the resource. This is always "fusiontables#task".
587 "type": "A String", # Type of background task.
Craig Citroe633be12015-03-02 13:40:36 -0800588 "taskId": "A String", # Identifier for the task.
589 }</pre>
590</div>
591
592<div class="method">
593 <code class="details" id="update">update(tableId, body, replaceViewDefinition=None)</code>
594 <pre>Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated.
595
596Args:
597 tableId: string, ID of the table that is being updated. (required)
598 body: object, The request body. (required)
599 The object takes the form of:
600
601{ # Represents a table.
602 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000603 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800604 "attribution": "A String", # Attribution assigned to the table.
605 "description": "A String", # Description assigned to the table.
606 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
607 "isExportable": True or False, # Variable for whether table is exportable.
608 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
609 "A String",
610 ],
611 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
612 "attributionLink": "A String", # Optional link for attribution.
613 "sql": "A String", # SQL that encodes the table definition for derived tables.
614 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
615 "columns": [ # Columns in the table.
616 { # Specifies the details of a column in a table.
617 "graphPredicate": "A String", # Column graph predicate.
618 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000619 # See W3C Graph-based Data Model.
620 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800621 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
622 "A String",
623 ],
624 "description": "A String", # Column description.
625 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
626 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
627 "columnId": 42, # The id of the column in the base table from which this column is derived.
628 },
629 "name": "A String", # Name of the column.
630 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
631 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000632 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800633 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
634 "type": "A String", # Type of the column.
635 "validateData": True or False, # If true, data entered via the web application is validated.
636 "columnId": 42, # Identifier for the column.
637 },
638 ],
639 "name": "A String", # Name assigned to a table.
640 }
641
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000642 replaceViewDefinition: boolean, Whether the view definition is also updated. The specified view definition replaces the existing one. Only a view can be updated with a new definition.
Craig Citroe633be12015-03-02 13:40:36 -0800643
644Returns:
645 An object of the form:
646
647 { # Represents a table.
648 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000649 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800650 "attribution": "A String", # Attribution assigned to the table.
651 "description": "A String", # Description assigned to the table.
652 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
653 "isExportable": True or False, # Variable for whether table is exportable.
654 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
655 "A String",
656 ],
657 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
658 "attributionLink": "A String", # Optional link for attribution.
659 "sql": "A String", # SQL that encodes the table definition for derived tables.
660 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
661 "columns": [ # Columns in the table.
662 { # Specifies the details of a column in a table.
663 "graphPredicate": "A String", # Column graph predicate.
664 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000665 # See W3C Graph-based Data Model.
666 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800667 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
668 "A String",
669 ],
670 "description": "A String", # Column description.
671 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
672 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
673 "columnId": 42, # The id of the column in the base table from which this column is derived.
674 },
675 "name": "A String", # Name of the column.
676 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
677 "formatPattern": "A String", # Format pattern.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000678 # Acceptable values are DT_DATE_MEDIUMe.g Dec 24, 2008 DT_DATE_SHORTfor example 12/24/08 DT_DATE_TIME_MEDIUMfor example Dec 24, 2008 8:30:45 PM DT_DATE_TIME_SHORTfor example 12/24/08 8:30 PM DT_DAY_MONTH_2_DIGIT_YEARfor example 24/12/08 DT_DAY_MONTH_2_DIGIT_YEAR_TIMEfor example 24/12/08 20:30 DT_DAY_MONTH_2_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/08 8:30 PM DT_DAY_MONTH_4_DIGIT_YEARfor example 24/12/2008 DT_DAY_MONTH_4_DIGIT_YEAR_TIMEfor example 24/12/2008 20:30 DT_DAY_MONTH_4_DIGIT_YEAR_TIME_MERIDIANfor example 24/12/2008 8:30 PM DT_ISO_YEAR_MONTH_DAYfor example 2008-12-24 DT_ISO_YEAR_MONTH_DAY_TIMEfor example 2008-12-24 20:30:45 DT_MONTH_DAY_4_DIGIT_YEARfor example 12/24/2008 DT_TIME_LONGfor example 8:30:45 PM UTC-6 DT_TIME_MEDIUMfor example 8:30:45 PM DT_TIME_SHORTfor example 8:30 PM DT_YEAR_ONLYfor example 2008 HIGHLIGHT_UNTYPED_CELLSHighlight cell data that does not match the data type NONENo formatting (default) NUMBER_CURRENCYfor example $1234.56 NUMBER_DEFAULTfor example 1,234.56 NUMBER_INTEGERfor example 1235 NUMBER_NO_SEPARATORfor example 1234.56 NUMBER_PERCENTfor example 123,456% NUMBER_SCIENTIFICfor example 1E3 STRING_EIGHT_LINE_IMAGEDisplays thumbnail images as tall as eight lines of text STRING_FOUR_LINE_IMAGEDisplays thumbnail images as tall as four lines of text STRING_JSON_TEXTAllows JSON editing of text in UI STRING_LINKTreats cell as a link (must start with http:// or https://) STRING_ONE_LINE_IMAGEDisplays thumbnail images as tall as one line of text STRING_VIDEO_OR_MAPDisplay a video or map thumbnail
Craig Citroe633be12015-03-02 13:40:36 -0800679 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
680 "type": "A String", # Type of the column.
681 "validateData": True or False, # If true, data entered via the web application is validated.
682 "columnId": 42, # Identifier for the column.
683 },
684 ],
685 "name": "A String", # Name assigned to a table.
686 }</pre>
687</div>
688
689</body></html>