Bảng

Hướng dẫn này mô tả cách và lý do sử dụng API Google Trang tính để tạo bảng trong bảng tính.

Bảng là gì?

Với bảng, bạn có thể đơn giản hoá việc tạo dữ liệu và giảm bớt nhu cầu định dạng, nhập và cập nhật dữ liệu nhiều lần bằng cách tự động áp dụng định dạng và cấu trúc cho các dải ô dữ liệu.

Bảng có nhiều tính năng, chẳng hạn như tiêu đề, chân trang, loại cột, bộ lọc, chế độ xem, tham chiếu bảng và tên bảng. Xem thêm trong thông báo về tính năng, và tìm hiểu về cách sử dụng bảng trong Trang tính.

Bạn có thể sử dụng bảng cho các tác vụ như Theo dõi dự án, Lập kế hoạch sự kiện và Quản lý kho.

Thêm bảng

Để thêm bảng, hãy sử dụng phương thức batchUpdate, cung cấp yêu cầu addTable. Bạn sử dụng yêu cầu này để thêm bảng vào bảng tính.

Ví dụ sau đây tạo một bảng có tên là "Project Tracker" (Trình theo dõi dự án) tại range được chỉ định với 2 cột đã đặt. Một cột phần trăm ở cột đầu tiên và một loại cột trình đơn thả xuống ở cột thứ hai.

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

Loại cột

Bảng có các loại cột như số, ngày, trình đơn thả xuống, khối thông tin thông minh, hộp kiểm. Các loại cột xếp hạng và hộp kiểm sẽ điền các giá trị mặc định là 0 và FALSE.

Loại cột trình đơn thả xuống tạo ra một trình đơn thả xuống khối thông tin. Nếu một loại cột được đặt là trình đơn thả xuống, thì dataValidationRule cho cột phải được đặt với điều kiện ONE_OF_LIST. Các loại cột khác không được đặt trường `dataValidationRule`.

Cập nhật bảng

Sử dụng phương thức spreadsheets.batchUpdate và cung cấp UpdateTableRequest.

Sửa đổi kích thước bảng

Sử dụng phương thức UpdateTableRequest để sửa đổi range mà bảng phải thêm hàng/cột mới.

Nếu bạn cần thêm một hàng hoặc cột mới trong bảng, hãy sử dụng InsertRangeRequest hoặc InsertDimensionRequest

Nếu cần xoá một hàng trong bảng, bạn có thể sử dụng DeleteRangeRequest nếu không, bạn có thể sử dụng DeleteDimensionRequest để xoá toàn bộ hàng khỏi bảng tính.

Nếu bạn đang cập nhật một bảng hiện có mà không có chân trang để thêm chân trang, thì range sẽ mở rộng thêm 1 hàng. Nếu bạn đang cập nhật một bảng hiện có có chân trang và xoá chân trang, thì range sẽ thu hẹp thêm 1 hàng.

Nối các giá trị vào bảng

Sử dụng AppendCellsRequest với tableId để thêm các hàng vào cuối bảng. Thao tác này sẽ nối các giá trị vào hàng trống đầu tiên và nhận biết các hàng đầy đủ và chân trang. Nếu không có hàng trống, thao tác này sẽ chèn các hàng vào cuối bảng và trước bất kỳ chân trang nào (nếu có).

Xoá bảng

Sử dụng spreadsheets.batchUpdate phương thức và cung cấp DeleteTableRequest. Sử dụng DeleteTableRequest để xoá toàn bộ bảng và nội dung của bảng.

Sử dụng DeleteBandingRequest để xoá định dạng bảng nhưng vẫn giữ nguyên dữ liệu.

Sử dụng bảng với các tính năng khác của Trang tính

Các tính năng khác của API hỗ trợ bảng làm dữ liệu sao lưu bao gồm bộ lọc, chế độ xem bộ lọc, và dải ô được bảo vệ.