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