Google Sheets API 可讓你在 工作表。本頁的範例說明一些常見的列和欄 也可以使用 Sheets API 完成相關作業
這些範例是以 HTTP 要求的形式呈現 中立。如要瞭解如何使用 Google API 用戶端程式庫,請參閱 試算表。
在這些範例中,預留位置 SPREADSHEET_ID
和 SHEET_ID
代表這些 ID 的提供位置。您可以找到這份試算表
ID。您可以
工作表 ID
spreadsheets.get
方法。
範圍是使用 A1 標記法來指定。一個
範例範圍是 Sheet1!A1:D5
調整欄寬或列高
下列
spreadsheets.batchUpdate
敬上
程式碼範例顯示如何使用
UpdateDimensionPropertiesRequest
將 A 欄的寬度屬性更新為 160 像素。第二次要求更新
前三列的列高屬性,大小為 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
來附加列和欄。第一個要求會在
而第二個欄位則附加一個空白欄。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
清除前三列的列高。列高會然後變長
動態調整每列的儲存格內容。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
刪除工作表中的前三列。第二次要求則會刪除 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
,在指定索引插入資料欄或資料列 (例如前面的空白列)
特定層級)。第一個要求會在 C 欄插入兩個空白欄。
第二個要求會從第 1 列開始插入三個空白列。
dimension
欄位會決定對資料欄或
。
如果為 true,inheritFromBefore
欄位會指示 Sheets API 提供
新資料欄或資料列的屬性,與前一列或先前資料欄相同,
false,讓沿用新的資料欄或列後方的維度。
如果在第 1 列或第 1 列插入一列,則「inheritFromBefore
」不得為 true
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 欄位置。第二次要求移動資料列
從第 5 到第 10 列位置。
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 } }, ], }