Sheets

Arkusz

Arkusz w arkuszu kalkulacyjnym.

Zapis JSON
{
  "properties": {
    object (SheetProperties)
  },
  "data": [
    {
      object (GridData)
    }
  ],
  "merges": [
    {
      object (GridRange)
    }
  ],
  "conditionalFormats": [
    {
      object (ConditionalFormatRule)
    }
  ],
  "filterViews": [
    {
      object (FilterView)
    }
  ],
  "protectedRanges": [
    {
      object (ProtectedRange)
    }
  ],
  "basicFilter": {
    object (BasicFilter)
  },
  "charts": [
    {
      object (EmbeddedChart)
    }
  ],
  "bandedRanges": [
    {
      object (BandedRange)
    }
  ],
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "rowGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "columnGroups": [
    {
      object (DimensionGroup)
    }
  ],
  "slicers": [
    {
      object (Slicer)
    }
  ]
}
Pola
properties

object (SheetProperties)

Właściwości arkusza.

data[]

object (GridData)

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ść Sheet1, a arkusz kalkulacyjny został przesłany z zakresami Sheet1!A1:C10 i Sheet1!D15:E20, pierwsze dane siatki będą miały wartość startRow/startColumn z 0, a drugie – startRow 14 (wiersz 15 liczony od zera) i startColumn 3 (kolumna D liczona od zera).

W przypadku arkusza DATA_SOURCE nie możesz zażądać określonego zakresu, ponieważ obiekt GridData zawiera wszystkie wartości.

merges[]

object (GridRange)

Zakresy, które zostały scalone.

conditionalFormats[]

object (ConditionalFormatRule)

Reguły formatowania warunkowego w tym arkuszu.

filterViews[]

object (FilterView)

Widoki filtra w tym arkuszu.

protectedRanges[]

object (ProtectedRange)

Zakresy chronione w tym arkuszu.

basicFilter

object (BasicFilter)

Filtr w tym arkuszu (jeśli istnieje).

charts[]

object (EmbeddedChart)

Specyfikacje każdego wykresu w tym arkuszu.

bandedRanges[]

object (BandedRange)

Pasmowe (naprzemienne kolory) zakresy na tym arkuszu.

developerMetadata[]

object (DeveloperMetadata)

Metadane dewelopera powiązane z arkuszem.

rowGroups[]

object (DimensionGroup)

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[]

object (DimensionGroup)

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[]

object (Slicer)

Segmentatory w tym arkuszu.

SheetProperties

Właściwości arkusza.

Zapis JSON
{
  "sheetId": integer,
  "title": string,
  "index": integer,
  "sheetType": enum (SheetType),
  "gridProperties": {
    object (GridProperties)
  },
  "hidden": boolean,
  "tabColor": {
    object (Color)
  },
  "tabColorStyle": {
    object (ColorStyle)
  },
  "rightToLeft": boolean,
  "dataSourceSheetProperties": {
    object (DataSourceSheetProperties)
  }
}
Pola
sheetId

integer

Identyfikator arkusza. Musi być nieujemna. Po ustawieniu tego pola nie można go zmienić.

title

string

Nazwa arkusza.

index

integer

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

enum (SheetType)

Typ arkusza. Domyślna wartość to GRID. Po ustawieniu tego pola nie można go zmienić.

gridProperties

