Tabel

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

Apa itu 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.

Tambahkan 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" di range yang ditentukan dengan 2 kolom set. 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 smart, 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 perlu menghapus baris tabel, Anda dapat menggunakan DeleteRangeRequest atau 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 sudah 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 menambahkan nilai ke baris kosong pertama dan mengetahui baris lengkap dan footer. Jika tidak ada baris kosong, baris ini akan disisipkan di 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 tetap menyimpan data.

Menggunakan tabel dengan fitur Spreadsheet lainnya

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