行と列の演算

Google Sheets API を使用すると、スプレッドシート内の行や列を追加、削除、操作できます。 できます。このページの例では、一般的な行と列が Sheets API ではこれらのオペレーションを実現できます。

これらの例は、HTTP リクエストという形式で示されています。これは、 ニュートラルです。異なる言語のバッチ アップデートを実装する方法については、 Google API クライアント ライブラリについては、 スプレッドシート

これらの例では、プレースホルダ SPREADSHEET_IDSHEET_ID は、 は、これらの ID を指定する場所を示しています。そのスプレッドシートの ID を入力します。取得できるもの: シート ID spreadsheets.get メソッドを使用します。「 範囲は A1 表記で指定します。「 Sheet1!A1:D5 です。

列の幅または行の高さを調整する

次の spreadsheets.batchUpdate コードサンプルを使用して、Terraform で UpdateDimensionPropertiesRequest 列 A の width プロパティを 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 コードサンプルを使用して、Terraform で AppendDimensionRequest 行や列を追加します最初のリクエストは、空の 3 行を 2 番目の行では空の列が 1 つ追加されます。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 コードサンプルを使用して、Terraform で 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 コードサンプルを使用して、Terraform で 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 コードサンプルを使用して、Terraform で 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 コードサンプルを使用して、Terraform で InsertDimensionRequest 特定のインデックスに列や行を挿入する(たとえば空の行の先頭への追加など) 表示されます)。最初のリクエストでは、列 C に 2 つの空の列を挿入します。 2 番目のリクエストは、行 1 から 3 つの空の行を挿入します。

dimension フィールドは、オペレーションを列または列のどちらに適用するかを決定します。 スプレッドシート内の行に入れられます。

true の場合、inheritFromBefore フィールドは Sheets API に 新しい列または行をその前の行または列と同じプロパティにし、 false に設定して、新しい列または行の後のディメンションから継承します。 行 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 コードサンプルを使用して、Terraform で MoveDimensionRequest を使用して列 A を列 D の位置に移動します。2 番目のリクエストは行を移動します。 5–10 を行 20 の位置にします。

dimension フィールドは、オペレーションを列または列のどちらに適用するかを決定します。 スプレッドシート内の行に入れられます。destinationIndex フィールドでは、変数の移動先を指定します。 ゼロベースの開始インデックスを使用します。

リクエスト プロトコルを以下に示します。

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