ตาราง

คู่มือนี้อธิบายวิธีและเหตุผลในการใช้ 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 ที่รองรับตารางเป็นข้อมูลเบื้องหลัง ได้แก่ ตัวกรอง, มุมมองตัวกรอง และ ช่วงที่ป้องกัน