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. Jeśli na przykład reprezentuje on wartość
W przypadku arkusza |
merges[]
|
Zakresy, które zostały scalone. |
conditionalFormats[]
|
Reguły formatowania warunkowego w tym arkuszu. |
filterViews[]
|
Widoki filtra w tym arkuszu. |
protectedRanges[]
|
Zakresy chronione w tym arkuszu. |
basicFilter
|
Filtr w tym arkuszu (jeśli istnieje). |
charts[]
|
Specyfikacje każdego wykresu w tym arkuszu. |
bandedRanges[]
|
Pasmowe (naprzemienne kolory) zakresy na tym arkuszu. |
developerMetadata[]
|
Metadane dewelopera powiązane z arkuszem. |
rowGroups[]
|
Wszystkie grupy wierszy na 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[]
|
Segmentatory w tym arkuszu. |
SheetProperties
Właściwości arkusza.
Zapis JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Pola | |
---|---|
sheetId
|
Identyfikator arkusza. 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 jest wykluczone, arkusz jest dodawany lub przenoszony na koniec listy arkuszy. Podczas aktualizowania indeksów arkuszy lub wstawiania arkuszy ruch jest uwzględniany w indeksach „przed przeniesieniem”. Jeśli na przykład istnieją 3 arkusze (S1, S2, S3), aby przesunąć S1 przed obszarem S2, indeks musiałby mieć wartość 2. Prośba o aktualizację indeksu arkusza jest ignorowana, jeśli żądany indeks jest identyczny z bieżącym indeksem arkusza lub jeśli żądany nowy indeks jest równy bieżącemu indeksowi arkusza + 1. |
sheetType
|
Typ arkusza. Domyślna wartość to |
gridProperties
|
Dodatkowe właściwości arkusza, jeśli jest on siatką. (jeśli arkusz jest arkuszem obiektu zawierającym wykres lub obraz, to pole jest puste). Podczas pisania błędem jest ustawianie właściwości siatki na arkuszach niebędących siatką.
Jeśli ten arkusz jest arkuszem |
tabColor
|
Kolor karty w interfejsie. Wycofane: użyj |
tabColorStyle
|
Kolor karty w interfejsie. Jeśli skonfigurowano również |
rightToLeft
|
Wartość Prawda, jeśli arkusz jest arkuszem RTL, a nie LTR. |
dataSourceSheetProperties
|
Tylko dane wyjściowe. Jeśli to pole jest obecne, zawiera właściwości |
SheetType
Rodzaj arkusza.
Wartości w polu enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Wartość domyślna, której nie należy używać. |
GRID
|
Arkusz jest siatką. |
OBJECT
|
Arkusz nie ma siatki, a zamiast tego zawiera obiekt, np. 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 zablokowanych w siatce. |
frozenColumnCount
|
Liczba kolumn zablokowanych w siatce. |
hideGridlines
|
Prawda, jeśli siatka nie jest wyświetlana w interfejsie. |
rowGroupControlAfter
|
Wartość Prawda, jeśli przełącznik kontrolujący grupowanie wierszy jest wyświetlany po grupie. |
columnGroupControlAfter
|
Prawda, jeśli przełącznik grupowania kolumn jest widoczny za grupą. |
DataSourceSheetProperties
Dodatkowe właściwości arkusza DATA_SOURCE
.
Zapis JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Pola | |
---|---|
dataSourceId
|
Identyfikator jednostki |
columns[]
|
Kolumny wyświetlane w arkuszu, które odpowiadają 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 odwołuje się GridData, liczony od zera. |
startColumn
|
Pierwsza kolumna, do której odwołuje się GridData, liczona od zera. |
rowData[]
|
Dane w kratce, po jednym wpisie na wiersz, zaczynając od wiersza podanego w parametrze 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, zaczynając 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ść (jeśli jest to wiersz) lub szerokość (jeśli jest to kolumna) 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, które są formatowane, jeśli warunek jest prawdziwy. Wszystkie zakresy muszą znajdować się w tym samym układzie. |
Pole uniirule . Reguła kontrolująca to formatowanie warunkowe. Musi być ustawiona dokładnie jedna reguła.
rule może mieć tylko jedną z tych wartości:
|
|
booleanRule
|
Formatowanie jest włączone lub wyłączone 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 lub nie może pasować, w zależności od warunku.
Zapis JSON |
---|
{ "condition": { object ( |
Pola | |
---|---|
condition
|
Warunek reguły. Jeśli warunek jest prawdziwy, format jest stosowany. |
format
|
Format, który ma zostać zastosowany. W formatowaniu warunkowym można stosować tylko podzbiór formatowania: |
GradientRule
Reguła, która stosuje format skali kolorów gradientowych na podstawie wymienionych punktów interpolacji. Format komórki będzie się różnić w zależności od jej zawartości w porównaniu z wartościami punktów interpolacji.
Zapis JSON |
---|
{ "minpoint": { object ( |
Pola | |
---|---|
minpoint
|
Punkt początkowy interpolacji. |
midpoint
|
Opcjonalny punkt interpolacji pośredniej. |
maxpoint
|
Ostatni punkt interpolacji. |
InterpolationPoint
Pojedynczy punkt interpolacji w formacie warunkowym gradientu. Te elementy przypinają skalę kolorów gradientu zgodnie z wybranym kolorem, typem 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 ustawiona jest też zasada |
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, której nie należy używać. |
MIN
|
Punkt interpolacji używa minimalnej wartości w komórkach w zakresie formatu warunkowego. |
MAX
|
Punkt interpolacji wykorzystuje maksymalną wartość w komórkach w zakresie formatu warunkowego. |
NUMBER
|
Punkt interpolacji używa dokładnie wartości z InterpolationPoint.value .
|
PERCENT
|
Punkt interpolacji to podany odsetek wszystkich komórek w zakresie formatu warunkowego. Jest to odpowiednik funkcji |
PERCENTILE
|
Punkt interpolacji to dany percentyl na wszystkich komórkach w zakresie formatu warunkowego. Jest to odpowiednik funkcji NUMBER , jeśli wartość to: =PERCENTILE(FLATTEN(range), value / 100) (gdzie błędy zakresu 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 zapisywania można ustawić tylko jedną z opcji: |
namedRangeId
|
Nazwany zakres (jeśli istnieje) powiązany z tym widokiem filtra.
Podczas zapisywania można ustawić tylko jedną z opcji: |
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 w każdej kolumnie. Kluczem mapy jest indeks kolumny, a wartością są kryteria tej kolumny.
To pole jest wycofane i zastąpione |
filterSpecs[]
|
Kryteria filtrowania wartości według kolumny.
Zarówno |
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ć całkowicie nieograniczony, co oznacza, że jest to arkusz chroniony.
Podczas zapisywania można ustawić tylko jedną z tych wartości: |
namedRangeId
|
Nazwa zakresu nazwanego, który jest źródłem danych dla tego zakresu chronionego (jeśli istnieje).
Podczas zapisywania można ustawić tylko jedną z opcji: |
description
|
Opis tego zakresu chronionego. |
warningOnly
|
Prawda, jeśli podczas edytowania tego chronionego zakresu ma się wyświetlać ostrzeżenie. Ochrona oparta na ostrzeżeniach oznacza, że każdy użytkownik może edytować dane w zakresie chronionym, ale przed edycją pojawi się ostrzeżenie z prośbą o potwierdzenie.
Podczas zapisywania: jeśli to pole ma wartość true, |
requestingUserCanEdit
|
Wartość Prawda, jeśli użytkownik, który poprosił o ten zakres chroniony, może edytować chroniony obszar. To pole jest tylko do odczytu. |
unprotectedRanges[]
|
Lista niechronionych zakresów w chronionym arkuszu. Zakresy niechronione są obsługiwane tylko w przypadku chronionych arkuszy. |
editors
|
Użytkownicy i grupy z dostępem do edycji chronionego zakresu. To pole jest widoczne tylko dla użytkowników, którzy mają uprawnienia do edycji zakresu chronionego i dokumentu. Edytory nie są obsługiwane w przypadku ochrony |
Edytujący
Edytujący 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 dostępem do edycji zakresu chronionego; |
domainUsersCanEdit
|
Wartość Prawda, jeśli każdy użytkownik w domenie dokumentu ma uprawnienia do edycji chronionego zakresu. 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, który obejmuje filtr. |
sortSpecs[]
|
kolejność sortowania w każdej kolumnie, Późniejsze specyfikacje są używane, gdy wartości są równe w wcześniejszych specyfikacjach. |
criteria
|
Kryteria wyświetlania/ukrywania wartości w każdej kolumnie. Kluczem mapy jest indeks kolumny, a wartością są kryteria tej kolumny.
To pole zostało wycofane i zastąpione polem |
filterSpecs[]
|
Kryteria filtra na kolumnę.
Zarówno |
BandedRange
Zakres paskowy (naprzemienny) w arkuszu.
Zapis JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Pola | |
---|---|
bandedRangeId
|
Identyfikator zakresu z pasmami. |
range
|
Zakres, w którym właściwości te są stosowane. |
rowProperties
|
Właściwości pasm wierszy. Właściwości te są stosowane pojedynczo do wszystkich wierszy w zakresie. Musisz określić co najmniej jedną z tych właściwości: |
columnProperties
|
Właściwości pasm kolumn. Te właściwości są stosowane do poszczególnych kolumn w całym zakresie. Musisz określić co najmniej jedną z tych właściwości: |
BandingProperties
Właściwości odwołujące się do jednego wymiaru (wiersza lub kolumny). Jeśli ustawisz oba parametry, BandedRange.row_properties
i BandedRange.column_properties
, kolory wypełnienia będą stosowane do komórek zgodnie z tymi regułami:
-
headerColor
ifooterColor
mają wyższy priorytet niż kolory pasków. -
firstBandColor
ma wyższy priorytet niżsecondBandColor
. -
Komponent
rowProperties
ma wyższy priorytet niżcolumnProperties
.
Na przykład kolor pierwszego wiersza ma pierwszeństwo przed kolorem pierwszej kolumny, ale kolor pierwszej kolumny ma pierwszeństwo przed kolorem drugiego wiersza. Podobnie nagłówek wiersza ma pierwszeństwo nad nagłówkiem kolumny w komórce w lewym górnym rogu, ale nagłówek kolumny ma pierwszeństwo nad kolorem pierwszego wiersza, jeśli nagłówek wiersza nie jest ustawiony.
Zapis JSON |
---|
{ "headerColor": { object ( |
Pola | |
---|---|
headerColor
|
Kolor pierwszego wiersza lub pierwszej kolumny. Jeśli to pole jest ustawione, pierwszy wiersz lub pierwsza kolumna jest wypełniona tym kolorem, a od drugiego wiersza lub drugiej kolumny kolory się naprzemiennie zmieniają: |
headerColorStyle
|
Kolor pierwszego wiersza lub pierwszej kolumny. Jeśli to pole jest ustawione, pierwszy wiersz lub pierwsza kolumna jest wypełniona tym kolorem, a od drugiego wiersza lub drugiej kolumny kolory się naprzemiennie zmieniają: |
firstBandColor
|
Pierwszy kolor, który się zmienia. (Wymagany) Wycofane: użyj |
firstBandColorStyle
|
Pierwszy kolor, który jest naprzemienny. (Wymagany) Jeśli ustawiona jest też zasada |
secondBandColor
|
Drugi kolor naprzemienny. (Wymagany) Wycofane: użyj |
secondBandColorStyle
|
Drugi kolor naprzemienny. (Wymagany) Jeśli ustawiona jest też zasada |
footerColor
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna są wypełnione kolorem |
footerColorStyle
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna są wypełnione kolorem |
DimensionGroup
Grupa obejmująca zakres wierszy lub kolumn w arkuszu, która może zawierać inne grupy lub być przez nie zawierana. Grupę można zwinąć lub rozwinąć jako całość na arkuszu.
Zapis JSON |
---|
{
"range": {
object ( |
Pola | |
---|---|
range
|
Zakres, w którym istnieje ta grupa. |
depth
|
Głębokość grupy, czyli liczba grup, których zakres całkowicie zawiera zakres tej grupy. |
collapsed
|
To pole ma wartość true, jeśli grupa jest zwinięta. Zwinięta grupa pozostaje zwinięta, jeśli rozwinięta zostanie grupa nachodząca na nią na mniejszym poziomie. Wartość Prawda nie oznacza, że wszystkie wymiary w grupie są ukryte, ponieważ widoczność wymiaru może się zmieniać niezależnie od tej właściwości grupy. Jednak po zaktualizowaniu tej usługi wszystkie wymiary w niej są ustawiane na ukryte, jeśli to pole ma wartość true, lub na widoczne, jeśli ma wartość false. |
Slicer
Narzędzie Slicer w arkuszu.
Zapis JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Pola | |
---|---|
slicerId
|
Identyfikator krojarki. |
spec
|
Specyfikacja urządzenia do dzielenia. |
position
|
Położenie fragmentatora. Pamiętaj, że fragmentator można umieścić tylko w istniejącym arkuszu. Szerokość i wysokość sekcji można też automatycznie dostosowywać, aby mieściły się w dozwolonych granicach. |
SlicerSpec
Specyfikacje fragmentatora.
Zapis JSON |
---|
{ "dataRange": { object ( |
Pola | |
---|---|
dataRange
|
Zakres danych fragmentatora. |
filterCriteria
|
Kryteria filtrowania w slicerze. |
columnIndex
|
Indeks kolumny liczony od zera w tabeli danych, do której zastosowano filtr. |
applyToPivotTables
|
Wartość Prawda, jeśli filtr ma być stosowany do tabel przestawnych. Jeśli nie zostanie ustawiony, domyślnie zostanie użyta wartość |
title
|
Tytuł narzędzia do wycinania. |
textFormat
|
Format tekstu tytułu w osi. Pole link nie jest obsługiwane. |
backgroundColor
|
Kolor tła narzędzia do dzielenia. Wycofane: użyj |
backgroundColorStyle
|
Kolor tła narzędzia do dzielenia. Jeśli skonfigurowano również |
horizontalAlignment
|
Wyrównanie tytułu we fragmentatorze w poziomie. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna |