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 zwróconych 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 pierwszy element GridData będzie miał startRow / startColumn o wartości 0, a drugi będzie miał 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 są łączone.

conditionalFormats[]

object (ConditionalFormatRule)

Reguły formatowania warunkowego w tym arkuszu.

filterViews[]

object (FilterView)

Widoki filtrów 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)

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ą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ątku zakresu, a następnie według głębokości grupy.

slicers[]

object (Slicer)

Slicery w tym arkuszu.

tables[]

object (Table)

tabel w tym arkuszu.

commentAnchors[]

object (CommentAnchor)

Punkty zakotwiczenia komentarzy 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ść nie może być ujemna. 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 pominięte, 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) i chcesz przenieść arkusz S1 przed arkusz S2, musisz ustawić indeks na 2. Żądanie aktualizacji indeksu arkusza jest ignorowane, 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 nie można ustawiać żadnych właściwości siatki w arkuszach innych niż siatka.

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

hidden

boolean

Prawda, jeśli arkusz jest ukryty w interfejsie, 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ść „prawda”, jeśli arkusz jest arkuszem RTL, a nie LTR.

dataSourceSheetProperties

object (DataSourceSheetProperties)

Tylko dane wyjściowe. Jeśli to pole występuje, 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, tylko 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ść „Prawda”, jeśli siatka nie wyświetla linii siatki w interfejsie.

rowGroupControlAfter

boolean

Wartość Prawda, jeśli przełącznik sterowania grupowaniem wierszy jest wyświetlany po grupie.

columnGroupControlAfter

boolean

Wartość Prawda, jeśli przełącznik sterowania grupowaniem kolumn jest wyświetlany po grupie.

DataSourceSheetProperties

Dodatkowe właściwościDATA_SOURCE arkusza.

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

string

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

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 kolumny 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

Wartość „true” (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 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 spełniony. Wszystkie zakresy muszą znajdować się w tej samej siatce.

Reguła kontrolująca ten format warunkowy. Musi być ustawiona dokładnie jedna reguła. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
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.

Koniec pól wykluczających się nawzajem.

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 przyjmuje 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 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)

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 z gradientem. Przypinają 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 powinien używać ten punkt interpolacji. Wycofano: użyj colorStyle.

colorStyle

object (ColorStyle)

Kolor, którego powinien używać ten punkt interpolacji. Jeśli ustawiona jest też zasada color, to pole 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 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 procent 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, o ile 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 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 we 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 tej kolumny.

To pole zostało wycofane na rzecz 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 podano 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 jest to arkusz chroniony.

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 zakres chroniony, jeśli taki istnieje.

Podczas pisania można ustawić tylko jedną z tych 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 tych 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 „true” na „false”, a pole editors nie zostanie ustawione (ani nie będzie uwzględnione w masce pola), edytorzy zostaną ustawieni na wszystkich edytorów w dokumencie.

requestingUserCanEdit

boolean

Wartość Prawda, jeśli użytkownik, który wysłał prośbę dotyczącą tego zakresu chronionego, 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

Edytujący 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żdy 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 tych wartości: range lub tableId.

sortSpecs[]

object (SortSpec)

Kolejność sortowania w poszczególnych kolumnach. Późniejsze specyfikacje są używane, gdy wartości we 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 tej kolumny.

To pole zostało wycofane na rzecz filterSpecs.

filterSpecs[]

object (FilterSpec)

Kryteria filtra w poszczególnych kolumnach.

W odpowiedziach są wypełniane zarówno pole criteria, jak i filterSpecs. Jeśli w żądaniu aktualizacji podano 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 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 ustawiono 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 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łnione 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łnione 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. Jeśli ustawiona jest też zasada headerColor, to pole ma pierwszeństwo.

firstBandColor
(deprecated)

object (Color)

Pierwszy kolor, który ma być używany naprzemiennie. (Wymagany) Wycofano: użyj firstBandColorStyle.

firstBandColorStyle

object (ColorStyle)

Pierwszy kolor, który ma być używany naprzemiennie. (Wymagane) Jeśli ustawiona jest też zasada firstBandColor, to pole ma pierwszeństwo.

secondBandColor
(deprecated)

object (Color)

Drugi kolor, który jest naprzemienny. (Wymagany) Wycofano: 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 zawarta. 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, czyli liczba grup, których zakres całkowicie zawiera 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ść „true” 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ść „prawda”, lub jako widoczne, jeśli to pole ma wartość „fałsz”.

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)

Pozycja suwaka. Pamiętaj, że fragmentator można umieścić tylko w istniejącym arkuszu. Szerokość i wysokość fragmentatora mogą być automatycznie dostosowywane, aby zachować je 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 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 ustawiony, 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 selektorze. 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 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, który ma być używany naprzemiennie. Jeśli to pole jest ustawione, pierwszy wiersz z paskami 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 w paski 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 atrybucie anchorId. Uwaga: wiele 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.