Google Sheets API, e-tablolardaki hücrelerin ve aralıkların biçimlendirmesini güncellemenize olanak tanır. Bu sayfadaki örnekler, bazı yaygın biçimlendirme işlemlerinin E-Tablolar API'si kullanılarak nasıl yapılabileceğini göstermektedir. Koşullu biçimlendirme tarif sayfasında daha fazla koşullu biçimlendirme örneği bulabilirsiniz.
Bir e-tabloyu güncellerken bazı istek türleri yanıt döndürebilir.
Bunlar, her yanıt karşılık gelen istekle aynı dizini işgal edecek şekilde bir dizi içinde döndürülür. Bazı isteklerde yanıt yok ve bu isteklerde yanıt boş. Bu örneklerle ilgili yanıt yapısı spreadsheets.batchUpdate altında bulunabilir.
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.
Yukarıdaki videoda e-tablo hücrelerini dondurulmuş satırlar oluşturma, hücreleri kalın hale getirme, para birimi biçimlendirmesi uygulama, hücre doğrulama ve hücre değerlerini kısıtlama gibi çeşitli yollarla nasıl biçimlendireceğinizi öğreneceksiniz.
Hücre kenarlıklarını düzenle
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, A1:F10 aralığındaki her bir hücreye kesikli, mavi renkte üst ve alt kenarlık vermek için UpdateBordersRequest özelliğinin nasıl kullanılacağı gösterilmektedir. innerHorizontal alanı, aralığın içinde yatay kenarlıklar oluşturur.
Bu alanın atlanması, kenarlıkların yalnızca tüm aralığı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, sayfadaki başlık satırını biçimlendirmek için RepeatCellRequest özelliğinin 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ında sütun dizinlerinin atlanması, tüm satırı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 özelliğinin nasıl kullanılacağı gösterilmektedir. İlk istek A1:B2 aralığını tek bir hücrede birleştirir. İkinci istek A3:B6'daki sütunları birleştirirken satırları ayrı durumda 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 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 kodunun nasıl kullanılacağı gösterilmektedir. İlk istekte A1:A10 aralığındaki hücrelere hh:mm:ss am/pm,
ddd mmm dd yyyy adlı özel tarih/saat biçimi verilir. Bu biçimdeki örnek bir tarih ve saat şöyledir: "02:05:07 PM, Paz Nisan 03 2016".
İkinci istek, B1:B10'daki hücrelere #,##0.0000 özel sayı biçimini verir. Bu biçim, sayıların virgülle ayırıcılarla gruplandırılması gerektiğini, ondalık basamaktan sonra 4 hanenin olması gerektiğini ve baştaki sıfırın biri hariç tümünün atlanması gerektiğini belirtir. Örneğin, "3,14" sayısı "3,1400", "12345.12345" 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"
}
}
]
}