Cells

Komórkowa transmisja danych

Dane o określonej 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 daty są przedstawiane jako podwójne wartości w formacie serial number.

effectiveValue

object (ExtendedValue)

Efektywna komórka. W przypadku komórek z formułami jest to wartość obliczona. W komórkach z literałem będzie to samo, co użytkownikEnteredValue. To pole jest tylko do odczytu.

formattedValue

string

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

userEnteredFormat

object (CellFormat)

Format komórki wpisany przez użytkownika.

Podczas pisania nowy format zostanie scalony z istniejącym.

effectiveFormat

object (CellFormat)

Efektywny format używany przez komórkę. Obejmuje to wyniki zastosowania formatowania warunkowego, a jeśli komórka zawiera formułę, obliczany format liczb. Jeśli format skuteczny jest domyślny, efektywny nie zostanie zapisany. To pole jest tylko do odczytu.

note

string

Każda notatka w komórce.

textFormatRuns[]

object (TextFormatRun)

Uruchomienia tekstu sformatowanego stosowane w podsekcjach komórki. Uruchamiane są tylko ciągi wprowadzane przez użytkownika, a nie formuły, wartości logiczne i liczby. Właściwości uruchomienia zaczynają się od określonego indeksu w tekście i trwają do następnego uruchomienia. Uruchomienia odziedziczą właściwości komórki, chyba że jednoznacznie ją zmienisz.

Podczas zapisywania nowe uruchomienia zastępują wszystkie wcześniejsze. Podczas zapisywania nowego obiektu userEnteredValue poprzednie uruchomienia są kasowane.

dataValidation

object (DataValidationRule)

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

Gdy piszesz, nowa reguła sprawdzania poprawności danych zastępuje wszystkie wcześniejsze reguły.

pivotTable

object (PivotTable)

Tabela przestawna zakotwiczona w tej komórce. Rozmiar samej tabeli przestawnej jest obliczany dynamicznie na podstawie jej danych, grupowania, filtrów, wartości itd. Tylko lewa górna komórka tabeli przestawnej zawiera definicję tabeli przestawnej. Inne komórki będą zawierać obliczone wartości wyników tabeli przestawnej w polach effectiveValue.

dataSourceTable

object (DataSourceTable)

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

dataSourceFormula

object (DataSourceFormula)

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

Format komórki

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 wartości liczbowe, które mają być wyświetlane użytkownikowi.

backgroundColor
(deprecated)

object (Color)

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

backgroundColorStyle

object (ColorStyle)

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

borders

object (Borders)

Obramowanie komórki.

padding

object (Padding)

Dopełnienie komórki.

horizontalAlignment

enum (HorizontalAlign)

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

verticalAlignment

enum (VerticalAlign)

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

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 został zastąpiony przez uruchomienie formatu). Ustawienie tutaj linku na poziomie komórki powoduje usunięcie istniejących linków w komórce. Ustawienie pola linku w TextFormatRun ma pierwszeństwo przed linkiem na poziomie komórki.

textRotation

object (TextRotation)

Rotacja zastosowana do tekstu w komórce.

Format liczb

Format liczbowy komórki.

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

enum (NumberFormatType)

Typ formatu liczb. Podczas pisania to pole należy ustawić.

pattern

string

Ciąg znaków używany do formatowania. Jeśli zasada nie jest skonfigurowana, w razie potrzeby jest używany domyślny wzorzec określony na podstawie języka użytkownika. Więcej informacji na temat obsługiwanych wzorców znajdziesz w przewodniku po formatach daty i cyfr.

Typ formatu liczb

Format liczbowy komórki. W tej dokumentacji przyjęto, że język występuje w języku angielskim (en_US), ale rzeczywisty format zależy od ustawień regionalnych arkusza kalkulacyjnego.

Wartości w polu enum
NUMBER_FORMAT_TYPE_UNSPECIFIED Format liczb nie jest określony i zależy od zawartości komórki. Nie używaj go jawnie.
TEXT Formatowanie tekstu, np.1000.12
NUMBER Formatowanie liczb, np.1,000.12
PERCENT Formatowanie w procentach, 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 numeru naukowego, np.1.01E+03

Borders

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)

Lewe obramowanie komórki.

right

object (Border)

Prawe obramowanie 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 „Styl”.

color
(deprecated)

object (Color)

Kolor obramowania. Wycofano: użyj właściwości colorStyle.

colorStyle

object (ColorStyle)

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

Styl

Styl obramowania.

