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)
    }
  ],
  "tables": [
    {
      object (Table)
    }
  ]
}
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 zapytań w tym arkuszu. Jeśli na przykład reprezentuje on wartość Sheet1, a arkusz kalkulacyjny został zażądany 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żna poprosić o określony zakres, ponieważ GridData zawiera wszystkie wartości.

merges[]

object (GridRange)

Zakresy, które są łączone.

conditionalFormats[]

object (ConditionalFormatRule)

Reguły formatowania warunkowego w tym arkuszu.

filterViews[]

object (FilterView)

Widoki filtra w tym arkuszu.

protectedRanges[]

object (ProtectedRange)

Chronione zakresy 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 na 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.

tables[]

object (Table)

tabele 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 zmiana jest uwzględniana w indeksach „przed przeniesieniem”. Jeśli na przykład masz 3 arkusz (S1, S2, S3), aby przesunąć arkusz S1 przed arkusz S2, musisz ustawić indeks na 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 to arkusz z siatką; (jeśli arkusz jest arkuszem obiektu, zawierającym wykres lub obraz, to pole nie będzie widoczne). Podczas pisania błędem jest ustawianie właściwości siatki na arkuszach niebędących siatką.

Jeśli jest to arkusz DATA_SOURCE, to pole jest tylko do odczytu, ale zawiera właściwości, które odzwierciedlają sposób renderowania arkusza źródła danych w interfejsie użytkownika, 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 ustawiona jest też zasada 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 źródłem danychDataSourcei pokazuje 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

Wartość „PRAWDA”, jeśli siatka nie wyświetla linii siatki w interfejsie.

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

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

DataSourceSheetProperties

Dodatkowe właściwości arkusza DATA_SOURCE.

