このページは Cloud Translation API によって翻訳されました。

行と列の演算

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

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

これらの例では、プレースホルダ SPREADSHEET_ID と SHEET_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
      }
    },
  ],
}