ตาราง

คู่มือนี้อธิบายวิธีและเหตุผลในการใช้ Google Sheets API เพื่อสร้างตาราง ในสเปรดชีต

ตารางคืออะไร

ตารางช่วยลดความซับซ้อนในการสร้างข้อมูลและลดความจำเป็นที่จะต้องจัดรูปแบบ ป้อนข้อมูล และอัปเดตข้อมูลซ้ำๆ ด้วยการใช้รูปแบบและโครงสร้างกับช่วงข้อมูลโดยอัตโนมัติ

ตารางมีฟีเจอร์มากมาย เช่น ส่วนหัว ส่วนท้าย ประเภทคอลัมน์ ตัวกรอง มุมมอง การอ้างอิงตาราง และชื่อตาราง ดูข้อมูลเพิ่มเติมได้ในประกาศฟีเจอร์ และดูข้อมูลเกี่ยวกับการใช้ตารางในชีต

คุณใช้ตารางสำหรับงานต่างๆ เช่น การติดตามโปรเจ็กต์ การวางแผนกิจกรรม และ การจัดการสินค้าคงคลังได้

เพิ่มตาราง

หากต้องการเพิ่มตาราง ให้ใช้วิธีการ batchUpdate โดยระบุคำขอ addTable คุณใช้คำขอนี้เพื่อเพิ่มตารางลงในสเปรดชีต

ตัวอย่างต่อไปนี้สร้างตารางชื่อ "Project Tracker" ที่ rangeที่ระบุโดยมี 2 คอลัมน์ที่ตั้งค่าไว้ คอลัมน์เปอร์เซ็นต์ในคอลัมน์แรกและประเภทคอลัมน์เมนูแบบเลื่อนลงในคอลัมน์ที่สอง

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

ประเภทคอลัมน์

ตารางมีประเภทคอลัมน์ เช่น ตัวเลข วันที่ เมนูแบบเลื่อนลง สมาร์ทชิป ช่องทําเครื่องหมาย ประเภทคอลัมน์การให้คะแนนและช่องทําเครื่องหมายจะป้อนค่าเริ่มต้นเป็น 0 และ FALSE ตามลําดับ

ประเภทคอลัมน์เมนูแบบเลื่อนลงจะสร้างเมนูแบบเลื่อนลงของชิป หากตั้งค่าประเภทคอลัมน์เป็น ดรอปดาวน์ จะต้องตั้งค่า dataValidationRule สำหรับคอลัมน์ด้วยเงื่อนไข ONE_OF_LIST คอลัมน์ประเภทอื่นๆ ไม่ควรกำหนดฟิลด์ `dataValidationRule `

อัปเดตตาราง

ใช้วิธีการ spreadsheets.batchUpdate และระบุ UpdateTableRequest

แก้ไขขนาดตาราง

ใช้วิธี UpdateTableRequest เพื่อแก้ไข range ที่ตารางต้องใช้เพื่อเพิ่มแถว/คอลัมน์ใหม่

หากต้องการเพิ่มแถวหรือคอลัมน์ใหม่ภายในตาราง ให้ใช้ InsertRangeRequest หรือ InsertDimensionRequest

หากต้องการลบแถวในตาราง คุณสามารถใช้ DeleteRangeRequest หรือใช้ DeleteDimensionRequest เพื่อลบทั้งแถวออกจากสเปรดชีต

หากคุณกำลังอัปเดตตารางที่มีอยู่ซึ่งไม่มีส่วนท้ายเพื่อเพิ่มส่วนท้าย range จะขยายออก 1 แถว หากคุณอัปเดตตารางที่มีอยู่ด้วยส่วนท้าย และนำส่วนท้ายออก range จะหดลง 1 แถว

ต่อท้ายค่าในตาราง

ใช้ AppendCellsRequest กับ tableId เพื่อเพิ่มแถวที่ท้ายตาราง ซึ่งจะต่อท้ายค่าใน แถวว่างแรก และรับรู้แถวและส่วนท้ายที่สมบูรณ์ หากไม่มีแถวว่าง ระบบจะแทรกแถวที่ส่วนท้ายของตารางและก่อนส่วนท้าย (หากมี)

ลบตาราง

ใช้เมธอด spreadsheets.batchUpdate และระบุ DeleteTableRequest ใช้ DeleteTableRequest เพื่อลบทั้งตารางและเนื้อหาของตาราง

ใช้ DeleteBandingRequest เพื่อนำการจัดรูปแบบตารางออก แต่เก็บข้อมูลไว้

ใช้ตารางกับฟีเจอร์อื่นๆ ของชีต

ฟีเจอร์ API อื่นๆ ที่รองรับตารางเป็นข้อมูลสำรอง ได้แก่ ตัวกรอง มุมมองตัวกรอง และ ช่วงที่ป้องกัน