Tabele

Z tego przewodnika dowiesz się, jak i dlaczego używać interfejsu Google Sheets API do tworzenia tabel w arkuszach kalkulacyjnych.

Co to jest tabela?

Tabele mogą uprościć tworzenie danych i ograniczyć konieczność wielokrotnego formatowania, wprowadzania i aktualizowania danych dzięki automatycznemu stosowaniu formatu i struktury w zakresach danych.

Tabele mają wiele funkcji, takich jak nagłówki, stopki, typy kolumn, filtry, widoki, odwołania do tabel i nazwy tabel. Więcej informacji znajdziesz w ogłoszeniu o funkcji i artykule o używaniu tabel w Arkuszach.

Tabel możesz używać do takich zadań jak śledzenie projektów, planowanie wydarzeń i zarządzanie zapasami.

Dodawanie tabeli

Aby dodać tabelę, użyj metody batchUpdate i prześlij żądanie addTable. Za pomocą tego żądania możesz dodać tabelę do arkusza kalkulacyjnego.

W tym przykładzie tworzymy tabelę o nazwie „Project Tracker” w określonymrange z 2 ustawionymi kolumnami. Kolumna procentowa w pierwszej kolumnie i kolumna typu menu w drugiej kolumnie.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Typy kolumn

Tabele mają typy kolumn, takie jak numeryczny, data, menu, element inteligentny czy pole wyboru. Kolumny typu ocena i pole wyboru są wypełniane wartościami domyślnymi 0 i FALSE.

Typ kolumny z rozwijanym menu tworzy rozwijane menu z elementami. Jeśli typ kolumny jest ustawiony jako menu, w przypadku kolumny dataValidationRule musi być ustawiony warunek ONE_OF_LIST. W przypadku innych typów kolumn nie należy ustawiać pola `dataValidationRule`.

Aktualizowanie tabeli

Użyj metody spreadsheets.batchUpdate i podaj UpdateTableRequest.

Zmiana rozmiaru tabeli

Aby zmodyfikować range, które tabela musi dodać nowe wiersze lub kolumny, użyj metody UpdateTableRequest.

Jeśli chcesz dodać nowy wiersz lub kolumnę w tabeli, użyj funkcji InsertRangeRequest lub InsertDimensionRequest.

Jeśli chcesz usunąć wiersz tabeli, możesz użyć DeleteRangeRequest. W przeciwnym razie możesz użyć DeleteDimensionRequest, aby usunąć cały wiersz z arkusza kalkulacyjnego.

Jeśli aktualizujesz istniejącą tabelę bez stopki, aby ją dodać, element range powiększy się o 1 wiersz. Jeśli aktualizujesz istniejącą tabelę ze stopką i usuwasz stopkę, range zmniejsza się o 1 wiersz.

Dołączanie wartości do tabeli

Użyj AppendCellsRequest z parametrem tableId, aby dodać wiersze na końcu tabeli. Dodaje wartości do pierwszego wolnego wiersza i uwzględnia pełne wiersze oraz stopki. Jeśli nie ma pustych wierszy, wstawia wiersze na końcu tabeli i przed stopką (jeśli występuje).

Usuwanie tabeli

Użyj metody spreadsheets.batchUpdate i podaj DeleteTableRequest. Użyj DeleteTableRequest, aby usunąć całą tabelę i jej zawartość.

Użyj DeleteBandingRequest, aby usunąć formatowanie tabeli, ale zachować dane.

Korzystanie z tabel z innymi funkcjami Arkuszy

Inne funkcje interfejsu API, które obsługują tabele jako dane źródłowe, to filtry, widoki filtrów i zakresy chronione.