Tabel

Panduan ini menjelaskan cara dan alasan menggunakan Google Sheets API untuk membuat tabel di spreadsheet Anda.

Apa yang dimaksud dengan tabel?

Dengan tabel, Anda dapat menyederhanakan pembuatan data dan mengurangi keharusan dalam memformat, memasukkan, dan memperbarui data berulang kali dengan menerapkan format serta struktur ke rentang data secara otomatis.

Tabel memiliki banyak fitur, seperti header, footer, jenis kolom, filter, tampilan, referensi tabel, dan nama tabel. Lihat selengkapnya di pengumuman fitur, dan pelajari cara menggunakan tabel di Spreadsheet.

Anda dapat menggunakan tabel untuk tugas seperti Pelacakan Project, Perencanaan Peristiwa, dan pengelolaan Inventaris.

Tambahkan tabel

Untuk menambahkan tabel, gunakan metode batchUpdate, yang menyediakan permintaan addTable. Anda menggunakan permintaan ini untuk menambahkan tabel ke spreadsheet.

Contoh berikut membuat tabel bernama "Project Tracker" di range yang ditentukan dengan 2 kolom yang ditetapkan. Kolom persen di kolom pertama dan jenis kolom dropdown di kolom kedua.

{
  "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"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Jenis kolom

Tabel memiliki jenis kolom seperti numerik, tanggal, dropdown, smart chip, kotak centang. Jenis kolom rating dan kotak centang diisi dengan nilai default 0 dan SALAH masing-masing.

Jenis kolom dropdown membuat dropdown chip. Jika jenis kolom ditetapkan sebagai dropdown, dataValidationRule untuk kolom harus ditetapkan dengan kondisi ONE_OF_LIST. Jenis kolom lainnya tidak boleh menetapkan kolom `dataValidationRule.

Memperbarui tabel

Gunakan metode spreadsheets.batchUpdate dan berikan UpdateTableRequest.

Mengubah ukuran tabel

Gunakan metode UpdateTableRequest untuk mengubah range yang harus ditambahkan tabel ke baris/kolom baru.

Jika Anda perlu menambahkan baris atau kolom baru dalam tabel, gunakan InsertRangeRequest atau InsertDimensionRequest

Jika perlu menghapus baris tabel, Anda dapat menggunakan DeleteRangeRequest. Jika tidak, Anda dapat menggunakan DeleteDimensionRequest untuk menghapus seluruh baris dari spreadsheet.

Jika Anda memperbarui tabel yang ada tanpa footer untuk menambahkan footer, range akan diperluas sebanyak 1 baris. Jika Anda memperbarui tabel yang ada dengan footer dan menghapus footer, range akan menyusut sebanyak 1 baris.

Menambahkan nilai ke tabel

Gunakan AppendCellsRequest dengan tableId untuk menambahkan baris ke akhir tabel. Tindakan ini akan menambahkan nilai ke baris kosong pertama dan mengetahui baris dan footer penuh. Jika tidak ada baris kosong, tindakan ini akan menyisipkan baris ke bagian akhir tabel dan sebelum footer, jika ada.

Menghapus tabel

Gunakan metode spreadsheets.batchUpdate dan berikan DeleteTableRequest. Gunakan DeleteTableRequest untuk menghapus seluruh tabel dan konten tabel.

Gunakan DeleteBandingRequest untuk menghapus format tabel, tetapi mempertahankan data.

Menggunakan tabel dengan fitur Spreadsheet lainnya

Fitur API lainnya yang mendukung tabel sebagai data pendukungnya mencakup filter, tampilan filter, dan rentang yang dilindungi.