Wartości w polu enum
STYLE_UNSPECIFIED Styl nie jest określony. Nie używaj tej funkcji.
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 Bez obramowania. Używany tylko podczas aktualizowania obramowania, aby go usunąć.
DOUBLE Obramowanie to dwie ciągłe linie.

Dopełnienie

Wielkość dopełnienia komórki w pikselach. Podczas aktualizowania dopełnienia trzeba wypełnić każde pole.

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

integer

Górne dopełnienie komórki.

right

integer

Prawe dopełnienie komórki.

bottom

integer

Dolne dopełnienie komórki.

left

integer

Lewe dopełnienie komórki.

Wyrównaj w pionie

Wyrównanie tekstu w komórce w pionie.

Wartości w polu enum
VERTICAL_ALIGN_UNSPECIFIED Wyrównanie w pionie nie jest określone. Nie używaj tej funkcji.
TOP Tekst jest wyrównany do góry komórki.
MIDDLE Tekst jest wyśrodkowany na środku komórki.
BOTTOM Tekst jest wyraźnie wyrównany u dołu komórki.

Strategia

Jak zawijać tekst w komórce.

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

Linie dłuższe niż szerokość komórki zostaną napisane w następnej komórce, o ile komórka będzie pusta. Jeśli kolejna komórka nie jest pusta, działa tak samo jak CLIP. Tekst nigdy nie zostanie zawinięty 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 polega na przycinaniu starych słów kluczowych, a nie dłuższych wierszy. 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ą przycięte. Tekst nigdy nie zostanie zawinięty 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ą zawijane na poziomie znaku, a nie przycinane. Przykład:

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

Kierunek tekstu

Kierunek tekstu w komórce.

Wartości w polu enum
TEXT_DIRECTION_UNSPECIFIED Nie określono kierunku tekstu. Nie używaj tej funkcji.
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.

HiperlinkDisplayType

Określa, czy wyrenderować hiperlink. Jeśli nie podasz hiperlinku, zostanie on połączony.

Wartości w polu enum
LINKED Hiperlink powinien być wyraźnie wyrenderowany.
PLAIN_TEXT Nie należy renderować hiperlinku.

Obrót tekstu

Rotacja zastosowana 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. Typ obrotu, pionowe lub kątowe. type może być tylko jedną z tych wartości:
angle

integer

Kąt między ustawieniem orientacji standardowej a żądaną. Mierzone w stopniach. Prawidłowe wartości należą do zakresu od -90 do 90. Kąty dodatnie są kątowe ku górze, a negatywne w dół.

Uwaga: kierunki tekstu w kierunku litery LTR są pozytywne, a w kierunku przeciwnym do ruchu wskazówek zegara.

vertical

boolean

Jeśli prawda jest włączona, tekst jest czytany 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 |

Uruchomienie formatu tekstowego

Uruchomienie formatu tekstowego. Format tego uruchomienia będzie się powtarzał, aż do rozpoczęcia następnego uruchomienia. Podczas aktualizacji musisz ustawić wszystkie pola.

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

integer

Indeks znaku zerowego, w którym zaczyna się to uruchomienie w jednostkach kodu UTF-16.

format

object (TextFormat)

Format tego uruchomienia. Brakujące wartości dziedziczą format komórki.

Reguła sprawdzania poprawności danych

Reguła sprawdzania poprawności danych.

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

object (BooleanCondition)

Warunek, jaki muszą mieć dane z komórki.

inputMessage

string

Komunikat informujący użytkownika podczas dodawania danych do komórki.

strict

boolean

Wartość „prawda”, jeśli należy odrzucić nieprawidłowe dane

showCustomUi

boolean

Wartość „prawda”, jeśli należy dostosować interfejs w zależności od rodzaju warunku. Jeśli warunek ma wartość Prawda, warunki „Lista” pokazują menu.

Tabela źródeł danych

Tabela źródeł danych, która umożliwia użytkownikowi importowanie statycznej tabeli danych z DataSource do Arkuszy. Ta funkcja nosi też nazwę „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 jest powiązana tabela źródeł danych.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

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

columns[]

object (DataSourceColumnReference)

Kolumny wybrane do tabeli źródła danych. columnSelectionType musi mieć wartość 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 według kolejności sortowania.

rowLimit

integer

Limit wierszy do zwrócenia. Jeśli zasada nie jest skonfigurowana, używany jest domyślny limit. Informacje o limitach domyślnych i maksymalnych znajdziesz w edytorze Arkuszy.

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

Typ kolumny danych źródłowych źródła danych

Typy kolumn tabeli źródeł 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 według pola columns.
SYNC_ALL

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

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

Formuła DataSource

formuła źródła danych,

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.