Interfejs API Arkuszy Google umożliwia aktualizowanie formatowania komórek i zakresów w arkuszach kalkulacyjnych. Przykłady na tej stronie pokazują, jak za pomocą interfejsu API Arkuszy można uzyskać niektóre typowe operacje formatowania. Więcej przykładów formatowania warunkowego znajdziesz na stronie przepisu o formatowaniu warunkowym.
Podczas aktualizowania arkusza kalkulacyjnego niektóre rodzaje żądań mogą zwracać odpowiedzi.
Są one zwracane w tablicy, przy czym każda odpowiedź zajmuje ten sam indeks co odpowiednie żądanie. Niektóre żądania nie mają odpowiedzi – w przypadku nich odpowiedź jest pusta. Strukturę odpowiedzi na te przykłady znajdziesz w sekcji spreadsheets.batchUpdate
.
Mają one postać żądań HTTP, które mają być neutralne pod względem języka. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu bibliotek klienta interfejsu API Google, przeczytaj artykuł Aktualizowanie arkuszy kalkulacyjnych.
W tych przykładach obiekty zastępcze SPREADSHEET_ID i SHEET_ID wskazują, gdzie należy je umieścić. Identyfikator arkusza kalkulacyjnego znajdziesz w adresie URL arkusza kalkulacyjnego. Identyfikator arkusza możesz uzyskać, korzystając z metody spreadsheets.get
. Zakresy są określane w notacji A1. Przykładowy zakres to Arkusz1!A1:D5.
Z filmu powyżej dowiesz się, jak formatować komórki arkusza kalkulacyjnego na różne sposoby, m.in. jak tworzyć zablokowane wiersze, pogrubiać komórki, implementować formatowanie walut, sprawdzać poprawność komórek i ograniczać wartości komórek.
Edytuj obramowanie komórek
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak za pomocą symbolu UpdateBordersRequest
nadać każdej komórce w zakresie A1:F10 przerywane, niebieskie obramowanie górne i dolne. Pole innerHorizontal
tworzy poziome obramowanie wewnątrz zakresu.
Pominięcie tego pola spowoduje dodanie obramowania tylko górnej i dolnej krawędzi całego zakresu.
Protokół żądania jest pokazany 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 użyć komponentu RepeatCellRequest
do sformatowania wiersza nagłówka w arkuszu. Pierwsze żądanie zmienia kolor tekstu, kolor tła, rozmiar czcionki tekstu i wyrównanie tekstu, a także pogrubia tekst. Pominięcie indeksów kolumn w polu range
powoduje formatowanie całego wiersza. Drugie żądanie dostosowuje właściwości arkusza w taki sposób, aby wiersz nagłówka był zablokowany.
Protokół żądania jest pokazany 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 użyć MergeCellsRequest
do scalenia komórek. Pierwsze żądanie scala zakres z zakresu A1:B2 w jedną komórkę. Drugie żądanie scala kolumny w formacie A3:B6, pozostawiając wiersze rozdzielone.
Protokół żądania jest pokazany 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" } }, ] }
Ustaw niestandardowy format daty i godziny lub liczb dziesiętnych dla zakresu
Poniższy przykładowy kod spreadsheets.batchUpdate
pokazuje, jak użyć RepeatCellRequest
do zaktualizowania komórek, tak aby miały niestandardowe formaty daty i godziny. Pierwsze żądanie powoduje przyznanie komórkom w zakresie A1:A10 niestandardowego formatu daty i godziny hh:mm:ss am/pm,
ddd mmm dd yyyy
. Przykładowa data i godzina w tym formacie: „02:05:07 PM, Sun Apr 2016”.
Drugie żądanie powoduje przyznanie komórkom w komórce B1:B10 niestandardowego formatu liczb #,##0.0000
, który oznacza, że liczby powinny być grupowane za pomocą separatora przecinków, powinny być 4 cyfry po separatorze dziesiętnym i usunąć wszystkie zera na początku. Na przykład liczba „3, 14” jest renderowana jako „3,1400”, a „12345.12345” – jako „12 345.1235”.
Protokół żądania jest pokazany 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" } } ] }