# Fusion Tables API . table

## Instance Methods

Copies a table.

Deletes a table.

Retrieves a specific table by its id.

Import more rows into a table.

Import a new table.

Creates a new table.

Retrieves a list of tables a user owns.

Retrieves the next page of results.

Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.

Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated.

### Method Details

`copy(tableId, copyPresentation=None)`

    Copies a table.

    Args:
      tableId: string, ID of the table that is being copied. (required)
      copyPresentation: boolean, Whether to also copy tabs, styles, and templates. Default is false.

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }

`delete(tableId)`

    Deletes a table.

    Args:
      tableId: string, ID of the table that is being deleted. (required)

`get(tableId)`

    Retrieves a specific table by its id.

    Args:
      tableId: string, Identifier(ID) for the table being requested. (required)

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }

`importRows(tableId, media_body=None, startLine=None, isStrict=None, encoding=None, delimiter=None, endLine=None)`

    Import more rows into a table.

    Args:
      tableId: string, The table into which new rows are being imported. (required)
      media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
      startLine: integer, The index of the first line from which to start importing, inclusive. Default is 0.
      isStrict: boolean, Whether the 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.
      encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
      delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ','.
      endLine: integer, The index of the last line from which to start importing, exclusive. Thus, the number of imported lines is endLine - startLine. If this parameter is not provided, the file will be imported until the last line of the file. If endLine is negative, then the imported content will exclude the last endLine lines. That is, if endline is negative, no line will be imported whose index is greater than N + endLine where N is the number of lines in the file, and the number of imported lines will be N + endLine - startLine.

    Returns:
      An object of the form:

        { # Represents an import request.
        "numRowsReceived": "A String", # The number of rows received from the import request.
        "kind": "fusiontables#import", # Type name: a template for an import request.
      }

`importTable(name, media_body=None, encoding=None, delimiter=None)`

    Import a new table.

    Args:
      name: string, The name to be assigned to the new table. (required)
      media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
      encoding: string, The encoding of the content. Default is UTF-8. Use 'auto-detect' if you are unsure of the encoding.
      delimiter: string, The delimiter used to separate cell values. This can only consist of a single character. Default is ','.

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }

`insert(body)`

    Creates a new table.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
        "kind": "fusiontables#table", # Type name: a template for an individual table.
        "attribution": "A String", # Optional attribution assigned to the table.
        "description": "A String", # Optional description assigned to the table.
        "isExportable": True or False, # Variable for whether table is exportable.
        "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
          "A String",
        ],
        "attributionLink": "A String", # Optional link for attribution.
        "sql": "A String", # Optional sql that encodes the table definition for derived tables.
        "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
        "columns": [ # Columns in the table.
          { # Specifies the id, name and type of a column in a table.
              "kind": "fusiontables#column", # Type name: a template for an individual column.
              "type": "A String", # Required type of the column.
              "columnId": 42, # Identifier for the column.
              "name": "A String", # Required name of the column.
              "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                "columnId": 42, # The id of the column in the base table from which this column is derived.
              },
            },
        ],
        "name": "A String", # Name assigned to a table.
      }

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }

`list(pageToken=None, maxResults=None)`

    Retrieves a list of tables a user owns.

    Args:
      pageToken: string, Continuation token specifying which result page to return. Optional.
      maxResults: integer, Maximum number of styles to return. Optional. Default is 5.

    Returns:
      An object of the form:

        { # Represents a list of tables.
        "nextPageToken": "A String", # Token used to access the next page of this result. No token is displayed if there are no more tokens left.
        "items": [ # List of all requested tables.
          { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
              "kind": "fusiontables#table", # Type name: a template for an individual table.
              "attribution": "A String", # Optional attribution assigned to the table.
              "description": "A String", # Optional description assigned to the table.
              "isExportable": True or False, # Variable for whether table is exportable.
              "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
                "A String",
              ],
              "attributionLink": "A String", # Optional link for attribution.
              "sql": "A String", # Optional sql that encodes the table definition for derived tables.
              "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
              "columns": [ # Columns in the table.
                { # Specifies the id, name and type of a column in a table.
                    "kind": "fusiontables#column", # Type name: a template for an individual column.
                    "type": "A String", # Required type of the column.
                    "columnId": 42, # Identifier for the column.
                    "name": "A String", # Required name of the column.
                    "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                      "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                      "columnId": 42, # The id of the column in the base table from which this column is derived.
                    },
                  },
              ],
              "name": "A String", # Name assigned to a table.
            },
        ],
        "kind": "fusiontables#tableList", # Type name: a list of all tables.
      }

