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)
    }
  ],
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ]
}
Pola
properties

object (SheetProperties)

Właściwości arkusza.

data[]

object (GridData)

Dane w siatce, jeśli jest to arkusz siatki.

Liczba zwracanych obiektów GridData zależy od liczby zakresów żądanych w tym arkuszu. Jeśli na przykład reprezentuje to Sheet1, a arkusz kalkulacyjny został zażądany z zakresami Sheet1!A1:C10 i Sheet1!D15:E20, to pierwsze GridData będzie miało startRow / startColumn o wartości 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 poprosić o określony zakres, ponieważ GridData zawiera wszystkie wartości.

merges[]

object (GridRange)

Zakresy, które mają zostać scalone.

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 występuje).

charts[]

object (EmbeddedChart)

Specyfikacje każdego wykresu w tym arkuszu.

bandedRanges[]

object (BandedRange)

Zakresy z naprzemiennymi kolorami w tym arkuszu.

developerMetadata[]

object (DeveloperMetadata)

Metadane dewelopera powiązane z arkuszem.

rowGroups[]

object (DimensionGroup)

Wszystkie grupy wierszy w tym arkuszu, uporządkowane według rosnącego indeksu początku 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ątku zakresu, a następnie według głębokości grupy.

slicers[]

object (Slicer)

selektory w tym arkuszu,

tables[]

object (Table)

tabele w tym arkuszu;

commentAnchors[]

object (CommentAnchor)

Komentarz jest zakotwiczony 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. Wartość 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 zostanie wykluczone, arkusz zostanie dodany lub przeniesiony 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 masz 3 arkusze (S1, S2, S3), aby przenieść arkusz S1 przed 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 on siatką. (Jeśli arkusz jest arkuszem obiektu zawierającym wykres lub obraz, to pole nie będzie występować). Podczas zapisywania ustawianie właściwości siatki w arkuszach innych niż siatka jest błędem.

Jeśli ten arkusz jest arkuszem DATA_SOURCE, to pole jest tylko wyjściowe, ale zawiera właściwości odzwierciedlające sposób renderowania arkusza źródła danych w interfejsie, np. rowCount.

hidden

boolean

Wartość „true”, jeśli arkusz jest ukryty w interfejsie, lub „false”, jeśli jest widoczny.

tabColor
(deprecated)

object (Color)

Kolor karty w interfejsie. Wycofano: 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 arkusza DATA_SOURCE.

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, ale zawiera obiekt, np. wykres lub obraz.
DATA_SOURCE Arkusz łączy się z zewnętrznymDataSourcei 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 zamrożonych w siatce.

frozenColumnCount

integer

Liczba kolumn zamrożonych w siatce.

hideGridlines

boolean

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

rowGroupControlAfter

boolean

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

columnGroupControlAfter

boolean

Wartość „true”, jeśli po grupie wyświetlany jest przełącznik przycisku kontrolującego grupę kolumn.

DataSourceSheetProperties

Dodatkowe właściwości arkusza.DATA_SOURCE

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

string

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

columns[]

object (DataSourceColumn)

Kolumny wyświetlane w arkuszu, odpowiadające 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 odnosi się ten obiekt GridData, liczony od zera.

startColumn

integer

Pierwsza kolumna, do której odnosi się ten obiekt GridData, liczona od zera.

rowData[]

object (RowData)

Dane w siatce, po jednym wpisie w wierszu, zaczynając od wiersza startRow. Wartości w RowData będą odpowiadać kolumnom zaczynającym się od startColumn.

rowMetadata[]

object (DimensionProperties)

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

columnMetadata[]

object (DimensionProperties)

Metadane dotyczące 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 w kolumnie.

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 jawnie ukryty.

pixelSize

integer

Wysokość (w przypadku wiersza) lub szerokość (w przypadku kolumny) wymiaru w pikselach.

developerMetadata[]

object (DeveloperMetadata)

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

dataSourceColumnReference

object (DataSourceColumnReference)

Tylko dane wyjściowe. Jeśli ta opcja jest ustawiona, jest to kolumna w arkuszu źródła danych.

ConditionalFormatRule

Reguła opisująca formatowanie warunkowe.

Zapis JSON 
{
  "ranges": [
    {
      object (GridRange)
    }
  ],

  "booleanRule": {
    object (BooleanRule)
  },
  "gradientRule": {
    object (GradientRule)
  }
}
Pola
ranges[]

object (GridRange)

Zakresy, które są formatowane, jeśli warunek jest prawdziwy. Wszystkie zakresy muszą znajdować się w tej samej siatce.

Pole zbiorczerule. Reguła kontrolująca ten format warunkowy. 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 pasować lub nie 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 zwraca wartość „prawda”, format jest stosowany.

