Arkusz
Arkusz w arkuszu kalkulacyjnym.
Zapis JSON |
---|
{ "properties": { object ( |
Pola | |
---|---|
properties
|
Właściwości arkusza. |
data[]
|
Dane w siatce, jeśli jest to arkusz siatki.
Liczba zwróconych obiektów GridData zależy od liczby zakresów żądanych w tym arkuszu. Na przykład, jeśli jest to reprezentowane
Dla
|
merges[]
|
Zakresy, które zostały scalone. |
conditionalFormats[]
|
Reguły formatowania warunkowego w tym arkuszu. |
filterViews[]
|
Widoki filtrów w tym arkuszu. |
protectedRanges[]
|
Zakresy chronione w tym arkuszu. |
basicFilter
|
Filtr w tym arkuszu (jeśli taki istnieje). |
charts[]
|
Specyfikacje każdego wykresu w tym arkuszu. |
bandedRanges[]
|
Zakresy pasków (naprzemiennych kolorów) w tym arkuszu. |
developerMetadata[]
|
Metadane dewelopera powiązane z arkuszem. |
rowGroups[]
|
Wszystkie grupy wierszy w tym arkuszu uporządkowane według rosnącego indeksu początkowego zakresu, a następnie według głębokości grupy. |
columnGroups[]
|
Wszystkie grupy kolumn w tym arkuszu, uporządkowane według rosnącego indeksu początkowego zakresu, a następnie według głębokości grupy. |
slicers[]
|
Fragmentatory w tym arkuszu. |
SheetProperties
Właściwości arkusza.
Zapis JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Pola | |
---|---|
sheetId
|
Identyfikator arkusza. Wartość musi być nieujemna. Po ustawieniu tego pola nie można go zmienić. |
title
|
Nazwa arkusza. |
index
|
Indeks arkusza w arkuszu kalkulacyjnym. Jeśli podczas dodawania lub aktualizowania właściwości arkusza to pole zostanie wykluczone, arkusz zostanie dodany lub przeniesiony na koniec listy arkuszy. Podczas aktualizowania indeksów arkuszy lub wstawiania arkuszy ruch jest uwzględniany „przed przeniesieniem” indeksów. Jeśli na przykład istnieją 3 arkusze (S1, S2, S3), aby przesunąć S1 przed obszarem S2, indeks musiałby mieć wartość 2. Żądanie aktualizacji indeksu arkusza jest ignorowane, jeśli żądany indeks jest taki sam jak bieżący indeks arkusza lub jeśli żądany nowy indeks jest równy indeksowi bieżącego arkusza + 1. |
sheetType
|
Typ arkusza. Domyślna wartość to
|
gridProperties
|
Dodatkowe właściwości arkusza, jeśli jest on siatką. To pole będzie puste, jeśli arkusz zawiera wykres lub obraz. Podczas zapisywania ustawianie jakichkolwiek właściwości siatki w arkuszach innych niż siatka powoduje wystąpienie błędu.
Jeśli ten arkusz to
|
tabColor
|
Kolor karty w interfejsie. Wycofane: użyj
|
tabColorStyle
|
Kolor karty w interfejsie. Jeśli
|
rightToLeft
|
Wartość true, jeśli arkusz jest arkuszem RTL, a nie LTR. |
dataSourceSheetProperties
|
Tylko dane wyjściowe. Jeśli ta opcja jest dostępna, pole zawiera
|
SheetType
Rodzaj arkusza.
Wartości w polu enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Wartość domyślna, nie używaj. |
GRID
|
Arkusz jest siatką. |
OBJECT
|
Arkusz nie ma siatki, tylko zawiera obiekt, taki jak wykres lub obraz. |
DATA_SOURCE
|
Arkusz łączy się z zewnętrznym
DataSource
i wyświetla podgląd danych.
|
GridProperties
Właściwości siatki.
Zapis JSON |
---|
{ "rowCount": integer, "columnCount": integer, "frozenRowCount": integer, "frozenColumnCount": integer, "hideGridlines": boolean, "rowGroupControlAfter": boolean, "columnGroupControlAfter": boolean } |
Pola | |
---|---|
rowCount
|
Liczba wierszy w siatce. |
columnCount
|
Liczba kolumn w siatce. |
frozenRowCount
|
Liczba wierszy, które są zablokowane w siatce. |
frozenColumnCount
|
Liczba kolumn zablokowanych w siatce. |
hideGridlines
|
Prawda, jeśli siatka nie jest wyświetlana w interfejsie. |
rowGroupControlAfter
|
Prawda, jeśli przełącznik grupowania wierszy jest widoczny za grupą. |
columnGroupControlAfter
|
Prawda, jeśli przełącznik grupowania kolumn jest widoczny za grupą. |
DataSourceSheetProperties
Dodatkowe właściwości
DATA_SOURCE
arkusza kalkulacyjnego.
Zapis JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Pola | |
---|---|
dataSourceId
|
Identyfikator
|
columns[]
|
Kolumny wyświetlane w arkuszu, odpowiadające wartościom w
|
dataExecutionStatus
|
Stan wykonania danych. |
GridData
Dane w siatce oraz metadane dotyczące wymiarów.
Zapis JSON |
---|
{ "startRow": integer, "startColumn": integer, "rowData": [ { object ( |
Pola | |
---|---|
startRow
|
Pierwszy wiersz, do którego odnosi się ten obiekt GridData, liczony od zera. |
startColumn
|
Pierwsza kolumna, do której odnosi się ten obiekt GridData, liczona od zera. |
rowData[]
|
Dane w siatce, po 1 wpisie na wiersz, począwszy od wiersza w startRow. Wartości w RowData będą odpowiadać kolumnom rozpoczynającym się od
|
rowMetadata[]
|
Metadane dotyczące żądanych wierszy w siatce, począwszy od wiersza w
|
columnMetadata[]
|
Metadane dotyczące żądanych kolumn w siatce, począwszy od kolumny w
|
RowData
Dane dotyczące każdej komórki w wierszu.
Zapis JSON |
---|
{
"values": [
{
object (
|
Pola | |
---|---|
values[]
|
Wartości w wierszu, po jednej na kolumnę. |
DimensionProperties
Właściwości wymiaru.
Zapis JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Pola | |
---|---|
pixelSize
|
Wysokość (wiersz) lub szerokość (w przypadku kolumny) wymiaru w pikselach. |
developerMetadata[]
|
Metadane dewelopera powiązane z pojedynczym wierszem lub pojedynczą kolumną. |
dataSourceColumnReference
|
Tylko dane wyjściowe. Jeśli jest ustawiona, jest to kolumna w arkuszu źródła danych. |
ConditionalFormatRule
Reguła opisująca format warunkowy.
Zapis JSON |
---|
{ "ranges": [ { object ( |
Pola | |
---|---|
ranges[]
|
Zakresy sformatowane, jeśli warunek jest prawdziwy. Wszystkie zakresy muszą znajdować się w tej samej siatce. |
Pole sumy
rule Reguła kontroluje ten format warunkowy – należy ustawić dokładnie jeden taki format.
rule
może być tylko jednym z tych elementów:
|
|
booleanRule
|
format jest „włączony”, lub „wyłącz” zgodnie z regułą. |
gradientRule
|
Formatowanie będzie się różnić w zależności od gradientów w regule. |
BooleanRule
Reguła, która może pasować lub nie, w zależności od warunku.
Zapis JSON |
---|
{ "condition": { object ( |
Pola | |
---|---|
condition
|
Warunek reguły. Jeśli warunek ma wartość Prawda, format jest stosowany. |
format
|
Format, który ma zostać zastosowany. Formatowanie warunkowe można stosować tylko w przypadku niektórych formatów:
|
GradientRule
Reguła, która stosuje format skali gradientu kolorów na podstawie wymienionych punktów interpolacji. Format komórki będzie różnić się w zależności od jej zawartości w porównaniu z wartościami punktów interpolacji.
Zapis JSON |
---|
{ "minpoint": { object ( |
Pola | |
---|---|
minpoint
|
Początkowy punkt interpolacji. |
midpoint
|
Opcjonalny środkowy punkt interpolacji. |
maxpoint
|
Ostatni punkt interpolacji. |
InterpolationPoint
Pojedynczy punkt interpolacji w formacie warunkowym gradientu. Przypinają skalę gradientu odpowiednio do wybranego koloru, typu i wartości.
Zapis JSON |
---|
{ "color": { object ( |
Pola | |
---|---|
color
|
Kolor, którego ma używać ten punkt interpolacji. Wycofane: użyj
|
colorStyle
|
Kolor, którego ma używać ten punkt interpolacji. Jeśli
|
type
|
Sposób interpretacji tej wartości. |
value
|
Wartość używana przez ten punkt interpolacji. Może to być formuła. Nieużywane, jeśli:
|
InterpolationPointType
Rodzaj punktu interpolacji.
Wartości w polu enum | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Wartość domyślna – nie używaj. |
MIN
|
Punkt interpolacji wykorzystuje minimalną wartość w komórkach w zakresie formatu warunkowego. |
MAX
|
Punkt interpolacji wykorzystuje maksymalną wartość w komórkach w zakresie formatu warunkowego. |
NUMBER
|
Punkt interpolacji wykorzystuje dokładnie wartość w argumencie
InterpolationPoint.value
|
PERCENT
|
Punkt interpolacji to określona wartość procentowa względem wszystkich komórek w zakresie formatu warunkowego. Jest to odpowiednik
|
PERCENTILE
|
Punkt interpolacji to dany percentyl na wszystkich komórkach w zakresie formatu warunkowego. Jest to odpowiednik
NUMBER
jeśli wartość to:
=PERCENTILE(FLATTEN(range), value / 100)
(gdzie błędy w zakresie są ignorowane podczas powiększania).
|
FilterView
Widok filtra.
Zapis JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Pola | |
---|---|
filterViewId
|
Identyfikator widoku filtra. |
title
|
Nazwa widoku filtra. |
range
|
Zakres uwzględniany w tym widoku filtra.
Podczas pisania tylko jedno z nich
|
namedRangeId
|
Nazwany zakres (jeśli istnieje) powiązany z tym widokiem filtra.
Podczas pisania tylko jedno z nich
|
sortSpecs[]
|
Kolejność sortowania według kolumny. Późniejsze specyfikacje są używane, gdy wartości są takie same jak we wcześniejszych specyfikacjach. |
criteria
|
Kryteria wyświetlania/ukrywania wartości na kolumnę. Kluczem mapy jest indeks kolumny, a wartość stanowi kryterium tej kolumny.
To pole zostało wycofane i zastąpione
|
filterSpecs[]
|
Kryteria filtrowania wartości według kolumny.
Obie opcje
|
ProtectedRange
Zakres chroniony.
Zapis JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Pola | |
---|---|
protectedRangeId
|
Identyfikator zakresu chronionego. To pole jest tylko do odczytu. |
range
|
Chroniony zakres. Zakres może być w pełni nieograniczony i w takim przypadku jest on uważany za arkusz chroniony.
Podczas pisania tylko jedno z nich
|
namedRangeId
|
Nazwany zakres (jeśli taki istnieje).
Podczas pisania tylko jedno z nich
|
description
|
Opis tego zakresu chronionego. |
warningOnly
|
Wartość prawda, jeśli podczas edycji ten zakres chroniony będzie wyświetlał ostrzeżenie. Ochrona oparta na ostrzeżeniach oznacza, że każdy użytkownik może edytować dane z zakresu chronionego. Wyjątkiem jest sytuacja, gdy podczas edycji pojawi się ostrzeżenie z prośbą o potwierdzenie zmiany.
Podczas zapisu: jeśli to pole jest prawdziwe, wówczas
|
requestingUserCanEdit
|
Prawda, jeśli użytkownik, który zażądał tego zakresu chronionego, może go edytować. To pole jest tylko do odczytu. |
unprotectedRanges[]
|
Lista niechronionych zakresów w chronionym arkuszu. Niechronione zakresy są obsługiwane tylko w przypadku chronionych arkuszy. |
editors
|
Użytkownicy i grupy z uprawnieniami do edycji zakresu chronionego. To pole jest widoczne tylko dla użytkowników z uprawnieniami do edycji zakresu chronionego i dokumentu. Edytorzy nie są obsługiwani w usługach
|
Edytujący
Osoby edytujące zakres chroniony.
Zapis JSON |
---|
{ "users": [ string ], "groups": [ string ], "domainUsersCanEdit": boolean } |
Pola | |
---|---|
users[]
|
Adresy e-mail użytkowników z uprawnieniami do edycji zakresu chronionego. |
groups[]
|
Adresy e-mail grup z uprawnieniami do edycji zakresu chronionego. |
domainUsersCanEdit
|
Prawda, jeśli każda osoba w domenie dokumentu ma uprawnienia do edycji zakresu chronionego. Ochrona domeny jest obsługiwana tylko w przypadku dokumentów w domenie. |
BasicFilter
Domyślny filtr powiązany z arkuszem.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres objęty filtrem. |
sortSpecs[]
|
Kolejność sortowania według kolumny. Późniejsze specyfikacje są używane, gdy wartości są takie same jak we wcześniejszych specyfikacjach. |
criteria
|
Kryteria wyświetlania/ukrywania wartości na kolumnę. Kluczem mapy jest indeks kolumny, a wartość stanowi kryterium tej kolumny.
To pole zostało wycofane i zastąpione
|
filterSpecs[]
|
Liczba kryteriów filtrowania na kolumnę.
Obie opcje
|
BandedRange
Zakres paskowy (naprzemienny) w arkuszu.
Zapis JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Pola | |
---|---|
bandedRangeId
|
Identyfikator zakresu. |
range
|
Zakres, w którym stosowane są te właściwości. |
rowProperties
|
Właściwości pasm wierszy. Właściwości te są stosowane pojedynczo do wszystkich wierszy w zakresie. Co najmniej jedna z tych wartości:
|
columnProperties
|
Właściwości pasm kolumn. Te właściwości są stosowane we wszystkich kolumnach w zakresie, kolumna po kolumnie. Co najmniej jedna z tych wartości:
|
BandingProperties
Usługi, które odwołują się do jednego wymiaru (wiersza lub kolumny). Jeśli oba
BandedRange.row_properties
oraz
BandedRange.column_properties
kolory wypełnienia zostaną zastosowane do komórek zgodnie z następującymi regułami:
-
headerColor
orazfooterColor
mają wyższy priorytet niż kolory pasków. -
firstBandColor
ma wyższy priorytet niżsecondBandColor
-
rowProperties
ma wyższy priorytet niżcolumnProperties
Na przykład kolor pierwszego wiersza ma pierwszeństwo przed kolorem pierwszej kolumny, a kolor pierwszej kolumny ma pierwszeństwo przed kolorem drugiego wiersza. Podobnie nagłówek wiersza ma wyższy priorytet niż nagłówek kolumny w lewej górnej komórce, ale nagłówek kolumny ma wyższy priorytet niż kolor pierwszego wiersza, jeśli nie został on ustawiony.
Zapis JSON |
---|
{ "headerColor": { object ( |
Pola | |
---|---|
headerColor
|
Kolor pierwszego wiersza lub pierwszej kolumny. Jeśli to pole jest skonfigurowane, pierwszy wiersz lub pierwszy wiersz jest wypełniany tym kolorem, a kolory są zmieniane
|
headerColorStyle
|
Kolor pierwszego wiersza lub pierwszej kolumny. Jeśli to pole jest skonfigurowane, pierwszy wiersz lub pierwszy wiersz jest wypełniany tym kolorem, a kolory są zmieniane
|
firstBandColor
|
Pierwszy kolor, który jest naprzemienny. (Wymagane) Wycofane: użyj
|
firstBandColorStyle
|
Pierwszy kolor, który jest naprzemienny. (Wymagane) Jeśli
|
secondBandColor
|
Drugi kolor, który jest naprzemienny. (Wymagane) Wycofane: użyj
|
secondBandColorStyle
|
Drugi kolor, który jest naprzemienny. (Wymagane) Jeśli
|
footerColor
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest skonfigurowane, w ostatnim wierszu lub kolumnie znajduje się albo
|
footerColorStyle
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest skonfigurowane, w ostatnim wierszu lub kolumnie znajduje się albo
|
DimensionGroup
Grupa w określonym przedziale wierszy lub kolumn w arkuszu. Może ona zawierać inne grupy lub być w nich zawarte. Grupę można zwinąć lub rozwinąć jako jednostkę w arkuszu.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres, w którym istnieje ta grupa. |
depth
|
Głębokość grupy, wskazująca, ile grup ma zakres, który w całości obejmuje zakres tej grupy. |
collapsed
|
To pole ma wartość true (prawda), jeśli ta grupa jest zwinięta. Zwinięta grupa pozostaje zwinięta, jeśli nakładająca się grupa na mniejszej głębokości jest rozwinięta. Wartość prawda nie oznacza, że wszystkie wymiary w grupie są ukryte, ponieważ widoczność wymiaru może się zmieniać niezależnie od właściwości grupy. Jednak po zaktualizowaniu tej właściwości wszystkie zawarte w niej wymiary zostaną ustawione jako ukryte, jeśli to pole ma wartość Prawda, lub ustawione na widoczne, jeśli to pole ma wartość Fałsz. |
Filtr
Fragmentator w arkuszu.
Zapis JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Pola | |
---|---|
slicerId
|
Identyfikator fragmentatora. |
spec
|
Specyfikacja fragmentatora. |
position
|
Położenie fragmentatora. Pamiętaj, że fragmentator można umieścić tylko w istniejącym arkuszu. Ponadto szerokość i wysokość fragmentatora mogą być automatycznie dostosowywane w taki sposób, aby mieściły się w dozwolonych granicach. |
SlicerSpec
Specyfikacje fragmentatora.
Zapis JSON |
---|
{ "dataRange": { object ( |
Pola | |
---|---|
dataRange
|
Zakres danych fragmentatora. |
filterCriteria
|
Kryteria filtrowania fragmentatora. |
columnIndex
|
Indeks kolumny liczony od zera w tabeli danych, do której zastosowano filtr. |
applyToPivotTables
|
Wartość prawda, jeśli filtr powinien być stosowany do tabel przestawnych. Jeśli zasada nie jest skonfigurowana, domyślną wartością jest
|
title
|
Tytuł fragmentatora. |
textFormat
|
Format tekstowy tytułu we fragmentatorze. Pole linku nie jest obsługiwane. |
backgroundColor
|
Kolor tła fragmentatora. Wycofane: użyj
|
backgroundColorStyle
|
Kolor tła fragmentatora. Jeśli
|
horizontalAlignment
|
Wyrównanie tytułu we fragmentatorze w poziomie. Jeśli nie określono inaczej, domyślna wartość to
|