Zapis JSON 
{
  "dataSourceId": string,
  "columns": [
    {
      object (DataSourceColumn)
    }
  ],
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Pola
dataSourceId

string

Identyfikator arkusza, z którym jest połączony element DataSource.

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 0.

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 począwszy od startColumn.

rowMetadata[]

object (DimensionProperties)

Metadane dotyczące żądanych wierszy w siatce, zaczynając od wiersza w startRow.

columnMetadata[]

object (DimensionProperties)

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

RowData

Dane o każdej komórce 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

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 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 formatowanie warunkowe.

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. rulemoże być 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ę zmieniać w zależności od gradientów w regułach.

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 chcesz zastosować. Formatowanie warunkowe może stosować tylko podzbiór formatowania: bold, italic, strikethrough, foreground color i background color.

GradientRule

Reguła, która stosuje format skończonej skali kolorów 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 przypadku formatowania warunkowego z gradientem. 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 ona ma pierwszeństwo.

type

enum (InterpolationPointType)

Sposób interpretacji 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 używa maksymalnej wartości 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 równoważne z NUMBER jeśli wartość była równa: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (gdzie błędy w zakresie są ignorowane podczas spłaszczania).

PERCENTILE Punkt interpolacji to podany centyl wszystkich komórek w zakresie formatu warunkowego. Jest to równoważne z NUMBER jeśli wartość była równa: =PERCENTILE(FLATTEN(range), value / 100) (gdzie błędy w zakresie są ignorowane podczas spłaszczania).

FilterView

Widok filtra.

Zapis JSON 
{
  "filterViewId": integer,
  "title": string,
  "range": {
    object (GridRange)
  },
  "namedRangeId": string,
  "tableId": 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, który obejmuje ten widok filtra.

Podczas pisania można ustawić tylko jedną z tych wartości: range, namedRangeId lub tableId.

namedRangeId

string

Zakres nazwany, na którym opiera się ten widok filtra (jeśli istnieje).

Podczas pisania można ustawić tylko jedną z tych opcji: range namedRangeId tableId

tableId

string

Tabela, na której się on opiera (jeśli istnieje).

Podczas pisania można ustawić tylko jedną z tych opcji: range namedRangeId tableId

sortSpecs[]

object (SortSpec)

kolejność sortowania w poszczególnych kolumnach, Późniejsze specyfikacje są używane, gdy wartości są równe w poprzednich specyfikacjach.

criteria
(deprecated)

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

Kryteria wyświetlania/ukrywania wartości w kolumnach. 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 filtrowania służące do wyświetlania/ukrywania wartości w kolumnach.

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,
  "tableId": 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 pisania można ustawić tylko jedną z tych opcji: range namedRangeId tableId

namedRangeId

string

Nazwa zakresu nazwanego, który jest źródłem danych dla tego zakresu chronionego (jeśli istnieje).

Podczas pisania można ustawić tylko jedną z tych opcji: range namedRangeId tableId

tableId

string

Tabela, w której znajduje się ten zakres chroniony (jeśli istnieje).

Podczas pisania można ustawić tylko jedną z tych opcji: range namedRangeId tableId

description

string

Opis tego zakresu chronionego.

warningOnly

boolean

Wartość 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. Jeśli dodatkowo to pole zostanie zmienione z prawda na fałsz, a pole editors nie będzie ustawione (ani uwzględnione w masce pola), edytorzy zostaną ustawieni jako wszyscy edytorzy w dokumencie.

requestingUserCanEdit

boolean

Wartość Prawda, jeśli użytkownik, który poprosił o ten zakres chroniony, może edytować obszar chroniony. 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 uprawnieniami do edycji zakresu chronionego. 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 dostępem do edycji w zakresie chronionym.

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

object (GridRange)

Zakres, który obejmuje filtr.

tableId

string

Tabela, na której podstawie działa filtr (jeśli istnieje). Podczas zapisywania można ustawić tylko jedną z opcji: range lub tableId.

sortSpecs[]

object (SortSpec)

kolejność sortowania w poszczególnych kolumnach, Późniejsze specyfikacje są używane, gdy wartości są równe w poprzednich specyfikacjach.

criteria
(deprecated)

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

Kryteria wyświetlania/ukrywania wartości w kolumnach. 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

Pasmowany (z naprzemiennymi kolorami) zakres 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 są stosowane.

rowProperties

object (BandingProperties)

Właściwości pasków wiersza. Te właściwości są stosowane do poszczególnych wierszy w całym 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 pojedynczego wymiaru (wiersza lub kolumny). Jeśli ustawisz zarówno opcję BandedRange.row_properties, jak 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ą:firstBandColor i secondBandColor. 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ą:firstBandColor i secondBandColor. W przeciwnym razie pierwszy wiersz lub pierwsza kolumna jest wypełniona kolorem firstBandColor, a kolory będą się naprzemiennie zmieniać. Jeśli ustawiona jest też zasada headerColor, to ona 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 się zmienia. (Wymagane) Jeśli ustawiona jest też zasada firstBandColor, to pole ma pierwszeństwo.

secondBandColor
(deprecated)

object (Color)

Drugi kolor, który jest naprzemienny. (Wymagany) Wycofane: użyj secondBandColorStyle.

secondBandColorStyle

object (ColorStyle)

Drugi kolor, który jest naprzemienny. (Wymagane) 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 ustawiona jest też zasada footerColor, to ona 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 właściwości 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)

Pozycja narzędzia do cięcia. Pamiętaj, że możesz umieścić slajder tylko na istniejącym arkuszu. Szerokość i wysokość sekcji można też automatycznie dostosowywać, aby mieściły się w dozwolonych granicach.

SlicerSpec

Specyfikacja urządzenia do cięcia.

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 w tabeli danych, do której jest stosowany filtr, liczony od 0.

applyToPivotTables

boolean

Wartość Prawda (True), 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 ustawiona jest też zasada backgroundColor, to pole ma pierwszeństwo.

horizontalAlignment

enum (HorizontalAlign)

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

Tabela

tabela

Zapis JSON 
{
  "tableId": string,
  "name": string,
  "range": {
    object (GridRange)
  },
  "rowsProperties": {
    object (TableRowsProperties)
  },
  "columnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Pola
tableId

string

Identyfikator tabeli.

name

string

Nazwa tabeli. Jest ona unikalna dla wszystkich tabel w tym samym arkuszu kalkulacyjnym.

range

object (GridRange)

Zakres tabeli.

rowsProperties

object (TableRowsProperties)

Właściwości wierszy tabeli.

columnProperties[]

object (TableColumnProperties)

Właściwości kolumny tabeli.

TableRowsProperties

Właściwości wiersza tabeli.

Zapis JSON 
{
  "headerColorStyle": {
    object (ColorStyle)
  },
  "firstBandColorStyle": {
    object (ColorStyle)
  },
  "secondBandColorStyle": {
    object (ColorStyle)
  },
  "footerColorStyle": {
    object (ColorStyle)
  }
}
Pola
headerColorStyle

object (ColorStyle)

Kolor wiersza nagłówka. Jeśli to pole jest ustawione, wiersz nagłówka jest wypełniony określonym kolorem. W przeciwnym razie wiersz nagłówka jest wypełniony kolorem domyślnym.

firstBandColorStyle

object (ColorStyle)

Pierwszy kolor, który się zmienia. Jeśli to pole jest ustawione, pierwszy pasek jest wypełniony określonym kolorem. W przeciwnym razie pierwszy pasek wiersza jest wypełniony kolorem domyślnym.

secondBandColorStyle

object (ColorStyle)

Drugi kolor, który jest naprzemienny. Jeśli to pole jest ustawione, drugi pasek jest wypełniony określonym kolorem. W przeciwnym razie drugi pasek jest wypełniony kolorem domyślnym.

footerColorStyle

object (ColorStyle)

Kolor ostatniego wiersza. Jeśli to pole nie jest ustawione, stopka nie jest dodawana, a ostatnie wiersz jest wypełniany kolorem firstBandColorStyle lub secondBandColorStyle, w zależności od koloru poprzedniego wiersza. Jeśli aktualizujesz istniejącą tabelę bez stopki, aby dodać stopkę, zakres zostanie rozszerzony o 1 wiersz. Jeśli aktualizujesz istniejącą tabelę z stopką i usuniesz stopkę, zakres zostanie zmniejszony o 1 wiersz.

TableColumnProperties

Kolumna tabeli.

Zapis JSON 
{
  "columnIndex": integer,
  "columnName": string,
  "columnType": enum (ColumnType),
  "dataValidationRule": {
    object (TableColumnDataValidationRule)
  }
}
Pola
columnIndex

integer

Indeks kolumny w skali od 0. Ten indeks jest względny do jego pozycji w tabeli i niekoniecznie jest taki sam jak indeks kolumny w arkuszu.

columnName

string

Nazwa kolumny.

columnType

enum (ColumnType)

Typ kolumny.

dataValidationRule

object (TableColumnDataValidationRule)

Reguła sprawdzania poprawności danych kolumny. Ustawiane tylko w przypadku typu kolumny z rozwijanym menu.

ColumnType

Typ kolumny w danej tabeli.

Wartości w polu enum
COLUMN_TYPE_UNSPECIFIED Nieokreślony typ kolumny.
DOUBLE Typ kolumny liczbowej.
CURRENCY Typ kolumny z walutami.
PERCENT Typ kolumny z wartościami procentowymi.
DATE Typ kolumny z datami.
TIME Typ kolumny z czasem.
DATE_TIME Typ kolumny z datą i godzinami.
TEXT Typ kolumny tekstowej.
BOOLEAN Typ kolumny z wartościami logicznymi.
DROPDOWN Typ kolumny z menu.
FILES_CHIP Typ kolumny z elementami prowadzącymi do plików
PEOPLE_CHIP Typ kolumny Element dotyczący osób
FINANCE_CHIP Typ kolumny z elementami finansowymi
PLACE_CHIP Typ kolumny z elementami dotyczącymi miejsca
RATINGS_CHIP Typ kolumny z elementami dotyczącymi ocen

TableColumnDataValidationRule

Reguła sprawdzania poprawności danych w kolumnie tabeli.

Zapis JSON 
{
  "condition": {
    object (BooleanCondition)
  }
}
Pola
condition

object (BooleanCondition)

Warunek, który musi być spełniony, aby dane w komórce były zgodne. Dotyczy tylko wtedy, gdy wartość [BooleanCondition.type] to ONE_OF_LIST.