format

object (CellFormat)

Format do zastosowania. Formatowanie warunkowe może stosować tylko podzbiór formatowania:bold,italic,strikethrough,foreground color ibackground color.

GradientRule

Reguła, która stosuje format skali kolorów gradientu na podstawie wymienionych punktów interpolacji. Format komórki zależy 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)

Początkowy punkt interpolacji.

midpoint

object (InterpolationPoint)

Opcjonalny punkt interpolacji w połowie.

maxpoint

object (InterpolationPoint)

Ostatni punkt interpolacji.

InterpolationPoint

Pojedynczy punkt interpolacji w formacie warunkowym gradientu. Ustawiają one 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. Wycofano: 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)

Jak należy interpretować wartość.

value

string

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

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 formatowania warunkowego.
MAX Punkt interpolacji używa maksymalnej wartości w komórkach w zakresie formatowania warunkowego.
NUMBER Punkt interpolacji używa dokładnie wartości w polu InterpolationPoint.value.
PERCENT

Punkt interpolacji to podany odsetek wszystkich komórek w zakresie formatowania warunkowego. Jest to równoważne NUMBER jeśli wartość to: =(MAX(FLATTEN(range)) * (value / 100)) + (MIN(FLATTEN(range)) * (1 - (value / 100))) (błędy w zakresie są ignorowane podczas spłaszczania).

PERCENTILE Punkt interpolacji to dany percentyl wszystkich komórek w zakresie formatowania warunkowego. Jest to równoważne NUMBER jeśli wartość to: =PERCENTILE(FLATTEN(range), value / 100) (błędy w zakresie są ignorowane podczas spłaszczania).

FilterView

widok przefiltrowany, Więcej informacji znajdziesz w artykule Zarządzanie widocznością danych za pomocą filtrów.

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

title

string

Nazwa widoku przefiltrowanego.

range

object (GridRange)

Zakres, który obejmuje ten widok przefiltrowany.

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

namedRangeId

string

Nazwany zakres, na którym opiera się ten widok filtra (jeśli taki istnieje).

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

tableId

string

Tabela, na której opiera się ten widok przefiltrowany (jeśli taka istnieje).

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

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

Kryteria wyświetlania lub ukrywania wartości w poszczególnych kolumnach. Kluczem mapy jest indeks kolumny, a wartością kryterium dla tej kolumny.

To pole zostało wycofane i zastąpione polem filterSpecs.

filterSpecs[]

object (FilterSpec)

Kryteria filtrowania służące do wyświetlania lub ukrywania wartości w poszczególnych kolumnach.

W odpowiedziach pojawiają się zarówno criteria, jak i filterSpecs. Jeśli w żądaniu aktualizacji podane są oba pola, to pole 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)

Zakres, który jest chroniony. Zakres może być całkowicie nieograniczony, w takim przypadku arkusz jest uznawany za chroniony.

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

namedRangeId

string

Zakres nazwany, na którym opiera się ten zakres chroniony (jeśli taki istnieje).

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

tableId

string

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

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

description

string

Opis tego zakresu chronionego.

warningOnly

boolean

Wartość Prawda, jeśli ten chroniony zakres będzie wyświetlać ostrzeżenie podczas edytowania. Ochrona oparta na ostrzeżeniach oznacza, że każdy użytkownik może edytować dane w chronionym zakresie, ale edycja spowoduje wyświetlenie ostrzeżenia z prośbą o potwierdzenie zmiany.

Podczas pisania: jeśli to pole ma wartość true, pola editors są ignorowane. Jeśli to pole zostanie zmienione z wartości „true” na „false”, a pole editors nie jest ustawione (ani nie jest uwzględnione w masce pola), edytorzy zostaną ustawieni na wszystkich edytorów w dokumencie.

requestingUserCanEdit

boolean

Wartość „true”, jeśli użytkownik, który wysłał prośbę o ten zakres chroniony, może edytować chroniony obszar. To pole jest tylko do odczytu.

unprotectedRanges[]

object (GridRange)

Lista niechronionych zakresów w arkuszu chronionym. 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 edytowania zakresu chronionego i dokumentu. Edytorzy nie są obsługiwani w przypadku ochrony warningOnly.

Edytujący

edytorzy zakresu chronionego;

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

string

Adresy e-mail użytkowników, którzy mają uprawnienia do edytowania zakresu chronionego.

groups[]

string

Adresy e-mail grup, które mają uprawnienia do edytowania zakresu chronionego.

domainUsersCanEdit

boolean

Wartość PRAWDA, jeśli każda osoba w domenie dokumentu ma dostęp do edycji zakresu chronionego. Ochrona domeny jest obsługiwana tylko w przypadku dokumentów w domenie.

