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 zwracanych obiektów GridData zależy od liczby zakresów żądanych w tym arkuszu. Jeśli na przykład reprezentuje to Sheet1, a arkusz został przesłany 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)

Zakresy chronione 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)

Slicery 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. 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 w arkuszu kalkulacyjnym są 3 arkusze (S1, S2, S3), aby przenieść arkusz S1 przed S2, indeks musi 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 nie będzie występować). Podczas pisania 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ść „prawda”, jeśli arkusz jest ukryty w interfejsie, lub „fałsz”, 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ść true, 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 przycisk kontrolujący grupowanie wierszy jest wyświetlany po grupie.

columnGroupControlAfter

boolean

Wartość Prawda, 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 o każdej komórce 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 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 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 jest spełniony, 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)

Określa sposób interpretacji wartości.

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

title

string

Nazwa widoku filtra.

range

object (GridRange)

Zakres, którego dotyczy ten widok filtra.

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 filtra (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 filtra 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 chronionego zakresu. To pole jest tylko do odczytu.

range

object (GridRange)

Zakres, który jest chroniony. Zakres może być w pełni 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 zakres chroniony 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 „prawda” na „fałsz”, 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 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 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 chronionego zakresu.

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 chronionego zakresu. 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 filtrowania 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.

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 zakresu. 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 odnoszące się do jednego wymiaru (wiersza lub kolumny). Jeśli ustawione są zarówno warunek BandedRange.row_properties, jak i warunek 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 jeśli nagłówek wiersza nie jest ustawiony, nagłówek kolumny ma wyższy priorytet niż kolor pierwszego wiersza.

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 jak zwykle. 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 narzędzia do wycinania.

position

object (EmbeddedObjectPosition)

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

SlicerSpec

Specyfikacje wycinarki.

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ść 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 selektora. Wycofano: użyj backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor tła selektora. 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 on unikalny 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 paskach jest wypełniany 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 naprzemienny jest wypełniany 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 dotyczącymi miejsc
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.