`list_next(previous_request, previous_response)`

    Retrieves the next page of results.

    Args:
      previous_request: The request for the previous page. (required)
      previous_response: The response from the request for the previous page. (required)

    Returns:
      A request object that you can call 'execute()' on to request the next
      page. Returns None if there are no more items in the collection.

`patch(tableId, body, replaceViewDefinition=None)`

    Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated. This method supports patch semantics.

    Args:
      tableId: string, ID of the table that is being updated. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
        "kind": "fusiontables#table", # Type name: a template for an individual table.
        "attribution": "A String", # Optional attribution assigned to the table.
        "description": "A String", # Optional description assigned to the table.
        "isExportable": True or False, # Variable for whether table is exportable.
        "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
          "A String",
        ],
        "attributionLink": "A String", # Optional link for attribution.
        "sql": "A String", # Optional sql that encodes the table definition for derived tables.
        "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
        "columns": [ # Columns in the table.
          { # Specifies the id, name and type of a column in a table.
              "kind": "fusiontables#column", # Type name: a template for an individual column.
              "type": "A String", # Required type of the column.
              "columnId": 42, # Identifier for the column.
              "name": "A String", # Required name of the column.
              "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                "columnId": 42, # The id of the column in the base table from which this column is derived.
              },
            },
        ],
        "name": "A String", # Name assigned to a table.
      }

      replaceViewDefinition: boolean, Should the view definition also be updated? The specified view definition replaces the existing one. Only a view can be updated with a new definition.

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }

`update(tableId, body, replaceViewDefinition=None)`

    Updates an existing table. Unless explicitly requested, only the name, description, and attribution will be updated.

    Args:
      tableId: string, ID of the table that is being updated. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
        "kind": "fusiontables#table", # Type name: a template for an individual table.
        "attribution": "A String", # Optional attribution assigned to the table.
        "description": "A String", # Optional description assigned to the table.
        "isExportable": True or False, # Variable for whether table is exportable.
        "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
          "A String",
        ],
        "attributionLink": "A String", # Optional link for attribution.
        "sql": "A String", # Optional sql that encodes the table definition for derived tables.
        "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
        "columns": [ # Columns in the table.
          { # Specifies the id, name and type of a column in a table.
              "kind": "fusiontables#column", # Type name: a template for an individual column.
              "type": "A String", # Required type of the column.
              "columnId": 42, # Identifier for the column.
              "name": "A String", # Required name of the column.
              "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                "columnId": 42, # The id of the column in the base table from which this column is derived.
              },
            },
        ],
        "name": "A String", # Name assigned to a table.
      }

      replaceViewDefinition: boolean, Should the view definition also be updated? The specified view definition replaces the existing one. Only a view can be updated with a new definition.

    Returns:
      An object of the form:

        { # Represents a table. Specifies the name, whether it is exportable, description, attribution, and attribution link.
          "kind": "fusiontables#table", # Type name: a template for an individual table.
          "attribution": "A String", # Optional attribution assigned to the table.
          "description": "A String", # Optional description assigned to the table.
          "isExportable": True or False, # Variable for whether table is exportable.
          "baseTableIds": [ # Optional base table identifier if this table is a view or merged table.
            "A String",
          ],
          "attributionLink": "A String", # Optional link for attribution.
          "sql": "A String", # Optional sql that encodes the table definition for derived tables.
          "tableId": "A String", # Encrypted unique alphanumeric identifier for the table.
          "columns": [ # Columns in the table.
            { # Specifies the id, name and type of a column in a table.
                "kind": "fusiontables#column", # Type name: a template for an individual column.
                "type": "A String", # Required type of the column.
                "columnId": 42, # Identifier for the column.
                "name": "A String", # Required name of the column.
                "baseColumn": { # Optional identifier of the base column. If present, this column is derived from the specified base column.
                  "tableIndex": 42, # Offset to the entry in the list of base tables in the table definition.
                  "columnId": 42, # The id of the column in the base table from which this column is derived.
                },
              },
          ],
          "name": "A String", # Name assigned to a table.
        }