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)
  },
  "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/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 wartość obliczona. 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ść komórki sformatowana. Jest to 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)

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

wszelkie notatki dotyczące komórki;

textFormatRuns[]

object (TextFormatRun)

Fragmenty tekstu sformatowanego zastosowane do podkomórek 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 odziedziczą właściwości komórki.

Podczas zapisywania nowe przebiegi zastąpią wszystkie poprzednie. Podczas zapisywania nowego pliku userEnteredValue poprzednie uruchomienia zostaną usunięte.

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 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 jakiegoś arkusza w arkuszu DATA_SOURCE, np. =SUM(DataSheet!Column).

chipRuns[]

object (ChipRun)

Opcjonalnie. Elementy w elementach podrzędnych komórki. Właściwości przebiegu zaczynają się od określonego indeksu w tekście i trwają do następnego przebiegu.

Podczas odczytu uwzględniane są wszystkie przebiegi z użyciem chipa i bez niego. W przypadku biegów bez chipów Chip będzie pusty.

Podczas zapisywania uwzględniane są tylko serie z udziałem żetonów. Sekwencje zawierające elementy mają długość 1 i są reprezentowane w tekstach wpisywanych przez użytkownika za pomocą symbolu zastępczego „@”. Nowe uruchomienia zastąpią wszystkie poprzednie. Zapisywanie nowego userEnteredValuespowoduje 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 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 backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor tła komórki. Jeśli ustawiona jest też zasada backgroundColor, to ona 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 wartości w komórce w pionie.

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 został zastąpiony przez formatowanie w ramach sesji 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 zapisywania to pole musi być ustawione.

pattern

string

Ciąg znaków wzoru używany do formatowania. Jeśli nie zostanie ustawiony, w razie potrzeby w przypadku danego typu będzie używany domyślny wzór oparty na ustawieniach języka 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 procentów, 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 naukowych, 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 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. Wycofane. 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 pole 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 jest cienką, ciągłą linią.
SOLID_MEDIUM Obwód jest średniej grubości i ciągły.
SOLID_THICK Obramowanie jest grubą, ciągłą linią.
NONE Bez obramowania. Używany tylko podczas aktualizowania obramowania w celu jego wymazania.
DOUBLE Obrzeże składa się z 2 ciągłych linii.

Dopełnienie

Ilość wypełnień 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

Odstęp górny komórki.

right

integer

Prawy margines komórki.

bottom

integer

Dopełnienie komórki u dołu.

left

integer

Wypełnienie z lewej 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, której nie należy używać.
OVERFLOW_CELL

Linie 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 nie jest pusta, funkcja działa tak samo jak CLIP. Tekst nigdy nie zostanie przeniesiony na kolejny wiersz, 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 stosowanej 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 nigdy nie zostanie przeniesiony na kolejny wiersz, 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 hiperlink ma być wyrenderowany w prosty sposób. Jeśli nie określisz tego ustawienia, hiperlink będzie połączony.

Wartości w polu enum
LINKED Hiperlink powinien być wyraźnie renderowany.
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 pisanego od lewej do prawej dodatnie są kąty przeciwne do ruchu wskazówek zegara, a w przypadku tekstu pisanego od prawej do lewej – dodatnie są kąty zgodne z ruchem wskazówek zegara.

vertical

boolean

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

Przebieg formatu tekstu. 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, który musi być spełniony, aby dane w komórce były zgodne.

inputMessage

string

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

strict

boolean

Prawda, jeśli nieprawidłowe dane mają być odrzucane.

showCustomUi

boolean

Wartość true, jeśli interfejs użytkownika powinien być dostosowywany na podstawie rodzaju warunku. Jeśli ma wartość Prawda, warunki „Lista” będą wyświetlane w menu.

DataSourceTable

Tabela źródła danych, która umożliwia użytkownikowi zaimportowanie statycznej tabeli danych z DataSourcedo Arkuszy. 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)

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

filterSpecs[]

object (FilterSpec)

specyfikacje filtrów w tabeli źródeł danych,

sortSpecs[]

object (SortSpec)

Sortuj 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 nie zostanie ustawiona, zostanie zastosowany 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 za pomocą pola columns.
SYNC_ALL

Synchronizuj wszystkie obecne i przyszłe kolumny w źródle danych.

Jeśli to ustawienie jest ustawione, 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 powiązana jest formuła.

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

ChipRun

Uruchomienie elementu. Element działa do indeksu początkowego następnego przebiegu.

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

integer

Wymagane. Indeks znaku oparty na 0, w którym rozpoczyna się ten przebieg, w jednostkach kodu UTF-16.

chip

object (Chip)

Opcjonalnie. Element tego przebiegu.

Układ scalony

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 uniiproperties. Właściwości elementu. propertiesmoże być tylko jedną z tych wartości:
personProperties

object (PersonProperties)

Właściwości powiązanej osoby.

PersonProperties

Właściwości dotyczące powiązanej osoby.

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

string

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

displayFormat

enum (DisplayFormat)

Opcjonalnie. Format wyświetlania elementu dotyczącego osoby. Jeśli nie zostanie ustawiony, używany jest 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, której nie należy używać.
DEFAULT Domyślny format wyświetlania.
LAST_NAME_COMMA_FIRST_NAME Format wyświetlania imię i nazwisko.
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). Jako elementy można zapisywać tylko pliki z Dysku. Wszystkie pozostałe typy rozszerzonych linków są tylko do odczytu.

Adresy URI nie mogą przekraczać 2000 bajtów podczas zapisywania.

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

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

string

Wymagane. Identyfikator URI linku. Jest zawsze obecny.

mimeType

string

Tylko dane wyjściowe. Typ MIME linku, jeśli istnieje (np. gdy jest to plik na Dysku).