Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 02bae1c909ec28088ebbc4007f3ef9b968b55e0a / . / docs / dyn / fusiontables_v2.table.html
blob: 0f1c00e8cea1b377720c5b4a8051ebd8c36d778c [file] [log] [blame]
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]1<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 +0000[diff] [blame]85<p class="firstline">Retrieves a specific table by its ID.</p>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]86<p class="toc_element">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]87 <code><a href="#importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</a></code></p>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]88<p class="firstline">Imports more rows into a table.</p>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]89<p class="toc_element">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]90 <code><a href="#importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</a></code></p>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]91<p class="firstline">Imports a new table.</p>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]92<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">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]105 <code><a href="#replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</a></code></p>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]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 +0000[diff] [blame]124 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]125 "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 +0000[diff] [blame]140 # 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 -0800[diff] [blame]142 "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.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]153 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]154 "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 +0000[diff] [blame]169 tableId: string, ID of the table to be deleted. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]170</pre>
171</div>
172
173<div class="method">
174 <code class="details" id="get">get(tableId)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]175 <pre>Retrieves a specific table by its ID.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]176
177Args:
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]178 tableId: string, Identifier for the table being requested. (required)
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]179
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 +0000[diff] [blame]185 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]186 "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 +0000[diff] [blame]201 # 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 -0800[diff] [blame]203 "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.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]214 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]215 "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">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]226 <code class="details" id="importRows">importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]227 <pre>Imports more rows into a table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]228
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 +0000[diff] [blame]233 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.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]235 media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]236 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
237 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 -0800[diff] [blame]238
239Returns:
240 An object of the form:
241
242 { # Represents an import request.
243 "numRowsReceived": "A String", # The number of rows received from the import request.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]244 "kind": "fusiontables#import", # The kind of item this is. For an import, this is always fusiontables#import.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]245 }</pre>
246</div>
247
248<div class="method">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]249 <code class="details" id="importTable">importTable(name, media_body=None, encoding=None, delimiter=None, media_mime_type=None)</code>
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]250 <pre>Imports a new table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]251
252Args:
253 name: string, The name to be assigned to the new table. (required)
254 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]255 encoding: string, The encoding of the content. Default is UTF-8. Use auto-detect if you are unsure of the encoding.
256 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]257 media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]258
259Returns:
260 An object of the form:
261
262 { # Represents a table.
263 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]264 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]265 "attribution": "A String", # Attribution assigned to the table.
266 "description": "A String", # Description assigned to the table.
267 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
268 "isExportable": True or False, # Variable for whether table is exportable.
269 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
270 "A String",
271 ],
272 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
273 "attributionLink": "A String", # Optional link for attribution.
274 "sql": "A String", # SQL that encodes the table definition for derived tables.
275 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
276 "columns": [ # Columns in the table.
277 { # Specifies the details of a column in a table.
278 "graphPredicate": "A String", # Column graph predicate.
279 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]280 # See W3C Graph-based Data Model.
281 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]282 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
283 "A String",
284 ],
285 "description": "A String", # Column description.
286 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
287 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
288 "columnId": 42, # The id of the column in the base table from which this column is derived.
289 },
290 "name": "A String", # Name of the column.
291 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
292 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]293 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]294 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
295 "type": "A String", # Type of the column.
296 "validateData": True or False, # If true, data entered via the web application is validated.
297 "columnId": 42, # Identifier for the column.
298 },
299 ],
300 "name": "A String", # Name assigned to a table.
301 }</pre>
302</div>
303
304<div class="method">
305 <code class="details" id="insert">insert(body)</code>
306 <pre>Creates a new table.
307
308Args:
309 body: object, The request body. (required)
310 The object takes the form of:
311
312{ # Represents a table.
313 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]314 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]315 "attribution": "A String", # Attribution assigned to the table.
316 "description": "A String", # Description assigned to the table.
317 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
318 "isExportable": True or False, # Variable for whether table is exportable.
319 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
320 "A String",
321 ],
322 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
323 "attributionLink": "A String", # Optional link for attribution.
324 "sql": "A String", # SQL that encodes the table definition for derived tables.
325 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
326 "columns": [ # Columns in the table.
327 { # Specifies the details of a column in a table.
328 "graphPredicate": "A String", # Column graph predicate.
329 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]330 # See W3C Graph-based Data Model.
331 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]332 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
333 "A String",
334 ],
335 "description": "A String", # Column description.
336 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
337 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
338 "columnId": 42, # The id of the column in the base table from which this column is derived.
339 },
340 "name": "A String", # Name of the column.
341 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
342 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]343 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]344 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
345 "type": "A String", # Type of the column.
346 "validateData": True or False, # If true, data entered via the web application is validated.
347 "columnId": 42, # Identifier for the column.
348 },
349 ],
350 "name": "A String", # Name assigned to a table.
351 }
352
353
354Returns:
355 An object of the form:
356
357 { # Represents a table.
358 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]359 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]360 "attribution": "A String", # Attribution assigned to the table.
361 "description": "A String", # Description assigned to the table.
362 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
363 "isExportable": True or False, # Variable for whether table is exportable.
364 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
365 "A String",
366 ],
367 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
368 "attributionLink": "A String", # Optional link for attribution.
369 "sql": "A String", # SQL that encodes the table definition for derived tables.
370 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
371 "columns": [ # Columns in the table.
372 { # Specifies the details of a column in a table.
373 "graphPredicate": "A String", # Column graph predicate.
374 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]375 # See W3C Graph-based Data Model.
376 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]377 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
378 "A String",
379 ],
380 "description": "A String", # Column description.
381 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
382 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
383 "columnId": 42, # The id of the column in the base table from which this column is derived.
384 },
385 "name": "A String", # Name of the column.
386 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
387 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]388 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]389 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
390 "type": "A String", # Type of the column.
391 "validateData": True or False, # If true, data entered via the web application is validated.
392 "columnId": 42, # Identifier for the column.
393 },
394 ],
395 "name": "A String", # Name assigned to a table.
396 }</pre>
397</div>
398
399<div class="method">
400 <code class="details" id="list">list(pageToken=None, maxResults=None)</code>
401 <pre>Retrieves a list of tables a user owns.
402
403Args:
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]404 pageToken: string, Continuation token specifying which result page to return.
405 maxResults: integer, Maximum number of tables to return. Default is 5.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]406
407Returns:
408 An object of the form:
409
410 { # Represents a list of tables.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]411 "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 -0800[diff] [blame]412 "items": [ # List of all requested tables.
413 { # Represents a table.
414 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]415 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]416 "attribution": "A String", # Attribution assigned to the table.
417 "description": "A String", # Description assigned to the table.
418 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
419 "isExportable": True or False, # Variable for whether table is exportable.
420 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
421 "A String",
422 ],
423 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
424 "attributionLink": "A String", # Optional link for attribution.
425 "sql": "A String", # SQL that encodes the table definition for derived tables.
426 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
427 "columns": [ # Columns in the table.
428 { # Specifies the details of a column in a table.
429 "graphPredicate": "A String", # Column graph predicate.
430 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]431 # See W3C Graph-based Data Model.
432 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]433 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
434 "A String",
435 ],
436 "description": "A String", # Column description.
437 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
438 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
439 "columnId": 42, # The id of the column in the base table from which this column is derived.
440 },
441 "name": "A String", # Name of the column.
442 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
443 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]444 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]445 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
446 "type": "A String", # Type of the column.
447 "validateData": True or False, # If true, data entered via the web application is validated.
448 "columnId": 42, # Identifier for the column.
449 },
450 ],
451 "name": "A String", # Name assigned to a table.
452 },
453 ],
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]454 "kind": "fusiontables#tableList", # The kind of item this is. For table list, this is always fusiontables#tableList.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]455 }</pre>
456</div>
457
458<div class="method">
459 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
460 <pre>Retrieves the next page of results.
461
462Args:
463 previous_request: The request for the previous page. (required)
464 previous_response: The response from the request for the previous page. (required)
465
466Returns:
467 A request object that you can call 'execute()' on to request the next
468 page. Returns None if there are no more items in the collection.
469 </pre>
470</div>
471
472<div class="method">
473 <code class="details" id="patch">patch(tableId, body, replaceViewDefinition=None)</code>
474 <pre>Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.
475
476Args:
477 tableId: string, ID of the table that is being updated. (required)
478 body: object, The request body. (required)
479 The object takes the form of:
480
481{ # Represents a table.
482 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]483 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]484 "attribution": "A String", # Attribution assigned to the table.
485 "description": "A String", # Description assigned to the table.
486 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
487 "isExportable": True or False, # Variable for whether table is exportable.
488 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
489 "A String",
490 ],
491 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
492 "attributionLink": "A String", # Optional link for attribution.
493 "sql": "A String", # SQL that encodes the table definition for derived tables.
494 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
495 "columns": [ # Columns in the table.
496 { # Specifies the details of a column in a table.
497 "graphPredicate": "A String", # Column graph predicate.
498 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]499 # See W3C Graph-based Data Model.
500 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]501 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
502 "A String",
503 ],
504 "description": "A String", # Column description.
505 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
506 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
507 "columnId": 42, # The id of the column in the base table from which this column is derived.
508 },
509 "name": "A String", # Name of the column.
510 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
511 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]512 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]513 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
514 "type": "A String", # Type of the column.
515 "validateData": True or False, # If true, data entered via the web application is validated.
516 "columnId": 42, # Identifier for the column.
517 },
518 ],
519 "name": "A String", # Name assigned to a table.
520 }
521
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]522 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 -0800[diff] [blame]523
524Returns:
525 An object of the form:
526
527 { # Represents a table.
528 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]529 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]530 "attribution": "A String", # Attribution assigned to the table.
531 "description": "A String", # Description assigned to the table.
532 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
533 "isExportable": True or False, # Variable for whether table is exportable.
534 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
535 "A String",
536 ],
537 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
538 "attributionLink": "A String", # Optional link for attribution.
539 "sql": "A String", # SQL that encodes the table definition for derived tables.
540 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
541 "columns": [ # Columns in the table.
542 { # Specifies the details of a column in a table.
543 "graphPredicate": "A String", # Column graph predicate.
544 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]545 # See W3C Graph-based Data Model.
546 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]547 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
548 "A String",
549 ],
550 "description": "A String", # Column description.
551 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
552 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
553 "columnId": 42, # The id of the column in the base table from which this column is derived.
554 },
555 "name": "A String", # Name of the column.
556 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
557 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]558 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]559 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
560 "type": "A String", # Type of the column.
561 "validateData": True or False, # If true, data entered via the web application is validated.
562 "columnId": 42, # Identifier for the column.
563 },
564 ],
565 "name": "A String", # Name assigned to a table.
566 }</pre>
567</div>
568
569<div class="method">
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]570 <code class="details" id="replaceRows">replaceRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, media_mime_type=None, delimiter=None, endLine=None)</code>
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]571 <pre>Replaces rows of an existing table. Current rows remain visible until all replacement rows are ready.
572
573Args:
574 tableId: string, Table whose rows will be replaced. (required)
575 media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
576 startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]577 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 -0800[diff] [blame]578 encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
Jon Wayne Parrott692617a2017-01-06 09:58:29 -0800[diff] [blame]579 media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]580 delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ,.
581 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 -0800[diff] [blame]582
583Returns:
584 An object of the form:
585
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]586 { # A background task on a table, initiated for time- or resource-consuming operations such as changing column types or deleting all rows.
587 "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 -0800[diff] [blame]588 "progress": "A String", # Task percentage completion.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]589 "kind": "fusiontables#task", # Type of the resource. This is always "fusiontables#task".
590 "type": "A String", # Type of background task.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]591 "taskId": "A String", # Identifier for the task.
592 }</pre>
593</div>
594
595<div class="method">
596 <code class="details" id="update">update(tableId, body, replaceViewDefinition=None)</code>
597 <pre>Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated.
598
599Args:
600 tableId: string, ID of the table that is being updated. (required)
601 body: object, The request body. (required)
602 The object takes the form of:
603
604{ # Represents a table.
605 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]606 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]607 "attribution": "A String", # Attribution assigned to the table.
608 "description": "A String", # Description assigned to the table.
609 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
610 "isExportable": True or False, # Variable for whether table is exportable.
611 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
612 "A String",
613 ],
614 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
615 "attributionLink": "A String", # Optional link for attribution.
616 "sql": "A String", # SQL that encodes the table definition for derived tables.
617 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
618 "columns": [ # Columns in the table.
619 { # Specifies the details of a column in a table.
620 "graphPredicate": "A String", # Column graph predicate.
621 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]622 # See W3C Graph-based Data Model.
623 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]624 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
625 "A String",
626 ],
627 "description": "A String", # Column description.
628 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
629 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
630 "columnId": 42, # The id of the column in the base table from which this column is derived.
631 },
632 "name": "A String", # Name of the column.
633 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
634 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]635 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]636 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
637 "type": "A String", # Type of the column.
638 "validateData": True or False, # If true, data entered via the web application is validated.
639 "columnId": 42, # Identifier for the column.
640 },
641 ],
642 "name": "A String", # Name assigned to a table.
643 }
644
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]645 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 -0800[diff] [blame]646
647Returns:
648 An object of the form:
649
650 { # Represents a table.
651 "tablePropertiesJsonSchema": "A String", # JSON schema for validating the JSON table properties.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]652 "kind": "fusiontables#table", # The kind of item this is. For a table, this is always fusiontables#table.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]653 "attribution": "A String", # Attribution assigned to the table.
654 "description": "A String", # Description assigned to the table.
655 "columnPropertiesJsonSchema": "A String", # Default JSON schema for validating all JSON column properties.
656 "isExportable": True or False, # Variable for whether table is exportable.
657 "baseTableIds": [ # Base table identifier if this table is a view or merged table.
658 "A String",
659 ],
660 "tablePropertiesJson": "A String", # JSON object containing custom table properties.
661 "attributionLink": "A String", # Optional link for attribution.
662 "sql": "A String", # SQL that encodes the table definition for derived tables.
663 "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
664 "columns": [ # Columns in the table.
665 { # Specifies the details of a column in a table.
666 "graphPredicate": "A String", # Column graph predicate.
667 # Used to map table to graph data model (subject,predicate,object)
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000[diff] [blame]668 # See W3C Graph-based Data Model.
669 "kind": "fusiontables#column", # The kind of item this is. For a column, this is always fusiontables#column.
Craig Citroe633be12015-03-02 13:40:36 -0800[diff] [blame]670 "validValues": [ # List of valid values used to validate data and supply a drop-down list of values in the web application.
671 "A String",
672 ],
673 "description": "A String", # Column description.
674 "baseColumn": { # Identifier of the base column. If present, this column is derived from the specified base column.
675 "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
676 "columnId": 42, # The id of the column in the base table from which this column is derived.
677 },
678 "name": "A String", # Name of the column.
679 "columnPropertiesJson": "A String", # JSON object containing custom column properties.
680 "formatPattern": "A String", # Format pattern.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700[diff] [blame]681 # 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 editing of text as JSON in UI STRING_JSON_LISTAllows editing of text as a JSON list 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 -0800[diff] [blame]682 "columnJsonSchema": "A String", # JSON schema for interpreting JSON in this column.
683 "type": "A String", # Type of the column.
684 "validateData": True or False, # If true, data entered via the web application is validated.
685 "columnId": 42, # Identifier for the column.
686 },
687 ],
688 "name": "A String", # Name assigned to a table.
689 }</pre>
690</div>
691
692</body></html>