การดำเนินการแถว & คอลัมน์

คุณสามารถใช้ Google Sheets API เพื่อเพิ่ม นำออก และจัดการแถวและคอลัมน์ใน ชีต ตัวอย่างในหน้านี้จะแสดงให้เห็นลักษณะของแถวและคอลัมน์ทั่วไป จะดำเนินการได้ด้วย Sheets API

ตัวอย่างเหล่านี้จะแสดงในรูปแบบคำขอ HTTP เป็นภาษา เป็นกลาง หากต้องการทราบวิธีใช้การอัปเดตเป็นกลุ่มในภาษาต่างๆ โดยใช้ ไลบรารีของไคลเอ็นต์ Google API โปรดดูการอัปเดต สเปรดชีต

ในตัวอย่างต่อไปนี้ ตัวยึดตำแหน่ง SPREADSHEET_ID และ SHEET_ID จะระบุตําแหน่งที่คุณจะส่งรหัสเหล่านั้น คุณจะพบสเปรดชีต รหัสใน URL ของสเปรดชีต คุณสามารถ รหัสชีตโดยใช้เมธอด spreadsheets.get มีการระบุช่วงโดยใช้รูปแบบ A1 CANNOT TRANSLATE ช่วงตัวอย่างคือ Sheet1!A1:D5

ปรับความกว้างของคอลัมน์หรือความสูงของแถว

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ UpdateDimensionPropertiesRequest เพื่ออัปเดตคุณสมบัติความกว้างของคอลัมน์ A เป็น 160 พิกเซล อัปเดตคำขอครั้งที่ 2 คุณสมบัติความสูงของแถวจาก 3 แถวแรกให้เป็น 40 พิกเซล dimension จะกำหนดว่าการดำเนินการจะใช้กับคอลัมน์หรือแถว ชีต

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "properties": {
          "pixelSize": 160
        },
        "fields": "pixelSize"
      }
    },
    {
      "updateDimensionProperties": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "properties": {
          "pixelSize": 40
        },
        "fields": "pixelSize"
      }
    }
  ]
}

เพิ่มแถวหรือคอลัมน์ที่ว่างเปล่าต่อท้าย

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ AppendDimensionRequest เพื่อเพิ่มแถวและคอลัมน์ต่อท้าย คำขอแรกเพิ่มแถวว่าง 3 แถวต่อท้ายฟังก์ชัน ส่วนท้ายของชีต ส่วนที่สองต่อท้ายคอลัมน์ว่างคอลัมน์เดียว dimension จะกำหนดว่าการดำเนินการจะใช้กับคอลัมน์หรือแถว ชีต

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "ROWS",
        "length": 3
      }
    },
    {
      "appendDimension": {
        "sheetId": SHEET_ID,
        "dimension": "COLUMNS",
        "length": 1
      }
    }
  ]
}

ปรับขนาดคอลัมน์โดยอัตโนมัติ

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ AutoResizeDimensionsRequest เพื่อปรับขนาดคอลัมน์ A:C ตามขนาดของเนื้อหาคอลัมน์ dimension แสดงว่าการดำเนินการนั้นมีผลกับคอลัมน์ของชีต

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

ปรับขนาดแถวอัตโนมัติ

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ AutoResizeDimensionsRequest เพื่อล้างความสูงของแถว 3 แถวแรก ความสูงของแถวจะเพิ่มขึ้น แบบไดนามิกตามเนื้อหาของเซลล์ในแต่ละแถว dimension แสดงว่าการดำเนินการนั้นใช้กับแถวของชีต

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

ลบแถวหรือคอลัมน์

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ DeleteDimensionRequest เพื่อลบ 3 แถวแรกในชีต คำขอที่ 2 จะลบคอลัมน์ B:D ฟิลด์ dimension จะกำหนดว่าการดำเนินการมีผลกับคอลัมน์หรือ ของชีต

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    },
    {
      "deleteDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 1,
          "endIndex": 4
        }
      }
    },
  ],
}

แทรกแถวหรือคอลัมน์ที่ว่างเปล่า

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ InsertDimensionRequest เพื่อแทรกคอลัมน์หรือแถวที่ดัชนีหนึ่งๆ (เช่น แถวว่างล่วงหน้า ที่ด้านบนของชีต) คำขอแรกแทรกคอลัมน์ว่างเปล่า 2 คอลัมน์ที่คอลัมน์ C คำขอที่ 2 จะแทรกแถวว่าง 3 แถวโดยเริ่มจากแถวที่ 1

ฟิลด์ dimension จะกำหนดว่าการดำเนินการมีผลกับคอลัมน์หรือ ของชีต

หากจริง ช่อง inheritFromBefore จะแจ้งให้ Sheets API ระบุ คอลัมน์หรือแถวใหม่มีคุณสมบัติเดียวกันกับแถวหรือคอลัมน์ก่อนหน้า และ false หากต้องการรับค่าจากมิติข้อมูลหลังคอลัมน์หรือแถวใหม่ inheritFromBefore ไม่สามารถเป็น "จริง" หากแทรกแถวที่แถว 1 หรือคอลัมน์ที่ คอลัมน์ A

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 2,
          "endIndex": 4
        },
        "inheritFromBefore": true
      }
    },
    {
      "insertDimension": {
        "range": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        },
        "inheritFromBefore": false
      }
    },
  ],
}

ย้ายแถวหรือคอลัมน์

ดังต่อไปนี้ spreadsheets.batchUpdate ตัวอย่างโค้ดจะแสดงวิธีใช้ MoveDimensionRequest เพื่อย้ายคอลัมน์ A ไปยังตำแหน่งคอลัมน์ D คำขอที่ 2 จะย้ายแถว 5–10 ไปยังตำแหน่งแถว 20

ฟิลด์ dimension จะกำหนดว่าการดำเนินการมีผลกับคอลัมน์หรือ ของชีต ช่อง destinationIndex จะระบุตำแหน่งที่จะย้าย ของแหล่งข้อมูลโดยใช้ดัชนีเริ่มต้นแบบ 0

โปรโตคอลคำขอแสดงอยู่ด้านล่างนี้

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 1
        },
        "destinationIndex": 3
      }
    },
    {
      "moveDimension": {
        "source": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 4,
          "endIndex": 10
        },
        "destinationIndex": 19
      }
    },
  ],
}