Toán tử trang tính

API Google Trang tính cho phép bạn tạo, xoá, sao chép và xoá trang tính, cũng như kiểm soát các tài sản của chúng. Các ví dụ trên trang này minh hoạ cách bạn có thể thực hiện một số thao tác phổ biến trong Trang tính với API Trang tính.

Những ví dụ này được trình bày dưới dạng các yêu cầu HTTP để trở thành ngôn ngữ bình thường. Để tìm hiểu cách triển khai quá trình cập nhật theo lô bằng nhiều ngôn ngữ bằng cách sử dụng thư viện ứng dụng API của Google, hãy xem phần Cập nhật bảng tính.

Trong những ví dụ này, phần giữ chỗ SPREADSHEET_IDSHEET_ID cho biết nơi bạn sẽ cung cấp các mã đó. Bạn có thể tìm thấy bảng tính Mã nhận dạng trong URL của bảng tính. Bạn có thể tải mã trang tính bằng cách sử dụng spreadsheets.get. Chiến lược phát hành đĩa đơn dải ô được chỉ định bằng ký hiệu A1. Một dải ô mẫu là Sheet1!A1:D5.

Thêm trang tính

Nội dung sau đây spreadsheets.batchUpdate mã mẫu cho biết cách sử dụng AddSheetRequest để thêm trang tính vào bảng tính, đồng thời đặt tiêu đề, kích thước lưới và màu tab.

Phản hồi bao gồm AddSheetResponse! Tệp này chứa một đối tượng có các thuộc tính của trang tính đã tạo (chẳng hạn như SHEET_ID).

Giao thức yêu cầu được trình bày dưới đây.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "addSheet": {
        "properties": {
          "title": "Deposits",
          "gridProperties": {
            "rowCount": 20,
            "columnCount": 12
          },
          "tabColor": {
            "red": 1.0,
            "green": 0.3,
            "blue": 0.4
          }
        }
      }
    }
  ]
}

Xóa tất cả giá trị một trang tính trong khi vẫn giữ nguyên định dạng

Nội dung sau đây spreadsheets.batchUpdate mã mẫu cho biết cách sử dụng UpdateCellsRequest để xóa tất cả các giá trị khỏi một trang tính mà vẫn giữ nguyên định dạng.

Chỉ định phương diện Trường userEnteredValue mà không có giá trị tương ứng được hiểu là một lệnh để xoá các giá trị trong dải ô. Bạn cũng có thể sử dụng chế độ cài đặt này với các trường khác. Ví dụ: thay đổi giá trị fields thành userEnteredFormat lượt xoá tất cả định dạng mà API Trang tính hỗ trợ khỏi trang tính nhưng giữ nguyên giá trị của ô.

Giao thức yêu cầu được trình bày dưới đây.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

Sao chép trang tính từ bảng tính này sang bảng tính khác

Nội dung sau đây spreadsheet.sheets.copyTo mã mẫu cho biết cách sao chép một trang tính do SHEET_ID chỉ định từ một bảng tính sang một bảng tính khác.

Biến TARGET_SPREADSHEET_ID trong nội dung yêu cầu chỉ định bảng tính đích. Bản sao này giữ lại tất cả giá trị, định dạng, công thức và các thuộc tính khác của văn bản gốc. Tiêu đề của trang tính được sao chép được đặt thành "Sao chép trong [tiêu đề trang tính gốc]".

Phản hồi bao gồm SheetProperties đối tượng mô tả các thuộc tính của trang tính đã tạo.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo
{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

Xoá trang tính

Nội dung sau đây spreadsheets.batchUpdate mã mẫu cho biết cách sử dụng DeleteSheetRequest để xóa trang tính do SHEET_ID chỉ định.

Giao thức yêu cầu được trình bày dưới đây.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

Đọc dữ liệu trang tính

Nội dung sau đây Mã mẫu spreadsheets.get cho biết cách lấy thông tin về thuộc tính trang tính từ bảng tính, do SHEET_ID chỉ định và SPREADSHEET_ID. Phương pháp này thường được dùng để xác định siêu dữ liệu của các trang tính trong một bảng tính cụ thể, vì vậy các thao tác bổ sung có thể nhắm mục tiêu các trang tính đó. Tham số truy vấn fields chỉ chỉ định thuộc tính trang tính (trái ngược với dữ liệu giá trị ô hoặc dữ liệu liên quan đến toàn bộ bảng tính).

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

Phản hồi bao gồm Spreadsheet tài nguyên, trong đó có chứa Sheet đối tượng có SheetProperties phần tử. Nếu một trường phản hồi nhất định được đặt thành giá trị mặc định, trường đó sẽ bị bỏ qua khỏi câu trả lời.

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}