Google Sheets 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, 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, 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 bölümüne bakın.
Bu örneklerde, SPREADSHEET_ID ve SHEET_ID yer tutucuları bu kimlikleri nerede sağlayacağınızı gösterir. E-tablo kimliğini e-tablonun 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 öğ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 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ı 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 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 saati 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 örnek tarih ve saat şu şekildedir: "02:05:07 PM, Paz
03 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" } } ] }