本頁面由 Cloud Translation API 翻譯而成。

資料列 (&A)；資料欄運算

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
      }
    },
  ],
}