Satır ve sütun işlemleri

Google E-Tablolar API'si, Google E-Tablolar'daki satır ve sütunları eklemenize, kaldırmanıza ve yaprak. Bu sayfadaki örnekler, bazı yaygın satır ve sütunların işlemleri Sheets API ile gerçekleştirilebilir.

Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Bir toplu güncellemeyi farklı dillerde nasıl uygulayacağınızı öğrenmek için hakkında daha fazla bilgi edinmek için Güncelleme e-tablolar gibi).

Bu örneklerde SPREADSHEET_ID ve SHEET_ID yer tutucuları bu kimlikleri nereye sağlayacağınızı belirtir. E-tabloyu kimliği ekleyin. Şundan faydalanabilirsiniz: sayfa kimliğini değiştirmek için spreadsheets.get yöntemini kullanabilirsiniz. İlgili içeriği oluşturmak için kullanılan aralıklar A1 gösterimi kullanılarak belirtilir. örnek aralık Sayfa1!A1:D5'tir.

Sütun genişliğini veya satır yüksekliğini ayarlama

Aşağıdakiler spreadsheets.batchUpdate kod örneği, UpdateDimensionPropertiesRequest kullanarak A sütununun genişlik özelliğini 160 piksel olarak güncelleyin. İkinci bir istek güncellenir ilk üç satırın satır yüksekliği özelliğini 40 piksel olacak şekilde ayarlayın. dimension alanı, işlemin bir sayfasına gitmelidir.

İstek protokolü aşağıda gösterilmiştir.

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

Boş satırlar veya sütunlar ekleme

Aşağıdakiler spreadsheets.batchUpdate kod örneği, AppendDimensionRequest satır ve sütun ekleyin. İlk istek, bir sayfanın sonuna, ikincisi ise tek bir boş sütun ekler. dimension alanı, işlemin bir sayfasına gitmelidir.

İstek protokolü aşağıda gösterilmiştir.

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

Bir sütunu otomatik olarak yeniden boyutlandırma

Aşağıdakiler spreadsheets.batchUpdate kod örneği, AutoResizeDimensionsRequest sütun içeriğinin boyutuna göre A:C sütunlarını yeniden boyutlandırmak için kullanılır. dimension alanı, işlemin sayfadaki sütunlara uygulandığını gösterir.

İstek protokolü aşağıda gösterilmiştir.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "COLUMNS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Satırları otomatik olarak yeniden boyutlandırma

Aşağıdakiler spreadsheets.batchUpdate kod örneği, AutoResizeDimensionsRequest ilk üç satırın satır yüksekliklerini temizleyin. Daha sonra satır yükseklikleri dinamik bir şekilde ayarlayabilirsiniz. dimension alanı, işlemin sayfadaki satırlara uygulandığını gösterir.

İstek protokolü aşağıda gösterilmiştir.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "autoResizeDimensions": {
        "dimensions": {
          "sheetId": SHEET_ID,
          "dimension": "ROWS",
          "startIndex": 0,
          "endIndex": 3
        }
      }
    }
  ]
}

Satır veya sütun silme

Aşağıdakiler spreadsheets.batchUpdate kod örneği, DeleteDimensionRequest sayfadaki ilk üç satırı silin. İkinci bir istek B:D sütunlarını siler. dimension alanı, işlemin sütunlara mı yoksa sütunlara mı uygulanacağını belirler. satırlarından oluşur.

İstek protokolü aşağıda gösterilmiştir.

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

Boş satır veya sütun ekle

Aşağıdakiler spreadsheets.batchUpdate kod örneği, InsertDimensionRequest için belirli bir dizine sütun veya satır ekleyin (örneğin, boş satırların başına tıklayın). İlk istek C sütununa iki boş sütun ekler. İkinci bir istek, 1. satırdan başlayan üç boş satır ekler.

dimension alanı, işlemin sütunlara mı yoksa sütunlara mı uygulanacağını belirler. satırlarından oluşur.

Doğru değerine ayarlanırsa inheritFromBefore alanı, Sheets API'ye önceki satır veya sütunla aynı özelliklere sahip yeni sütunlar veya satırlar false (yanlış) değerini alır. inheritFromBefore 1. satıra bir satır veya sütun A'yı tıklayın.

İstek protokolü aşağıda gösterilmiştir.

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

Satır veya sütun taşıma

Aşağıdakiler spreadsheets.batchUpdate kod örneği, MoveDimensionRequest tuşuna basarak A sütununu D sütununa taşıyın. İkinci bir istek satırları taşır Satır 20 konumuna 5-10.

dimension alanı, işlemin sütunlara mı yoksa sütunlara mı uygulanacağını belirler. satırlarından oluşur. destinationIndex alanı, başlangıç dizinindeki adımların birleştirilmesiyle oluşturulur.

İstek protokolü aşağıda gösterilmiştir.

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