Interfejs Google Sheets API umożliwia aktualizowanie formatowania komórek i zakresów w arkuszach kalkulacyjnych. Przykłady na tej stronie pokazują, jak za pomocą interfejsu Sheets API można wykonywać niektóre typowe operacje formatowania. Więcej przykładów formatowania warunkowego znajdziesz na stronie z recepturami dotyczącymi formatowania warunkowego.
Podczas aktualizowania arkusza kalkulacyjnego niektóre rodzaje żądań mogą zwracać odpowiedzi.
Są one zwracane w tablicy, a każda odpowiedź zajmuje ten sam indeks co odpowiadające jej żądanie. Niektóre żądania nie mają odpowiedzi, więc odpowiedź jest pusta. Strukturę odpowiedzi w przypadku tych przykładów znajdziesz w sekcji spreadsheets.batchUpdate.
Przykłady te są przedstawione w formie żądań HTTP, aby były neutralne językowo. Aby dowiedzieć się, jak za pomocą bibliotek klienta interfejsu API Google wdrożyć zbiorcze aktualizowanie w różnych językach, przeczytaj artykuł Aktualizowanie arkuszy kalkulacyjnych.
W tych przykładach obiekty zastępcze SPREADSHEET_ID i SHEET_ID wskazują, gdzie należy podać te identyfikatory. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza. Identyfikator arkusza możesz uzyskać, korzystając z metody spreadsheets.get. Zakresy są określane za pomocą notacji A1. Przykładowy zakres to Arkusz1!A1:D5.
Z powyższego filmu dowiesz się, jak formatować komórki arkusza kalkulacyjnego na różne sposoby, m.in. tworzyć zablokowane wiersze, wyróżniać komórki, stosować formatowanie waluty, przeprowadzać sprawdzanie komórek i ograniczać wartości komórek.
Edytowanie obramowania komórki
Poniższy przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji UpdateBordersRequest nadać każdej komórce w zakresie A1:F10 przerywany niebieski górny i dolny margines. Pole innerHorizontal tworzy obramowania poziome wewnątrz zakresu.
Pominięcie tego pola spowoduje dodanie obramowania tylko do górnej i dolnej krawędzi całego zakresu.
Protokół żądania przedstawiono poniżej.
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
},
},
}
}
]
}
Formatowanie wiersza nagłówka
Poniższy przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji RepeatCellRequest sformatować wiersz nagłówka w arkuszu. Pierwsze żądanie aktualizuje kolor tekstu, kolor tła, rozmiar czcionki tekstu oraz wyrównanie tekstu, a także powoduje pogrubienie tekstu. Pominięcie indeksów kolumn w polu range spowoduje sformatowanie całego wiersza. Drugie żądanie dostosowuje właściwości arkusza, aby wiersz nagłówka był zablokowany.
Protokół żądania przedstawiono poniżej.
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"
}
}
]
}
Scal komórki
Poniższy przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji MergeCellsRequest scalić komórki. Pierwsze żądanie scala zakres A1:B2 w jedną komórkę. Druga prośba scala kolumny w komórkach A3:B6, ale pozostawia wiersze rozdzielone.
Protokół żądania przedstawiono poniżej.
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"
}
},
]
}
Ustawianie niestandardowego formatu daty i godziny lub dziesiętnego dla zakresu
Ten przykładowy kod spreadsheets.batchUpdate pokazuje, jak za pomocą funkcji RepeatCellRequest zaktualizować komórki, aby miały niestandardowe formaty daty i godziny oraz liczb. Pierwsze żądanie nadaje komórkom w zakresie A1:A1 niestandardowy format daty i godziny hh:mm:ss am/pm,
ddd mmm dd yyyy. Przykładowy format daty i godziny: „02:05:07, Sun Apr
03 2016”.
Druga prośba nadaje komórkom B1:B10 niestandardowy format liczby #,##0.0000, który wskazuje, że liczby powinny być grupowane za pomocą przecinków, że po przecinku powinny być 4 cyfry, a wszystkie zera na początku powinny zostać pominięte. Na przykład liczba „3,14” jest wyświetlana jako „3,1400”, a „12345,12345” jako „12 345,1235”.
Protokół żądania przedstawiono poniżej.
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"
}
}
]
}