Cells

CellData

Dane o konkretnej komórce.

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 przez użytkownika w komórce, np. 1234, 'Hello' lub =NOW()Uwaga: daty, godziny i daty/godziny są reprezentowane jako liczby podwójnie złożone w formacie serial number.

effectiveValue

object (ExtendedValue)

Rzeczywista wartość komórki. W przypadku komórek z formułami jest to obliczona wartość. W przypadku komórek z wartościami dosłownymi jest to wartość taka sama jak w userEnteredValue. To pole jest tylko do odczytu.

formattedValue

string

Wartość sformatowanej 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 zapisywania nowy format zostanie połączony z dotychczasowym.

effectiveFormat

object (CellFormat)

Efektywny format używany przez komórkę. Obejmuje to wyniki zastosowania dowolnego formatowania warunkowego oraz, jeśli komórka zawiera formułę, obliczony format liczby. Jeśli format skuteczny jest formatem domyślnym, nie zostanie zapisany. To pole jest tylko do odczytu.

note

string

dowolną notatkę do tej komórki.

textFormatRuns[]

object (TextFormatRun)

Fragmenty tekstu sformatowanego zastosowane do pododdziałów komórki. Wykonania są ważne tylko w przypadku ciągów znaków wpisywanych przez użytkownika, a nie formuł, wartości logicznych ani liczb. Właściwości przebiegu zaczynają się od określonego indeksu w tekście i trwają do następnego przebiegu. Jeśli nie zostaną zmienione, przebiegi będą dziedziczyć właściwości komórki.

Podczas zapisywania nowe przebiegi zastąpią wszystkie poprzednie. Podczas zapisywania nowego userEnteredValue poprzednie uruchomienia zostaną wymazane.

dataValidation

object (DataValidationRule)

regułę sprawdzania poprawności danych w komórce (jeśli występuje);

Podczas zapisywania nowa reguła sprawdzania danych zastąpi wszystkie poprzednie reguły.

pivotTable

object (PivotTable)

Tabela przestawna zablokowana w tej komórce. Rozmiar samej tabeli przestawnej jest obliczany dynamicznie na podstawie jej danych, grupowania, filtrów, wartości itp. Tylko komórka w lewym górnym rogu tabeli przestawnej zawiera jej definicję. Pozostałe komórki będą zawierać w polach effectiveValue obliczone wartości wyników funkcji pivot.

dataSourceTable

object (DataSourceTable)

tabela źródła danych zadokowana w tej komórce, Rozmiar tabeli źródła danych jest obliczany dynamicznie na podstawie jej konfiguracji. Definicję tabeli źródeł danych zawiera tylko pierwsza komórka tabeli źródeł danych. Pozostałe komórki będą zawierać wartości wyświetlania wyniku tabeli źródła danych w ich polach effectiveValue.

dataSourceFormula

object (DataSourceFormula)

Tylko dane wyjściowe. Informacje o formule źródła danych w komórce. Pole jest ustawione, jeśli zmienna userEnteredValue jest formułą odwołującą się do arkusza DATA_SOURCE, 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 określający, jak wartości liczbowe powinny być wyświetlane użytkownikowi.

backgroundColor
(deprecated)

object (Color)

Kolor tła komórki. Wycofane: użyj właściwości backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

obramowania 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 pionowe wartości w komórce.

wrapStrategy

enum (WrapStrategy)

Strategia zawinięcia 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 tutaj połączenia na poziomie komórki powoduje usunięcie dotychczasowych połączeń komórki. Ustawienie pola linku w elementach TextFormatRun ma pierwszeństwo przed linkiem na poziomie komórki.

textRotation

object (TextRotation)

Obrót tekstu w komórce.

NumberFormat

Format liczby w komórce.

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

enum (NumberFormatType)

Typ formatu liczby. Podczas pisania to pole musi być ustawione.

pattern

string

Ciąg znaków wzoru 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. Więcej informacji o obsługiwanych wzorach znajdziesz w przewodniku Formaty dat i liczb.

NumberFormatType

Format liczby w komórce. W tej dokumentacji zakłada się, że językiem jest en_US, ale rzeczywisty format zależy od języka arkusza kalkulacyjnego.

Wartości w polu enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Format liczb nie jest określony i jest określany na podstawie zawartości komórki. Nie używaj tego wprost.
TEXT Formatowanie tekstu, np.: 1000.12
NUMBER Formatowanie 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 Formatowanie czasu, np.: 3:59:00 PM
DATE_TIME Formatowanie daty i godziny, np.:9/26/08 15:59:00
SCIENTIFIC Formatowanie liczb w notacji naukowej, np.: 1.01E+03