BasicFilter

Filtr domyślny powiązany z arkuszem. Więcej informacji znajdziesz w artykule Zarządzanie widocznością danych za pomocą filtrów.

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 opiera się ten filtr (jeśli taka istnieje). Podczas pisania można ustawić tylko jedną z wartości: range lub tableId.

sortSpecs[]

object (SortSpec)

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

criteria
(deprecated)

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

Kryteria wyświetlania lub ukrywania wartości w poszczególnych kolumnach. Kluczem mapy jest indeks kolumny, a wartością kryterium dla tej kolumny.

To pole zostało wycofane i zastąpione polem filterSpecs.

filterSpecs[]

object (FilterSpec)

Kryteria filtra w każdej kolumnie.

W odpowiedziach pojawiają się zarówno criteria, jak i filterSpecs. Jeśli w żądaniu aktualizacji podane są oba pola, to pole ma pierwszeństwo.

BandedRange

Zakres w arkuszu z naprzemiennymi kolorami.

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

integer

Identyfikator zakresu pasmowego. Jeśli nie jest ustawiona, zapoznaj się z informacjami w sekcji bandedRangeReference.

bandedRangeReference

string

Tylko dane wyjściowe. Odwołanie do zakresu pasmowego, używane do identyfikowania identyfikatora, który nie jest obsługiwany przez bandedRangeId.

range

object (GridRange)

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

rowProperties

object (BandingProperties)

Właściwości pasków wierszy. Te właściwości są stosowane wiersz po wierszu we wszystkich wierszach w zakresie. Musisz określić co najmniej jedną z tych właściwości: rowProperties lub columnProperties.

columnProperties

object (BandingProperties)

Właściwości pasów 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 odnoszące się do jednego wymiaru (wiersza lub kolumny). Jeśli ustawione są zarówno BandedRange.row_properties, jak i BandedRange.column_properties, kolory wypełnienia są stosowane do komórek zgodnie z tymi regułami:

Na przykład kolor pierwszego wiersza ma priorytet przed kolorem pierwszej kolumny, ale kolor pierwszej kolumny ma priorytet przed kolorem drugiego wiersza. Podobnie w lewej górnej komórce nagłówek wiersza ma wyższy priorytet niż nagłówek kolumny, ale nagłówek kolumny ma wyższy priorytet niż kolor 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 są wypełniane tym kolorem, a kolory zmieniają się naprzemiennie między firstBandColor a secondBandColor od drugiego wiersza lub drugiej kolumny. W przeciwnym razie pierwszy wiersz lub pierwsza kolumna zostaną wypełnione znakiem firstBandColor, a kolory będą się zmieniać naprzemiennie w normalny sposób. Wycofano: użyj headerColorStyle.

headerColorStyle

object (ColorStyle)

Kolor pierwszego wiersza lub pierwszej kolumny. Jeśli to pole jest ustawione, pierwszy wiersz lub pierwsza kolumna są wypełniane tym kolorem, a kolory zmieniają się naprzemiennie między firstBandColor a secondBandColor od drugiego wiersza lub drugiej kolumny. W przeciwnym razie pierwszy wiersz lub pierwsza kolumna zostaną wypełnione znakiem firstBandColor, a kolory będą się zmieniać naprzemiennie jak zwykle. Jeśli ustawiona jest też zasada headerColor, to pole ma pierwszeństwo.

firstBandColor
(deprecated)

object (Color)

Pierwszy kolor naprzemienny. (Wymagany) Wycofany: użyj firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

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

secondBandColor
(deprecated)

object (Color)

Drugi kolor, który jest naprzemienny. (Wymagany) Wycofany: 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 kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub kolumna są wypełniane kolorem firstBandColor lub secondBandColor w zależności od koloru poprzedniego wiersza lub kolumny. Wycofano: użyj footerColorStyle.

footerColorStyle

object (ColorStyle)

Kolor ostatniego wiersza lub kolumny. Jeśli to pole nie jest ustawione, ostatni wiersz lub kolumna są wypełniane kolorem firstBandColor lub secondBandColor w zależności od koloru poprzedniego wiersza lub kolumny. Jeśli ustawiona jest też zasada footerColor, to pole ma pierwszeństwo.

DimensionGroup

Grupa w przedziale wierszy lub kolumn w arkuszu, która może zawierać inne grupy lub być przez nie obejmowana. Grupę można zwinąć lub rozwinąć jako jednostkę w arkuszu.

Zapis JSON 
{
  "range": {
    object (DimensionRange)
  },
  "depth": integer,
  "collapsed": boolean
}
Pola
range

object (DimensionRange)

Zakres, w którym ta grupa istnieje.

depth

integer

