Google Sheets API 可讓您更新儲存格和範圍的格式設定 。本頁的例子說明瞭 您可使用 Sheets API 完成格式設定作業。你可以 如需更多條件式格式設定範例，請參閱「條件式 設定食譜網頁的格式
更新試算表時，某些類型的要求可能會傳回回應。
這些字串會以陣列的形式傳回，且每項回應都擁有與
對應的要求有些要求沒有回應，
則回應空白。您可以在下方找到這些範例的回應結構
spreadsheets.batchUpdate。
這些範例是以 HTTP 要求的形式呈現 中立。如要瞭解如何使用 Google API 用戶端程式庫，請參閱 試算表。
在這些範例中，預留位置 SPREADSHEET_ID 和 SHEET_ID
代表這些 ID 的提供位置。您可以找到這份試算表
ID。您可以
工作表 ID
spreadsheets.get 方法。
範圍是使用 A1 標記法來指定。一個
範例範圍是 Sheet1!A1:D5
在上述影片中，我們將說明如何以多種方式設定試算表儲存格的格式： 包括：建立凍結列、粗體儲存格、導入貨幣 格式化、執行儲存格驗證，以及限制儲存格的值。
編輯儲存格框線
下列
spreadsheets.batchUpdate敬上
程式碼範例顯示如何使用
UpdateBordersRequest
為 A1:F10 範圍內的每個儲存格加上虛線、藍色上框線和下框線
innerHorizontal 欄位會在範圍的內部建立水平框線。
如果省略此欄位，將只會加上在頂部和
和展開討論
要求通訊協定如下所示。
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 欄位中省略資料欄索引會使整個
。第二個要求會調整工作表屬性，讓
標題列凍結。
要求通訊協定如下所示。
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 範圍合併為單一儲存格。
第二個要求會合併 A3:B6 中的資料欄，同時將列分隔出來。
要求通訊協定如下所示。
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」。
第二個要求為 B1:B10 的儲存格提供自訂數字格式
#,##0.0000，表示數字應以半形逗號分隔
例如小數點後 4 位數字
應捨棄開頭的零例如數字「3.14」算繪完成
「3.1400」，「12345.12345」會顯示為「12,345.1235」。
要求通訊協定如下所示。
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"
}
}
]
}