Borders

obramowania komórki,

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

object (Border)

Górne obramowanie 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 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 pole „style”.

color
(deprecated)

object (Color)

Kolor obramowania. Wycofane: użyj colorStyle.

colorStyle

object (ColorStyle)

Kolor obramowania. Jeśli ustawiona jest też zasada color, to ona ma pierwszeństwo.

Styl

Styl obramowania.

Wartości w polu enum
STYLE_UNSPECIFIED Nie podano stylu. Nie używaj tego.
DOTTED Obramowanie jest przerywane.
DASHED Obramowanie jest przerywane.
SOLID Obramowanie to cienka linia ciągła.
SOLID_MEDIUM Obramowanie to średnia linia ciągła.
SOLID_THICK Obramowanie jest grubą, ciągłą linią.
NONE Bez obramowania. Używana tylko podczas aktualizowania obramowania w celu jego usunięcia.
DOUBLE Obrzeże składa się z 2 ciągłych linii.

Dopełnienie

Ilość dopełnienia wokół komórki w pikselach. Podczas aktualizowania wypełnienia należy podać wszystkie pola.

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

integer

Dopełnienie górnej części komórki.

right

integer

Prawy margines komórki.

bottom

integer

Dopełnienie komórki u dołu.

left

integer

Wypełnienie z lewej strony komórki.

VerticalAlign

Wyrównanie tekstu w pionie w komórce.

Wartości w polu enum
VERTICAL_ALIGN_UNSPECIFIED Nie określono wyrównania w pionie. Nie używaj tego.
TOP Tekst jest wyraźnie wyrównany do górnej krawędzi komórki.
MIDDLE Tekst jest wyraźnie wyrównany do środka komórki.
BOTTOM Tekst jest wyraźnie 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 nie jest pusta, funkcja 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 jest odpowiednikiem starej strategii przenoszenia w Arkuszach Google, w której słowa dłuższe niż wiersz są obcinane, a nie dzielone. 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ż wiersz są przenoszone 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 tego.
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 Hiperlink nie powinien być renderowany.

TextRotation

Obrót 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 uniitype. Typ obrotu: pionowy lub kątowy. typemoże być tylko jedną z tych wartości:
angle

integer

Kąt między standardową orientacją a pożądaną orientacją. Mierzona w stopniach. Prawidłowe wartości mieszczą się w zakresie od -90 do 90. Kąty dodatnie są skierowane w górę, 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 ma wartość true, tekst jest odczytywany od góry do dołu, ale orientacja poszczególnych znaków pozostaje niezmieniona. Na przykład: 

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

TextFormatRun

Uruchomienie formatu tekstowego. Format tego przebiegu jest kontynuowany do indeksu początkowego następnego przebiegu. Podczas aktualizowania należy ustawić wszystkie pola.

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

integer

Indeks znaku oparty na 0, w którym rozpoczyna się ten przebieg, 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ść true, jeśli interfejs użytkownika powinien być dostosowywany na podstawie rodzaju warunku. Jeśli ma wartość prawda, warunki „Lista” powodują wyświetlenie menu.

DataSourceTable

Tabela źródeł danych, która umożliwia użytkownikowi importowanie do Arkuszy statycznej tabeli danych z funkcji DataSource. W edytorze Arkuszy jest to nazywane „wyodrębnianiem”.

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 kolumn do wybrania w tabeli źródła danych. Domyślna wartość to SELECTED.

columns[]

object (DataSourceColumnReference)

Wybrano kolumny tabeli źródeł danych. Wartość w polu columnSelectionType musi być równa SELECTED.

filterSpecs[]

object (FilterSpec)

Filtruj specyfikacje w tabeli źródeł danych.

sortSpecs[]

object (SortSpec)

Posortuj specyfikacje w tabeli źródeł danych. Wynik tabeli źródła danych jest sortowany według kolejności określonych specyfikacji sortowania.

rowLimit

integer

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

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

DataSourceTableColumnSelectionType

Typy kolumn tabeli źródła danych.

Wartości w polu enum
DATA_SOURCE_TABLE_COLUMN_SELECTION_TYPE_UNSPECIFIED Domyślny typ wyboru kolumny, którego nie należy używać.
SELECTED Wybierz kolumny określone przez pole columns.
SYNC_ALL

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

Jeśli ta opcja jest ustawiona, tabela źródła danych pobiera wszystkie kolumny w źródle danych w momencie odświeżania.

DataSourceFormula

formuły ź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.