Google E-Tablolar API, e-tablolardaki hücrelerin ve aralıkların biçimlendirmesini güncellemenize olanak tanır. Bu sayfada, bazı yaygın biçimlendirme işlemlerinin E-Tablolar API'si ile nasıl yapılabileceği gösterilmektedir. Daha fazla koşullu biçimlendirme örneğini Koşullu biçimlendirme tarifi sayfasında bulabilirsiniz.
Bir e-tablo güncellenirken bazı istek türleri yanıt döndürebilir.
Bunlar bir dizi halinde döndürülür ve her yanıt, ilgili istekle aynı dizini kaplar. Bazı isteklerin yanıtı yoktur ve bu isteklerin yanıtı boştur. Bu örneklerin yanıt yapısını spreadsheets.batchUpdate altında bulabilirsiniz.
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.
Yukarıdaki videoda, e-tablo hücrelerini dondurulmuş satırlar oluşturma, hücreleri kalınlaştırma, para birimi biçimlendirmesini uygulama, hücre doğrulaması yapma ve hücre değerlerini kısıtlama gibi çeşitli şekillerde nasıl biçimlendireceğinizi öğreneceksiniz.
Hücre kenarlıkları düzenleme
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, A1:F10 aralığındaki her hücreye kesikli, mavi bir üst ve alt kenar çizgisi vermek için UpdateBordersRequest işlevinin nasıl kullanılacağı gösterilmektedir. innerHorizontal alanı, aralığın iç kısmında yatay kenarlıklar oluşturur.
Alanın atlanması, kenarlıkların yalnızca aralığın tamamının üst ve alt kısmına eklenmesine neden olur.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateBorders": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 6
},
"top": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"bottom": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"innerHorizontal": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
}
}
]
}
Başlık satırını biçimlendirme
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, bir sayfadaki başlık satırını biçimlendirmek için RepeatCellRequest işlevinin nasıl kullanılacağı gösterilmektedir. İlk istek, metin rengini, arka plan rengini, metin yazı tipi boyutunu ve metin hizalamasını günceller ve metni kalın yapar. range alanındaki sütun dizinlerinin atlanması, satırın tamamının biçimlendirilmesine neden olur. İkinci istek, sayfa özelliklerini başlık satırının dondurulacağı şekilde ayarlar.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 1
},
"cell": {
"userEnteredFormat": {
"backgroundColor": {
"red": 0.0,
"green": 0.0,
"blue": 0.0
},
"horizontalAlignment" : "CENTER",
"textFormat": {
"foregroundColor": {
"red": 1.0,
"green": 1.0,
"blue": 1.0
},
"fontSize": 12,
"bold": true
}
}
},
"fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
}
},
{
"updateSheetProperties": {
"properties": {
"sheetId": SHEET_ID,
"gridProperties": {
"frozenRowCount": 1
}
},
"fields": "gridProperties.frozenRowCount"
}
}
]
}
Hücreleri birleştir
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, hücreleri birleştirmek için MergeCellsRequest işlevinin nasıl kullanılacağı gösterilmektedir. İlk istek, A1:B2 aralığını tek bir hücrede birleştirir. İkinci istek, A3:B6 arasındaki sütunları birleştirirken satırları ayrı bırakır.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 2,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_ALL"
}
},
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 2,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_COLUMNS"
}
},
]
}
Bir aralık için özel bir tarih/saat veya ondalık biçim ayarlama
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, hücreleri özel tarih/saat ve sayı biçimlerine sahip olacak şekilde güncellemek için RepeatCellRequest işlevinin nasıl kullanılacağı gösterilmektedir. İlk istek, A1:A10 aralığındaki hücrelere hh:mm:ss am/pm,
ddd mmm dd yyyy özel tarih/saat biçimini verir. Bu biçimdeki bir tarih ve saat örneği: "14:05:07, Pazar 03 Nisan 2016".
İkinci istek, B1:B10 arasındaki hücrelere #,##0.0000 özel sayı biçimini verir. Bu biçim, sayıların virgül ayırıcılarla gruplandırılmasını, ondalık noktadan sonra 4 basamak olmasını ve bir tane hariç tüm başlangıç sıfırlarının atılmasını belirtir. Örneğin, "3,14" sayısı "3,1400" olarak, "12345,12345" sayısı ise "12.345,1235" olarak oluşturulur.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 1
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "DATE",
"pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
},
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 2
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "NUMBER",
"pattern": "#,##0.0000"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
}
]
}