Głębokość grupy, która określa, ile grup ma zakres całkowicie zawierający zakres tej grupy.

collapsed

boolean

To pole ma wartość „true”, jeśli ta grupa jest zwinięta. Zwinięta grupa pozostaje zwinięta, jeśli zostanie rozwinięta nakładająca się na nią grupa o mniejszej głębokości.

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. Gdy jednak ta właściwość zostanie zaktualizowana, wszystkie wymiary w niej zostaną ustawione jako ukryte, jeśli to pole ma wartość true, lub jako widoczne, jeśli to pole ma wartość false.

Fragmentator

Slicer w arkuszu.

Zapis JSON 
{
  "slicerId": integer,
  "spec": {
    object (SlicerSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  }
}
Pola
slicerId

integer

Identyfikator fragmentatora.

spec

object (SlicerSpec)

Specyfikacja fragmentatora.

position

object (EmbeddedObjectPosition)

Położenie fragmentatora. Pamiętaj, że fragmentator można umieścić tylko w istniejącym arkuszu. Szerokość i wysokość fragmentatora mogą być automatycznie dostosowywane, aby utrzymać go w dozwolonych limitach.

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

columnIndex

integer

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

applyToPivotTables

boolean

Wartość True (Prawda), jeśli filtr ma być stosowany do tabel przestawnych. Jeśli nie jest ustawiona, domyślnie przyjmuje wartość True.

title

string

Tytuł fragmentatora.

textFormat

object (TextFormat)

Format tekstu tytułu w selektorze. Pole linku nie jest obsługiwane.

backgroundColor
(deprecated)

object (Color)

Kolor tła fragmentatora. Wycofano: użyj backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor tła fragmentatora. Jeśli ustawiona jest też zasada backgroundColor, to pole ma pierwszeństwo.

horizontalAlignment

enum (HorizontalAlign)

Wyrównanie tytułu w poziomie w fragmentatorze. Jeśli nie określisz 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 to unikalna wartość 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 zostanie wypełniony domyślnym kolorem.

firstBandColorStyle

object (ColorStyle)

Pierwszy kolor naprzemienny. Jeśli to pole jest ustawione, pierwszy wiersz w paski jest wypełniony określonym kolorem. W przeciwnym razie pierwszy wiersz naprzemienny zostanie wypełniony domyślnym kolorem.

secondBandColorStyle

object (ColorStyle)

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

footerColorStyle

object (ColorStyle)

Kolor ostatniego wiersza. Jeśli to pole nie jest ustawione, stopka nie jest dodawana, a ostatni wiersz jest wypełniany znakiem firstBandColorStyle lub secondBandColorStyle w zależności od koloru poprzedniego wiersza. Jeśli aktualizujesz istniejącą tabelę bez stopki, aby dodać stopkę, zakres zostanie powiększony o 1 wiersz. Jeśli aktualizujesz istniejącą tabelę ze stopką i usuwasz stopkę, zakres zmniejszy się o 1 wiersz.

TableColumnProperties

Kolumna tabeli.

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

integer

Indeks kolumny rozpoczynający się od 0. Ten indeks jest względny w stosunku do pozycji w tabeli i nie musi być 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 w kolumnie. Ustawiane tylko w przypadku typu kolumny z rozwijanym menu.

ColumnType

Typ kolumny w danej kolumnie 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 wartościami czasowymi.
DATE_TIME Typ kolumny z datami i godzinami.
TEXT Typ kolumny z tekstem.
BOOLEAN Typ kolumny z wartościami logicznymi.
DROPDOWN Typ kolumny z rozwijanym menu.
FILES_CHIP Typ kolumny z elementami prowadzącymi do plików
PEOPLE_CHIP Typ kolumny z elementami dotyczącymi osób
FINANCE_CHIP Typ kolumny z elementami finansowymi
PLACE_CHIP Typ kolumny z elementami mapy
RATINGS_CHIP Typ kolumny z elementami oceny

TableColumnDataValidationRule

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

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

object (BooleanCondition)

Warunek, który muszą spełniać dane w komórce. Prawidłowe tylko wtedy, gdy [BooleanCondition.type] ma wartość ONE_OF_LIST.

CommentAnchor

Lokalizacja w arkuszu kalkulacyjnym powiązana z właściwością CommentThread o tym samym anchorId. Uwaga: kilka kotwic może odnosić się do tej samej lokalizacji.

Zapis JSON 
{
  "anchorId": string,
  "range": {
    object (GridRange)
  }
}
Pola
anchorId

string

Unikalny identyfikator kotwicy komentarza. Tylko dane wyjściowe.

range

object (GridRange)

Zakres współrzędnych w arkuszu, w którym jest zakotwiczony ten komentarz.