Tabele

Z tego przewodnika dowiesz się, jak i dlaczego używać Arkuszy Google 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, oraz w artykule o używaniu tabel w Arkuszach.

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

Dodawanie tabeli

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

Poniższy przykład tworzy tabelę o nazwie „Project Tracker” w określonym range z 2 ustawionymi kolumnami. Pierwsza kolumna to kolumna procentowa, a druga to kolumna z rozwijanym menu.

{
  "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 liczbowy, data, rozwijane menu, inteligentny element i pole wyboru. Typy kolumn oceny i pola wyboru są wypełniane odpowiednio wartościami domyślnymi 0 i FALSE.

Typ kolumny z rozwijanym menu tworzy rozwijane menu z elementami. Jeśli typ kolumny jest ustawiony jako rozwijane menu, dataValidationRule dla kolumny musi być ustawiony z warunkiem ONE_OF_LIST. Inne typy kolumn nie powinny ustawiać pola `dataValidationRule`.

Aktualizowanie tabeli

Użyj metody spreadsheets.batchUpdate i podaj UpdateTableRequest.

Modyfikowanie rozmiaru tabeli

Aby zmodyfikować range, w którym tabela ma dodawać nowe wiersze lub kolumny, użyj metody UpdateTableRequest.

Jeśli chcesz dodać nowy wiersz lub kolumnę w tabeli, użyj 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 dodać stopkę, range powiększa 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

Aby dodać wiersze na końcu tabeli, użyj AppendCellsRequest z tableId. Spowoduje to dołączenie wartości do pierwszego wolnego wiersza i uwzględni pełne wiersze oraz stopki. Jeśli nie ma pustych wierszy, spowoduje to wstawienie wierszy na końcu tabeli i przed stopką, jeśli taka istnieje.

Usuwanie tabeli

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

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

Używanie 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.