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 Acara, dan pengelolaan Inventaris.

Menambahkan tabel

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

Contoh berikut membuat tabel bernama "Project Tracker" pada range yang ditentukan dengan 2 kolom yang ditetapkan. Kolom persentase 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, chip cerdas, kotak centang. Jenis kolom rating dan kotak centang diisi dengan nilai default 0 dan FALSE.

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 dimiliki tabel untuk menambahkan baris/kolom baru.

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

Jika Anda 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 diperkecil sebanyak 1 baris.

Menambahkan nilai ke tabel

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

Menghapus tabel

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

Gunakan DeleteBandingRequest untuk menghapus pemformatan tabel, tetapi menyimpan data.

Menggunakan tabel dengan fitur Spreadsheet lainnya

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