Charts

Wykres umieszczony

Wykres umieszczony w arkuszu.

Zapis JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
Pola
chartId

integer

Identyfikator wykresu.

spec

object (ChartSpec)

Specyfikacja wykresu.

position

object (EmbeddedObjectPosition)

Pozycja wykresu.

border

object (EmbeddedObjectBorder)

Obramowanie wykresu.

Specyfikacja wykresu

Specyfikacja wykresu.

Zapis JSON
{
  "title": string,
  "altText": string,
  "titleTextFormat": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "subtitle": string,
  "subtitleTextFormat": {
    object (TextFormat)
  },
  "subtitleTextPosition": {
    object (TextPosition)
  },
  "fontName": string,
  "maximized": boolean,
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "dataSourceChartProperties": {
    object (DataSourceChartProperties)
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "hiddenDimensionStrategy": enum (ChartHiddenDimensionStrategy),

  // Union field chart can be only one of the following:
  "basicChart": {
    object (BasicChartSpec)
  },
  "pieChart": {
    object (PieChartSpec)
  },
  "bubbleChart": {
    object (BubbleChartSpec)
  },
  "candlestickChart": {
    object (CandlestickChartSpec)
  },
  "orgChart": {
    object (OrgChartSpec)
  },
  "histogramChart": {
    object (HistogramChartSpec)
  },
  "waterfallChart": {
    object (WaterfallChartSpec)
  },
  "treemapChart": {
    object (TreemapChartSpec)
  },
  "scorecardChart": {
    object (ScorecardChartSpec)
  }
  // End of list of possible types for union field chart.
}
Pola
title

string

Tytuł wykresu.

altText

string

Alternatywny tekst opisujący wykres. Często używa się go przy ułatwieniach dostępu.

titleTextFormat

object (TextFormat)

Format tytułu tytułu. Przekreślenie, podkreślenie i link nie są obsługiwane.

titleTextPosition

object (TextPosition)

Pozycja tekstu tytułu. To pole jest opcjonalne.

subtitle

string

Podtytuł wykresu.

subtitleTextFormat

object (TextFormat)

Format tekstu podtytułu. Przekreślenie, podkreślenie i link nie są obsługiwane.

subtitleTextPosition

object (TextPosition)

Pozycja tekstu podtytułu. To pole jest opcjonalne.

fontName

string

Nazwa czcionki, która ma być domyślnie używana w całym tekście wykresu (np. tytuł, etykiety osi, legenda). Jeśli czcionka jest określona dla danej części wykresu, zastąpi ona tę nazwę.

maximized

boolean

Wartość prawda powoduje, że wykres wypełnia całą przestrzeń, w której jest renderowana, za pomocą minimalnego dopełnienia. Fałsz, aby użyć domyślnego dopełnienia. (nie dotyczy wykresów danych geograficznych i organizacyjnych).

backgroundColor
(deprecated)

object (Color)

Kolor tła całego wykresu. Nie dotyczy wykresów organizacji. Wycofano: użyj właściwości backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

Kolor tła całego wykresu. Nie dotyczy wykresów organizacji. Jeśli ustawiona jest też wartość backgroundColor, to pole ma pierwszeństwo.

dataSourceChartProperties

object (DataSourceChartProperties)

Jeśli występuje, pole zawiera właściwości związane z wykresem źródeł danych.

filterSpecs[]

object (FilterSpec)

Filtry zastosowane do danych źródłowych wykresu. Obsługiwane tylko w przypadku wykresów źródeł danych.

sortSpecs[]

object (SortSpec)

Kolejność sortowania danych na wykresie. Obsługiwana jest tylko jedna specyfikacja sortowania. Obsługiwane tylko w przypadku wykresów źródeł danych.

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

Określa sposób używania na wykresach ukrytych wierszy i kolumn.

Pole sumy: chart. Określona specyfikacja wykresu musi być określona dokładnie jedna wartość. chart może być tylko jedną z tych wartości:
basicChart

object (BasicChartSpec)

Podstawowa specyfikacja wykresu może być jednym z wielu typów wykresów. Listę wszystkich wykresów, które obsługują ten wykres, znajdziesz BasicChartType.

pieChart

object (PieChartSpec)

Specyfikacja wykresu kołowego.

bubbleChart

object (BubbleChartSpec)

Specyfikacja wykresu bąbelkowego.

candlestickChart

object (CandlestickChartSpec)

Specyfikacja wykresu świecowego.

orgChart

object (OrgChartSpec)

Specyfikacja wykresu organizacyjnego.

histogramChart

object (HistogramChartSpec)

Specyfikacja histogramu.

waterfallChart

object (WaterfallChartSpec)

Specyfikacja wykresu kaskadowego.

treemapChart

object (TreemapChartSpec)

Specyfikacja wykresu drzewa

scorecardChart

object (ScorecardChartSpec)

Specyfikacja wykresu podsumowania statystyk.

Pozycja tekstu

Ustawienia pozycji tekstu.

Zapis JSON
{
  "horizontalAlignment": enum (HorizontalAlign)
}
Pola
horizontalAlignment

enum (HorizontalAlign)

Ustawienie wyrównania w poziomie fragmentu tekstu.

Właściwości wykresu źródła danych

Właściwości wykresu źródła danych.

Zapis JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Pola
dataSourceId

string

Identyfikator źródła danych, z którym jest powiązany wykres.

dataExecutionStatus

object (DataExecutionStatus)

Tylko dane wyjściowe. Stan wykonania danych.

Specyfikacja podstawowego wykresu

Specyfikacja wykresu podstawowego. Listę obsługiwanych wykresów znajdziesz na BasicChartType.

Zapis JSON
{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}
Pola
chartType

enum (BasicChartType)

Typ wykresu.

legendPosition

enum (BasicChartLegendPosition)

Pozycja legendy wykresu.

axis[]

object (BasicChartAxis)

Oś na wykresie.

domains[]

object (BasicChartDomain)

Domena danych, których wykres chcesz utworzyć. Obsługiwana jest tylko jedna domena.

series[]

object (BasicChartSeries)

Dane, które przedstawia wykres na wykresie.

headerCount

integer

Liczba wierszy lub kolumn danych, które są „nagłówkami”. Jeśli nie jest skonfigurowana, Arkusze Google rozpoznają liczbę wierszy na podstawie danych.

(pamiętaj, że wartość BasicChartAxis.title może zastąpić tytuł osi wywnioskowany z wartości nagłówka).

threeDimensional

boolean

Prawda, aby utworzyć wykres 3D. Dotyczy wykresów słupkowych i kolumnowych.

interpolateNulls

boolean

Jeśli brakuje wartości w serii, na wykresie mogą pojawić się luki (np.brakuje segmentów na wykresie liniowym). Aby wyeliminować te luki, ustaw wartość Prawda. Dotyczy to wykresów liniowych, warstwowych i mieszanych.

stackedType

enum (BasicChartStackedType)

Typ skumulowany do wykresów, które obsługują nakładanie pionowe. Dotyczy wykresów warstwowych, słupkowych, kolumnowych, mieszanych i obszarów krokowych.

lineSmoothing

boolean

Określa, czy wszystkie linie mają być domyślnie renderowane płynnie, czy prosto. Dotyczy wykresów liniowych.

compareMode

enum (BasicChartCompareMode)

Działanie etykietek i wyróżnienie danych po najechaniu kursorem na obszar danych.

totalDataLabel

object (DataLabel)

Określa, czy na wykresach skumulowanych wyświetlane są dodatkowe etykiety danych, które sumują łączną wartość wszystkich wartości skumulowanych w każdej wartości na osi domeny. Te etykiety danych można ustawić tylko wtedy, gdy chartType jest jednym z AREA, BAR, COLUMN, COMBO lub STEPPED_AREA , a stackedType ma wartość STACKED lub PERCENT_STACKED. Dodatkowo w przypadku COMBO zostanie obsługiwana tylko wtedy, gdy jest tylko 1 typ serii type z możliwymi do układania modułami lub jeden typ ma więcej serii niż pozostałe, a pozostałe typy mają więcej niż 1 serię. Jeśli na przykład wykres przedstawia 2 serie słupkowe i 1 serię powierzchni, obsługiwane będą etykiety wszystkich danych. Jeśli zawiera on 3 serie słupkowe i 2 serie powierzchni, etykiety wszystkich danych nie są dozwolone. Ani CUSTOM, ani placement nie mogą być ustawione w totalDataLabel.

Typ podstawowego wykresu

Jak powinien wyglądać wykres.

Wartości w polu enum
BASIC_CHART_TYPE_UNSPECIFIED Wartość domyślna, nie używać.
BAR Wykres słupkowy
LINE Wykres liniowy
AREA Wykres warstwowy.
COLUMN Wykres kolumnowy.
SCATTER Wykres rozproszony.
COMBO Wykres mieszany
STEPPED_AREA Wykres warstwowy krokowy.

Pozycja legendy na wykresie podstawowym

Gdzie powinien znajdować się legenda wykresu.

Wartości w polu enum
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED Wartość domyślna, nie używać.
BOTTOM_LEGEND Legenda wyświetla się na dole wykresu.
LEFT_LEGEND Legenda jest renderowana po lewej stronie wykresu.
RIGHT_LEGEND Legenda jest wyświetlana po prawej stronie wykresu.
TOP_LEGEND Legenda jest renderowana nad wykresem.
NO_LEGEND Legenda nie jest renderowana.

Oś wykresu

Oś wykresu. Wykres może mieć maksymalnie 1 oś na axis position.

Zapis JSON
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
Pola
position

enum (BasicChartAxisPosition)

Pozycja tej osi.

title

string

Tytuł tej osi. Jeśli jest ustawiony, zastępuje tytuł z nagłówków danych.

format

object (TextFormat)

Format tytułu. Prawidłowe tylko wtedy, gdy oś nie jest powiązana z domeną. Pole linku nie jest obsługiwane.

titleTextPosition

object (TextPosition)

Tytuł tekstu osi.

viewWindowOptions

object (ChartAxisViewWindowOptions)

Opcje okna widoku tej osi.

Pozycja podstawowego wykresu

Pozycja osi wykresu.

Wartości w polu enum
BASIC_CHART_AXIS_POSITION_UNSPECIFIED Wartość domyślna, nie używać.
BOTTOM_AXIS Oś wyrenderowana u dołu wykresu. W przypadku większości wykresów jest to standardowa oś główna. Na wykresach słupkowych jest to mniejsza oś.
LEFT_AXIS Oś wyrenderowana po lewej stronie wykresu. W przypadku większości wykresów jest to oś mniejsza. W przypadku wykresów słupkowych jest to standardowa oś główna.
RIGHT_AXIS Oś po prawej stronie wykresu. W przypadku większości wykresów jest to oś mniejsza. Jest to nietypowa duża oś dla wykresów słupkowych.

Opcje okresu na wykresie

Opcje, które definiują „okno widoku” wykresu (np. wartości widoczne na osi).

Zapis JSON
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
Pola
viewWindowMin

number

Minimalna wartość liczbowa widoczna w tym oknie widoku. Jeśli zasada jest nieskonfigurowana, automatycznie określa minimalną wartość, która dobrze wygląda dla danych.

viewWindowMax

number

Maksymalna wartość liczbowa widoczna w tym oknie widoku. Jeśli zasada jest nieskonfigurowana, automatycznie określa maksymalną wartość, która pasuje do danych.

viewWindowMode

enum (ViewWindowMode)

Tryb widoku.

Tryb okna

Tryb widoku. Określa sposób traktowania minimalnego i maksymalnego okna widoku.

Wartości w polu enum
DEFAULT_VIEW_WINDOW_MODE Domyślny tryb wyświetlania widoku danych używany w edytorze Arkuszy dla tego typu wykresu W większości przypadków tryb domyślny jest taki sam jak w PRETTY.
VIEW_WINDOW_MODE_UNSUPPORTED Nie używać. Wskazuje, że obecnie ustawiony tryb nie jest obsługiwany przez interfejs API.
EXPLICIT Używa wartości minimalnej i maksymalnej, jeśli zostaną określone. Jeśli wartość jest nieokreślona, przywraca się wartość PRETTY.
PRETTY Określa minimalną i maksymalną wartość, dzięki którym wykres wygląda dobrze. W tym trybie ignorowana jest zarówno wartość minimalna, jak i maksymalna.

DomenaGrafuPodstawowego

Domena wykresu. Na przykład jeśli wykres przedstawia ceny akcji w czasie, będzie to data.

Zapis JSON
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
Pola
domain

object (ChartData)

Dane domeny. Jeśli na przykład notujesz na wykresie ceny akcji w ujęciu czasowym, otrzymasz dane reprezentujące daty.

reversed

boolean

Wartość prawda powoduje odwrócenie kolejności wartości domeny (oś pozioma).

Dane wykresu

Dane zawarte w domenie lub serii.

Zapis JSON
{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}
Pola
groupRule

object (ChartGroupRule)

Reguła do grupowania danych, według których wykres ChartData stanowi bazę danych wykresu źródła danych. Obsługiwane tylko w przypadku wykresów źródeł danych.

aggregateType

enum (ChartAggregateType)

Typ agregacji serii wykresów źródła danych. Obsługiwane tylko w przypadku wykresów źródeł danych.

Pole sumy: type. Typ zawartych danych: należy ustawić dokładnie jedną wartość. type może być tylko jedną z tych wartości:
sourceRange

object (ChartSourceRange)

Zakresy źródłowe danych.

columnReference

object (DataSourceColumnReference)

Odwołanie do kolumny źródła danych, z której odczytuje dane.

Zakres_źródłowy

Zakresy źródłowe wykresu.

Zapis JSON
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
Pola
sources[]

object (GridRange)

Zakresy danych dotyczących serii lub domeny. Dokładnie 1 wymiar musi mieć długość 1, a wszystkie źródła na liście muszą mieć ten sam wymiar o długości 1. Domena (jeśli istnieje) i wszystkie serie muszą mieć taką samą liczbę zakresów źródłowych. Jeśli korzystasz z więcej niż 1 zakresu źródłowego, zakres źródłowy w danym zakresie musi być ustawiony na stałe i ciągle w całej domenie i serii.

Są to na przykład prawidłowe konfiguracje:

domain sources: A1:A5
series1 sources: B1:B5
series2 sources: D6:D10

domain sources: A1:A5, C10:C12
series1 sources: B1:B5, D10:D12
series2 sources: C1:C5, E10:E12

Reguła grupy wykresów

Opcjonalne ustawienie na ChartData domeny wykresu źródła danych, który definiuje zasobniki wartości w domenie, zamiast dzielić poszczególne wartości.

Na przykład na wykresie źródła danych możesz określić regułę histogramu w domenie (zawierającą tylko wartości liczbowe), grupując jego wartości w zasobnika. Wszystkie wartości serii wykresów, które należą do tego samego zasobnika, są agregowane na podstawie aggregateType.

Zapis JSON
{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}
Pola
Pole sumy: rule. Reguła, która ma być stosowana do ChartData. rule może być tylko jedną z tych wartości:
dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule.

histogramRule

object (ChartHistogramRule)

ChartHistogramRule

ChartDateTimeRule

Umożliwia porządkowanie wartości daty i godziny w kolumnie danych źródłowych w zasobniki na podstawie wybranych części ich wartości daty lub godziny.

Zapis JSON
{
  "type": enum (ChartDateTimeRuleType)
}
Pola
type

enum (ChartDateTimeRuleType)

Typ grupowania daty i godziny do zastosowania.

Typ reguły daty i godziny

Dostępne typy reguł grupowania „data i godzina”.

Wartości w polu enum
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED Domyślny typ; nie używaj.
SECOND Grupuj daty według sekund, od 0 do 59.
MINUTE Grupuj daty w minutach od 0 do 59.
HOUR Pogrupuj daty według godziny za pomocą systemu 24-godzinnego, od 0 do 23.
HOUR_MINUTE Grupuj daty według godzin i minut, używając 24-godzinnego systemu, na przykład 19:45.
HOUR_MINUTE_AMPM Pogrupuj daty według godziny i minuty, korzystając z systemu 12-godzinnego, np. 19:45. Oznaczenie AM/PM jest tłumaczone na podstawie języka arkusza kalkulacyjnego.
DAY_OF_WEEK Grupuj daty według dnia tygodnia, na przykład niedziela. Dni tygodnia będą tłumaczone na podstawie języka arkusza kalkulacyjnego.
DAY_OF_YEAR Pogrupuj daty według dni roku, od 1 do 366. Pamiętaj, że daty po 29 lutego należą do różnych segmentów w roku przestępnym, a nie w roku przestępnym.
DAY_OF_MONTH Pogrupuj daty według dni miesiąca, od 1 do 31.
DAY_MONTH Grupuj daty według dnia i miesiąca, np. 22–12.12. Miesiąc jest tłumaczony na podstawie języka arkusza kalkulacyjnego.
MONTH Grupuj daty według miesięcy, na przykład listopad. Miesiąc jest tłumaczony na podstawie ustawień regionalnych arkusza kalkulacyjnego.
QUARTER Pogrupuj daty według kwartału, np. I kwartał (styczeń–marca).
YEAR Pogrupuj daty według roku, na przykład 2008.
YEAR_MONTH Grupuj daty według roku i miesiąca, na przykład 2008–listopad. Miesiąc jest tłumaczony na podstawie ustawień arkusza kalkulacyjnego.
YEAR_QUARTER Pogrupuj daty według roku i kwartału, na przykład 4 kwartał 2008 r.
YEAR_MONTH_DAY Pogrupuj daty według roku, miesiąca i dnia, na przykład 2008-11-22.

Reguła Histogram

Umożliwia porządkowanie wartości liczbowych w kolumnie danych źródłowych w zasobniki o stałym rozmiarze.

Zapis JSON
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
Pola
minValue

number

Minimalna wartość, przy której elementy są umieszczane w zasobnikach. Wartości mniejsze niż minimalne są grupowane w jeden zasobnik. W przypadku jego pominięcia wartość jest określana na podstawie minimalnej wartości elementu.

maxValue

number

Maksymalna wartość, w której elementy są umieszczane w zasobnikach. Wartości wyższe niż maksymalne są zgrupowane w jednym zasobniku. Jeśli zostanie pominięty, zależy od maksymalnej wartości elementu.

intervalSize

number

Rozmiar tworzonych zasobników. Musi być dodatnia.

Typ wykresu

Typ agregacji serii wykresów.

Wartości w polu enum
CHART_AGGREGATE_TYPE_UNSPECIFIED Wartość domyślna, nie używać.
AVERAGE Średnia funkcja agregacji.
COUNT Funkcja liczenia agregacji.
MAX Maksymalna funkcja agregacji.
MEDIAN Mediana agregacji.
MIN Minimalna funkcja agregacji.
SUM Sumuj funkcję zbiorczą.

Serie wykresów podstawowych

Pojedyncza seria danych na wykresie. Jeśli na przykład notujesz ceny akcji na przestrzeni czasu, możesz mieć do czynienia z wieloma serialami, po jednej dla kategorii „Cena otwarta”, „Niska cena” i „Cena zamknięcia”.

Zapis JSON
{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}
Pola
series

object (ChartData)

Dane przedstawione w tej serii wykresów.

targetAxis

enum (BasicChartAxisPosition)

Oś dodatkowa określająca zakres wartości dla tej serii. Jeśli na przykład na wykresie notowania giełdowe będą się zmieniać, seria „Liczba” może być przypięta po prawej stronie z cenami przypiętymi po lewej stronie, bo skalę handlu można zmienić na inną skalę. Określenie osi, która nie jest prawidłową osią podrzędną obiektu type wykresu, jest błędem.

type

enum (BasicChartType)

Typ tej serii. Wartość obowiązuje tylko wtedy, gdy chartType to COMBO. Różne typy zmieniają sposób wizualizacji serii. Obsługiwane są tylko zasady LINE, AREA i COLUMN.

lineStyle

object (LineStyle)

Styl linii w tej serii. Obowiązuje tylko wtedy, gdy chartType to AREA, LINE lub SCATTER. Wykresy COMBO są również obsługiwane, jeśli series chart type to AREA lub LINE.

dataLabel

object (DataLabel)

Informacje o etykietach danych tej serii.

color
(deprecated)

object (Color)

Kolor elementów (takich jak słupki, linie i punkty) powiązanych z tą serią. Jeśli jest pusty, używany jest kolor domyślny. Wycofano: użyj właściwości colorStyle.

colorStyle

object (ColorStyle)

Kolor elementów (takich jak słupki, linie i punkty) powiązanych z tą serią. Jeśli jest pusty, używany jest kolor domyślny. Jeśli ustawiona jest też wartość color, to pole ma pierwszeństwo.

pointStyle

object (PointStyle)

Styl punktów powiązanych z tą serią. Obowiązuje tylko wtedy, gdy chartType to AREA, LINE lub SCATTER. Wykresy COMBO są również obsługiwane, jeśli series chart type to AREA, LINE lub SCATTER. Jeśli jest pusty, używany jest domyślny styl punktu.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

Ustawienia zastępowania stylu dla punktów danych serii.

Styl linii

Właściwości opisujące styl linii.

Zapis JSON
{
  "width": integer,
  "type": enum (LineDashType)
}
Pola
width

integer

Grubość linii w pikselach.

type

enum (LineDashType)

Styl linii.

Rodzaj linii

Styl linii.

Wartości w polu enum
LINE_DASH_TYPE_UNSPECIFIED Wartość domyślna, nie używać.
INVISIBLE Brak typu kreski, który odpowiada liczbie niewidocznej linii.
CUSTOM Niestandardowy łącznik dotyczący linii. Zmiana dokładnego niestandardowego stylu kreski nie jest obecnie obsługiwana.
SOLID Linia ciągła.
DOTTED Linia przerywana.
MEDIUM_DASHED Linia przerywana, w której myślniki są zapisane „średnio”.
MEDIUM_DASHED_DOTTED Linia zmieniająca „pary” i „średnią” kropkę.
LONG_DASHED Linia przerywana, w której myślniki są długie.
LONG_DASHED_DOTTED Linia zmieniająca czas między „długim” łącznikiem a kropką.

Etykieta danych

Ustawienia dla jednego zestawu etykiet danych. Etykiety danych to adnotacje, które pojawiają się obok zbioru danych, takie jak punkty na wykresie liniowym i dostarczają dodatkowych informacji o tym, co reprezentują dane, np. prezentacji wartości znajdującej się za tym punktem na wykresie.

Zapis JSON
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
Pola
type

enum (DataLabelType)

Typ etykiety danych.

textFormat

object (TextFormat)

Format tekstu etykiety danych. Pole linku nie jest obsługiwane.

placement

enum (DataLabelPlacement)

Umieszczanie etykiety danych względem danych oznaczonych etykietą.

customLabelData

object (ChartData)

Dane, które mają być używane na potrzeby etykiet własnych. Używany tylko wtedy, gdy type ma wartość CUSTOM. Te dane muszą mieć taką samą długość jak seria lub inny element, do którego odnosi się ta etykieta danych. Jeśli seria jest podzielona na wiele zakresów źródłowych, dane źródłowe muszą pochodzić z następnej kolumny tych danych. Jeśli np. seria to B2:B4, E6:E8,dane te muszą pochodzić z kodu C2:C4,F6:F8.

Typ etykiety danych

Typ etykiety danych.

Wartości w polu enum
DATA_LABEL_TYPE_UNSPECIFIED Typ etykiety danych nie jest określony i będzie interpretowany w zależności od kontekstu etykiety danych na wykresie.
NONE Etykieta danych nie jest wyświetlana.
DATA Etykieta danych jest wyświetlana z wykorzystaniem wartości z danych serii.
CUSTOM Etykieta danych jest wyświetlana z użyciem wartości z niestandardowego źródła danych wskazanej przez customLabelData.

Miejsce_etykiety danych

Umieszczanie etykiety danych względem danych oznaczonych etykietą.

Wartości w polu enum
DATA_LABEL_PLACEMENT_UNSPECIFIED Pozycjonowanie jest określane automatycznie przez mechanizm renderowania.
CENTER na środku paska lub kolumny, zarówno w poziomie, jak i w pionie;
LEFT Po lewej stronie punktu danych.
RIGHT Po prawej stronie punktu danych.
ABOVE Powyżej punktu danych.
BELOW Poniżej punktu danych.
INSIDE_END Wewnątrz paska lub kolumny na końcu (u góry, jeśli znak dodatni, na dole – znak minus).
INSIDE_BASE W pasku lub kolumnie u dołu.
OUTSIDE_END Poza paskiem lub kolumną na końcu.

Styl punktu

Styl punktu na wykresie.

Zapis JSON
{
  "size": number,
  "shape": enum (PointShape)
}
Pola
size

number

Rozmiar punktu. Jeśli jest pusty, używany jest rozmiar domyślny.

shape

enum (PointShape)

Kształt punktu. Jeśli jest pusty lub nieokreślony, używany jest kształt domyślny.

Okrągły

Kształt punktu.

Wartości w polu enum
POINT_SHAPE_UNSPECIFIED Wartość domyślna.
CIRCLE Kształt okręgu.
DIAMOND Rombowy kształt.
HEXAGON Sześciokąt
PENTAGON Pięciokąt
SQUARE Kwadratowy.
STAR Kształt gwiazdy.
TRIANGLE Trójkąt.
X_MARK Kształt litery X.

Podstawowy Ciąg danychSparowaniaDuży

Ustawienia zastępowania stylu dla pojedynczego punktu danych serii.

Zapis JSON
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
Pola
index

integer

Indeks zerowy punktu danych serii.

color
(deprecated)

object (Color)

Kolor punktu danych serii. Jeśli to pole jest puste, używana jest wartość domyślna serii. Wycofano: użyj właściwości colorStyle.

colorStyle

object (ColorStyle)

Kolor punktu danych serii. Jeśli to pole jest puste, używana jest wartość domyślna serii. Jeśli ustawiona jest też wartość color, to pole ma pierwszeństwo.

pointStyle

object (PointStyle)

Styl punktu danych serii. Obowiązuje tylko wtedy, gdy chartType to AREA, LINE lub SCATTER. Wykresy COMBO są również obsługiwane, jeśli series chart type to AREA, LINE lub SCATTER. Jeśli to pole jest puste, używana jest wartość domyślna serii.

Typ podstawowego wykresu umieszczony

Gdy wykresy są skumulowane, wartości zakresu (oś pionowa) są renderowane jedna nad drugą, a nie oś poziomą. Na przykład dwie wartości 20 i 80 zostaną pobrane z zakresu 0, gdzie 80 będzie oddalone o 80 jednostek od osi poziomej. W sytuacji, gdy byłyby nałożone na siebie, 80 zostaną wyrenderowane z 20, przez co 100 jednostek oddali się od osi poziomej.

Wartości w polu enum
BASIC_CHART_STACKED_TYPE_UNSPECIFIED Wartość domyślna, nie używać.
NOT_STACKED Seria nie jest skumulowana.
STACKED Wartości serii są skumulowane, a każda wartość jest wyświetlana pionowo na górze wartości znajdującej się pod nią.
PERCENT_STACKED Stosy pionowe są rozciągnięte, by dotrzeć do początku wykresu, a wartości są ułożone według wartości procentowych.

Tryb podstawowego porównania wykresów

Tryb porównywania, który opisuje zachowanie etykietek i wyróżnienia danych po najechaniu kursorem na obszar danych i wykresu.

Wartości w polu enum
BASIC_CHART_COMPARE_MODE_UNSPECIFIED Wartość domyślna, nie używać.
DATUM Etykietka jest wyróżniona i wyświetlana w etykietce.
CATEGORY Wszystkie elementy danych z tej samej kategorii (np. wartość domeny) są wyróżnione i wyświetlane w etykietce.

Specyfikacja wykresu kołowego

Wykres kołowy.

Zapis JSON
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
Pola
legendPosition

enum (PieChartLegendPosition)

Miejsce narysowania legendy do wykresu kołowego.

domain

object (ChartData)

Dane dotyczące domeny wykresu kołowego.

series

object (ChartData)

Dane obejmujące tylko jedną serię wykresów kołowych.

threeDimensional

boolean

Prawda, jeśli ciasto ma trójwymiarowe wymiary.

pieHole

number

Rozmiar otworu na wykresie kołowym.

Pozycja legendy wykresu kołowego

Gdzie powinien znajdować się legenda wykresu.

Wartości w polu enum
PIE_CHART_LEGEND_POSITION_UNSPECIFIED Wartość domyślna, nie używać.
BOTTOM_LEGEND Legenda wyświetla się na dole wykresu.
LEFT_LEGEND Legenda jest renderowana po lewej stronie wykresu.
RIGHT_LEGEND Legenda jest wyświetlana po prawej stronie wykresu.
TOP_LEGEND Legenda jest renderowana nad wykresem.
NO_LEGEND Legenda nie jest renderowana.
LABELED_LEGEND Każdy wycinek koła jest oznaczony etykietą.

Specyfikacja wykresu bąbelkowego

Wykres bąbelkowy

Zapis JSON
{
  "legendPosition": enum (BubbleChartLegendPosition),
  "bubbleLabels": {
    object (ChartData)
  },
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "groupIds": {
    object (ChartData)
  },
  "bubbleSizes": {
    object (ChartData)
  },
  "bubbleOpacity": number,
  "bubbleBorderColor": {
    object (Color)
  },
  "bubbleBorderColorStyle": {
    object (ColorStyle)
  },
  "bubbleMaxRadiusSize": integer,
  "bubbleMinRadiusSize": integer,
  "bubbleTextStyle": {
    object (TextFormat)
  }
}
Pola
legendPosition

enum (BubbleChartLegendPosition)

Miejsce narysowania legendy wykresu.

bubbleLabels

object (ChartData)

Dane zawierające etykiety dymków. Nie muszą być niepowtarzalne.

domain

object (ChartData)

Dane zawierające wartości bąbelkowych. Te wartości służą do lokalizowania dymków na wykresie w poziomie.

series

object (ChartData)

Dane zawierające wartości y dymków. Te wartości służą do lokalizowania dymków na wykresie w pionie.

groupIds

object (ChartData)

Dane zawierające identyfikatory grup dymków. Wszystkie dymki z tym samym identyfikatorem grupy są rysowane w tym samym kolorze. Jeśli określono bubbleSizes, musisz też określić to pole, ale może ono zawierać puste wartości. To pole jest opcjonalne.

bubbleSizes

object (ChartData)

Dane zawierające rozmiary bąbelków. Rozmiary bąbelków służą do rysowania dymków w różnych rozmiarach względem siebie. Jeśli jest określony, musisz też podać groupIds. To pole jest opcjonalne.

bubbleOpacity

number

Przezroczystość bąbelków z zakresu od 0 do 1,0. 0 oznacza pełną przezroczystość, a 1 – pełną nieprzezroczystość.

bubbleBorderColor
(deprecated)

object (Color)

Kolor obramowania dymka. Wycofano: użyj właściwości bubbleBorderColorStyle.

bubbleBorderColorStyle

object (ColorStyle)

Kolor obramowania dymka. Jeśli ustawiona jest też wartość bubbleBorderColor, to pole ma pierwszeństwo.

bubbleMaxRadiusSize

integer

Maksymalny promień promienia w pikselach. Jeśli jest określona, pole musi zawierać wartość dodatnią.

bubbleMinRadiusSize

integer

Minimalny rozmiar dymków w pikselach. Jeśli jest określona, pole musi zawierać wartość dodatnią.

bubbleTextStyle

object (TextFormat)

Format tekstu w dymkach. Przekreślenie, podkreślenie i link nie są obsługiwane.

Pozycja wykresu bąbelkowego

Gdzie powinien znajdować się legenda wykresu.

Wartości w polu enum
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED Wartość domyślna, nie używać.
BOTTOM_LEGEND Legenda wyświetla się na dole wykresu.
LEFT_LEGEND Legenda jest renderowana po lewej stronie wykresu.
RIGHT_LEGEND Legenda jest wyświetlana po prawej stronie wykresu.
TOP_LEGEND Legenda jest renderowana nad wykresem.
NO_LEGEND Legenda nie jest renderowana.
INSIDE_LEGEND Legenda jest renderowana wewnątrz obszaru wykresu.

Specyfikacja wykresu świecowego

Wykres świecowy.

Zapis JSON
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
Pola
domain

object (CandlestickDomain)

Dane domeny (oś pozioma) wykresu świecowego. Dane o ciągu znaków będą traktowane jako osobne etykiety, a inne – jako wartości ciągłe.

data[]

object (CandlestickData)

Dane wykresu świecowego. Obsługiwana jest tylko jedna funkcja CandlestickData.

Świecznik

Domena wykresu świecowego.

Zapis JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Pola
data

object (ChartData)

Dane CandlestickDomain.

reversed

boolean

Wartość prawda powoduje odwrócenie kolejności wartości domeny (oś pozioma).

Świecznik

Dane wykresu świecowego zawierające wartości niskie, otwarte, zamknięte i wysokie dla serii.

Zapis JSON
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
Pola
lowSeries

object (CandlestickSeries)

Dane zakresu (oś pionowa) dla małej wartości minimalnej dla każdej świecy. Ta wartość oznacza dolny koniec środkowej linii świecy.

openSeries

object (CandlestickSeries)

Dane zakresu (oś pionowa) dla wartości otwartej/początkowej każdej świecy. Ta wartość przedstawia dolną część świecy. Świeca będzie wypełniana wartością mniejszą niż zamknięta. W przeciwnym razie świeca będzie pusta.

closeSeries

object (CandlestickSeries)

Dane zakresu (oś pionowa) dla wartości zamkniętej/końcowej każdej świecy. Ta górna część świecy. Świeca będzie wypełniona wartością większą niż otwarta. W przeciwnym razie świeca będzie pusta.

highSeries

object (CandlestickSeries)

Dane zakresu (oś pionowa) dla każdej wartości świeczki. Ta wartość wyznacza górny koniec środkowej linii świecy.

Seria świecowa

Seria CandlestickData.

Zapis JSON
{
  "data": {
    object (ChartData)
  }
}
Pola
data

object (ChartData)

Dane CandlestickSeries.

Specyfikacja wykresu organizacyjnego

Wykres organizacyjny. Wykresy organizacyjne wymagają unikalnego zestawu etykiet w labels i mogą opcjonalnie zawierać parentLabels i tooltips. parentLabels zawiera etykietę identyfikującą węzeł nadrzędny. tooltips: w przypadku każdego węzła zawiera opcjonalną etykietę.

Aby na przykład opisać schemat organizacyjny – Alicja jako prezeska, Robert (jako wiceprezes – Alicja) i Kasia – wiceprezeska ds. sprzedaży, powinna labels mieć „Alicja”, „Robert”, „Kasia”, „parentLabels” – „”, „Alicja”, „Alicja” i „Prezes”.tooltips

Zapis JSON
{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}
Pola
nodeSize

enum (OrgChartNodeSize)

Rozmiar węzłów wykresu organizacyjnego.

nodeColor
(deprecated)

object (Color)

Kolor węzłów wykresu organizacyjnego. Wycofano: użyj właściwości nodeColorStyle.

nodeColorStyle

object (ColorStyle)

Kolor węzłów wykresu organizacyjnego. Jeśli ustawiona jest też wartość nodeColor, to pole ma pierwszeństwo.

selectedNodeColor
(deprecated)

object (Color)

Kolor wybranych węzłów wykresu organizacyjnego. Wycofano: użyj właściwości selectedNodeColorStyle.

selectedNodeColorStyle

object (ColorStyle)

Kolor wybranych węzłów wykresu organizacyjnego. Jeśli ustawiona jest też wartość selectedNodeColor, to pole ma pierwszeństwo.

labels

object (ChartData)

Dane zawierające etykiety wszystkich węzłów na wykresie. Etykiety muszą być unikalne.

parentLabels

object (ChartData)

Dane zawierające etykietę elementu nadrzędnego danego węzła. Pusta wartość oznacza, że węzeł nie ma obiektu nadrzędnego i jest węzłem najwyższego poziomu. To pole jest opcjonalne.

tooltips

object (ChartData)

Dane zawierające etykietkę odpowiedniego węzła. Pusta wartość oznacza, że w węźle nie wyświetla się etykietka. To pole jest opcjonalne.

Rozmiarwęzła organizacji

Rozmiar węzłów wykresu organizacyjnego.

Wartości w polu enum
ORG_CHART_LABEL_SIZE_UNSPECIFIED Wartość domyślna, nie używać.
SMALL Mały rozmiar węzła na wykresie organizacyjnym.
MEDIUM Rozmiar węzła wykresu w organizacji średniej.
LARGE Duży rozmiar węzła wykresu organizacyjnego.

HistogramGrafSpecSpec

Wykres histogramu. Histogram grupuje elementy danych w koszyki i każde z nich przedstawia się jako kolumna skumulowanych elementów. Histogramy służą do wyświetlania rozkładu zbioru danych. Każda kolumna elementów reprezentuje zakres, do którego należą te elementy. Liczba kontenerów można wybrać automatycznie lub określić wyraźnie.

Zapis JSON
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
Pola
series[]

object (HistogramSeries)

Seria histogramu może obejmować jedną serię wartości do grupowania lub wiele serii, z których każda ma tę samą długość i zawiera nazwę serii, a następnie wartości, które mają być połączone z tą serią.

legendPosition

enum (HistogramChartLegendPosition)

Pozycja legendy wykresu.

showItemDividers

boolean

Określa, czy poziome linie separatora mają być wyświetlane między elementami w każdej kolumnie.

bucketSize

number

Domyślnie wybrany jest rozmiar zasobnika (zakres wartości w jednej kolumnie), ale można go zastąpić tutaj. Np. Wielkość zasobnika wynosząca 1,5 oznacza, że zasobniki należą do zakresu od 0 do 1,5, 1,5–3,0 itd. Nie może być liczbą ujemną. To pole jest opcjonalne.

outlierPercentile

number

Percentyl wartości odstających służy do niekorzystnego wpływu na obliczanie rozmiarów zasobników. Na przykład ustawienie wartości odstające od 0,05 oznacza, że górne i dolne 5% wartości podczas obliczania zasobników. Wartości są nadal uwzględniane na wykresie. Zostaną dodane do pierwszego lub ostatniego zasobnika, a nie jako ich własne. Wymagana wartość z zakresu od 0,0 do 0,5.

Seria histogramu

Seria histogramu zawierająca kolor i dane serii.

Zapis JSON
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
Pola
barColor
(deprecated)

object (Color)

Kolor kolumny reprezentującej tę serię w każdym zasobniku. To pole jest opcjonalne. Wycofano: użyj właściwości barColorStyle.

barColorStyle

object (ColorStyle)

Kolor kolumny reprezentującej tę serię w każdym zasobniku. To pole jest opcjonalne. Jeśli ustawiona jest też wartość barColor, to pole ma pierwszeństwo.

data

object (ChartData)

Dane do tego histogramu.

HistogramWykres legendy

Gdzie powinien znajdować się legenda wykresu.

Wartości w polu enum
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED Wartość domyślna, nie używać.
BOTTOM_LEGEND Legenda wyświetla się na dole wykresu.
LEFT_LEGEND Legenda jest renderowana po lewej stronie wykresu.
RIGHT_LEGEND Legenda jest wyświetlana po prawej stronie wykresu.
TOP_LEGEND Legenda jest renderowana nad wykresem.
NO_LEGEND Legenda nie jest renderowana.
INSIDE_LEGEND Legenda jest renderowana wewnątrz obszaru wykresu.

Specyfikacja wodospadu

Wykres kaskadowy

Zapis JSON
{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}
Pola
domain

object (WaterfallChartDomain)

Dane domeny (oś pozioma) wykresu kaskadowego.

series[]

object (WaterfallChartSeries)

Dane, które przedstawia ten wykres kaskadowy.

stackedType

enum (WaterfallChartStackedType)

Typ skumulowany.

firstValueIsTotal

boolean

Wartość prawda pozwala ogólnie zinterpretować pierwszą wartość.

hideConnectorLines

boolean

Wartość prawda powoduje ukrycie linii oprogramowania sprzęgającego między kolumnami.

connectorLineStyle

object (LineStyle)

Styl linii linii oprogramowania sprzęgającego.

totalDataLabel

object (DataLabel)

Określa, czy na wykresach skumulowanych wyświetlane są dodatkowe etykiety danych, które sumują łączną wartość wszystkich wartości skumulowanych w każdej wartości na osi domeny. stackedType musi mieć wartość STACKED, a nie można ustawić właściwości CUSTOM ani placement na totalDataLabel.

DomenaPotoku Wodospadów

Domena wykresu kaskadowego.

Zapis JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Pola
data

object (ChartData)

Dane z GasneyChartDomain.

reversed

boolean

Wartość prawda powoduje odwrócenie kolejności wartości domeny (oś pozioma).

Seria kaskadowa

Pojedyncza seria danych do wykresu kaskadowego.

Zapis JSON
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
Pola
data

object (ChartData)

Dane przedstawione w tej serii.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

Style we wszystkich kolumnach w tej serii z wartościami dodatnimi.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

Style we wszystkich kolumnach w tej serii z wartościami ujemnymi.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

Style dla wszystkich kolumn części podrzędnych w tej serii.

hideTrailingSubtotal

boolean

Wartość prawda powoduje ukrycie kolumny sumy częściowej na końcu serii. Domyślnie na końcu każdej serii pojawi się kolumna sumy częściowej. Jeśli to pole ma wartość Prawda, ta kolumna sumy częściowej dla tej serii jest ukryta.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

Niestandardowe kolumny sumy częściowej wyświetlane w tej serii. Kolejność obowiązywania sum częściowych nie jest istotna. Dla każdego punktu danych można określić tylko jedną sumę częściową.

dataLabel

object (DataLabel)

Informacje o etykietach danych tej serii.

KaskadowyWykres kolumnowy

Style w formie kolumny kaskadowej.

Zapis JSON
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Pola
label

string

Etykieta legendy kolumny.

color
(deprecated)

object (Color)

Kolor kolumny. Wycofano: użyj właściwości colorStyle.

colorStyle

object (ColorStyle)

Kolor kolumny. Jeśli ustawiona jest też wartość color, to pole ma pierwszeństwo.

KaskadowyWykres niestandardowySubsumowy

Niestandardowa kolumna sumy częściowej dla serii kaskadowych wykresów.

Zapis JSON
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
Pola
subtotalIndex

integer

Indeks zerowy punktu danych w serii. Jeśli dataIsSubtotal ma wartość Prawda, punkt danych w tym indeksie jest sumą częściową. W przeciwnym razie suma częściowa pojawi się po punkcie danych z tym indeksem. Serie mogą mieć wiele sum częściowych w arbitralnych indeksach, ale sumy częściowe nie mają wpływu na indeksy punktów danych. Jeśli na przykład seria ma 3 punkty danych, jej indeksy będą zawsze wynosić 0, 1 i 2, niezależnie od tego, ile sum częściowych istnieje w serii i z jakimi punktami danych są powiązane.

label

string

Etykieta kolumny sumy częściowej.

dataIsSubtotal

boolean

Prawda, jeśli punkt danych na poziomie subtotalIndex jest sumą częściową. Jeśli ma wartość false (fałsz), suma częściowa zostanie obliczona i pojawi się po punkcie danych.

Typ wykresu kaskadowego

Opcje typów skumulowanych wykresów kaskadowych.

Wartości w polu enum
WATERFALL_STACKED_TYPE_UNSPECIFIED Wartość domyślna, nie używać.
STACKED Wartości odpowiadające tej samej domenie (oś pozioma) zostaną ułożone pionowo.
SEQUENTIAL Ciągi będą widoczne wzdłuż osi poziomej.

Specyfikacja Diagramy

Wykres graficzny.

Zapis JSON
{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}
Pola
labels

object (ChartData)

Dane zawierające etykiety komórek w mapie drzewa.

parentLabels

object (ChartData)

Dane zawierają etykiety nadrzędne komórek mapy drzewa.

sizeData

object (ChartData)

Dane, które określają rozmiar każdej komórki mapy drzewa. Dane te muszą mieć wartości liczbowe. Komórki odpowiadające danym nieliczbowym lub brakujących nie zostaną wyrenderowane. Jeśli colorData nie zostanie określony, te dane będą też używane do określania kolorów tła komórek danych.

colorData

object (ChartData)

Dane, które określają kolor tła każdej komórki danych mapy drzewa. To pole jest opcjonalne. Jeśli nie podasz koloru, do określenia kolorów tła służy sizeData. Jeśli jest określona, dane powinny być liczbami. colorScale będzie określać sposób mapowania wartości w tej mapie na kolory tła komórek danych.

textFormat

object (TextFormat)

Format tekstowy dla wszystkich etykiet na wykresie. Pole linku nie jest obsługiwane.

levels

integer

Liczba poziomów danych wyświetlanych na wykresie w formie drzewa. Te poziomy są interaktywne i są oznaczone etykietami. Jeśli nie zostaną podane, domyślnie przyjmuje się wartość 2.

hintedLevels

integer

Liczba dodatkowych poziomów danych poza poziomami oznaczonych etykietami wyświetlanych na wykresie w formie drzewa. Te poziomy nie są interaktywne i są wyświetlane bez ich etykiet. Jeśli nie zostanie podana, wartość domyślna to 0.

minValue

number

Minimalna możliwa wartość danych. Komórki z wartością mniejszą niż ta będą miały ten sam kolor co komórki z tą wartością. Jeśli nie podasz tu żadnej wartości, zostanie użyta domyślna wartość minimalna od colorData lub minimalna wartość z pola sizeData, jeśli nie podasz właściwości colorData.

maxValue

number

Maksymalna możliwa wartość danych. Komórki z wartościami większymi niż ten mają ten sam kolor co komórki z tą wartością. Jeśli nie podano tej wartości, przyjmuje ona domyślną wartość maksymalną z colorData lub maksymalną wartość z sizeData, jeśli nie określono colorData.

headerColor
(deprecated)

object (Color)

Kolor tła komórek nagłówków. Wycofano: użyj właściwości headerColorStyle.

headerColorStyle

object (ColorStyle)

Kolor tła komórek nagłówków. Jeśli ustawiona jest też wartość headerColor, to pole ma pierwszeństwo.

colorScale

object (TreemapChartColorScale)

Skala kolorów dla komórek danych na wykresie drzewa. Komórkom danych są przypisywane kolory na podstawie ich wartości kolorów. Te wartości kolorów pochodzą z właściwości colorData lub od sizeData, jeśli nie określono właściwości colorData. Komórki, których wartość koloru jest mniejsza lub równa minValue, będą mieć kolor tła minValueColor. Kolorem tła komórek, których wartość koloru jest co najmniej maxValue, jest maxValueColor. Komórki z wartościami kolorów od minValue do maxValue będą miały kolory tła na gradientie między minValueColor a maxValueColor. W tym środku będzie znajdować się wartość midValueColor. Komórki z brakującymi lub nieliczbowymi wartościami kolorów będą mieć kolor tła noDataColor.

hideTooltips

boolean

Wartość prawda pozwala ukryć etykietki.

Skala kolorów mapy drzewa

Skala kolorów dla wykresu drzewa.

Zapis JSON
{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}
Pola
minValueColor
(deprecated)

object (Color)

Kolor tła komórek z wartością koloru mniejszą niż lub równą minValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #dc3912. Wycofano: użyj właściwości minValueColorStyle.

minValueColorStyle

object (ColorStyle)

Kolor tła komórek z wartością koloru mniejszą niż lub równą minValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #dc3912. Jeśli ustawiona jest też wartość minValueColor, to pole ma pierwszeństwo.

midValueColor
(deprecated)

object (Color)

Kolor tła komórek z wartością koloru w połowie między minValue a maxValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #efe6dc. Wycofano: użyj właściwości midValueColorStyle.

midValueColorStyle

object (ColorStyle)

Kolor tła komórek z wartością koloru w połowie między minValue a maxValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #efe6dc. Jeśli ustawiona jest też wartość midValueColor, to pole ma pierwszeństwo.

maxValueColor
(deprecated)

object (Color)

Kolor tła komórek z wartością koloru większą lub równą maxValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #109618. Wycofano: użyj właściwości maxValueColorStyle.

maxValueColorStyle

object (ColorStyle)

Kolor tła komórek z wartością koloru większą lub równą maxValue. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #109618. Jeśli ustawiona jest też wartość maxValueColor, to pole ma pierwszeństwo.

noDataColor
(deprecated)

object (Color)

Kolor tła komórek, z którymi nie są powiązane dane koloru. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #000000. Wycofano: użyj właściwości noDataColorStyle.

noDataColorStyle

object (ColorStyle)

Kolor tła komórek, z którymi nie są powiązane dane koloru. Jeśli nie zostanie podany, przyjmuje się domyślnie wartość #000000. Jeśli ustawiona jest też wartość noDataColor, to pole ma pierwszeństwo.

Tabela wyników specyfikacji karty

Wykres podsumowania statystyk. Wykresy podsumowania statystyk służą do wyróżniania w arkuszu kalkulacyjnym kluczowych wskaźników wydajności, znanych jako KPI. Wykres podsumowania statystyk może pokazywać takie dane jak łączna sprzedaż, średni koszt czy bestseller. Możesz podać pojedynczą wartość danych lub zagregować je w zakresie danych. Można wyróżnić wartość procentową lub bezwzględną względem wartości bazowej, np. zmiany w czasie.

Zapis JSON
{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}
Pola
keyValueData

object (ChartData)

Dane pary klucz-wartość w podsumowaniu statystyk.

baselineValueData

object (ChartData)

Dane wartości bazowej podsumowania statystyk. To pole jest opcjonalne.

aggregateType

enum (ChartAggregateType)

Typ agregacji dla kluczowych i podstawowych danych na wykresie podsumowania statystyk. To pole nie jest obsługiwane w przypadku wykresów źródeł danych. Na wykresie źródła danych użyj pola ChartData.aggregateType w metodzie keyValueData lub baselineValueData. To pole jest opcjonalne.

keyValueFormat

object (KeyValueFormat)

Opcje formatowania pary klucz-wartość.

baselineValueFormat

object (BaselineValueFormat)

Opcje formatowania wartości bazowej. To pole jest wymagane tylko wtedy, gdy określono baselineValueData.

scaleFactor

number

Wartość do skalowania klucza podsumowania statystyk i wartości bazowej. Na przykład współczynnik 10 może zostać użyty do podzielenia wszystkich wartości na wykresie przez 10. To pole jest opcjonalne.

numberFormatSource

enum (ChartNumberFormatSource)

Źródło formatu liczb używanego na wykresie podsumowania statystyk. To pole jest opcjonalne.

customFormatOptions

object (ChartCustomNumberFormatOptions)

Niestandardowe opcje formatowania par klucz-wartość liczbowych lub podstawowych na wykresie podsumowania statystyk. To pole jest używane tylko wtedy, gdy numberFormatSource ma wartość CUSTOM. To pole jest opcjonalne.

Format klucza-wartości

Opcje formatowania pary klucz-wartość.

Zapis JSON
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
Pola
textFormat

object (TextFormat)

Opcje formatowania tekstu dla pary klucz-wartość. Pole linku nie jest obsługiwane.

position

object (TextPosition)

Określa pozycję tekstu w poziomie dla par klucz-wartość. To pole jest opcjonalne. Jeśli zasada nie jest określona, używane jest domyślne położenie.

Podstawowy format wartości

Opcje formatowania wartości bazowej.

Zapis JSON
{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}
Pola
comparisonType

enum (ComparisonType)

Typ porównania wartości kluczowej z wartością bazową.

textFormat

object (TextFormat)

Opcje formatowania tekstu dla wartości bazowej. Pole linku nie jest obsługiwane.

position

object (TextPosition)

Określa poziome pozycjonowanie tekstu w wartości bazowej. To pole jest opcjonalne. Jeśli zasada nie jest określona, używane jest domyślne położenie.

description

string

Opis, który jest dołączany po wartości bazowej. To pole jest opcjonalne.

positiveColor
(deprecated)

object (Color)

Używane są kolory, jeśli wartość bazowa odpowiada dodatniej zmianie wartości klucza. To pole jest opcjonalne. Wycofano: użyj właściwości positiveColorStyle.

positiveColorStyle

object (ColorStyle)

Używane są kolory, jeśli wartość bazowa odpowiada dodatniej zmianie wartości klucza. To pole jest opcjonalne. Jeśli ustawiona jest też wartość positiveColor, to pole ma pierwszeństwo.

negativeColor
(deprecated)

object (Color)

Kolor, który ma być użyty, jeśli wartość bazowa odpowiada ujemnej zmianie wartości kluczowej. To pole jest opcjonalne. Wycofano: użyj właściwości negativeColorStyle.

negativeColorStyle

object (ColorStyle)

Kolor, który ma być użyty, jeśli wartość bazowa odpowiada ujemnej zmianie wartości kluczowej. To pole jest opcjonalne. Jeśli ustawiona jest też wartość negativeColor, to pole ma pierwszeństwo.

Typ porównania

Typ porównania wartości kluczowej z wartością bazową.

Wartości w polu enum
COMPARISON_TYPE_UNDEFINED Wartość domyślna, nie używać.
ABSOLUTE_DIFFERENCE Użyj różnicy bezwzględnej między wartością klucza a wartością bazową.
PERCENTAGE_DIFFERENCE Użyj różnicy procentowej między wartością klucza a wartością bazową.

Źródło formatu liczb

Opcje źródła formatowania liczb dla atrybutów wykresu.

Wartości w polu enum
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Wartość domyślna, nie używać.
FROM_DATA Dziedzicz formatowanie liczb z danych.
CUSTOM Zastosuj formatowanie niestandardowe określone przez ChartCustomNumberFormatOptions.

Opcje formatu wykresu

Niestandardowe opcje formatowania liczb dla atrybutów wykresu.

Zapis JSON
{
  "prefix": string,
  "suffix": string
}
Pola
prefix

string

Niestandardowy prefiks, który będzie dołączany do atrybutu wykresu. To pole jest opcjonalne.

suffix

string

Sufiks niestandardowy, który zostanie dołączony do atrybutu wykres. To pole jest opcjonalne.

Strategia dotycząca ukrytego wymiaru wykresu

Określa sposób, w jaki wykresy powinny obsługiwać ukryte wiersze źródłowe. Ukryte wiersze obejmują zarówno ręcznie ukryte, jak i ukryte przez filtr.

Wartości w polu enum
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Wartość domyślna, nie używać.
SKIP_HIDDEN_ROWS_AND_COLUMNS Wykresy będą pomijać ukryte wiersze i kolumny.
SKIP_HIDDEN_ROWS Wykresy będą pomijać tylko ukryte wiersze.
SKIP_HIDDEN_COLUMNS Wykresy będą pomijać tylko ukryte kolumny.
SHOW_ALL Wykresy nie pomijają żadnych ukrytych wierszy ani kolumn.

Obramowanie umieszczonego obiektu

Obramowanie umieszczonego obiektu.

Zapis JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Pola
color
(deprecated)

object (Color)

Kolor obramowania. Wycofano: użyj właściwości colorStyle.

colorStyle

object (ColorStyle)

Kolor obramowania. Jeśli ustawiona jest też wartość color, to pole ma pierwszeństwo.