Bảng

Hướng dẫn này mô tả cách thức 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 nhiệm vụ như Theo dõi dự án, Lập kế hoạch sự kiện và Quản lý khoảng không quảng cáo.

Thêm bảng

Để thêm một 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 "Project Tracker" (Trình theo dõi dự án) tại range được chỉ định với 2 cột được đặt. Cột phần trăm trong cột đầu tiên và loại cột trình đơn thả xuống trong 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 minh, hộp đánh dấu. Các loại cột điểm xếp hạng và hộp đánh dấu sẽ điền sẵn các giá trị mặc định là 0 và FALSE tương ứng.

Loại cột trình đơn thả xuống sẽ tạo một trình đơn thả xuống dạng khối. Nếu một loại cột được đặt thành trình đơn thả xuống, thì bạn phải đặt dataValidationRule cho cột đó bằng đ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 các 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 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ẽ thêm các giá trị vào hàng trống đầu tiên và nhận biết được các hàng và chân trang đầy đủ. Nếu không có hàng trống, hàm này sẽ chèn các hàng vào cuối bảng và trước mọi chân trang, nếu có.

Xoá bảng

Sử dụng phương thức spreadsheets.batchUpdate 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 giữ lại 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 API khác 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ệ.