การจัดรูปแบบพื้นฐาน

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

เมื่ออัปเดตสเปรดชีต คำขอบางประเภทอาจแสดงการตอบกลับ ซึ่งจะแสดงผลในอาร์เรย์ โดยแต่ละการตอบกลับใช้ดัชนีเดียวกันกับคำขอที่เกี่ยวข้อง คำขอบางรายการไม่มีการตอบกลับ และคำขอเหล่านั้นไม่มีข้อมูล ดูโครงสร้างคำตอบของตัวอย่างเหล่านี้ได้ในส่วนspreadsheets.batchUpdate

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

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

ในวิดีโอด้านบน คุณจะได้เรียนรู้วิธีจัดรูปแบบเซลล์ของสเปรดชีตได้หลายวิธี เช่น การสร้างแถวที่ตรึงไว้ การสร้างเซลล์เป็นตัวหนา การใช้การจัดรูปแบบสกุลเงิน การตรวจสอบเซลล์ และการจำกัดค่าของเซลล์

แก้ไขเส้นขอบของเซลล์

ตัวอย่างโค้ด spreadsheets.batchUpdate ต่อไปนี้จะแสดงวิธีใช้ UpdateBordersRequest เพื่อใส่เส้นขอบด้านบนและด้านล่างของแต่ละเซลล์ในช่วง A1:F10 ช่อง innerHorizontal จะสร้างเส้นขอบแนวนอนที่ภายในของช่วง การไม่ระบุช่องจะทำให้มีการเพิ่มเส้นขอบที่ด้านบนและด้านล่างของทั้งช่วงเท่านั้น

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

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateBorders": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 6
        },
        "top": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "bottom": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "innerHorizontal": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
      }
    }
  ]
}

จัดรูปแบบแถวส่วนหัว

ตัวอย่างโค้ด spreadsheets.batchUpdate ต่อไปนี้จะแสดงวิธีใช้ RepeatCellRequest เพื่อจัดรูปแบบแถวส่วนหัวในชีต คำขอแรกจะอัปเดตสีข้อความ สีพื้นหลัง ขนาดแบบอักษรของข้อความ และเหตุผลรองรับของข้อความ รวมถึงทำให้ข้อความเป็นตัวหนา การไม่ระบุดัชนีคอลัมน์ในช่อง range จะทำให้ระบบจัดรูปแบบแถวทั้งหมด คำขอที่ 2 จะปรับคุณสมบัติของชีตให้ตรึงแถวส่วนหัว

ตารางขนาด 3x3 ซึ่งมีแถวส่วนหัวที่จัดรูปแบบในชีต
รูปที่ 2 จัดรูปแบบแถวส่วนหัวในชีต

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "backgroundColor": {
              "red": 0.0,
              "green": 0.0,
              "blue": 0.0
            },
            "horizontalAlignment" : "CENTER",
            "textFormat": {
              "foregroundColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              },
              "fontSize": 12,
              "bold": true
            }
          }
        },
        "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
      }
    },
    {
      "updateSheetProperties": {
        "properties": {
          "sheetId": SHEET_ID,
          "gridProperties": {
            "frozenRowCount": 1
          }
        },
        "fields": "gridProperties.frozenRowCount"
      }
    }
  ]
}

ผสานเซลล์

ตัวอย่างโค้ด spreadsheets.batchUpdate ต่อไปนี้จะแสดงวิธีใช้ MergeCellsRequest เพื่อผสานเซลล์ คำขอแรกจะรวมช่วง A1:B2 เป็นเซลล์เดียว คำขอที่ 2 จะรวมคอลัมน์ใน A3:B6 และปล่อยให้แถวแยกกัน

ตารางขนาด 3x3 ที่มีเซลล์ที่ผสานในชีต
รูปที่ 3 ผสานเซลล์ในชีต

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 2,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_ALL"
      }
    },
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 2,
          "endRowIndex": 6,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_COLUMNS"
      }
    },
  ]
}

ตั้งค่ารูปแบบวันที่และเวลาที่กำหนดเองสำหรับช่วง

ตัวอย่างโค้ด spreadsheets.batchUpdate ต่อไปนี้จะแสดงวิธีใช้ RepeatCellRequest เพื่ออัปเดตเซลล์ให้มีรูปแบบวันที่และเวลาแบบกำหนดเอง คำขอแรกจะทำให้เซลล์ในช่วง A1:A10 มีรูปแบบวันที่และเวลาที่กำหนดเอง hh:mm:ss am/pm, ddd mmm dd yyyy ตัวอย่างวันที่และเวลาในรูปแบบนี้คือ "02:05:07 PM, Sun Apr 03 2016"

คำขอที่ 2 จะกำหนดรูปแบบตัวเลขที่กำหนดเอง #,##0.0000 ให้กับเซลล์ใน B1:B10 ซึ่งระบุว่าควรจัดกลุ่มตัวเลขด้วยตัวคั่นคอมมา โดยควรมีตัวเลข 4 หลักหลังทศนิยม และตัดเลข 0 นำหน้าทั้งหมดให้เหลือ 1 หลัก เช่น ตัวเลข "3.14" จะแสดงผลเป็น "3.1400" ขณะที่ "12345.12345" จะแสดงผลเป็น "12,345.1235"

ตารางขนาด 3x3 พร้อมรูปแบบวันที่และเวลาที่กำหนดเองในชีต
รูปที่ 4 อัปเดตเซลล์ให้มีรูปแบบวันที่และเวลาที่กำหนดเองในชีต

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "DATE",
              "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    },
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 2
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "NUMBER",
              "pattern": "#,##0.0000"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    }
  ]
}