Google E-Tablolar API'si, e-tablolara satır ve sütun eklemenize, bunları kaldırmanıza ve değiştirmenize olanak tanır. Bu sayfadaki örneklerde, bazı yaygın satır ve sütun işlemlerinin Sheets API ile nasıl gerçekleştirilebileceği gösterilmektedir.
Bu örnekler, dilden bağımsız olması için HTTP istekleri şeklinde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme işlemini nasıl uygulayacağınızı öğrenmek için E-tabloları güncelleme başlıklı makaleyi inceleyin.
Bu örneklerde, SPREADSHEET_ID ve SHEET_ID yer tutucuları, bu kimlikleri nerede sağlayacağınızı gösterir. E-tablo kimliğini e-tablo URL'sinde bulabilirsiniz. spreadsheets.get yöntemini kullanarak sayfa kimliğini alabilirsiniz. Aralıklar, A1 gösterimi kullanılarak belirtilir. Örnek bir aralık: Sayfa1!A1:D5.
Sütun genişliğini veya satır yüksekliğini ayarlama
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, A sütununun genişlik özelliğini 160 piksel olarak güncellemek için UpdateDimensionPropertiesRequest işlevinin nasıl kullanılacağı gösterilmektedir. İkinci istek, ilk üç satırın satır yüksekliği özelliğini 40 piksel olarak günceller. dimension alanı, işlemin bir sayfanın sütunlarına mı yoksa satırlarına mı uygulanacağını belirler.
İstek protokolü aşağıda gösterilmektedir.
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ır veya sütun ekleme
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, satır ve sütun eklemek için AppendDimensionRequest işlevinin nasıl kullanılacağı gösterilmektedir. İlk istek, bir sayfanın sonuna üç boş satır eklerken ikinci istek tek bir boş sütun ekler. dimension alanı, işlemin bir sayfanın sütunlarına mı yoksa satırlarına mı uygulanacağını belirler.
İstek protokolü aşağıda gösterilmektedir.
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 } } ] }Sütunu otomatik olarak yeniden boyutlandırma
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, sütun içeriğinin boyutuna göre A:C sütunlarını yeniden boyutlandırmak için AutoResizeDimensionsRequest işlevinin nasıl kullanılacağı gösterilmektedir. dimension alanı, işlemin sayfanın sütunları için geçerli olduğunu gösterir.
İstek protokolü aşağıda gösterilmektedir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{ "requests": [ { "autoResizeDimensions": { "dimensions": { "sheetId": SHEET_ID, "dimension": "COLUMNS", "startIndex": 0, "endIndex": 3 } } } ] }Satırı otomatik olarak yeniden boyutlandırma
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, ilk üç satırın satır yüksekliklerini temizlemek için AutoResizeDimensionsRequest işlevinin nasıl kullanılacağı gösterilmektedir. Satır yükseklikleri daha sonra her satırdaki hücrelerin içeriğine göre dinamik olarak artar. dimension alanı, işlemin sayfanın satırları için geçerli olduğunu gösterir.
İstek protokolü aşağıda gösterilmektedir.
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ğıdaki spreadsheets.batchUpdate kod örneğinde, bir sayfadaki ilk üç satırı silmek için DeleteDimensionRequest işlevinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek, B:D sütunlarını siler. dimension alanı, işlemin bir sayfanın sütunlarına mı yoksa satırlarına mı uygulanacağını belirler.
İstek protokolü aşağıda gösterilmektedir.
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 ekleme
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, belirli bir dizine sütun veya satır eklemek için (ör. bir sayfanın en üstüne boş satırlar eklemek) InsertDimensionRequest öğesinin nasıl kullanılacağı gösterilmektedir. İlk istek, C sütununa iki boş sütun ekler. İkinci istek, 1. satırdan başlayarak üç boş satır ekler.
dimension alanı, işlemin bir sayfanın sütunlarına mı yoksa satırlarına mı uygulanacağını belirler.
Doğruysa inheritFromBefore alanı, E-Tablolar API'sine yeni sütunlara veya satırlara önceki satır ya da sütunla aynı özellikleri vermesini, yanlışsa yeni sütun veya satırlardan sonraki boyutlardan devralmasını söyler. 1. satıra satır veya A sütununa sütun ekleniyorsa inheritFromBefore doğru olamaz.
İstek protokolü aşağıda gösterilmektedir.
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ğıdaki spreadsheets.batchUpdate kod örneğinde, A sütununu D sütunu konumuna taşımak için MoveDimensionRequest işlevinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek, 5-10. satırları 20. satır konumuna taşır.
dimension alanı, işlemin bir sayfanın sütunlarına mı yoksa satırlarına mı uygulanacağını belirler. destinationIndex alanı, sıfır tabanlı bir başlangıç dizini kullanarak kaynak verilerin nereye taşınacağını belirler.
İstek protokolü aşağıda gösterilmektedir.
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 } }, ], }