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 występuje tu wartość
W przypadku arkusza |
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 (jeśli istnieje) na tym arkuszu. |
charts[]
|
Specyfikacje każdego wykresu w tym arkuszu. |
bandedRanges[]
|
Pasma (alternatywne) mają zakres zakresowy dla tego arkusza. |
developerMetadata[]
|
Metadane dewelopera powiązane z arkuszem. |
rowGroups[]
|
Wszystkie grupy wierszy w tym arkuszu posortowane według rosnącego indeksu początkowego zakresu, a następnie według głębokości grupy. |
columnGroups[]
|
Wszystkie grupy kolumn w tym arkuszu posortowane według rosnącego indeksu początkowego zakresu, a następnie według głębokości grupy. |
slicers[]
|
Fragmentatory na tym arkuszu. |
Właściwości arkusza
Właściwości arkusza.
Zapis JSON |
---|
{ "sheetId": integer, "title": string, "index": integer, "sheetType": enum ( |
Pola | |
---|---|
sheetId
|
Identyfikator arkusza. Wartość nie może być liczbą ujemną. Tego ustawienia nie można zmienić po ustawieniu. |
title
|
Nazwa arkusza. |
index
|
Indeks arkusza w arkuszu kalkulacyjnym. Jeśli podczas dodawania lub aktualizowania właściwości arkusza usuniesz to pole, arkusz zostanie dodany lub przeniesiony na koniec listy arkuszy. Podczas aktualizowania indeksów i wstawiania arkuszy ruch jest uwzględniany w indeksie „przed przeniesieniem”. Jeśli na przykład mamy trzy arkusze (S1, S2, S3), aby przenieść pozycję S1 przed nią, indeks musi zostać ustawiony na 2. Żądanie aktualizacji indeksu arkusza jest ignorowane, jeśli żądany indeks jest taki sam jak bieżący indeks Arkuszy lub jeśli żądany indeks jest równy obecnemu 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 obiektów zawierającym wykres lub obraz, nie zostanie podane to pole. Podczas zapisywania właściwości siatki w arkuszach innych niż siatka jest błąd.
Jeśli ten arkusz jest arkuszem |
tabColor
|
Kolor karty w interfejsie. Wycofano: użyj właściwości |
tabColorStyle
|
Kolor karty w interfejsie. Jeśli ustawiona jest też wartość |
rightToLeft
|
Prawda, jeśli arkusz jest arkuszem RTL zamiast arkusza LTR. |
dataSourceSheetProperties
|
Tylko dane wyjściowe. Jeśli występuje, pole zawiera właściwości charakterystyczne dla |
Typ arkusza
Rodzaj arkusza.
Wartości w polu enum | |
---|---|
SHEET_TYPE_UNSPECIFIED
|
Wartość domyślna, nie używać. |
GRID
|
Arkusz jest siatką. |
OBJECT
|
Arkusz nie ma siatki, a zawiera obiekt taki jak wykres lub obraz. |
DATA_SOURCE
|
Arkusz łączy się z zewnętrznym narzędziem DataSource i wyświetla podgląd danych.
|
Właściwości siatki
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
|
Wartość to „true”, jeśli siatka nie wyświetla linii siatki w interfejsie. |
rowGroupControlAfter
|
Wartość to „prawda”, jeśli za grupą jest wyświetlany przełącznik grupowania wierszy. |
columnGroupControlAfter
|
Wartość to „prawda”, jeśli za grupą widać przełącznik grupowania kolumn. |
Właściwości DataSourceSheet
Dodatkowe właściwości arkusza DATA_SOURCE
.
Zapis JSON |
---|
{ "dataSourceId": string, "columns": [ { object ( |
Pola | |
---|---|
dataSourceId
|
Identyfikator elementu |
columns[]
|
Kolumny w arkuszu odpowiadające wartościom w |
dataExecutionStatus
|
Stan wykonania danych. |
Dane siatki
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ę GridData, zera. |
startColumn
|
Pierwsza kolumna, do której odwołuje się GridData, zera. |
rowData[]
|
Dane w siatce, po jednym w wierszu, zaczynając od wiersza w wierszu startRow. Wartości w wierszach danych odpowiadają kolumnom, począwszy 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 |
Dane wiersza
Dane o każdej komórce z rzędu.
Zapis JSON |
---|
{
"values": [
{
object (
|
Pola | |
---|---|
values[]
|
Wartości w wierszu, po jednej w każdej kolumnie. |
Właściwości wymiaru
Właściwości dotyczące wymiaru.
Zapis JSON |
---|
{ "hiddenByFilter": boolean, "hiddenByUser": boolean, "pixelSize": integer, "developerMetadata": [ { object ( |
Pola | |
---|---|
pixelSize
|
Wysokość (w wierszu) lub szerokość (w kolumnie) wymiaru w pikselach. |
developerMetadata[]
|
Metadane dewelopera powiązane z jednym wierszem lub pojedynczą kolumną. |
dataSourceColumnReference
|
Tylko dane wyjściowe. Jeśli jest ustawiona, to jest kolumna w arkuszu źródła danych. |
Reguła warunkowa
Reguła określają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 . Należy ustawić regułę kontrolującą ten format warunkowy.
rule może być tylko jedną z tych wartości:
|
|
booleanRule
|
Formatowanie jest zgodnie z regułą włączone lub wyłączone. |
gradientRule
|
Formatowanie będzie się różnić w zależności od gradientu w regule. |
Wartość logiczna
Reguła, która może (ale nie musi) pasować do warunku.
Zapis JSON |
---|
{ "condition": { object ( |
Pola | |
---|---|
condition
|
Warunek reguły. Jeśli warunek zostanie spełniony, zostanie zastosowany format. |
format
|
Format, który chcesz zastosować. Formatowanie warunkowe może stosować tylko niektóre formatowanie: |
Reguła gradientu
Reguła, która stosuje format skali kolorów gradientu na podstawie wymienionych wyżej punktów interpolacji. Format komórki zależy od jej zawartości w porównaniu z wartościami interpolacji.
Zapis JSON |
---|
{ "minpoint": { object ( |
Pola | |
---|---|
minpoint
|
Punkt początkowy interpolacji. |
midpoint
|
Opcjonalny punkt pośredni. |
maxpoint
|
Ostatni punkt interpolacji. |
Punkt interpolacyjny
Jeden punkt interpolacji na formacie warunkowym gradientu. Przypinają skalę kolorów gradientu zgodnie z wybranym kolorem, typem i wartością.
Zapis JSON |
---|
{ "color": { object ( |
Pola | |
---|---|
color
|
Kolor, którego powinien używać ten punkt interpolacji. Wycofano: użyj właściwości |
colorStyle
|
Kolor, którego powinien używać ten punkt interpolacji. Jeśli ustawiona jest też wartość |
type
|
Sposób interpretacji wartości. |
value
|
Wartość używana przez ten punkt interpolacji. Może to być formuła. Nieużywana, jeśli |
InterpolationPointType
Rodzaj punktu interpolacji.
Wartości w polu enum | |
---|---|
INTERPOLATION_POINT_TYPE_UNSPECIFIED
|
Wartość domyślna – nie używaj. |
MIN
|
Punkt interpolacji używa minimalnej wartości w komórkach w zakresie formatu warunkowego. |
MAX
|
Punkt interpolacyjny wykorzystuje maksymalną wartość w komórkach komórek w zakresie formatu warunkowego. |
NUMBER
|
Punkt interpolacyjny używa dokładnie tej wartości: InterpolationPoint.value .
|
PERCENT
|
Punkt interpolacji to podany odsetek wszystkich komórek w zakresie formatu warunkowego. Odpowiada to polu |
PERCENTILE
|
Punkt interpolacji to centyli wszystkich komórek w zakresie formatu warunkowego. Odpowiada to polu NUMBER , jeśli wartość była: =PERCENTILE(FLATTEN(range), value / 100) (gdzie podczas spłaszczania są ignorowane błędy w zakresie).
|
Widok filtra
Widok filtra
Zapis JSON |
---|
{ "filterViewId": integer, "title": string, "range": { object ( |
Pola | |
---|---|
filterViewId
|
Identyfikator widoku filtra. |
title
|
Nazwa widoku filtra. |
range
|
Zakres, jaki obejmuje ten widok filtra.
Podczas zapisu można ustawić tylko jedną wartość |
namedRangeId
|
Zakres nazwany, którym podlega ten widok filtra.
Podczas zapisu można ustawić tylko jedną wartość |
sortSpecs[]
|
Kolejność sortowania na kolumnę. Specyfikacje te są używane później, gdy wartości są takie same we wcześniejszych specyfikacjach. |
criteria
|
Kryteria wyświetlania/ukrywania wartości w poszczególnych kolumnach. Kluczem mapy jest indeks kolumny, a wartość jest kryteriami dla tej kolumny.
To pole jest wycofane i zastąpione polem |
filterSpecs[]
|
Kryteria filtrowania dla wyświetlania/ukrywania wartości na kolumnę.
Zarówno odpowiedzi |
Chroniony zakres
Zakres chroniony.
Zapis JSON |
---|
{ "protectedRangeId": integer, "range": { object ( |
Pola | |
---|---|
protectedRangeId
|
Identyfikator zakresu chronionego. To pole jest tylko do odczytu. |
range
|
Zakres chroniony. Zakres może być całkowicie nieograniczony. W takim przypadku jest to arkusz chroniony.
Podczas zapisu można ustawić tylko jedną wartość |
namedRangeId
|
Zakres nazwany, dla którego jest obsługiwany ten chroniony zakres (jeśli istnieje).
Podczas zapisu można ustawić tylko jedną wartość |
description
|
Opis tego chronionego zakresu. |
warningOnly
|
Wartość to „prawda”, jeśli w tym chronionym zakresie wyświetlane są ostrzeżenia podczas edytowania. Ochrona oparta na ostrzeżeniach oznacza, że każdy użytkownik może edytować dane w chronionym zakresie. Wyjątkiem jest edytowanie, w którym wyświetla się ostrzeżenie z prośbą o potwierdzenie zmiany.
Podczas zapisywania: jeśli to pole ma wartość Prawda, |
requestingUserCanEdit
|
Wartość to „prawda”, jeśli użytkownik, który wysłał żądanie tego chronionego zakresu, może go edytować. To pole jest tylko do odczytu. |
unprotectedRanges[]
|
Lista niechronionych zakresów w chronionym arkuszu. Zakresy niechronione są obsługiwane tylko w arkuszach chronionych. |
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. Edytory nie są obsługiwane przy użyciu zabezpieczenia |
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 uprawnieniami do edycji zakresu chronionego. |
domainUsersCanEdit
|
Wartość to „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 znajdujących się w domenie. |
Filtr podstawowy
Domyślny filtr powiązany z arkuszem.
Zapis JSON |
---|
{ "range": { object ( |
Pola | |
---|---|
range
|
Zakres obejmujący filtr. |
sortSpecs[]
|
Kolejność sortowania na kolumnę. Specyfikacje te są używane później, gdy wartości są takie same we wcześniejszych specyfikacjach. |
criteria
|
Kryteria wyświetlania/ukrywania wartości w poszczególnych kolumnach. Kluczem mapy jest indeks kolumny, a wartość jest kryteriami dla tej kolumny.
To pole jest wycofane i zastąpione polem |
filterSpecs[]
|
Kryteria filtrowania na kolumnę.
Zarówno odpowiedzi |
Zakres pasma
Pasmo (zakres kolorów) w arkuszu.
Zapis JSON |
---|
{ "bandedRangeId": integer, "range": { object ( |
Pola | |
---|---|
bandedRangeId
|
Identyfikator zakresu pasma. |
range
|
Zakres, w którym stosowane są te właściwości. |
rowProperties
|
Właściwości pasków wierszy. Właściwości te są stosowane wiersz po wierszu we wszystkich wierszach w zakresie. Musisz określić co najmniej jedną z tych właściwości: |
columnProperties
|
Właściwości dotyczące pasm kolumnowych. Właściwości te są stosowane po kolei we wszystkich kolumnach w zakresie. Musisz określić co najmniej jedną z tych właściwości: |
Właściwości pasma
Właściwości odwołujące się do jednego wymiaru (wiersza lub kolumny). Jeśli ustawiona jest zarówno wartość BandedRange.row_properties
, jak i BandedRange.column_properties
, kolory wypełnienia zostaną zastosowane 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
. -
rowProperties
ma wyższy priorytet niżcolumnProperties
.
Na przykład kolor pierwszego wiersza ma wyższy priorytet niż pierwszy, a kolor drugiego. Podobnie nagłówek wiersza ma wyższy priorytet niż nagłówek kolumny w lewej górnej komórce, ale jeśli nagłówek wiersza nie jest ustawiony, priorytet ma kolor pierwszego wiersza.
Zapis JSON |
---|
{ "headerColor": { object ( |
Pola | |
---|---|
headerColor
|
Kolor pierwszego wiersza lub kolumny. Jeśli to pole jest ustawione, pierwszy wiersz lub kolumna jest wypełniona tym kolorem, a kolory z zakresu od |
headerColorStyle
|
Kolor pierwszego wiersza lub kolumny. Jeśli to pole jest ustawione, pierwszy wiersz lub kolumna jest wypełniona tym kolorem, a kolory z zakresu od |
firstBandColor
|
Pierwszy kolor naprzemiennie. (Wymagane) Wycofane: użyj interfejsu |
firstBandColorStyle
|
Pierwszy kolor naprzemiennie. (Wymagane) Jeśli ustawiona jest też wartość |
secondBandColor
|
Drugi kolor, który jest naprzemiennie. (Wymagane) Wycofane: użyj interfejsu |
secondBandColorStyle
|
Drugi kolor, który jest naprzemiennie. (Wymagane) Jeśli ustawiona jest też wartość |
footerColor
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna zawiera wartość |
footerColorStyle
|
Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna zawiera wartość |
Grupa wymiarów
Grupa na osi czasu z wierszami lub kolumnami w arkuszu, która może zawierać lub należeć do innych grup. Grupę możesz zwinąć lub rozwinąć jako jednostkę arkusza.
Zapis JSON |
---|
{
"range": {
object (
|
Pola | |
---|---|
range
|
Zakres, w którym istnieje ta grupa. |
depth
|
Głębokość grupy reprezentująca zakres grup, które w całości zawiera zakres tej grupy. |
collapsed
|
To pole ma wartość true (prawda), jeśli grupa jest zwinięta. Zwinięta grupa pozostaje zwinięta, jeśli nakładająca się grupa na płytką głębokość jest rozwinięta. Wartość prawdziwa nie oznacza, że wszystkie wymiary w grupie są ukryte, bo widoczność wymiaru może się zmieniać niezależnie od tej właściwości grupy. Jednak w przypadku aktualizacji tej właściwości wszystkie wymiary znajdujące się w jej polu zostaną ukryte, jeśli to pole jest prawdziwe, lub ustawione jako widoczne, jeśli to pole jest fałszywe. |
Filtr
Fragmentator w arkuszu.
Zapis JSON |
---|
{ "slicerId": integer, "spec": { object ( |
Pola | |
---|---|
slicerId
|
Identyfikator fragmentatora. |
spec
|
Specyfikacja fragmentatora. |
position
|
Pozycja fragmentatora. Fragmentator można umieścić tylko w istniejącym arkuszu. Szerokość i wysokość fragmentatora mogą być automatycznie dostosowywane tak, by nie przekraczały dozwolonych limitów. |
Specyfikacja fragmentatora
Parametry fragmentatora.
Zapis JSON |
---|
{ "dataRange": { object ( |
Pola | |
---|---|
dataRange
|
Zakres danych fragmentatora. |
filterCriteria
|
Kryteria filtrowania fragmentatora. |
columnIndex
|
Indeks kolumny opartej na zerach w tabeli danych, do której zastosowano filtr. |
applyToPivotTables
|
Wartość „prawda”, jeśli filtr powinien być stosowany do tabel przestawnych. Jeśli nie skonfigurujesz tej zasady, domyślnie zostanie użyta wartość |
title
|
Tytuł fragmentatora. |
textFormat
|
Format tekstu we fragmentatorze. Pole linku nie jest obsługiwane. |
backgroundColor
|
Kolor tła fragmentatora. Wycofano: użyj właściwości |
backgroundColorStyle
|
Kolor tła fragmentatora. Jeśli ustawiona jest też wartość |
horizontalAlignment
|
Wyrównanie tytułu w fragmentatorze w poziomie. Jeśli wartość nie została określona, przyjmuje wartość domyślną
|