object (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 DATA_SOURCE, to pole jest wyświetlane tylko z danymi wyjściowymi, ale zawiera właściwości, które odzwierciedlają sposób renderowania arkusza źródła danych w interfejsie, np. rowCount.

hidden

boolean

Wartość „prawda”, jeśli arkusz jest ukryty w interfejsie, i „fałsz”, jeśli jest widoczny.

tabColor
(deprecated)

object (Color)

Kolor karty w interfejsie. Wycofane: użyj tabColorStyle.

tabColorStyle

object (ColorStyle)

Kolor karty w interfejsie. Jeśli skonfigurowano również tabColor, to pole ma pierwszeństwo.

rightToLeft

boolean

Wartość Prawda, jeśli arkusz jest arkuszem RTL, a nie LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Tylko dane wyjściowe. Jeśli to pole jest obecne, zawiera właściwości DATA_SOURCE arkusza.

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

integer

Liczba wierszy w siatce.

columnCount

integer

Liczba kolumn w siatce.

frozenRowCount

integer

Liczba wierszy zablokowanych w siatce.

frozenColumnCount

integer

Liczba kolumn zablokowanych w siatce.

hideGridlines

boolean

Prawda, jeśli siatka nie jest wyświetlana w interfejsie.

rowGroupControlAfter

boolean

Wartość Prawda, jeśli przełącznik kontrolujący grupowanie wierszy jest wyświetlany po grupie.

columnGroupControlAfter

boolean

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 (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Pola
dataSourceId

string

Identyfikator jednostki DataSource, z którą jest połączony arkusz.

columns[]

object (DataSourceColumn)

Kolumny wyświetlane w arkuszu, które odpowiadają wartościom w RowData.

dataExecutionStatus

object (DataExecutionStatus)

Stan wykonania danych.

GridData

Dane w siatce oraz metadane dotyczące wymiarów.

Zapis JSON
{
  "startRow": integer,
  "startColumn": integer,
  "rowData": [
    {
      object (RowData)
    }
  ],
  "rowMetadata": [
    {
      object (DimensionProperties)
    }
  ],
  "columnMetadata": [
    {
      object (DimensionProperties)
    }
  ]
}
Pola
startRow

integer

Pierwszy wiersz, do którego odwołuje się GridData, liczony od zera.

startColumn

integer

Pierwsza kolumna, do której odwołuje się GridData, liczona od zera.

rowData[]

object (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 startColumn.

rowMetadata[]

object (DimensionProperties)

Metadane dotyczące żądanych wierszy w siatce, począwszy od wiersza w startRow.

columnMetadata[]

object (DimensionProperties)

Metadane dotyczące żądanych kolumn w siatce, zaczynając od kolumny w startColumn.

RowData

Dane dotyczące każdej komórki w wierszu.

Zapis JSON
{
  "values": [
    {
      object (CellData)
    }
  ]
}
Pola
values[]

object (CellData)

wartości w wierszu, po jednej na kolumnę;

DimensionProperties

Właściwości wymiaru.

Zapis JSON
{
  "hiddenByFilter": boolean,
  "hiddenByUser": boolean,
  "pixelSize": integer,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
}
Pola
hiddenByFilter

boolean

Wartość „PRAWDA”, jeśli ten wymiar jest filtrowany. To pole jest tylko do odczytu.

hiddenByUser

boolean

Wartość Prawda, jeśli ten wymiar jest wyraźnie ukryty.

pixelSize

integer

Wysokość (jeśli jest to wiersz) lub szerokość (jeśli jest to kolumna) wymiaru w pikselach.

developerMetadata[]

object (DeveloperMetadata)

Metadane dewelopera powiązane z pojedynczym wierszem lub pojedynczą kolumną.

dataSourceColumnReference

object (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 (GridRange)
    }
  ],

  // Union field rule can be only one of the following:
  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
  // End of list of possible types for union field rule.
}
Pola
ranges[]

object (GridRange)

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

object (BooleanRule)

Formatowanie jest włączone lub wyłączone zgodnie z regułą.

gradientRule

object (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 (BooleanCondition)
  },
  "format": {
    object (CellFormat)
  }
}
Pola
condition

object (BooleanCondition)

Warunek reguły. Jeśli warunek jest prawdziwy, format jest stosowany.

format

object (CellFormat)

Format, który ma zostać zastosowany. W formatowaniu warunkowym można stosować tylko podzbiór formatowania: bold, italic, strikethrough, foreground color i background color.

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 (InterpolationPoint)
  },
  "midpoint": {
    object (InterpolationPoint)
  },
  "maxpoint": {
    object (InterpolationPoint)
  }
}
Pola
minpoint

object (InterpolationPoint)

Punkt początkowy interpolacji.

midpoint

object (InterpolationPoint)

Opcjonalny punkt interpolacji pośredniej.

maxpoint

object (InterpolationPoint)

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 (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "type": enum (InterpolationPointType),
  "value": string
}
Pola
color
(deprecated)

object (Color)

