Google E-Tablolar API, e-tablolarda satır ve sütun eklemenize, kaldırmanıza ve bunlar üzerinde işlem yapmanıza olanak tanır. Bu sayfada, Sheets API ile bazı yaygın satır ve sütun işlemlerinin nasıl yapılabileceği gösterilmektedir.
Bu örnekler, dil açısından tarafsız olması için HTTP istekleri biçiminde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncelleme yapmayı öğ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 e-tablo kimliğini alabilirsiniz. Aralıklar A1 gösterimi kullanılarak belirtilir. Örnek 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 piksele 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ı veya satırları için geçerli olup olmadığı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 işlevinin nasıl kullanılacağı gösterilmektedir. İlk istek, bir sayfanın sonuna üç boş satır ekler. İkinci istek ise tek bir boş sütun ekler. dimension alanı, işlemin bir sayfanın sütunları veya satırları için geçerli olup olmadığı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
}
}
]
}
Sütunları 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 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ö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 işlevinin nasıl kullanılacağı gösterilmektedir. Ardından satır yükseklikleri, her satırdaki hücrelerin içeriğine göre dinamik olarak büyür. dimension alanı, işlemin sayfanın satırları için geçerli olduğunu 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ın nasıl silineceği DeleteDimensionRequest gösterilmektedir. İkinci istek, B:D sütunlarını siler.
dimension alanı, işlemin bir sayfanın sütunları veya satırları için geçerli olup olmadığı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 dizinde sütun veya satır eklemek için InsertDimensionRequest işlevinin nasıl kullanılacağı gösterilmektedir (ör. bir sayfanın başına boş satır ekleme). İ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ı veya satırları için geçerli olup olmadığını belirler.
Doğru ise inheritFromBefore alanı, E-Tablolar API'ye yeni sütunlara veya satırlara önceki satır veya sütunla aynı özellikleri vermesini, yanlış ise yeni sütunlar 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ö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ütunu konumuna taşımak için MoveDimensionRequest işlevinin nasıl kullanılacağı gösterilmektedir. İkinci istek, 5-10 arasındaki satırları 20. satıra taşır.
dimension alanı, işlemin bir sayfanın sütunları veya satırları için geçerli olup olmadığı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
}
},
],
}