Cells

CellData

Dane dotyczące określonej komórki.

Zapis JSON
{
  "userEnteredValue": {
    object (ExtendedValue)
  },
  "effectiveValue": {
    object (ExtendedValue)
  },
  "formattedValue": string,
  "userEnteredFormat": {
    object (CellFormat)
  },
  "effectiveFormat": {
    object (CellFormat)
  },
  "hyperlink": string,
  "note": string,
  "textFormatRuns": [
    {
      object (TextFormatRun)
    }
  ],
  "dataValidation": {
    object (DataValidationRule)
  },
  "pivotTable": {
    object (PivotTable)
  },
  "dataSourceTable": {
    object (DataSourceTable)
  },
  "dataSourceFormula": {
    object (DataSourceFormula)
  }
}
Pola
userEnteredValue

object (ExtendedValue)

Wartość wpisana w komórce. np. 1234, 'Hello' lub =NOW() Uwaga: daty, godziny i daty i godziny są wyświetlane jako liczby zmiennoprzecinkowe w serial number .

effectiveValue

object (ExtendedValue)

Efektywna wartość komórki. W przypadku komórek z formułami jest to obliczona wartość. W przypadku komórek z literałami wartość ta jest równa wartości userEnteredValue. To pole jest tylko do odczytu.

formattedValue

string

Sformatowana wartość komórki. To jest wartość wyświetlana użytkownikowi. To pole jest tylko do odczytu.

userEnteredFormat

object (CellFormat)

Format komórki wpisany przez użytkownika.

Podczas tworzenia nowego formatu nowy format zostanie scalony z istniejącym formatem.

effectiveFormat

object (CellFormat)

Efektywny format używany przez komórkę. Obejmuje to wyniki zastosowania formatowania warunkowego oraz, jeśli komórka zawiera formułę, obliczony format liczbowy. Jeśli obowiązujący format to format domyślny, nie zostanie on zapisany. To pole jest tylko do odczytu.

note

string

dowolną notatkę do tej komórki.

textFormatRuns[]

object (TextFormatRun)

Uruchomienia tekstu sformatowanego zastosowane do podsekcji komórki. Uruchomienia działają tylko w przypadku ciągów wpisanych przez użytkownika. Nie można formuł, wartości logicznych ani liczb. Właściwości uruchomienia rozpoczynają się od określonego indeksu w tekście i są kontynuowane aż do następnego uruchomienia. Uruchomienia odziedziczą właściwości komórki, chyba że wyraźnie je zmienisz.

Podczas zapisywania nowe uruchomienia zastąpią wszystkie wcześniejsze uruchomienia. Podczas pisania nowego userEnteredValue, wcześniejsze uruchomienia zostały usunięte.

dataValidation

object (DataValidationRule)

reguła sprawdzania poprawności danych w komórce (jeśli istnieje).

Podczas zapisywania nowa reguła sprawdzania poprawności danych zastąpi wszystkie wcześniejsze reguły.

pivotTable

object (PivotTable)

Tabela przestawna zakotwiczona w tej komórce. Rozmiar samej tabeli przestawnej jest określany dynamicznie na podstawie jej danych, grupowania, filtrów, wartości itp. Definicję tabeli przestawnej zawiera tylko lewa górna komórka tabeli. Pozostałe komórki będą zawierać obliczone wartości wyników tabeli przestawnej. effectiveValue .

dataSourceTable

object (DataSourceTable)

Tabela źródła danych zakotwiczona w tej komórce. Rozmiar tabeli źródeł danych jest obliczany dynamicznie na podstawie jej konfiguracji. Tylko pierwsza komórka tabeli źródła danych zawiera definicję tabeli źródła danych. Pozostałe komórki będą zawierać wyświetlane wartości wyniku tabeli źródła danych w ich effectiveValue .

dataSourceFormula

object (DataSourceFormula)

Tylko dane wyjściowe. Informacje o formule źródła danych w komórce. Pole jest ustawiane, jeśli userEnteredValue to formuła odwołująca się do pewnych DATA_SOURCE arkusz, np. =SUM(DataSheet!Column)

CellFormat

Format komórki.

