Cells

CellData

Dane dotyczące konkretnej 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)
  },
  "chipRuns": [
    {
      object (ChipRun)
    }
  ]
}
Pola
userEnteredValue

object (ExtendedValue)

Wartość wpisana przez użytkownika w komórce, np. 1234, 'Hello' lub =NOW() Uwaga: daty, godziny i daty z godzinami są reprezentowane jako liczby zmiennoprzecinkowe podwójnej precyzji w formacie 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 jest to to samo co userEnteredValue. 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 wpisany przez użytkownika w komórce.

Podczas zapisywania nowy format zostanie scalony z dotychczasowym.

effectiveFormat

object (CellFormat)

Format używany w komórce. Obejmuje to wyniki zastosowania formatowania warunkowego, a jeśli komórka zawiera formułę, obliczony format liczbowy. Jeśli obowiązujący format jest formatem domyślnym, nie zostanie zapisany. To pole jest tylko do odczytu.

note

string

dowolną notatkę w komórce.

textFormatRuns[]

object (TextFormatRun)

Ciągi tekstu sformatowanego zastosowane do podsekcji komórki. Działają one tylko w przypadku ciągów znaków wpisanych przez użytkownika, a nie w przypadku formuł, wartości logicznych ani liczb. Właściwości fragmentu zaczynają się od określonego indeksu w tekście i trwają do następnego fragmentu. Uruchomienia dziedziczą właściwości komórki, chyba że zostaną one wyraźnie zmienione.

Podczas zapisywania nowe uruchomienia zastąpią poprzednie. Podczas pisania nowego userEnteredValue poprzednie uruchomienia są usuwane.

dataValidation

object (DataValidationRule)

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

Podczas zapisywania nowa reguła weryfikacji danych zastąpi poprzednią regułę.

pivotTable

object (PivotTable)

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

dataSourceTable

object (DataSourceTable)

Tabela źródła danych zakotwiczona w tej komórce. Rozmiar tabeli źródła danych jest obliczany dynamicznie na podstawie jej konfiguracji. Definicja tabeli źródeł danych znajduje się tylko w pierwszej komórce tabeli źródeł danych. Pozostałe komórki będą zawierać wartości wyświetlane wyniku tabeli źródła danych w odpowiednich polach.effectiveValue

dataSourceFormula

object (DataSourceFormula)

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

chipRuns[]

object (ChipRun)

Opcjonalnie. Serie elementów zastosowane do podsekcji komórki. Właściwości fragmentu zaczynają się od określonego indeksu w tekście i trwają do następnego fragmentu.

Podczas odczytu uwzględniane są wszystkie biegi z chipem i bez niego. W przypadku biegów bez chipa pole Chip będzie puste.

Podczas pisania uwzględniane są tylko przebiegi z chipami. Ciągi zawierające elementy mają długość 1 i są reprezentowane w tekście wpisanym przez użytkownika za pomocą symbolu zastępczego „@”. Nowe uruchomienia zastąpią poprzednie. Zapisanie nowego userEnteredValue spowoduje usunięcie poprzednich przebiegów.

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 wartości liczbowe powinny być przedstawiane użytkownikowi.

backgroundColor
(deprecated)

object (Color)

Kolor tła komórki. Wycofano: użyj 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 poziome wartości w komórce.

verticalAlignment

enum (VerticalAlign)

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

wrapStrategy

enum (WrapStrategy)

Strategia zawijania tekstu 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 formatowanie). Ustawienie połączenia na poziomie komórki spowoduje usunięcie istniejących połączeń komórki. Ustawienie pola linku w TextFormatRun ma pierwszeństwo przed linkiem na poziomie komórki.

textRotation

object (TextRotation)

Obrót zastosowany do tekstu w komórce.

NumberFormat

Format liczb komórki.

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

enum (NumberFormatType)

Typ formatu liczbowego. Podczas zapisywania to pole musi być ustawione.

pattern

string

Ciąg wzorca używany do formatowania. Jeśli nie zostanie ustawiony, w razie potrzeby zostanie użyty domyślny wzorzec oparty na ustawieniach regionalnych arkusza kalkulacyjnego. Więcej informacji o obsługiwanych wzorcach znajdziesz w przewodniku po formatach daty i liczb.

NumberFormatType

Format liczb w komórce. W tej dokumentacji założono, że ustawienia regionalne to 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 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ó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 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. Wycofane. Szerokość jest określana przez pole „style”.

color
(deprecated)

object (Color)

Kolor obramowania. Wycofano: użyj colorStyle.

colorStyle

object (ColorStyle)

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

Styl

Styl obramowania.

Wartości w polu enum
STYLE_UNSPECIFIED Styl nie został 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 jest grubą linią ciągłą.
NONE Bez obramowania. Używane tylko podczas aktualizowania obramowania w celu jego usunięcia.
DOUBLE Obramowanie składa się z 2 linii ciągłych.

Dopełnienie

Wielkość dopełnienia wokół komórki w pikselach. Podczas aktualizowania dopełnienia należy określić wszystkie pola.

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 komórki u dołu.

left

integer

Dopełnienie z lewej strony komórki.

VerticalAlign

Wyrównanie tekstu w pionie w komórce.

Wartości w polu enum
VERTICAL_ALIGN_UNSPECIFIED Wyrównanie w pionie nie jest określone. Nie używaj tej opcji.
TOP Tekst jest wyraźnie wyrównany do góry 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 zawijać 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 jest ona pusta. Jeśli następna komórka jest niepusta, funkcja działa tak samo jak CLIP. Tekst nigdy nie zostanie przeniesiony do następnego wiersza, chyba że użytkownik ręcznie wstawia 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 reprezentuje starą strategię zawijania tekstu 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 stopniowo wycofywana. Przykład: 

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

