Google Sheets API, e-tablolarda satır ve sütun eklemenize, kaldırmanıza ve değiştirmenize olanak tanır. Bu sayfadaki örnekler, bazı yaygın satır ve sütun işlemlerinin Sheets API kullanılarak nasıl yapılabileceğini gösterir.
Bu örnekler, dilsiz olması için HTTP istekleri biçiminde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncellemenin nasıl uygulanacağını öğrenmek için E-tabloları güncelleme bölümüne bakın.
Bu örneklerde SPREADSHEET_ID
ve SHEET_ID
yer tutucuları, bu kimlikleri nereye gireceğinizi 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. Sayfa1!A1:D5 örnek aralıktır.
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
özelliğinin 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ır veya sütun ekleme
Aşağıdaki spreadsheets.batchUpdate
kod örneğinde satır ve sütun eklemek için AppendDimensionRequest
özelliğinin nasıl kullanılacağı gösterilmektedir. İlk istek, 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, sütun içeriğinin boyutuna göre A:C sütunlarını yeniden boyutlandırmak için AutoResizeDimensionsRequest
özelliğinin nasıl kullanılacağı gösterilmektedir. dimension
alanı, işlemin sayfadaki sütunlarına uygulandığını belirtir.
İ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ı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
özelliğinin nasıl kullanılacağı gösterilmektedir. Daha sonra satır yükseklikleri, her bir satırdaki hücrelerin içeriğine göre dinamik olarak büyür. dimension
alanı, işlemin sayfadaki satırlara uygulandığını belirtir.
İ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
özelliğinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek B:D sütunlarını siler.
dimension
alanı, işlemin sayfadaki sütunlarına mı yoksa satırlarına 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 ekleme
Aşağıdaki spreadsheets.batchUpdate
kod örneğinde, belirli bir dizine sütun veya satır eklemek için (ör. bir sayfanın üst kısmına boş satır eklemek gibi) InsertDimensionRequest
kodunun nasıl kullanılacağı gösterilmektedir. İlk istek C sütununa iki boş sütun ekliyor.
İkinci istek, 1. satırdan başlayarak üç boş satır ekliyor.
dimension
alanı, işlemin sayfadaki sütunlarına mı yoksa satırlarına mı uygulanacağını belirler.
True (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ütun veya satırlardan sonraki boyutları devralmasını bildirir.
1. satıra satır veya A sütununa bir sütun ekliyorsanız 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ütununa taşımak için MoveDimensionRequest
özelliğinin nasıl kullanılacağı gösterilmektedir. İkinci bir istek, 5-10 arasındaki satırları 20. satıra taşır.
dimension
alanı, işlemin sayfadaki 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ö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 } }, ], }