Tabelas

Este guia descreve como e por que usar a API Google Sheets para criar tabelas nas suas planilhas.

O que é uma tabela?

Com as tabelas, você pode simplificar a criação de dados e reduzir a necessidade de formatar, inserir e atualizar dados repetidamente, aplicando automaticamente formato e estrutura aos intervalos de dados.

As tabelas têm muitos recursos, como cabeçalhos, rodapés, tipos de coluna, filtros, visualizações, referências e nomes de tabelas. Saiba mais no anúncio do recurso, e aprenda a usar tabelas nas Planilhas.

Você pode usar tabelas para tarefas como monitoramento de projetos, planejamento de eventos e gerenciamento de inventário.

Adicionar uma tabela

Para adicionar uma tabela, use o batchUpdate método, fornecendo uma solicitação addTable. Use essa solicitação para adicionar uma tabela à planilha.

O exemplo a seguir cria uma tabela chamada "Project Tracker" no range especificado com duas colunas definidas. Uma coluna de porcentagem na primeira coluna e um tipo de coluna suspensa na segunda coluna.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Tipos de coluna

As tabelas têm tipos de coluna como numérica, data, menu suspenso, ícone inteligente e caixa de seleção. Os tipos de coluna de classificação e caixa de seleção são preenchidos com os valores padrão de 0 e FALSE, respectivamente.

O tipo de coluna suspensa cria um menu suspenso de chip. Se um tipo de coluna for definido como suspenso, a dataValidationRule da coluna precisará ser definida com uma condição ONE_OF_LIST. Outros tipos de coluna não devem definir o campo `dataValidationRule`.

Atualizar uma tabela

Use o método spreadsheets.batchUpdate e forneça um UpdateTableRequest.

Modificar o tamanho da tabela

Use o UpdateTableRequest método para modificar o range que a tabela precisa adicionar novas linhas/colunas.

Se você precisar adicionar uma nova linha ou coluna na tabela, use o InsertRangeRequest ou o InsertDimensionRequest

Se você precisar excluir uma linha da tabela, use DeleteRangeRequest caso contrário, use DeleteDimensionRequest para excluir uma linha inteira da planilha.

Se você estiver atualizando uma tabela sem rodapé para adicionar um rodapé, o range será expandido em uma linha. Se você estiver atualizando uma tabela com um rodapé e removendo o rodapé, o range será reduzido em uma linha.

Anexar valores a uma tabela

Use AppendCellsRequest com tableId para adicionar linhas ao final de uma tabela. Isso anexa os valores à primeira linha livre e reconhece linhas e rodapés completos. Se não houver linhas vazias, isso vai inserir linhas no final da tabela e antes de qualquer rodapé, se aplicável.

Excluir uma tabela

Use o spreadsheets.batchUpdate método e forneça um DeleteTableRequest. Use o DeleteTableRequest para excluir toda a tabela e o conteúdo dela.

Use o DeleteBandingRequest para remover a formatação da tabela, mas manter os dados.

Usar tabelas com outros recursos das Planilhas

Outros recursos da API que oferecem suporte a tabelas como dados de apoio incluem filtros, visualizações de filtro e intervalos protegidos.