ตาราง

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

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

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

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

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

เพิ่มตาราง

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

ตัวอย่างต่อไปนี้สร้างตารางชื่อ "เครื่องมือติดตามโปรเจ็กต์" ที่ตำแหน่งที่ระบุ range โดยมีการกำหนดคอลัมน์ 2 คอลัมน์ คอลัมน์เปอร์เซ็นต์ในคอลัมน์แรกและประเภทคอลัมน์แบบเลื่อนลงในคอลัมน์ที่ 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 ที่รองรับตารางเป็นข้อมูลสำรอง ได้แก่ ตัวกรอง มุมมองตัวกรอง และช่วงที่ได้รับการป้องกัน