Google Sheets API, hücrelerin ve aralıkların biçimlendirmesini güncellemenize olanak tanır. yardımcı olabilir. Bu sayfadaki örnekler, bazı yaygın sorunların Biçimlendirme işlemleri Sheets API ile gerçekleştirilebilir. Şunları yapabilirsiniz: Daha fazla koşullu biçimlendirme örneği için Koşullu biçimlendirme yemek tarifi sayfası.
Bir e-tabloyu güncellerken bazı istek türleri yanıt döndürebilir.
Bunlar, her yanıt
gönderin. Bazı istekler yanıt içermiyor ve
yanıt boş. Bu örnekler için yanıt yapısı şurada bulunabilir:
spreadsheets.batchUpdate
.
Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Bir toplu güncellemeyi farklı dillerde nasıl uygulayacağınızı öğrenmek için hakkında daha fazla bilgi edinmek için Güncelleme e-tablolar gibi).
Bu örneklerde SPREADSHEET_ID ve SHEET_ID yer tutucuları
bu kimlikleri nereye sağlayacağınızı belirtir. E-tabloyu
kimliği ekleyin. Şundan faydalanabilirsiniz:
sayfa kimliğini değiştirmek için
spreadsheets.get
yöntemini kullanabilirsiniz. İlgili içeriği oluşturmak için kullanılan
aralıklar A1 gösterimi kullanılarak belirtilir.
örnek aralık Sayfa1!A1:D5'tir.
Yukarıdaki videoda, e-tablo hücrelerini çeşitli şekillerde biçimlendirmeyi ve Bunlar arasında, dondurulmuş satırlar oluşturma, hücreleri kalınlaştırma, para birimi uygulama hücre doğrulaması gerçekleştirebilir ve hücre değerlerinin kısıtlanmasını sağlayabilirsiniz.
Hücre kenarlıklarını düzenle
Aşağıdakiler
spreadsheets.batchUpdate
kod örneği,
UpdateBordersRequest
(A1:F10 aralığındaki her hücreye kesik çizgili, mavi renkte üst ve alt kenarlık ekler. İlgili içeriği oluşturmak için kullanılan
innerHorizontal
alanı, aralığın iç tarafında yatay kenarlıklar oluşturur.
Alanın atlanması, kenarlıkların yalnızca üste eklenmesine ve
en düşük olanı seçin.
İ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ğıdakiler
spreadsheets.batchUpdate
kod örneği,
RepeatCellRequest
başlık satırını biçimlendirmek için kullanılır. İlk istek metin rengini günceller.
arka plan rengini, metin yazı tipi boyutunu ve metin hizalamasını belirler.
metin kalın. range
alanında sütun dizinlerinin atlanması,
satırının biçimlendirilmesi gerekir. İkinci istek, sayfa özelliklerini,
başlık satırı donduruldu.
İ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ğıdakiler
spreadsheets.batchUpdate
kod örneği,
MergeCellsRequest
kullanarak hücreleri birleştirebilirsiniz. İlk istek, A1:B2 aralığını tek bir hücrede birleştirir. İlgili içeriği oluşturmak için kullanılan
ikinci 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ğıdakiler
spreadsheets.batchUpdate
kod örneği,
RepeatCellRequest
özel tarih ve sayı biçimlerine sahip olacak şekilde hücreleri güncelleyin. İ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 Nis
03 2016".
İkinci istek, B1:B10 hücresine özel sayı biçimini verir
#,##0.0000
, numaraların virgülle gruplanması gerektiğini gösterir
ayırıcılarından sonra 4 rakam olması gerektiğini ve
baştaki bir sıfır atlanmalıdır. Örneğin, "3.14" sayısı oluşturuldu
"3.1400" olarak, "12345.12345" olarak da gösterilir değeri "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" } } ] }