Komórkowa transmisja danych
Dane o określonej komórce.
Zapis JSON |
---|
{ "userEnteredValue": { object ( |
Pola | |
---|---|
userEnteredValue
|
Wartość wpisana przez użytkownika w komórce, np.
|
effectiveValue
|
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
|
Sformatowana wartość komórki. Jest to wartość wyświetlana użytkownikowi. To pole jest tylko do odczytu. |
userEnteredFormat
|
Format komórki wpisany przez użytkownika. Podczas pisania nowy format zostanie scalony z istniejącym. |
effectiveFormat
|
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. |
hyperlink
|
hiperlink do tej komórki (jeśli istnieje), Jeśli komórka zawiera wiele hiperlinków, to pole będzie puste. To pole jest tylko do odczytu. Aby go ustawić, użyj formuły |
note
|
Każda notatka w komórce. |
textFormatRuns[]
|
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 |
dataValidation
|
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
|
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 |
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 |
dataSourceFormula
|
Tylko dane wyjściowe. Informacje o formule źródła danych w komórce. Pole jest ustawione, jeśli |
Format komórki
Format komórki.
Zapis JSON |
---|
{ "numberFormat": { object ( |
Pola | |
---|---|
numberFormat
|
Format opisujący wartości liczbowe, które mają być wyświetlane użytkownikowi. |
backgroundColor
|
Kolor tła komórki. Wycofano: użyj właściwości |
backgroundColorStyle
|
Kolor tła komórki. Jeśli ustawiona jest też wartość |
borders
|
Obramowanie komórki. |
padding
|
Dopełnienie komórki. |
horizontalAlignment
|
Wyrównanie poziomu w wartości w komórce. |
verticalAlignment
|
Wyrównanie w pionie wartości w komórce. |
wrapStrategy
|
Strategia zawijania wartości w komórce. |
textDirection
|
Kierunek tekstu w komórce. |
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 |
hyperlinkDisplayType
|
Jeśli tak, hiperlink powinien zostać wyświetlony w komórce. |
textRotation
|
Rotacja zastosowana do tekstu w komórce. |
Format liczb
Format liczbowy komórki.
Zapis JSON |
---|
{
"type": enum (
|
Pola | |
---|---|
type
|
Typ formatu liczb. Podczas pisania to pole należy ustawić. |
pattern
|
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 ( |
Pola | |
---|---|
top
|
Górna krawędź komórki. |
bottom
|
Dolna krawędź komórki. |
left
|
Lewe obramowanie komórki. |
right
|
Prawe obramowanie komórki. |
Borders
Obramowanie komórki.
Zapis JSON |
---|
{ "style": enum ( |
Pola | |
---|---|
style
|
Styl obramowania. |
width
|
Szerokość obramowania w pikselach. Wycofano. Szerokość jest określana przez pole „Styl”. |
color
|
Kolor obramowania. Wycofano: użyj właściwości |
colorStyle
|
Kolor obramowania. Jeśli ustawiona jest też wartość |
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
|
Górne dopełnienie komórki. |
right
|
Prawe dopełnienie komórki. |
bottom
|
Dolne dopełnienie komórki. |
left
|
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
|
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:
|
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:
|
WRAP
|
Słowa dłuższe niż wiersz są zawijane na poziomie znaku, a nie przycinane. Przykład:
|
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 | |
---|---|
HYPERLINK_DISPLAY_TYPE_UNSPECIFIED
|
Wartość domyślna: wyrenderowany jest hiperlink. Nie używaj tej funkcji. |
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 |
Pola | |
---|---|
Pole sumy: type . Typ obrotu, pionowe lub kątowe.
type może być tylko jedną z tych wartości:
|
|
angle
|
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
|
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:
|
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 (
|
Pola | |
---|---|
startIndex
|
Indeks znaku zerowego, w którym zaczyna się to uruchomienie w jednostkach kodu UTF-16. |
format
|
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 (
|
Pola | |
---|---|
condition
|
Warunek, jaki muszą mieć dane z komórki. |
inputMessage
|
Komunikat informujący użytkownika podczas dodawania danych do komórki. |
strict
|
Wartość „prawda”, jeśli należy odrzucić nieprawidłowe dane |
showCustomUi
|
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 ( |
Pola | |
---|---|
dataSourceId
|
Identyfikator źródła danych, z którym jest powiązana tabela źródeł danych. |
columnSelectionType
|
Typ wyboru kolumn tabeli źródeł danych. Domyślna wartość to |
columns[]
|
Kolumny wybrane do tabeli źródła danych. |
filterSpecs[]
|
Filtruj specyfikacje w tabeli źródeł danych. |
sortSpecs[]
|
Posortuj specyfikacje w tabeli źródeł danych. Wynik tabeli źródeł danych jest sortowany według kolejności sortowania. |
rowLimit
|
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
|
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 (
|
Pola | |
---|---|
dataSourceId
|
Identyfikator źródła danych, z którym formuła jest powiązana. |
dataExecutionStatus
|
Tylko dane wyjściowe. Stan wykonania danych. |