Kolor, którego ma używać ten punkt interpolacji. Wycofane: użyj colorStyle.

colorStyle

object (ColorStyle)

Kolor, którego ma używać ten punkt interpolacji. Jeśli ustawiona jest też zasada color, to pole ma pierwszeństwo.

type

enum (InterpolationPointType)

Sposób interpretacji tej wartości.

value

string

Wartość używana przez ten punkt interpolacji. Może to być formuła. Nieużywane, jeśli type to MIN lub MAX.

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 NUMBER, jeśli wartość to: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (gdzie błędy zakresu są ignorowane podczas powiększania).

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 (GridRange)
  },
  "namedRangeId": string,
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Pola
filterViewId

integer

Identyfikator widoku filtra.

title

string

Nazwa widoku filtra.

range

object (GridRange)

Zakres uwzględniany w tym widoku filtra.

Podczas zapisywania można ustawić tylko jedną z opcji: range lub namedRangeId.

namedRangeId

string

Nazwany zakres (jeśli istnieje) powiązany z tym widokiem filtra.

Podczas zapisywania można ustawić tylko jedną z opcji: range lub namedRangeId.

sortSpecs[]

object (SortSpec)

Kolejność sortowania według kolumny. Późniejsze specyfikacje są używane, gdy wartości są takie same jak we wcześniejszych specyfikacjach.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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.

filterSpecs[]

object (FilterSpec)

Kryteria filtrowania wartości według kolumny.

Zarówno criteria, jak i filterSpecs są wypełniane w odpowiedziach. Jeśli w żądaniu aktualizacji są podane oba pola, to pierwsze z nich ma pierwszeństwo.

ProtectedRange

zakres chroniony.

Zapis JSON
{
  "protectedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "description": string,
  "warningOnly": boolean,
  "requestingUserCanEdit": boolean,
  "unprotectedRanges": [
    {
      object (GridRange)
    }
  ],
  "editors": {
    object (Editors)
  }
}
Pola
protectedRangeId

integer

Identyfikator zakresu chronionego. To pole jest tylko do odczytu.

range

object (GridRange)

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: range lub namedRangeId.

namedRangeId

string

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: range lub namedRangeId.

description

string

Opis tego zakresu chronionego.

warningOnly

boolean

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, editors są ignorowane. Dodatkowo, jeśli to pole zmieni się z „true” (prawda) na false (fałsz), a pole editors nie zostanie skonfigurowane (ani nie zostanie uwzględnione w masce pola), edytujący będą mieli dostęp do wszystkich edytorów dokumentu.

requestingUserCanEdit

boolean

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[]

object (GridRange)

Lista niechronionych zakresów w chronionym arkuszu. Zakresy niechronione są obsługiwane tylko w przypadku chronionych arkuszy.

editors

