Google Sheets API, e-tablolara satır ve sütun eklemenize, kaldırmanıza ve bunları değiştirmenize olanak tanır. Bu sayfadaki örnekler, bazı yaygın satır ve sütun işlemlerinin Sheets API ile nasıl gerçekleştirilebileceğini gösterir.
Bu örnekler, dilden bağımsız olarak HTTP istekleri şeklinde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme yapmayı öğrenmek için E-tabloları güncelleme bölümüne bakın.
Bu örneklerde SPREADSHEET_ID ve SHEET_ID yer tutucuları, bu kimlikleri nerede sağlayacağınızı belirtir. E-tablo kimliğini e-tablonun URL'sinde bulabilirsiniz. Sayfa kimliğini, spreadsheets.get yöntemini kullanarak alabilirsiniz. Aralıklar, A1 gösterimi kullanılarak belirtilir. Örneğin 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 olacak şekilde güncellemek için UpdateDimensionPropertiesRequest öğesinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek, ilk üç satırın satır yüksekliği özelliğini 40 piksel olacak şekilde günceller. dimension alanı, işlemin bir sayfadaki sütunlara mı yoksa satırlara mı uygulanacağını belirler.
İ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ğıdaki spreadsheets.batchUpdate kod örneğinde, satır ve sütun eklemek için AppendDimensionRequest öğesinin nasıl kullanılacağı gösterilmektedir. İlk istek bir sayfanın sonuna üç boş satır, ikinci istek ise tek bir boş sütun ekler. dimension alanı, işlemin bir sayfadaki sütunlara mı yoksa satırlara mı uygulanacağını belirler.
İ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ğıdaki spreadsheets.batchUpdate kod örneğinde, A:C sütunlarını sütun içeriğinin boyutuna göre yeniden boyutlandırmak için AutoResizeDimensionsRequest öğesinin nasıl kullanılacağı gösterilmektedir. dimension alanı, işlemin e-tablodaki 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ğıdaki spreadsheets.batchUpdate kod örneğinde, ilk üç satırın satır yüksekliklerini temizlemek için AutoResizeDimensionsRequest öğesinin nasıl kullanılacağı gösterilmektedir. Daha sonra satır yükseklikleri, her satırdaki hücrelerin içeriğine göre dinamik olarak büyür. dimension alanı, işlemin e-tablodaki 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ğıdaki spreadsheets.batchUpdate kod örneğinde, bir sayfadaki ilk üç satırı silmek için DeleteDimensionRequest öğesinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek B:D sütunlarını siler.
dimension alanı, işlemin bir sayfadaki sütunlara mı yoksa satırlara mı uygulanacağını belirler.
İ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ğıdaki spreadsheets.batchUpdate kod örneğinde, belirli bir dizine sütun veya satır eklemek (ör. bir sayfanın en üstüne boş satır eklemek) için InsertDimensionRequest'in nasıl kullanılacağı gösterilmektedir. İ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 bir sayfadaki sütunlara mı yoksa satırlara mı uygulanacağını belirler.
Doğru değerine ayarlanırsa inheritFromBefore alanı, Sheets API'ye yeni sütunlara veya satırlara önceki satır veya sütunla aynı özellikleri vermesini, yanlışsa yeni sütunlar veya satırlardan sonraki boyutlardan devralmasını bildirir.
1. satıra satır veya A sütununa bir sütun ekleniyorsa inheritFromBefore doğru olamaz.
İ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ğıdaki spreadsheets.batchUpdate kod örneğinde, A sütununu D sütununun D konumuna taşımak için MoveDimensionRequest öğesinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek, 5-10 arasındaki satırları 20. satır konumuna taşır.
dimension alanı, işlemin bir sayfadaki sütunlara mı yoksa satırlara 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ö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
}
},
],
}