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 Sheets API ile nasıl gerçekleştirilebileceğini gösterir. 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ı dizine sahip bir dizide döndürülür. Bazı istekler yanıt içermiyor ve
bu istekler için yanıt boş. Bu örneklerin yanıt yapısı, spreadsheets.batchUpdate altında bulunabilir.
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.
Yukarıdaki videoda, dondurulmuş satırlar oluşturma, hücreleri kalınlaştırma, para birimi biçimlendirme uygulama, hücre doğrulaması yapma ve hücre değerlerini kısıtlama dahil olmak üzere e-tablo hücrelerini çeşitli şekillerde 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 eklemek için UpdateBordersRequest öğesinin nasıl kullanılacağı gösterilmektedir. innerHorizontal alanı, aralığın iç tarafında yatay kenarlıklar oluşturur.
Alanın atlanması, tüm aralığın yalnızca üst ve alt kısmına kenarlıkların 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 öğesinin 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 hale getirir. 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ı dondurulacak ş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 öğesinin 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ı 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 ve sayı biçimlerine sahip olacak şekilde güncellemek için RepeatCellRequest öğesinin 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 ve saat biçimini verir. Bu biçimdeki örnek tarih ve saat şu şekildedir: "02:05:07 PM, Paz
03 2016".
İkinci istek, B1:B10 hücresindeki hücrelere #,##0.0000 özel sayı biçimini verir. Bu biçim, sayıların virgül ayırıcılarla gruplandırılması gerektiğini, ondalık basamaktan sonra 4 basamak olması gerektiğini ve baştaki sıfırın biri hariç tümünün çıkarılması gerektiğini belirtir. Örneğin, "3.14" sayısı "3.1400" olarak, "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"
}
}
]
}