Interfejs API Arkuszy Google umożliwia aktualizowanie formatowania komórek i zakresów w arkuszach kalkulacyjnych. Przykłady na tej stronie pokazują, jak operacje formatowania można wykonać za pomocą interfejsu Arkuszy API. Dostępne opcje więcej przykładów formatowania warunkowego znajdziesz w sekcji Funkcja sformatuj stronę przepisu.
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
z odpowiednim żądaniem. Niektóre żądania nie mają odpowiedzi. W przypadku
odpowiedź jest pusta. Strukturę odpowiedzi na te przykłady można znaleźć w
spreadsheets.batchUpdate
Przykłady te są przedstawione w formie żądań HTTP, które stanowią język. i nie mam zdania. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsów API Google, przeczytaj artykuł Aktualizacja arkusze kalkulacyjne.
W tych przykładach zmienne SPREADSHEET_ID i SHEET_ID
wskazuje, gdzie należy je podać. Arkusz kalkulacyjny można znaleźć
ID w adresie URL arkusza kalkulacyjnego. Możesz uzyskać
identyfikator arkusza za pomocą funkcji
spreadsheets.get.
zakresy określa się w notacji A1. An
przykładowy zakres to Arkusz1!A1:D5.
Powyższy film pokazuje, jak formatować komórki arkusza kalkulacyjnego na różne sposoby w tym: tworzenie zablokowanych wierszy, pogrubienie komórek, wdrożenie waluty formatowanie, sprawdzanie poprawności komórek i ograniczenie wartości komórek.
Edytuj obramowanie komórek
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
UpdateBordersRequest
aby każda komórka z zakresu A1:F10 otrzymała przerywane, niebieskie obramowanie górne i dolne.
Pole innerHorizontal tworzy poziome obramowanie wewnątrz zakresu.
Pominięcie tego pola spowodowałoby dodanie obramowań tylko do górnej części
dolną część całego zakresu.
Protokół żądania jest widoczny 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żej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
RepeatCellRequest
aby sformatować wiersz nagłówka w arkuszu. Pierwsze żądanie aktualizuje kolor tekstu,
kolor tła, rozmiar czcionki tekstu i wyrównanie tekstu,
pogrubienie. Pominięcie indeksów kolumn w polu range powoduje, że cały wynik
do sformatowania. Drugie żądanie dostosowuje właściwości arkusza tak, aby
wiersz nagłówka jest zablokowany.
Protokół żądania jest widoczny 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żej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
MergeCellsRequest
aby scalić komórki. Pierwsze żądanie scala zakres A1:B2 w jedną komórkę.
drugie żądanie scala kolumny w komórkach A3:B6, pozostawiając wiersze rozdzielone.
Protokół żądania jest widoczny 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 zakresu
Poniżej
spreadsheets.batchUpdate
przykładowy kod pokazuje, jak korzystać z
RepeatCellRequest
, aby zaktualizować komórki, aby zawierały niestandardowe formaty daty i liczby. Pierwsza prośba
nadaje komórkom z zakresu A1:A10 niestandardowy format daty i godziny hh:mm:ss am/pm,
ddd mmm dd yyyy. Przykładowa data i godzina w tym formacie: „02:05:07 PM, Nd Kwi
03 2016 r.”.
Drugie żądanie nadaje komórkom B1:B10 niestandardowy format liczbowy.
#,##0.0000, który oznacza, że liczby powinny być pogrupowane za pomocą przecinka;
muszą być 4 cyfry po separatorze dziesiętnym i że wszystkie oprócz
należy usunąć jedno początkowe zero. Na przykład liczba „3.14” jest renderowany
jako „3.1400”, a „12345.12345” jest renderowana jako „12 345.1235”.
Protokół żądania jest widoczny 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"
}
}
]
}