Zapis JSON
{
  "numberFormat": {
    object (NumberFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "borders": {
    object (Borders)
  },
  "padding": {
    object (Padding)
  },
  "horizontalAlignment": enum (HorizontalAlign),
  "verticalAlignment": enum (VerticalAlign),
  "wrapStrategy": enum (WrapStrategy),
  "textDirection": enum (TextDirection),
  "textFormat": {
    object (TextFormat)
  },
  "hyperlinkDisplayType": enum (HyperlinkDisplayType),
  "textRotation": {
    object (TextRotation)
  }
}
Pola
numberFormat

object (NumberFormat)

Format opisujący, jak powinny być przedstawione użytkownikowi wartości liczbowe.

backgroundColor
(deprecated)

object (Color)

Kolor tła komórki. Wycofane: użyj backgroundColorStyle

backgroundColorStyle

object (ColorStyle)

Kolor tła komórki. Jeśli backgroundColor jest ustawiona, to pole ma pierwszeństwo.

borders

object (Borders)

Obramowanie komórki.

padding

object (Padding)

Dopełnienie komórki.

horizontalAlignment

enum (HorizontalAlign)

Wyrównanie wartości w komórce w poziomie.

verticalAlignment

enum (VerticalAlign)

Wyrównanie wartości w komórce w pionie.

wrapStrategy

enum (WrapStrategy)

Strategia zawijania wartości w komórce.

textDirection

enum (TextDirection)

Kierunek tekstu w komórce.

textFormat

object (TextFormat)

Format tekstu w komórce (chyba że zostanie zastąpiony przez uruchomienie formatowania). Ustawienie linku na poziomie komórki w tym miejscu powoduje wyczyszczenie istniejących linków w komórce. Ustawienie pola linku w TextFormatRun ma pierwszeństwo przed linkiem na poziomie komórki.

textRotation

object (TextRotation)

Obrót został zastosowany do tekstu w komórce.

NumberFormat

Format liczb w komórce.

Zapis JSON
{
  "type": enum (NumberFormatType),
  "pattern": string
}
Pola
type

enum (NumberFormatType)

Rodzaj formatu liczb. Podczas pisania to pole musi być ustawione.

pattern

string

Ciąg znaków wzorca używany do formatowania. Jeśli zasada nie jest skonfigurowana, w razie potrzeby w przypadku danego typu jest używany wzorzec domyślny oparty na języku użytkownika. Zobacz Przewodnik po formatach dat i liczb .

NumberFormatType

Format liczb w komórce. W tej dokumentacji przyjmuje się, że język to pl_PL, ale rzeczywisty format zależy od ustawień regionalnych arkusza kalkulacyjnego.

Wartości w polu enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Format liczb nie został określony i jest oparty na zawartości komórki. Nie używaj go bezpośrednio.
TEXT Formatowanie tekstu, np. 1000.12
NUMBER Format liczb, np. 1,000.12
PERCENT Formatowanie procentowe, np. 10.12%
CURRENCY Formatowanie waluty, np. $1,000.12
DATE Formatowanie daty, np. 9/26/2008
TIME Format godziny, np. 3:59:00 PM
DATE_TIME Formatowanie daty i godziny, np. 9/26/08 15:59:00
SCIENTIFIC Format liczb naukowych, np. 1.01E+03

Granice

Obramowanie komórki.

Zapis JSON
{
  "top": {
    object (Border)
  },
  "bottom": {
    object (Border)
  },
  "left": {
    object (Border)
  },
  "right": {
    object (Border)
  }
}
Pola
top

object (Border)

Górna krawędź komórki.

bottom

object (Border)

Dolna krawędź komórki.

left

object (Border)

Lewa krawędź komórki.

right

object (Border)

Prawa krawędź komórki.

Borders

Obramowanie wzdłuż komórki.

Zapis JSON
{
  "style": enum (Style),
  "width": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Pola
style

enum (Style)

Styl obramowania.

width
(deprecated)

integer

Szerokość obramowania w pikselach. Wycofano; szerokość jest określana przez atrybut „style” .

color
(deprecated)

object (Color)

Kolor obramowania. Wycofane: użyj colorStyle

colorStyle

object (ColorStyle)

Kolor obramowania. Jeśli color jest ustawiona, to pole ma pierwszeństwo.

Styl

Styl obramowania.

Wartości w polu enum
STYLE_UNSPECIFIED Styl nie jest określony. Nie używaj tej opcji.
DOTTED Obramowanie jest kropkowane.
DASHED Obramowanie jest przerywane.
SOLID Obramowanie to cienka linia ciągła.
SOLID_MEDIUM Obramowanie to średnia linia ciągła.
SOLID_THICK Obramowanie to gruba linia ciągła.
NONE Brak obramowania. Używana tylko podczas aktualizowania obramowania w celu jego usunięcia.
DOUBLE Obramowanie to dwie linie ciągłe.

Dopełnienie

Ilość dopełnienia wokół komórki w pikselach. Podczas aktualizowania dopełnienia należy określić każde pole.

Zapis JSON
{
  "top": integer,
  "right": integer,
  "bottom": integer,
  "left": integer
}
Pola
top

integer

Dopełnienie u góry komórki.

right

integer

Dopełnienie z prawej strony komórki.

bottom

integer

Dopełnienie dolne komórki.

left

integer

Dopełnienie z lewej strony komórki.

VerticalAlign

Wyrównanie tekstu w komórce w pionie.

Wartości w polu enum
VERTICAL_ALIGN_UNSPECIFIED Nie określono wyrównania w pionie. Nie używaj tej opcji.
TOP Tekst zostanie wyrównany do górnej części komórki.
MIDDLE Tekst jest wyrównany do środka komórki.
BOTTOM Tekst zostanie wyrównany do dołu komórki.

WrapStrategy

Jak zawinąć tekst w komórce.

Wartości w polu enum
WRAP_STRATEGY_UNSPECIFIED Wartość domyślna – nie używaj.
OVERFLOW_CELL

Wiersze dłuższe niż szerokość komórki zostaną zapisane w następnej komórce, o ile ta komórka jest pusta. Jeśli następna komórka „nad” nie jest pusta, działa tak samo jak CLIP Tekst nie będzie zawijany do następnego wiersza, chyba że użytkownik ręcznie wstawi nowy wiersz. Przykład:

| First sentence. |
| Manual newline that is very long. <- Text continues into next cell
| Next newline.   |
LEGACY_WRAP

Ta strategia zawijania tekstu odzwierciedla poprzednią strategię zawijania tekstu w Arkuszach Google, w której słowa dłuższe niż wiersz są przycinane, a nie połamane. Ta strategia nie jest obsługiwana na wszystkich platformach i jest wycofywana. Przykład:

| Cell has a |
| loooooooooo| <- Word is clipped.
| word.      |
CLIP

Linie dłuższe niż szerokość komórki zostaną obcięte. Tekst nie będzie zawijany do następnego wiersza, chyba że użytkownik ręcznie wstawi nowy wiersz. Przykład:

| First sentence. |
| Manual newline t| <- Text is clipped
| Next newline.   |
WRAP

Słowa dłuższe niż linia są zawijane na poziomie znaku, a nie obcinane. Przykład:

| Cell has a |
| loooooooooo| <- Word is broken.
| ong word.  |

TextDirection

Kierunek tekstu w komórce.

Wartości w polu enum
TEXT_DIRECTION_UNSPECIFIED Nie określono kierunku tekstu. Nie używaj tej opcji.
LEFT_TO_RIGHT Kierunek tekstu od lewej do prawej został ustawiony przez użytkownika.
RIGHT_TO_LEFT Kierunek tekstu od prawej do lewej został ustawiony przez użytkownika.

HyperlinkDisplayType

Określa, czy jednoznacznie renderować hiperlink. Jeśli nie podasz żadnej wartości, hiperlink będzie połączony.

Wartości w polu enum
LINKED Link musi być renderowany wprost.
PLAIN_TEXT Nie należy renderować hiperlinku.

TextRotation

Obrót zastosowany do tekstu w komórce.

Zapis JSON
{

  // Union field type can be only one of the following:
  "angle": integer,
  "vertical": boolean
  // End of list of possible types for union field type.
}
Pola
Pole sumy type Rodzaj obrotu (pionowy lub pod kątem). type może być tylko jednym z tych elementów:
angle

integer

Kąt między orientacją standardową a żądaną orientacją. Mierzona w stopniach. Prawidłowe wartości mieszczą się w przedziale od -90 do 90. Kąty dodatnie są skierowane ku górze, a ujemne w dół.

Uwaga: w przypadku tekstu LTR kąty dodatnie są ustawione w kierunku przeciwnym do ruchu wskazówek zegara, a w przypadku od prawej do lewej – w kierunku zgodnym z ruchem wskazówek zegara.

vertical

boolean

Jeśli wybrano opcję prawda, tekst jest odczytywany od góry do dołu, ale orientacja poszczególnych znaków pozostaje bez zmian. Na przykład:

| V |
| e |
| r |
| t |
| i |
| c |
| a |
| l |

TextFormatRun

Uruchomienie formatu tekstowego. Format tego uruchomienia będzie kontynuowany do momentu utworzenia indeksu początkowego następnego uruchomienia. Podczas aktualizacji musisz skonfigurować wszystkie pola.

Zapis JSON
{
  "startIndex": integer,
  "format": {
    object (TextFormat)
  }
}
Pola
startIndex

integer

Indeks znaków liczony od zera, przy którym rozpoczyna się uruchomienie, w jednostkach kodu UTF-16.

format

object (TextFormat)

Format tego uruchomienia. Wartości nieobecne dziedziczą format komórki.

DataValidationRule

Reguła sprawdzania poprawności danych.

Zapis JSON
{
  "condition": {
    object (BooleanCondition)
  },
  "inputMessage": string,
  "strict": boolean,
  "showCustomUi": boolean
}
Pola
condition

object (BooleanCondition)

Warunek, z którym muszą być zgodne dane w komórce.

inputMessage

string

Komunikat wyświetlany użytkownikowi podczas dodawania danych do komórki.

strict

boolean

Prawda, jeśli nieprawidłowe dane mają zostać odrzucone.

showCustomUi

boolean

Wartość prawda, jeśli interfejs powinien być dostosowywany na podstawie rodzaju warunku. Jeśli ma wartość true (prawda), „List” (Lista) warunki wyświetli menu.

DataSourceTable

tabeli źródeł danych, która umożliwia użytkownikowi importowanie statycznej tabeli danych z DataSource do Arkuszy. Nazywa się to „Wyodrębnij”. w edytorze Arkuszy.

Zapis JSON
{
  "dataSourceId": string,
  "columnSelectionType": enum (DataSourceTableColumnSelectionType),
  "columns": [
    {
      object (DataSourceColumnReference)
    }
  ],
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "rowLimit": integer,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Pola
dataSourceId

string

Identyfikator źródła danych, z którym powiązana jest tabela źródeł danych.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Typ do wybierania kolumn do tabeli źródeł danych. Domyślna wartość to SELECTED

columns[]

object (DataSourceColumnReference)

Wybrano kolumny tabeli źródeł danych. columnSelectionType musi być SELECTED

filterSpecs[]

object (FilterSpec)

Filtruj specyfikacje w tabeli źródeł danych.

sortSpecs[]

object (SortSpec)

Posortuj specyfikacje w tabeli źródeł danych. Wynik tabeli źródeł danych jest sortowany na podstawie specyfikacji sortowania.

rowLimit

integer

Limit wierszy do zwrócenia. Jeśli zasada nie jest skonfigurowana, stosowany jest domyślny limit. Domyślne i maksymalne limity znajdziesz w edytorze Arkuszy.

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

DataSourceTableColumnSelectionType

Typy wyboru kolumn tabeli źródła danych.

Wartości w polu enum
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Nie używaj domyślnego typu wyboru kolumny.
SELECTED Wybierz kolumny określone przez columns .
SYNC_ALL

Synchronizuj wszystkie bieżące i przyszłe kolumny w źródle danych.

Jeśli jest skonfigurowana, tabela źródła danych pobiera wszystkie kolumny ze źródła danych w momencie odświeżania.

DataSourceFormula

Formuła źródła danych.

Zapis JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Pola
dataSourceId

string

Identyfikator źródła danych, z którym jest powiązana formuła.

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.