Podstawowe formatowanie

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.

3 na 3, w których każda komórka ma przerywane, niebieskie obramowanie górne i dolne.
Rysunek 1. Sformatuj każdą komórkę za pomocą przerywanych, niebieskich ramek u góry i dołu arkusza.

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.

Tabela 3 na 3 ze sformatowanym wierszem nagłówka w arkuszu.
Rysunek 2. Sformatuj wiersz nagłówka w arkuszu.

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.

Tabela 3 na 3 ze scalonymi komórkami w arkuszu.
Rysunek 3. Scalanie komórek w arkuszu.

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”.

tabela 3 na 3 z niestandardowymi formatami daty i godziny w arkuszu.
Rysunek 4. Zaktualizuj komórki, aby miały w arkuszu niestandardowe formaty daty i godziny.

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"
      }
    }
  ]
}