Wiersze dłuższe niż szerokość komórki zostaną obcięte. Tekst nigdy nie zostanie przeniesiony do następnego wiersza, chyba że użytkownik ręcznie wstawia 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 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 hiperlink ma być renderowany w sposób jawny. Jeśli nie określisz tu żadnej wartości, hiperlink będzie aktywny.

Wartości w polu enum
LINKED Hiperlink powinien być wyraźnie renderowany.
PLAIN_TEXT Hiperlink nie powinien być renderowany.

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 zbiorczetype. Rodzaj obrotu: pionowy lub pod kątem. type może mieć tylko jedną z tych wartości:
angle

integer

Kąt między orientacją standardową a pożądaną. 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 kierunku tekstu od lewej do prawej kąty dodatnie są mierzone w kierunku przeciwnym do ruchu wskazówek zegara, a w przypadku kierunku tekstu od prawej do lewej – w kierunku zgodnym z ruchem wskazówek zegara.

vertical

boolean

Jeśli ma wartość true, 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 |

TextFormatRun

Ciąg formatu tekstowego. Format tego fragmentu jest kontynuowany do indeksu początkowego następnego fragmentu. Podczas aktualizacji należy ustawić wszystkie pola.

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

integer

Indeks znaku, od którego zaczyna się ten fragment, liczony od zera w jednostkach kodu UTF-16.

format

object (TextFormat)

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

DataValidationRule

regułę sprawdzania poprawności danych,

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

object (BooleanCondition)

Warunek, który muszą spełniać dane w komórce.

inputMessage

string

Komunikat, który ma być wyświetlany użytkownikowi podczas dodawania danych do komórki.

strict

boolean

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

showCustomUi

boolean

Wartość „true”, jeśli interfejs powinien być dostosowany do rodzaju warunku. Jeśli ma wartość true, warunki „Lista” będą wyświetlać menu.

DataSourceTable

Tabela źródła danych, która umożliwia użytkownikowi importowanie statycznej tabeli danych z DataSource do Arkuszy. W edytorze Arkuszy jest to funkcja „Wyodrębnij”.

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ódła danych.

columnSelectionType

enum (DataSourceTableColumnSelectionType)

Typ kolumn do wybrania w tabeli źródła danych. Domyślna wartość to SELECTED.

columns[]

object (DataSourceColumnReference)

Kolumny wybrane w tabeli źródła danych. Wartość columnSelectionType musi być równa SELECTED.

filterSpecs[]

object (FilterSpec)

Filtruj specyfikacje w tabeli źródła danych.

sortSpecs[]

object (SortSpec)

Posortuj specyfikacje w tabeli źródła danych. Wynik tabeli źródła danych jest sortowany na podstawie specyfikacji sortowania w odpowiedniej kolejności.

rowLimit

integer

Limit wierszy do zwrócenia. Jeśli nie zostanie skonfigurowany, zostanie zastosowany limit domyślny. Domyślny i maksymalny limit 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 Domyślny typ wyboru kolumn, nie używaj.
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ła źródła danych.

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

string

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

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

ChipRun

Uruchomienie elementu. Ciąg znaków trwa do indeksu początkowego następnego uruchomienia.

Zapis JSON 
{
  "startIndex": integer,
  "chip": {
    object (Chip)
  }
}
Pola
startIndex

integer

Wymagane. Indeks znaku, od którego zaczyna się ten fragment, liczony od zera w jednostkach kodu UTF-16.

chip

object (Chip)

Opcjonalnie. Element tego przejazdu.

Chip

Element inteligentny.

Zapis JSON 
{

  // Union field properties can be only one of the following:
  "personProperties": {
    object (PersonProperties)
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
  // End of list of possible types for union field properties.
}
Pola
Pole zbiorczeproperties. Właściwości komponentu. properties może mieć tylko jedną z tych wartości:
personProperties

object (PersonProperties)

Właściwości połączonej osoby.

PersonProperties

Właściwości powiązane z osobą.

Zapis JSON 
{
  "email": string,
  "displayFormat": enum (DisplayFormat)
}
Pola
email

string

Wymagane. Adres e-mail powiązany z tą osobą. To pole jest zawsze obecne.

displayFormat

enum (DisplayFormat)

Opcjonalnie. Format wyświetlania karty osoby. Jeśli nie zostanie skonfigurowany, używany będzie domyślny format wyświetlania.

DisplayFormat

Preferowany format wyświetlania, jeśli jest dostępny.

Wartości w polu enum
DISPLAY_FORMAT_UNSPECIFIED Wartość domyślna, nie używaj.
DEFAULT Domyślny format wyświetlania.
LAST_NAME_COMMA_FIRST_NAME Format wyświetlania nazwiska i imienia.
EMAIL Format wyświetlania adresu e-mail.

RichLinkProperties

Właściwości linku do zasobu Google (np. pliku na Dysku, filmu w YouTube, adresu w Mapach lub wydarzenia w Kalendarzu). W postaci elementów można zapisywać tylko pliki z Dysku. Wszystkie inne typy linków z elementami rozszerzonymi są tylko do odczytu.

Podczas zapisywania identyfikatory URI nie mogą przekraczać 2000 bajtów.

UWAGA: zapisywanie elementów plików na Dysku wymaga co najmniej jednego z tych zakresów OAuth: drive.file, drive.readonly lub drive.

Zapis JSON 
{
  "uri": string,
  "mimeType": string
}
Pola
uri

string

Wymagane. Identyfikator URI linku. Ta wartość jest zawsze obecna.

mimeType

string

Tylko dane wyjściowe. Typ MIME linku, jeśli taki istnieje (np. w przypadku pliku na Dysku).