object (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 warningOnly.

Edytujący

Edytujący zakres chroniony.

Zapis JSON
{
  "users": [
    string
  ],
  "groups": [
    string
  ],
  "domainUsersCanEdit": boolean
}
Pola
users[]

string

Adresy e-mail użytkowników z uprawnieniami do edycji zakresu chronionego.

groups[]

string

adresy e-mail grup z dostępem do edycji zakresu chronionego;

domainUsersCanEdit

boolean

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 (GridRange)
  },
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "criteria": {
    integer: {
      object (FilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ]
}
Pola
range

object (GridRange)

Zakres, który obejmuje filtr.

sortSpecs[]

object (SortSpec)

kolejność sortowania w każdej kolumnie, Późniejsze specyfikacje są używane, gdy wartości są równe w wcześniejszych specyfikacjach.

criteria
(deprecated)

map (key: integer, value: object ( FilterCriteria))

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.

filterSpecs[]

object (FilterSpec)

Kryteria filtra na kolumnę.

Zarówno criteria, jak i filterSpecs są wypełniane w odpowiedziach. Jeśli w żądaniu aktualizacji są podane oba pola, to pierwsze z nich ma pierwszeństwo.

BandedRange

Zakres paskowy (naprzemienny) w arkuszu.

Zapis JSON
{
  "bandedRangeId": integer,
  "range": {
    object (GridRange)
  },
  "rowProperties": {
    object (BandingProperties)
  },
  "columnProperties": {
    object (BandingProperties)
  }
}
Pola
bandedRangeId

integer

Identyfikator zakresu z pasmami.

range

object (GridRange)

Zakres, w którym właściwości te są stosowane.

rowProperties

object (BandingProperties)

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: rowProperties lub columnProperties.

columnProperties

object (BandingProperties)

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: rowProperties lub columnProperties.

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:

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 (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColor": {
    object (Color)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColor": {
    object (Color)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColor": {
    object (Color)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Pola
headerColor
(deprecated)

object (Color)

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ą:firstBandColorsecondBandColor. W przeciwnym razie pierwszy wiersz lub pierwsza kolumna jest wypełniona kolorem firstBandColor, a kolory będą się naprzemiennie zmieniać. Wycofane: użyj headerColorStyle.

headerColorStyle

object (ColorStyle)

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ą:firstBandColorsecondBandColor. W przeciwnym razie pierwszy wiersz lub pierwsza kolumna jest wypełniona wartością firstBandColor, a kolory będą się naprzemiennie zmieniać. Jeśli skonfigurowano również headerColor, to pole ma pierwszeństwo.

firstBandColor
(deprecated)

object (Color)

Pierwszy kolor, który się zmienia. (Wymagany) Wycofane: użyj firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Pierwszy kolor, który jest naprzemienny. (Wymagany) Jeśli ustawiona jest też zasada firstBandColor, to pole ma pierwszeństwo.

secondBandColor
(deprecated)

object (Color)

Drugi kolor naprzemienny. (Wymagany) Wycofane: użyj secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Drugi kolor naprzemienny. (Wymagany) Jeśli ustawiona jest też zasada secondBandColor, to pole ma pierwszeństwo.

footerColor
(deprecated)

object (Color)

Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna są wypełnione kolorem firstBandColor lub secondBandColor, w zależności od koloru poprzedniego wiersza lub poprzedniej kolumny. Wycofane: użyj footerColorStyle.

footerColorStyle

object (ColorStyle)

Kolor ostatniego wiersza lub ostatniej kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub ostatnia kolumna są wypełnione kolorem firstBandColor lub secondBandColor, w zależności od koloru poprzedniego wiersza lub poprzedniej kolumny. Jeśli skonfigurowano również footerColor, to pole ma pierwszeństwo.

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 (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Pola
range

object (DimensionRange)

Zakres, w którym istnieje ta grupa.

depth

integer

Głębokość grupy, czyli liczba grup, których zakres całkowicie zawiera zakres tej grupy.

collapsed

boolean

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 (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Pola
slicerId

integer

Identyfikator krojarki.

spec

object (SlicerSpec)

Specyfikacja urządzenia do dzielenia.

position

object (EmbeddedObjectPosition)

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 (GridRange)
  },
  "filterCriteria": {
    object (FilterCriteria)
  },
  "columnIndex": integer,
  "applyToPivotTables": boolean,
  "title": string,
  "textFormat": {
    object (TextFormat)
  },
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "horizontalAlignment": enum (HorizontalAlign)
}
Pola
dataRange

object (GridRange)

Zakres danych fragmentatora.

filterCriteria

object (FilterCriteria)

Kryteria filtrowania w slicerze.

columnIndex

integer

Indeks kolumny liczony od zera w tabeli danych, do której zastosowano filtr.

applyToPivotTables

boolean

Wartość Prawda, jeśli filtr ma być stosowany do tabel przestawnych. Jeśli nie zostanie ustawiony, domyślnie zostanie użyta wartość True.

title

string

Tytuł narzędzia do wycinania.

textFormat

object (TextFormat)

Format tekstu tytułu w osi. Pole link nie jest obsługiwane.

backgroundColor
(deprecated)

object (Color)

Kolor tła narzędzia do dzielenia. Wycofane: użyj backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor tła narzędzia do dzielenia. Jeśli skonfigurowano również backgroundColor, to pole ma pierwszeństwo.

horizontalAlignment

enum (HorizontalAlign)

Wyrównanie tytułu we fragmentatorze w poziomie. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna LEFT.