встроенная диаграмма
Диаграмма, встроенная в лист.
Представление JSON |
---|
{ "chartId": integer, "spec": { object ( |
Поля | |
---|---|
chartId | Идентификатор диаграммы. |
spec | Спецификация диаграммы. |
position | Положение диаграммы. |
border | Граница диаграммы. |
ChartSpec
Спецификации диаграммы.
Представление JSON |
---|
{ "title": string, "altText": string, "titleTextFormat": { object ( |
Поля | |
---|---|
title | Название диаграммы. |
altText | Альтернативный текст, описывающий диаграмму. Это часто используется для доступности. |
titleTextFormat | Формат текста заголовка. Зачеркивание, подчеркивание и ссылка не поддерживаются. |
titleTextPosition | Позиция текста заголовка. Это поле является необязательным. |
subtitle | Подзаголовок диаграммы. |
subtitleTextFormat | Формат текста субтитров. Зачеркивание, подчеркивание и ссылка не поддерживаются. |
subtitleTextPosition | Позиция текста субтитров. Это поле является необязательным. |
fontName | Имя шрифта, который будет использоваться по умолчанию для всего текста диаграммы (например, заголовок, метки осей, легенда). Если шрифт указан для определенной части диаграммы, он переопределит это имя шрифта. |
maximized | Значение true, чтобы диаграмма заполнила все пространство, в котором она отображается, с минимальным отступом. False, чтобы использовать заполнение по умолчанию. (Неприменимо к географическим и организационным диаграммам.) |
backgroundColor | Цвет фона всей диаграммы. Не применимо к организационным диаграммам. Устарело: используйте |
backgroundColorStyle | Цвет фона всей диаграммы. Не применимо к организационным диаграммам. Если также установлен |
dataSourceChartProperties | Поле, если оно присутствует, содержит определенные свойства диаграммы источника данных. |
filterSpecs[] | Фильтры применяются к исходным данным диаграммы. Поддерживается только для диаграмм источников данных. |
sortSpecs[] | Порядок сортировки данных диаграммы. Поддерживается только одна спецификация сортировки. Поддерживается только для диаграмм источников данных. |
chart поля Союза. Для конкретной спецификации диаграммы должно быть установлено ровно одно значение. chart может быть только одной из следующих: | |
basicChart | Базовая спецификация диаграммы может быть одним из многих видов диаграмм. См. |
pieChart | Спецификация круговой диаграммы. |
bubbleChart | Спецификация пузырьковой диаграммы. |
candlestickChart | Спецификация свечного графика. |
orgChart | Спецификация организационной диаграммы. |
histogramChart | Спецификация диаграммы гистограммы. |
waterfallChart | Спецификация каскадной диаграммы. |
treemapChart | Спецификация диаграммы древовидной карты. |
scorecardChart | Спецификация диаграммы системы показателей. |
TextPosition
Настройки положения для текста.
Представление JSON |
---|
{
"horizontalAlignment": enum ( |
Поля | |
---|---|
horizontalAlignment | Параметр горизонтального выравнивания для фрагмента текста. |
DataSourceChartProperties
Свойства диаграммы источника данных.
Представление JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
Поля | |
---|---|
dataSourceId | ID источника данных, с которым связана диаграмма. |
dataExecutionStatus | Только вывод. Статус выполнения данных. |
BasicChartSpec
Спецификация базовой диаграммы. См. BasicChartType
для списка поддерживаемых диаграмм.
Представление JSON |
---|
{ "chartType": enum ( |
Поля | |
---|---|
chartType | Тип диаграммы. |
legendPosition | Положение легенды диаграммы. |
axis[] | Ось на графике. |
domains[] | Домен данных это диаграммы. Поддерживается только один домен. |
series[] | Данные, которые эта диаграмма визуализирует. |
headerCount | Количество строк или столбцов в данных, которые являются «заголовками». Если не задано, Google Таблицы будут угадывать, сколько строк являются заголовками на основе данных. (Обратите внимание, что |
threeDimensional | True, чтобы сделать диаграмму трехмерной. Применяется к линейчатым и столбчатым диаграммам. |
interpolateNulls | Если некоторые значения в ряду отсутствуют, на диаграмме могут появиться пропуски (например, будут отсутствовать сегменты линий на линейной диаграмме). Чтобы устранить эти пробелы, установите для этого параметра значение true. Применяется к линейным, площадным и комбинированным диаграммам. |
stackedType | Тип с накоплением для диаграмм, поддерживающих вертикальное наложение. Применяется к диаграммам с областями, гистограммами, столбцами, комбинированными и ступенчатыми областями. |
lineSmoothing | Определяет, должны ли все линии отображаться гладкими или прямыми по умолчанию. Применяется к линейным графикам. |
compareMode | Поведение всплывающих подсказок и выделения данных при наведении курсора на область данных и диаграммы. |
totalDataLabel | Определяет, отображать ли дополнительные метки данных на диаграммах с накоплением, которые суммируют общее значение всех значений с накоплением для каждого значения вдоль оси домена. Эти метки данных могут быть установлены только в том случае, если |
BasicChartType
Как должна быть визуализирована диаграмма.
перечисления | |
---|---|
BASIC_CHART_TYPE_UNSPECIFIED | Значение по умолчанию, не использовать. |
BAR | Гистограмма . |
LINE | Линейный график . |
AREA | Диаграмма с областями . |
COLUMN | Столбчатая диаграмма . |
SCATTER | Точечная диаграмма . |
COMBO | Комбинированная диаграмма . |
STEPPED_AREA | Ступенчатая диаграмма с областями . |
BasicChartLegendPosition
Где должна располагаться легенда диаграммы.
перечисления | |
---|---|
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED | Значение по умолчанию, не использовать. |
BOTTOM_LEGEND | Легенда отображается в нижней части диаграммы. |
LEFT_LEGEND | Легенда отображается слева от диаграммы. |
RIGHT_LEGEND | Легенда отображается справа от диаграммы. |
TOP_LEGEND | Легенда отображается в верхней части диаграммы. |
NO_LEGEND | Легенда не отображается. |
BasicChartAxis
Ось диаграммы. Диаграмма не может иметь более одной оси на axis position
.
Представление JSON |
---|
{ "position": enum ( |
Поля | |
---|---|
position | Положение этой оси. |
title | Название этой оси. Если установлено, это переопределяет любой заголовок, выведенный из заголовков данных. |
format | Формат заголовка. Допустимо только в том случае, если ось не связана с доменом. Поле ссылки не поддерживается. |
titleTextPosition | Позиция текста заголовка оси. |
viewWindowOptions | Параметры окна просмотра для этой оси. |
BasicChartAxisPosition
Положение оси диаграммы.
перечисления | |
---|---|
BASIC_CHART_AXIS_POSITION_UNSPECIFIED | Значение по умолчанию, не использовать. |
BOTTOM_AXIS | Ось, отображаемая в нижней части диаграммы. Для большинства диаграмм это стандартная большая ось. Для гистограмм это второстепенная ось. |
LEFT_AXIS | Ось, отображаемая слева от диаграммы. Для большинства диаграмм это малая ось. Для гистограмм это стандартная главная ось. |
RIGHT_AXIS | Ось, отображаемая справа от диаграммы. Для большинства диаграмм это малая ось. Для гистограмм это необычная главная ось. |
ChartAxisViewWindowOptions
Параметры, определяющие «окно просмотра» для диаграммы (например, видимые значения на оси).
Представление JSON |
---|
{
"viewWindowMin": number,
"viewWindowMax": number,
"viewWindowMode": enum ( |
Поля | |
---|---|
viewWindowMin | Минимальное числовое значение, которое будет отображаться в этом окне просмотра. Если не установлено, будет автоматически определено минимальное значение, подходящее для данных. |
viewWindowMax | Максимальное числовое значение, отображаемое в этом окне просмотра. Если не установлено, будет автоматически определено максимальное значение, подходящее для данных. |
viewWindowMode | Режим окна просмотра. |
ViewWindowMode
Режим окна просмотра. Он определяет, как обрабатывать минимум и максимум окна просмотра.
перечисления | |
---|---|
DEFAULT_VIEW_WINDOW_MODE | Режим окна просмотра по умолчанию, используемый в редакторе листов для этого типа диаграммы. В большинстве случаев, если установлено, режим по умолчанию эквивалентен PRETTY . |
VIEW_WINDOW_MODE_UNSUPPORTED | Не использовать. Указывает, что текущий установленный режим не поддерживается API. |
EXPLICIT | Точно соответствует минимальному и максимальному значению, если оно указано. Если значение не указано, оно вернется к значению PRETTY . |
PRETTY | Выбирает минимум и максимум, чтобы диаграмма выглядела хорошо. И min, и max игнорируются в этом режиме. |
BasicChartDomain
Область диаграммы. Например, если отображать цены акций с течением времени, это будет дата.
Представление JSON |
---|
{
"domain": {
object ( |
Поля | |
---|---|
domain | Данные домена. Например, если отображать цены акций во времени, это данные, представляющие даты. |
reversed | Значение true, чтобы изменить порядок значений домена (горизонтальная ось). |
ДиаграммаДанные
Данные, включенные в домен или серию.
Представление JSON |
---|
{ "groupRule": { object ( |
Поля | |
---|---|
groupRule | Правило для группировки данных, если ChartData поддерживает домен диаграммы источника данных. Поддерживается только для диаграмм источников данных. |
aggregateType | Тип агрегации для серии диаграммы источника данных. Поддерживается только для диаграмм источников данных. |
type поля объединения. Тип включенных данных, должно быть установлено ровно одно значение. type может быть только одним из следующих: | |
sourceRange | Исходные диапазоны данных. |
columnReference | Ссылка на столбец источника данных, из которого считываются данные. |
ChartSourceRange
Исходные диапазоны для диаграммы.
Представление JSON |
---|
{
"sources": [
{
object ( |
Поля | |
---|---|
sources[] | Диапазоны данных для серии или домена. Ровно одно измерение должно иметь длину 1, и все источники в списке должны иметь одно и то же измерение длины 1. Домен (если он существует) и все серии должны иметь одинаковое количество диапазонов источников. Если используется более одного исходного диапазона, то исходный диапазон с заданным смещением должен быть упорядоченным и непрерывным в домене и серии. Например, это допустимые конфигурации:
|
ДиаграммаГруппаПравило
Необязательный параметр ChartData
домена диаграммы источника данных, который определяет сегменты для значений в домене, а не разбивает каждое отдельное значение.
Например, при построении диаграммы источника данных вы можете указать правило гистограммы для домена (оно должно содержать только числовые значения), сгруппировав его значения в сегменты. Любые значения ряда диаграммы, которые попадают в одно и то же ведро, агрегируются на основе aggregateType
.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
rule союзного поля. Правило, применяемое к ChartData . rule может быть только одним из следующих: | |
dateTimeRule | Правило |
histogramRule | |
Правило ДиаграммыДатыВремя
Позволяет упорядочивать значения даты и времени в столбце исходных данных в сегменты на основе выбранных частей их значений даты или времени.
Представление JSON |
---|
{
"type": enum ( |
Поля | |
---|---|
type | Применяемый тип группировки даты и времени. |
ChartDateTimeRuleType
Доступные типы правил группировки даты и времени.
перечисления | |
---|---|
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED | Тип по умолчанию, не использовать. |
SECOND | Группировать даты по секундам, от 0 до 59. |
MINUTE | Сгруппируйте даты по минутам, от 0 до 59. |
HOUR | Сгруппируйте даты по часам, используя 24-часовую систему, от 0 до 23. |
HOUR_MINUTE | Сгруппируйте даты по часам и минутам, используя 24-часовую систему, например 19:45. |
HOUR_MINUTE_AMPM | Сгруппируйте даты по часам и минутам, используя 12-часовую систему, например 19:45. Обозначение AM/PM переводится в зависимости от языкового стандарта электронной таблицы. |
DAY_OF_WEEK | Сгруппируйте даты по дням недели, например воскресенье. Дни недели будут переведены в зависимости от языкового стандарта электронной таблицы. |
DAY_OF_YEAR | Сгруппируйте даты по дням года, от 1 до 366. Обратите внимание, что даты после 29 февраля попадают в разные корзины в високосные годы и в невисокосные годы. |
DAY_OF_MONTH | Сгруппируйте даты по дням месяца, от 1 до 31. |
DAY_MONTH | Сгруппируйте даты по дням и месяцам, например, 22 ноября. Месяц переводится на основе языкового стандарта электронной таблицы. |
MONTH | Сгруппируйте даты по месяцам, например, ноябрь. Месяц переводится в зависимости от языкового стандарта электронной таблицы. |
QUARTER | Сгруппируйте даты по кварталам, например Q1 (что соответствует январю-марту). |
YEAR | Сгруппируйте даты по годам, например 2008. |
YEAR_MONTH | Сгруппируйте даты по годам и месяцам, например 2008-ноябрь. Месяц переводится на основе языкового стандарта электронной таблицы. |
YEAR_QUARTER | Сгруппируйте даты по годам и кварталам, например 2008 Q4. |
YEAR_MONTH_DAY | Сгруппируйте даты по году, месяцу и дню, например 2008-11-22. |
ДиаграммаГистограммаПравило
Позволяет организовать числовые значения в столбце исходных данных в сегменты постоянного размера.
Представление JSON |
---|
{ "minValue": number, "maxValue": number, "intervalSize": number } |
Поля | |
---|---|
minValue | Минимальное значение, при котором элементы помещаются в ведра. Значения, которые меньше минимального, группируются в одно ведро. Если он опущен, он определяется минимальным значением элемента. |
maxValue | Максимальное значение, при котором элементы помещаются в ведра. Значения, превышающие максимальное значение, группируются в одно ведро. Если опущено, определяется максимальным значением элемента. |
intervalSize | Размер создаваемых сегментов. Должен быть положительным. |
ChartAggregateType
Тип агрегации для рядов диаграмм.
перечисления | |
---|---|
CHART_AGGREGATE_TYPE_UNSPECIFIED | Значение по умолчанию, не использовать. |
AVERAGE | Средняя агрегатная функция. |
COUNT | Счетная агрегатная функция. |
MAX | Максимальная агрегатная функция. |
MEDIAN | Медианная агрегатная функция. |
MIN | Минимальная агрегатная функция. |
SUM | Суммарная агрегатная функция. |
BasicChartSeries
Отдельный ряд данных на диаграмме. Например, если отображать цены акций во времени, может существовать несколько рядов, один для «Цены открытия», «Максимальной цены», «Низкой цены» и «Цены закрытия».
Представление JSON |
---|
{ "series": { object ( |
Поля | |
---|---|
series | Данные визуализируются в этой серии диаграмм. |
targetAxis | Второстепенная ось, которая будет указывать диапазон значений для этого ряда. Например, при построении графика акций с течением времени ряд «Объем» может захотеть закрепить справа, а цены — слева, потому что масштаб объема торгов отличается от масштаба цен. Указание оси, которая не является допустимой вспомогательной осью для |
type | Тип этой серии. Допустимо, только если |
lineStyle | Стиль линии этой серии. Допустимо только в том случае, если |
dataLabel | Информация о метках данных для этой серии. |
color | Цвет элементов (таких как столбцы, линии и точки), связанных с этой серией. Если пусто, используется цвет по умолчанию. Устарело: используйте |
colorStyle | Цвет элементов (таких как столбцы, линии и точки), связанных с этой серией. Если пусто, используется цвет по умолчанию. Если также задан |
pointStyle | Стиль для точек, связанных с этой серией. Допустимо только в том случае, если |
styleOverrides[] | Параметры переопределения стиля для точек данных серии. |
Стиль линии
Свойства, описывающие стиль линии.
Представление JSON |
---|
{
"width": integer,
"type": enum ( |
Поля | |
---|---|
width | Толщина линии в px. |
type | Штриховой тип линии. |
LineDashType
Штриховой тип линии.
перечисления | |
---|---|
LINE_DASH_TYPE_UNSPECIFIED | Значение по умолчанию, не использовать. |
INVISIBLE | Без тире, что эквивалентно невидимой линии. |
CUSTOM | Пользовательский тире для линии. Изменение точного пользовательского стиля тире в настоящее время не поддерживается. |
SOLID | Сплошная линия. |
DOTTED | Пунктирная линия. |
MEDIUM_DASHED | Пунктирная линия, где штрихи имеют «среднюю» длину. |
MEDIUM_DASHED_DOTTED | Линия, которая чередуется между «средним» тире и точкой. |
LONG_DASHED | Пунктирная линия, где штрихи имеют «длинную» длину. |
LONG_DASHED_DOTTED | Линия, которая чередуется между «длинным» тире и точкой. |
Метка данных
Настройки для одного набора меток данных. Метки данных — это аннотации, которые отображаются рядом с набором данных, например точками на линейной диаграмме, и предоставляют дополнительную информацию о том, что представляют данные, например текстовое представление значения за этой точкой на графике.
Представление JSON |
---|
{ "type": enum ( |
Поля | |
---|---|
type | Тип метки данных. |
textFormat | Текстовый формат, используемый для метки данных. Поле ссылки не поддерживается. |
placement | Размещение метки данных относительно помеченных данных. |
customLabelData | Данные для использования в пользовательских ярлыках. Используется, только если |
DataLabelType
Тип метки данных.
перечисления | |
---|---|
DATA_LABEL_TYPE_UNSPECIFIED | Тип метки данных не указан и будет интерпретироваться в зависимости от контекста метки данных на диаграмме. |
NONE | Метка данных не отображается. |
DATA | Метка данных отображается с использованием значений из данных серии. |
CUSTOM | Метка данных отображается с использованием значений из пользовательского источника данных, указанного customLabelData . |
DataLabelPlacement
Размещение метки данных относительно помеченных данных.
перечисления | |
---|---|
DATA_LABEL_PLACEMENT_UNSPECIFIED | Позиционирование определяется автоматически визуализатором. |
CENTER | Центрируйте полосу или столбец как по горизонтали, так и по вертикали. |
LEFT | Слева от точки данных. |
RIGHT | Справа от точки данных. |
ABOVE | Над точкой данных. |
BELOW | Ниже точки данных. |
INSIDE_END | Внутри полосы или столбца в конце (сверху, если положительный, снизу, если отрицательный). |
INSIDE_BASE | Внутри бара или колонны у основания. |
OUTSIDE_END | Вне бара или столбца в конце. |
Стиль точки
Стиль точки на графике.
Представление JSON |
---|
{
"size": number,
"shape": enum ( |
Поля | |
---|---|
size | Размер точки. Если пусто, используется размер по умолчанию. |
shape | Форма точки. Если пусто или не указано, используется форма по умолчанию. |
PointShape
Форма точки.
перечисления | |
---|---|
POINT_SHAPE_UNSPECIFIED | Значение по умолчанию. |
CIRCLE | Форма круга. |
DIAMOND | Алмазная форма. |
HEXAGON | Шестиугольная форма. |
PENTAGON | Форма пятиугольника. |
SQUARE | Квадратная форма. |
STAR | Форма звезды. |
TRIANGLE | Треугольная форма. |
X_MARK | Х-образная форма. |
BasicSeriesDataPointStyleOverride
Настройки переопределения стиля для одной точки данных серии.
Представление JSON |
---|
{ "index": integer, "color": { object ( |
Поля | |
---|---|
index | Отсчитываемый от нуля индекс точки данных ряда. |
color | Цвет точки данных ряда. Если пусто, используется серия по умолчанию. Устарело: используйте |
colorStyle | Цвет точки данных ряда. Если пусто, используется серия по умолчанию. Если также задан |
pointStyle | Стиль точки точки данных ряда. Допустимо только в том случае, если |
BasicChartStackedType
Когда диаграммы сложены, значения диапазона (вертикальная ось) отображаются друг над другом, а не от горизонтальной оси. Например, два значения 20 и 80 будут взяты из 0, а 80 — это 80 единиц от горизонтальной оси. Если бы они были сложены, 80 были бы отрисованы из 20, отодвигая их на 100 единиц от горизонтальной оси.
перечисления | |
---|---|
BASIC_CHART_STACKED_TYPE_UNSPECIFIED | Значение по умолчанию, не использовать. |
NOT_STACKED | Серии не складываются. |
STACKED | Значения серии складываются, каждое значение отображается вертикально, начиная с верхней части значения под ним. |
PERCENT_STACKED | Вертикальные стеки растягиваются, чтобы достичь верхней части диаграммы, а значения расположены в процентах друг от друга. |
BasicChartCompareMode
Тип режима сравнения, описывающий поведение всплывающих подсказок и выделения данных при наведении курсора на область данных и диаграммы.
перечисления | |
---|---|
BASIC_CHART_COMPARE_MODE_UNSPECIFIED | Значение по умолчанию, не использовать. |
DATUM | Только выделенный элемент данных выделяется и отображается во всплывающей подсказке. |
CATEGORY | Все элементы данных одной категории (например, значение домена) выделяются и отображаются во всплывающей подсказке. |
круговая диаграмма
Представление JSON |
---|
{ "legendPosition": enum ( |
Поля | |
---|---|
legendPosition | Где должна быть нарисована легенда круговой диаграммы. |
domain | Данные, которые охватывают домен круговой диаграммы. |
series | Данные, которые охватывают одну и единственную серию круговой диаграммы. |
threeDimensional | Верно, если круг трехмерный. |
pieHole | Размер отверстия в круговой диаграмме. |
Круговая ДиаграммаЛегенда
Где должна располагаться легенда диаграммы.
перечисления | |
---|---|
PIE_CHART_LEGEND_POSITION_UNSPECIFIED | Значение по умолчанию, не использовать. |
BOTTOM_LEGEND | Легенда отображается в нижней части диаграммы. |
LEFT_LEGEND | Легенда отображается слева от диаграммы. |
RIGHT_LEGEND | Легенда отображается справа от диаграммы. |
TOP_LEGEND | Легенда отображается в верхней части диаграммы. |
NO_LEGEND | Легенда не отображается. |
LABELED_LEGEND | К каждому кусочку пирога прикреплена этикетка. |
пузырьковая диаграмма
Представление JSON |
---|
{ "legendPosition": enum ( |
Поля | |
---|---|
legendPosition | Где должна быть нарисована легенда диаграммы. |
bubbleLabels | Данные, содержащие пузырьковые метки. Они не должны быть уникальными. |
domain | Данные, содержащие значения x пузырька. Эти значения располагают пузырьки на диаграмме по горизонтали. |
series | Данные, содержащие пузырьковые значения y. Эти значения размещают пузырьки на диаграмме по вертикали. |
groupIds | Данные, содержащие идентификаторы групп пузырьков. Все пузырьки с одинаковым идентификатором группы отображаются одним цветом. Если указано значение |
bubbleSizes | Данные, содержащие размеры пузырьков. Размеры пузырьков используются для рисования пузырьков разного размера относительно друг друга. Если указано, |
bubbleOpacity | Непрозрачность пузырьков от 0 до 1,0. 0 — полностью прозрачный, 1 — полностью непрозрачный. |
bubbleBorderColor | Цвет границы пузырька. Устарело: используйте |
bubbleBorderColorStyle | Цвет границы пузырька. Если также установлено значение |
bubbleMaxRadiusSize | Размер максимального радиуса пузырьков в пикселях. Если указано, поле должно быть положительным значением. |
bubbleMinRadiusSize | Размер минимального радиуса пузырьков в пикселях. Если указано, поле должно быть положительным значением. |
bubbleTextStyle | Формат текста внутри пузырьков. Зачеркивание, подчеркивание и ссылка не поддерживаются. |
ПузырьДиаграммаЛегенда
Где должна располагаться легенда диаграммы.
перечисления | |
---|---|
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED | Значение по умолчанию, не использовать. |
BOTTOM_LEGEND | Легенда отображается в нижней части диаграммы. |
LEFT_LEGEND | Легенда отображается слева от диаграммы. |
RIGHT_LEGEND | Легенда отображается справа от диаграммы. |
TOP_LEGEND | Легенда отображается в верхней части диаграммы. |
NO_LEGEND | Легенда не отображается. |
INSIDE_LEGEND | Легенда отображается внутри области диаграммы. |
ПодсвечникДиаграммаSpec
Представление JSON |
---|
{ "domain": { object ( |
Поля | |
---|---|
domain | Данные домена (горизонтальная ось) для свечного графика. Строковые данные будут рассматриваться как дискретные метки, другие данные будут рассматриваться как непрерывные значения. |
data[] | Данные свечного графика. Поддерживается только один CandlestickData. |
ПодсвечникДомен
Домен CandlestickChart.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | Данные CandlestickDomain. |
reversed | Значение true, чтобы изменить порядок значений домена (горизонтальная ось). |
CandlestickData
Данные свечного графика, каждый из которых содержит минимальное, открытое, закрытое и максимальное значения для ряда.
Представление JSON |
---|
{ "lowSeries": { object ( |
Поля | |
---|---|
lowSeries | Данные диапазона (вертикальная ось) для минимального/минимального значения для каждой свечи. Это нижняя часть центральной линии свечи. |
openSeries | Данные диапазона (вертикальная ось) для открытия/начального значения для каждой свечи. Это нижняя часть тела свечи. Если меньше значения закрытия, свеча будет заполнена. В противном случае свеча будет полой. |
closeSeries | Данные диапазона (вертикальная ось) для закрытия/финального значения для каждой свечи. Это верхняя часть тела свечи. Если больше, чем значение открытия, свеча будет заполнена. В противном случае свеча будет полой. |
highSeries | Данные диапазона (вертикальная ось) для максимального/максимального значения для каждой свечи. Это вершина центральной линии свечи. |
ПодсвечникСерия
Серия CandlestickData.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | Данные CandlestickSeries. |
OrgChartSpec
Организационная схема . Организационные диаграммы требуют уникального набора меток в labels
и могут дополнительно включать parentLabels
и tooltips
. parentLabels
содержат для каждого узла метку, идентифицирующую родительский узел. tooltips
содержат для каждого узла необязательную всплывающую подсказку.
Например, чтобы описать OrgChart с Алисой в качестве генерального директора, Бобом в качестве президента (подотчетного Алисе) и Кэти в качестве вице-президента по продажам (также подотчетного Алисе), labels
должны содержать «Алиса», «Боб», «Кэти», parentLabels
содержат "", "Alice", "Alice", а tooltips
содержат "CEO", "President", "VP Sales".
Представление JSON |
---|
{ "nodeSize": enum ( |
Поля | |
---|---|
nodeSize | Размер узлов организационной диаграммы. |
nodeColor | Цвет узлов организационной диаграммы. Устарело: используйте |
nodeColorStyle | Цвет узлов организационной диаграммы. Если также установлен |
selectedNodeColor | Цвет выбранных узлов организационной диаграммы. Устарело: используйте |
selectedNodeColorStyle | Цвет выбранных узлов организационной диаграммы. Если также установлен |
labels | Данные, содержащие метки для всех узлов диаграммы. Метки должны быть уникальными. |
parentLabels | Данные, содержащие метку родителя для соответствующего узла. Пустое значение указывает, что узел не имеет родителя и является узлом верхнего уровня. Это поле является необязательным. |
tooltips | Данные, содержащие всплывающую подсказку для соответствующего узла. Пустое значение приводит к тому, что подсказка для узла не отображается. Это поле является необязательным. |
OrgChartNodeSize
Размер узлов организационной диаграммы.
перечисления | |
---|---|
ORG_CHART_LABEL_SIZE_UNSPECIFIED | Значение по умолчанию, не использовать. |
SMALL | Небольшой размер узла организационной диаграммы. |
MEDIUM | Средний размер узла организационной диаграммы. |
LARGE | Большой размер узла организационной диаграммы. |
ГистограммаChartSpec
График гистограммы . Гистограмма группирует элементы данных в ячейки, отображая каждую ячейку в виде столбца сложенных элементов. Гистограммы используются для отображения распределения набора данных. Каждый столбец элементов представляет собой диапазон, в который попадают эти элементы. Количество бинов может быть выбрано автоматически или указано явно.
Представление JSON |
---|
{ "series": [ { object ( |
Поля | |
---|---|
series[] | Серией для гистограммы может быть либо одна серия значений, которые должны быть разделены на сегменты, либо несколько рядов, каждая из которых имеет одинаковую длину, содержащих имя ряда, за которым следуют значения, которые должны быть разделены на сегменты для этого ряда. |
legendPosition | Положение легенды диаграммы. |
showItemDividers | Должны ли отображаться горизонтальные разделительные линии между элементами в каждом столбце. |
bucketSize | По умолчанию размер корзины (диапазон значений в одном столбце) выбирается автоматически, но здесь его можно переопределить. Например, размер сегмента 1,5 приводит к сегментам от 0 до 1,5, от 1,5 до 3,0 и т. д. Не может быть отрицательным. Это поле является необязательным. |
outlierPercentile | Процентиль выбросов используется для того, чтобы выбросы не оказывали неблагоприятного влияния на расчет размеров сегментов. Например, установка процентиля выброса, равного 0,05, означает, что верхние и нижние 5% значений при расчете сегментов. Значения по-прежнему включены в диаграмму, они будут добавлены в первую или последнюю корзины вместо своих собственных корзин. Должен быть между 0,0 и 0,5. |
Серия гистограмм
Ряд гистограмм, содержащий цвет ряда и данные.
Представление JSON |
---|
{ "barColor": { object ( |
Поля | |
---|---|
barColor | Цвет столбца, представляющего эту серию в каждом сегменте. Это поле является необязательным. Устарело: используйте |
barColorStyle | Цвет столбца, представляющего эту серию в каждом сегменте. Это поле является необязательным. Если также установлено |
data | Данные для этой серии гистограмм. |
ГистограммаДиаграммаЛегендаПозиция
Где должна располагаться легенда диаграммы.
перечисления | |
---|---|
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED | Значение по умолчанию, не использовать. |
BOTTOM_LEGEND | Легенда отображается в нижней части диаграммы. |
LEFT_LEGEND | Легенда отображается слева от диаграммы. |
RIGHT_LEGEND | Легенда отображается справа от диаграммы. |
TOP_LEGEND | Легенда отображается в верхней части диаграммы. |
NO_LEGEND | Легенда не отображается. |
INSIDE_LEGEND | Легенда отображается внутри области диаграммы. |
ВодопадДиаграммаSpec
График водопада.
Представление JSON |
---|
{ "domain": { object ( |
Поля | |
---|---|
domain | Данные домена (горизонтальная ось) для каскадной диаграммы. |
series[] | Данные, которые визуализирует эта каскадная диаграмма. |
stackedType | Штабелированный тип. |
firstValueIsTotal | Значение true, чтобы интерпретировать первое значение как итоговое. |
hideConnectorLines | Значение true, чтобы скрыть соединительные линии между столбцами. |
connectorLineStyle | Стиль линии для соединительных линий. |
totalDataLabel | Определяет, отображать ли дополнительные метки данных на диаграммах с накоплением, которые суммируют общее значение всех значений с накоплением для каждого значения вдоль оси домена. |
ВодопадДиаграммаДомен
Область водопадной диаграммы.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | Данные WaterfallChartDomain. |
reversed | Значение true, чтобы изменить порядок значений домена (горизонтальная ось). |
ВодопадДиаграммаСерия
Один ряд данных для каскадной диаграммы.
Представление JSON |
---|
{ "data": { object ( |
Поля | |
---|---|
data | Данные визуализируются в этой серии. |
positiveColumnsStyle | Стили для всех столбцов в этой серии с положительными значениями. |
negativeColumnsStyle | Стили для всех столбцов в этой серии с отрицательными значениями. |
subtotalColumnsStyle | Стили для всех столбцов промежуточных итогов в этой серии. |
hideTrailingSubtotal | Значение true, чтобы скрыть столбец промежуточных итогов с конца ряда. По умолчанию столбец промежуточных итогов будет отображаться в конце каждой серии. Установка для этого поля значения true скроет этот столбец промежуточных итогов для этой серии. |
customSubtotals[] | Пользовательские столбцы промежуточных итогов, появляющиеся в этой серии. Порядок, в котором определяются промежуточные итоги, не имеет значения. Для каждой точки данных может быть определен только один промежуточный итог. |
dataLabel | Информация о метках данных для этой серии. |
водопаддиаграммастолбецстиль
Стили для столбца каскадной диаграммы.
Представление JSON |
---|
{ "label": string, "color": { object ( |
Поля | |
---|---|
label | Метка легенды столбца. |
color | Цвет столбца. Устарело: используйте |
colorStyle | Цвет столбца. Если также задан |
ВодопадДиаграммаПользовательскийПромежуточный итог
Пользовательский столбец промежуточных итогов для серии каскадных диаграмм.
Представление JSON |
---|
{ "subtotalIndex": integer, "label": string, "dataIsSubtotal": boolean } |
Поля | |
---|---|
subtotalIndex | Отсчитываемый от нуля индекс точки данных в ряду. Если значение |
label | Метка для столбца промежуточных итогов. |
dataIsSubtotal | Истинно, если точка данных в |
ВодопадДиаграммаStackedType
Параметры с накоплением для каскадных диаграмм.
перечисления | |
---|---|
WATERFALL_STACKED_TYPE_UNSPECIFIED | Значение по умолчанию, не использовать. |
STACKED | Значения, соответствующие одному и тому же значению домена (горизонтальная ось), будут располагаться вертикально. |
SEQUENTIAL | Ряды будут распространяться вдоль горизонтальной оси. |
TreemapChartSpec
Представление JSON |
---|
{ "labels": { object ( |
Поля | |
---|---|
labels | Данные, содержащие метки ячеек карты дерева. |
parentLabels | Данные содержат родительские метки ячеек карты дерева. |
sizeData | Данные, определяющие размер каждой ячейки данных древовидной карты. Ожидается, что эти данные будут числовыми. Ячейки, соответствующие нечисловым или отсутствующим данным, не будут отображаться. Если |
colorData | Данные, определяющие цвет фона каждой ячейки данных древовидной карты. Это поле является необязательным. Если не указано, |
textFormat | Текстовый формат для всех меток на диаграмме. Поле ссылки не поддерживается. |
levels | Количество уровней данных для отображения на диаграмме древовидной карты. Эти уровни являются интерактивными и отображаются со своими метками. По умолчанию 2, если не указано иное. |
hintedLevels | Количество дополнительных уровней данных помимо помеченных уровней, которые будут отображаться на диаграмме древовидной карты. Эти уровни не интерактивны и показаны без меток. По умолчанию 0, если не указано. |
minValue | Минимально возможное значение данных. Ячейки со значениями меньше этого будут иметь тот же цвет, что и ячейки с этим значением. Если не указано, по умолчанию используется фактическое минимальное значение из |
maxValue | Максимально возможное значение данных. Ячейки со значениями выше этого будут иметь тот же цвет, что и ячейки с этим значением. Если не указано, по умолчанию используется фактическое максимальное значение из |
headerColor | Цвет фона для ячеек заголовка. Устарело: используйте |
headerColorStyle | Цвет фона для ячеек заголовка. Если также задан |
colorScale | Цветовая шкала для ячеек данных в древовидной диаграмме. Ячейкам данных назначаются цвета на основе значений их цветов. Эти значения цвета берутся из |
hideTooltips | True, чтобы скрыть всплывающие подсказки. |
Древовидная картаДиаграммаЦветМасштаб
Цветовая шкала для древовидной диаграммы.
Представление JSON |
---|
{ "minValueColor": { object ( |
Поля | |
---|---|
minValueColor | Цвет фона для ячеек со значением цвета меньше или равным |
minValueColorStyle | Цвет фона для ячеек со значением цвета меньше или равным |
midValueColor | Цвет фона для ячеек со значением цвета посередине между |
midValueColorStyle | Цвет фона для ячеек со значением цвета посередине между |
maxValueColor | Цвет фона для ячеек со значением цвета больше или равным |
maxValueColorStyle | Цвет фона для ячеек со значением цвета больше или равным |
noDataColor | Цвет фона для ячеек, с которыми не связаны данные о цвете. По умолчанию #000000, если не указано иное. Устарело: используйте |
noDataColorStyle | Цвет фона для ячеек, с которыми не связаны данные о цвете. По умолчанию #000000, если не указано иное. Если также установлено |
ScorecardChartSpec
Таблица показателей. Диаграммы показателей используются для выделения ключевых показателей эффективности, известных как KPI, в электронной таблице. Диаграмма системы показателей может отображать такие вещи, как общий объем продаж, средняя стоимость или самый продаваемый товар. Вы можете указать одно значение данных или агрегировать по диапазону данных. Можно выделить процентное или абсолютное отклонение от базового значения, например изменения с течением времени.
Представление JSON |
---|
{ "keyValueData": { object ( |
Поля | |
---|---|
keyValueData | Данные для значения ключа системы показателей. |
baselineValueData | Данные для базового значения системы показателей. Это поле является необязательным. |
aggregateType | Тип агрегации для ключевых и базовых данных диаграммы в диаграмме системы показателей. Это поле не поддерживается для диаграмм источников данных. Вместо этого используйте поле |
keyValueFormat | Параметры форматирования значения ключа. |
baselineValueFormat | Параметры форматирования базового значения. Это поле необходимо, только если указано |
scaleFactor | Значение для масштабирования ключа системы показателей и базового значения. Например, коэффициент 10 можно использовать для деления всех значений в диаграмме на 10. Это поле является необязательным. |
numberFormatSource | Источник числового формата, используемый в диаграмме системы показателей. Это поле является необязательным. |
customFormatOptions | Пользовательские параметры форматирования для числовых ключей/базовых значений в диаграмме системы показателей. This field is used only when |
KeyValueFormat
Formatting options for key value.
Представление JSON |
---|
{ "textFormat": { object ( |
Поля | |
---|---|
textFormat | Text formatting options for key value. The link field is not supported. |
position | Specifies the horizontal text positioning of key value. This field is optional. If not specified, default positioning is used. |
BaselineValueFormat
Formatting options for baseline value.
Представление JSON |
---|
{ "comparisonType": enum ( |
Поля | |
---|---|
comparisonType | The comparison type of key value with baseline value. |
textFormat | Text formatting options for baseline value. The link field is not supported. |
position | Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used. |
description | Description which is appended after the baseline value. This field is optional. |
positiveColor | Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use |
positiveColorStyle | Color to be used, in case baseline value represents a positive change for key value. This field is optional. If |
negativeColor | Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use |
negativeColorStyle | Color to be used, in case baseline value represents a negative change for key value. This field is optional. If |
ComparisonType
The comparison type of key value with baseline value.
перечисления | |
---|---|
COMPARISON_TYPE_UNDEFINED | Default value, do not use. |
ABSOLUTE_DIFFERENCE | Use absolute difference between key and baseline value. |
PERCENTAGE_DIFFERENCE | Use percentage difference between key and baseline value. |
ChartNumberFormatSource
The number formatting source options for chart attributes.
перечисления | |
---|---|
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED | Default value, do not use. |
FROM_DATA | Inherit number formatting from data. |
CUSTOM | Apply custom formatting as specified by ChartCustomNumberFormatOptions . |
ChartCustomNumberFormatOptions
Custom number formatting options for chart attributes.
Представление JSON |
---|
{ "prefix": string, "suffix": string } |
Поля | |
---|---|
prefix | Custom prefix to be prepended to the chart attribute. This field is optional. |
suffix | Custom suffix to be appended to the chart attribute. This field is optional. |
ChartHiddenDimensionStrategy
Determines how charts should handle source rows that are hidden. Hidden rows include both manually hidden and hidden by a filter.
перечисления | |
---|---|
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED | Default value, do not use. |
SKIP_HIDDEN_ROWS_AND_COLUMNS | Charts will skip hidden rows and columns. |
SKIP_HIDDEN_ROWS | Charts will skip hidden rows only. |
SKIP_HIDDEN_COLUMNS | Charts will skip hidden columns only. |
SHOW_ALL | Charts will not skip any hidden rows or columns. |
EmbeddedObjectBorder
A border along an embedded object.
Представление JSON |
---|
{ "color": { object ( |
Поля | |
---|---|
color | The color of the border. Deprecated: Use |
colorStyle | The color of the border. If |
EmbeddedChart
A chart embedded in a sheet.
Представление JSON |
---|
{ "chartId": integer, "spec": { object ( |
Поля | |
---|---|
chartId | The ID of the chart. |
spec | The specification of the chart. |
position | The position of the chart. |
border | The border of the chart. |
ChartSpec
The specifications of a chart.
Представление JSON |
---|
{ "title": string, "altText": string, "titleTextFormat": { object ( |
Поля | |
---|---|
title | The title of the chart. |
altText | The alternative text that describes the chart. This is often used for accessibility. |
titleTextFormat | The title text format. Strikethrough, underline, and link are not supported. |
titleTextPosition | The title text position. This field is optional. |
subtitle | The subtitle of the chart. |
subtitleTextFormat | The subtitle text format. Strikethrough, underline, and link are not supported. |
subtitleTextPosition | The subtitle text position. This field is optional. |
fontName | The name of the font to use by default for all chart text (eg title, axis labels, legend). If a font is specified for a specific part of the chart it will override this font name. |
maximized | True to make a chart fill the entire space in which it's rendered with minimum padding. False to use the default padding. (Not applicable to Geo and Org charts.) |
backgroundColor | The background color of the entire chart. Not applicable to Org charts. Deprecated: Use |
backgroundColorStyle | The background color of the entire chart. Not applicable to Org charts. If |
dataSourceChartProperties | If present, the field contains data source chart specific properties. |
filterSpecs[] | The filters applied to the source data of the chart. Only supported for data source charts. |
sortSpecs[] | The order to sort the chart data by. Only a single sort spec is supported. Only supported for data source charts. |
Union field chart . The specific chart specification, exactly one value must be set. chart can be only one of the following: | |
basicChart | A basic chart specification, can be one of many kinds of charts. See |
pieChart | A pie chart specification. |
bubbleChart | A bubble chart specification. |
candlestickChart | A candlestick chart specification. |
orgChart | An org chart specification. |
histogramChart | A histogram chart specification. |
waterfallChart | A waterfall chart specification. |
treemapChart | A treemap chart specification. |
scorecardChart | A scorecard chart specification. |
TextPosition
Position settings for text.
Представление JSON |
---|
{
"horizontalAlignment": enum ( |
Поля | |
---|---|
horizontalAlignment | Horizontal alignment setting for the piece of text. |
DataSourceChartProperties
Properties of a data source chart.
Представление JSON |
---|
{
"dataSourceId": string,
"dataExecutionStatus": {
object ( |
Поля | |
---|---|
dataSourceId | ID of the data source that the chart is associated with. |
dataExecutionStatus | Output only. The data execution status. |
BasicChartSpec
The specification for a basic chart. See BasicChartType
for the list of charts this supports.
Представление JSON |
---|
{ "chartType": enum ( |
Поля | |
---|---|
chartType | The type of the chart. |
legendPosition | The position of the chart legend. |
axis[] | The axis on the chart. |
domains[] | The domain of data this is charting. Only a single domain is supported. |
series[] | The data this chart is visualizing. |
headerCount | The number of rows or columns in the data that are "headers". If not set, Google Sheets will guess how many rows are headers based on the data. (Note that |
threeDimensional | True to make the chart 3D. Applies to Bar and Column charts. |
interpolateNulls | If some values in a series are missing, gaps may appear in the chart (eg, segments of lines in a line chart will be missing). To eliminate these gaps set this to true. Applies to Line, Area, and Combo charts. |
stackedType | The stacked type for charts that support vertical stacking. Applies to Area, Bar, Column, Combo, and Stepped Area charts. |
lineSmoothing | Gets whether all lines should be rendered smooth or straight by default. Applies to Line charts. |
compareMode | The behavior of tooltips and data highlighting when hovering on data and chart area. |
totalDataLabel | Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. These data labels can only be set when |
BasicChartType
How the chart should be visualized.
перечисления | |
---|---|
BASIC_CHART_TYPE_UNSPECIFIED | Default value, do not use. |
BAR | A bar chart . |
LINE | A line chart . |
AREA | An area chart . |
COLUMN | A column chart . |
SCATTER | A scatter chart . |
COMBO | A combo chart . |
STEPPED_AREA | A stepped area chart . |
BasicChartLegendPosition
Where the legend of the chart should be positioned.
перечисления | |
---|---|
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED | Default value, do not use. |
BOTTOM_LEGEND | The legend is rendered on the bottom of the chart. |
LEFT_LEGEND | The legend is rendered on the left of the chart. |
RIGHT_LEGEND | The legend is rendered on the right of the chart. |
TOP_LEGEND | The legend is rendered on the top of the chart. |
NO_LEGEND | No legend is rendered. |
BasicChartAxis
An axis of the chart. A chart may not have more than one axis per axis position
.
Представление JSON |
---|
{ "position": enum ( |
Поля | |
---|---|
position | The position of this axis. |
title | The title of this axis. If set, this overrides any title inferred from headers of the data. |
format | The format of the title. Only valid if the axis is not associated with the domain. The link field is not supported. |
titleTextPosition | The axis title text position. |
viewWindowOptions | The view window options for this axis. |
BasicChartAxisPosition
The position of a chart axis.
перечисления | |
---|---|
BASIC_CHART_AXIS_POSITION_UNSPECIFIED | Default value, do not use. |
BOTTOM_AXIS | The axis rendered at the bottom of a chart. For most charts, this is the standard major axis. For bar charts, this is a minor axis. |
LEFT_AXIS | The axis rendered at the left of a chart. For most charts, this is a minor axis. For bar charts, this is the standard major axis. |
RIGHT_AXIS | The axis rendered at the right of a chart. For most charts, this is a minor axis. For bar charts, this is an unusual major axis. |
ChartAxisViewWindowOptions
The options that define a "view window" for a chart (such as the visible values in an axis).
Представление JSON |
---|
{
"viewWindowMin": number,
"viewWindowMax": number,
"viewWindowMode": enum ( |
Поля | |
---|---|
viewWindowMin | The minimum numeric value to be shown in this view window. If unset, will automatically determine a minimum value that looks good for the data. |
viewWindowMax | The maximum numeric value to be shown in this view window. If unset, will automatically determine a maximum value that looks good for the data. |
viewWindowMode | The view window's mode. |
ViewWindowMode
The view window's mode. It defines how to treat the min and max of the view window.
перечисления | |
---|---|
DEFAULT_VIEW_WINDOW_MODE | The default view window mode used in the Sheets editor for this chart type. In most cases, if set, the default mode is equivalent to PRETTY . |
VIEW_WINDOW_MODE_UNSUPPORTED | Do not use. Represents that the currently set mode is not supported by the API. |
EXPLICIT | Follows the min and max exactly if specified. If a value is unspecified, it will fall back to the PRETTY value. |
PRETTY | Chooses a min and max that make the chart look good. Both min and max are ignored in this mode. |
BasicChartDomain
The domain of a chart. For example, if charting stock prices over time, this would be the date.
Представление JSON |
---|
{
"domain": {
object ( |
Поля | |
---|---|
domain | The data of the domain. For example, if charting stock prices over time, this is the data representing the dates. |
reversed | True to reverse the order of the domain values (horizontal axis). |
ChartData
The data included in a domain or series.
Представление JSON |
---|
{ "groupRule": { object ( |
Поля | |
---|---|
groupRule | The rule to group the data by if the ChartData backs the domain of a data source chart. Only supported for data source charts. |
aggregateType | The aggregation type for the series of a data source chart. Only supported for data source charts. |
Union field type . The type of data included, exactly one value must be set. type can be only one of the following: | |
sourceRange | The source ranges of the data. |
columnReference | The reference to the data source column that the data reads from. |
ChartSourceRange
Source ranges for a chart.
Представление JSON |
---|
{
"sources": [
{
object ( |
Поля | |
---|---|
sources[] | The ranges of data for a series or domain. Exactly one dimension must have a length of 1, and all sources in the list must have the same dimension with length 1. The domain (if it exists) & all series must have the same number of source ranges. If using more than one source range, then the source range at a given offset must be in order and contiguous across the domain and series. For example, these are valid configurations:
|
ChartGroupRule
An optional setting on the ChartData
of the domain of a data source chart that defines buckets for the values in the domain rather than breaking out each individual value.
For example, when plotting a data source chart, you can specify a histogram rule on the domain (it should only contain numeric values), grouping its values into buckets. Any values of a chart series that fall into the same bucket are aggregated based on the aggregateType
.
Представление JSON |
---|
{ // Union field |
Поля | |
---|---|
Union field rule . The rule to apply to the ChartData . rule can be only one of the following: | |
dateTimeRule | |
histogramRule | |
ChartDateTimeRule
Allows you to organize the date-time values in a source data column into buckets based on selected parts of their date or time values.
Представление JSON |
---|
{
"type": enum ( |
Поля | |
---|---|
type | The type of date-time grouping to apply. |
ChartDateTimeRuleType
The available types of date-time grouping rules.
перечисления | |
---|---|
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED | The default type, do not use. |
SECOND | Group dates by second, from 0 to 59. |
MINUTE | Group dates by minute, from 0 to 59. |
HOUR | Group dates by hour using a 24-hour system, from 0 to 23. |
HOUR_MINUTE | Group dates by hour and minute using a 24-hour system, for example 19:45. |
HOUR_MINUTE_AMPM | Group dates by hour and minute using a 12-hour system, for example 7:45 PM. The AM/PM designation is translated based on the spreadsheet locale. |
DAY_OF_WEEK | Group dates by day of week, for example Sunday. The days of the week will be translated based on the spreadsheet locale. |
DAY_OF_YEAR | Group dates by day of year, from 1 to 366. Note that dates after Feb. 29 fall in different buckets in leap years than in non-leap years. |
DAY_OF_MONTH | Group dates by day of month, from 1 to 31. |
DAY_MONTH | Group dates by day and month, for example 22-Nov. The month is translated based on the spreadsheet locale. |
MONTH | Group dates by month, for example Nov. The month is translated based on the spreadsheet locale. |
QUARTER | Group dates by quarter, for example Q1 (which represents Jan-Mar). |
YEAR | Group dates by year, for example 2008. |
YEAR_MONTH | Group dates by year and month, for example 2008-Nov. The month is translated based on the spreadsheet locale. |
YEAR_QUARTER | Group dates by year and quarter, for example 2008 Q4. |
YEAR_MONTH_DAY | Group dates by year, month, and day, for example 2008-11-22. |
ChartHistogramRule
Allows you to organize numeric values in a source data column into buckets of constant size.
Представление JSON |
---|
{ "minValue": number, "maxValue": number, "intervalSize": number } |
Поля | |
---|---|
minValue | The minimum value at which items are placed into buckets. Values that are less than the minimum are grouped into a single bucket. If omitted, it is determined by the minimum item value. |
maxValue | The maximum value at which items are placed into buckets. Values greater than the maximum are grouped into a single bucket. If omitted, it is determined by the maximum item value. |
intervalSize | The size of the buckets that are created. Must be positive. |
ChartAggregateType
The type of aggregation for chart series.
перечисления | |
---|---|
CHART_AGGREGATE_TYPE_UNSPECIFIED | Default value, do not use. |
AVERAGE | Average aggregate function. |
COUNT | Count aggregate function. |
MAX | Maximum aggregate function. |
MEDIAN | Median aggregate function. |
MIN | Minimum aggregate function. |
SUM | Sum aggregate function. |
BasicChartSeries
A single series of data in a chart. For example, if charting stock prices over time, multiple series may exist, one for the "Open Price", "High Price", "Low Price" and "Close Price".
Представление JSON |
---|
{ "series": { object ( |
Поля | |
---|---|
series | The data being visualized in this chart series. |
targetAxis | The minor axis that will specify the range of values for this series. For example, if charting stocks over time, the "Volume" series may want to be pinned to the right with the prices pinned to the left, because the scale of trading volume is different than the scale of prices. It is an error to specify an axis that isn't a valid minor axis for the chart's |
type | The type of this series. Valid only if the |
lineStyle | The line style of this series. Valid only if the |
dataLabel | Information about the data labels for this series. |
color | The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. Deprecated: Use |
colorStyle | The color for elements (such as bars, lines, and points) associated with this series. If empty, a default color is used. If |
pointStyle | The style for points associated with this series. Valid only if the |
styleOverrides[] | Style override settings for series data points. |
LineStyle
Properties that describe the style of a line.
Представление JSON |
---|
{
"width": integer,
"type": enum ( |
Поля | |
---|---|
width | The thickness of the line, in px. |
type | The dash type of the line. |
LineDashType
The dash type of a line.
перечисления | |
---|---|
LINE_DASH_TYPE_UNSPECIFIED | Default value, do not use. |
INVISIBLE | No dash type, which is equivalent to a non-visible line. |
CUSTOM | A custom dash for a line. Modifying the exact custom dash style is currently unsupported. |
SOLID | A solid line. |
DOTTED | A dotted line. |
MEDIUM_DASHED | A dashed line where the dashes have "medium" length. |
MEDIUM_DASHED_DOTTED | A line that alternates between a "medium" dash and a dot. |
LONG_DASHED | A dashed line where the dashes have "long" length. |
LONG_DASHED_DOTTED | A line that alternates between a "long" dash and a dot. |
DataLabel
Settings for one set of data labels. Data labels are annotations that appear next to a set of data, such as the points on a line chart, and provide additional information about what the data represents, such as a text representation of the value behind that point on the graph.
Представление JSON |
---|
{ "type": enum ( |
Поля | |
---|---|
type | The type of the data label. |
textFormat | The text format used for the data label. The link field is not supported. |
placement | The placement of the data label relative to the labeled data. |
customLabelData | Data to use for custom labels. Only used if |
DataLabelType
The type of a data label.
перечисления | |
---|---|
DATA_LABEL_TYPE_UNSPECIFIED | The data label type is not specified and will be interpreted depending on the context of the data label within the chart. |
NONE | The data label is not displayed. |
DATA | The data label is displayed using values from the series data. |
CUSTOM | The data label is displayed using values from a custom data source indicated by customLabelData . |
DataLabelPlacement
The placement of a data label relative to the labeled data.
перечисления | |
---|---|
DATA_LABEL_PLACEMENT_UNSPECIFIED | The positioning is determined automatically by the renderer. |
CENTER | Center within a bar or column, both horizontally and vertically. |
LEFT | To the left of a data point. |
RIGHT | To the right of a data point. |
ABOVE | Above a data point. |
BELOW | Below a data point. |
INSIDE_END | Inside a bar or column at the end (top if positive, bottom if negative). |
INSIDE_BASE | Inside a bar or column at the base. |
OUTSIDE_END | Outside a bar or column at the end. |
PointStyle
The style of a point on the chart.
Представление JSON |
---|
{
"size": number,
"shape": enum ( |
Поля | |
---|---|
size | The point size. If empty, a default size is used. |
shape | The point shape. If empty or unspecified, a default shape is used. |
PointShape
The shape of a point.
перечисления | |
---|---|
POINT_SHAPE_UNSPECIFIED | Default value. |
CIRCLE | A circle shape. |
DIAMOND | A diamond shape. |
HEXAGON | A hexagon shape. |
PENTAGON | A pentagon shape. |
SQUARE | A square shape. |
STAR | A star shape. |
TRIANGLE | A triangle shape. |
X_MARK | An x-mark shape. |
BasicSeriesDataPointStyleOverride
Style override settings for a single series data point.
Представление JSON |
---|
{ "index": integer, "color": { object ( |
Поля | |
---|---|
index | The zero-based index of the series data point. |
color | Color of the series data point. If empty, the series default is used. Deprecated: Use |
colorStyle | Color of the series data point. If empty, the series default is used. If |
pointStyle | Point style of the series data point. Valid only if the |
BasicChartStackedType
When charts are stacked, range (vertical axis) values are rendered on top of one another rather than from the horizontal axis. For example, the two values 20 and 80 would be drawn from 0, with 80 being 80 units away from the horizontal axis. If they were stacked, 80 would be rendered from 20, putting it 100 units away from the horizontal axis.
перечисления | |
---|---|
BASIC_CHART_STACKED_TYPE_UNSPECIFIED | Default value, do not use. |
NOT_STACKED | Series are not stacked. |
STACKED | Series values are stacked, each value is rendered vertically beginning from the top of the value below it. |
PERCENT_STACKED | Vertical stacks are stretched to reach the top of the chart, with values laid out as percentages of each other. |
BasicChartCompareMode
The compare mode type, which describes the behavior of tooltips and data highlighting when hovering on data and chart area.
перечисления | |
---|---|
BASIC_CHART_COMPARE_MODE_UNSPECIFIED | Default value, do not use. |
DATUM | Only the focused data element is highlighted and shown in the tooltip. |
CATEGORY | All data elements with the same category (eg, domain value) are highlighted and shown in the tooltip. |
PieChartSpec
A pie chart .
Представление JSON |
---|
{ "legendPosition": enum ( |
Поля | |
---|---|
legendPosition | Where the legend of the pie chart should be drawn. |
domain | The data that covers the domain of the pie chart. |
series | The data that covers the one and only series of the pie chart. |
threeDimensional | True if the pie is three dimensional. |
pieHole | The size of the hole in the pie chart. |
PieChartLegendPosition
Where the legend of the chart should be positioned.
перечисления | |
---|---|
PIE_CHART_LEGEND_POSITION_UNSPECIFIED | Default value, do not use. |
BOTTOM_LEGEND | The legend is rendered on the bottom of the chart. |
LEFT_LEGEND | The legend is rendered on the left of the chart. |
RIGHT_LEGEND | The legend is rendered on the right of the chart. |
TOP_LEGEND | The legend is rendered on the top of the chart. |
NO_LEGEND | No legend is rendered. |
LABELED_LEGEND | Each pie slice has a label attached to it. |
BubbleChartSpec
A bubble chart .
Представление JSON |
---|
{ "legendPosition": enum ( |
Поля | |
---|---|
legendPosition | Where the legend of the chart should be drawn. |
bubbleLabels | The data containing the bubble labels. These do not need to be unique. |
domain | The data containing the bubble x-values. These values locate the bubbles in the chart horizontally. |
series | The data containing the bubble y-values. These values locate the bubbles in the chart vertically. |
groupIds | The data containing the bubble group IDs. All bubbles with the same group ID are drawn in the same color. If |
bubbleSizes | The data containing the bubble sizes. Bubble sizes are used to draw the bubbles at different sizes relative to each other. If specified, |
bubbleOpacity | The opacity of the bubbles between 0 and 1.0. 0 is fully transparent and 1 is fully opaque. |
bubbleBorderColor | The bubble border color. Deprecated: Use |
bubbleBorderColorStyle | The bubble border color. If |
bubbleMaxRadiusSize | The max radius size of the bubbles, in pixels. If specified, the field must be a positive value. |
bubbleMinRadiusSize | The minimum radius size of the bubbles, in pixels. If specific, the field must be a positive value. |
bubbleTextStyle | The format of the text inside the bubbles. Strikethrough, underline, and link are not supported. |
BubbleChartLegendPosition
Where the legend of the chart should be positioned.
перечисления | |
---|---|
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED | Default value, do not use. |
BOTTOM_LEGEND | The legend is rendered on the bottom of the chart. |
LEFT_LEGEND | The legend is rendered on the left of the chart. |
RIGHT_LEGEND | The legend is rendered on the right of the chart. |
TOP_LEGEND | The legend is rendered on the top of the chart. |
NO_LEGEND | No legend is rendered. |
INSIDE_LEGEND | The legend is rendered inside the chart area. |
CandlestickChartSpec
Представление JSON |
---|
{ "domain": { object ( |
Поля | |
---|---|
domain | The domain data (horizontal axis) for the candlestick chart. String data will be treated as discrete labels, other data will be treated as continuous values. |
data[] | The Candlestick chart data. Only one CandlestickData is supported. |
CandlestickDomain
The domain of a CandlestickChart.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | The data of the CandlestickDomain. |
reversed | True to reverse the order of the domain values (horizontal axis). |
CandlestickData
The Candlestick chart data, each containing the low, open, close, and high values for a series.
Представление JSON |
---|
{ "lowSeries": { object ( |
Поля | |
---|---|
lowSeries | The range data (vertical axis) for the low/minimum value for each candle. This is the bottom of the candle's center line. |
openSeries | The range data (vertical axis) for the open/initial value for each candle. This is the bottom of the candle body. If less than the close value the candle will be filled. Otherwise the candle will be hollow. |
closeSeries | The range data (vertical axis) for the close/final value for each candle. This is the top of the candle body. If greater than the open value the candle will be filled. Otherwise the candle will be hollow. |
highSeries | The range data (vertical axis) for the high/maximum value for each candle. This is the top of the candle's center line. |
CandlestickSeries
The series of a CandlestickData.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | The data of the CandlestickSeries. |
OrgChartSpec
An org chart . Org charts require a unique set of labels in labels
and may optionally include parentLabels
and tooltips
. parentLabels
contain, for each node, the label identifying the parent node. tooltips
contain, for each node, an optional tooltip.
For example, to describe an OrgChart with Alice as the CEO, Bob as the President (reporting to Alice) and Cathy as VP of Sales (also reporting to Alice), have labels
contain "Alice", "Bob", "Cathy", parentLabels
contain "", "Alice", "Alice" and tooltips
contain "CEO", "President", "VP Sales".
Представление JSON |
---|
{ "nodeSize": enum ( |
Поля | |
---|---|
nodeSize | The size of the org chart nodes. |
nodeColor | The color of the org chart nodes. Deprecated: Use |
nodeColorStyle | The color of the org chart nodes. If |
selectedNodeColor | The color of the selected org chart nodes. Deprecated: Use |
selectedNodeColorStyle | The color of the selected org chart nodes. If |
labels | The data containing the labels for all the nodes in the chart. Labels must be unique. |
parentLabels | The data containing the label of the parent for the corresponding node. A blank value indicates that the node has no parent and is a top-level node. This field is optional. |
tooltips | The data containing the tooltip for the corresponding node. A blank value results in no tooltip being displayed for the node. This field is optional. |
OrgChartNodeSize
The size of the org chart nodes.
перечисления | |
---|---|
ORG_CHART_LABEL_SIZE_UNSPECIFIED | Default value, do not use. |
SMALL | The small org chart node size. |
MEDIUM | The medium org chart node size. |
LARGE | The large org chart node size. |
HistogramChartSpec
A histogram chart . A histogram chart groups data items into bins, displaying each bin as a column of stacked items. Histograms are used to display the distribution of a dataset. Each column of items represents a range into which those items fall. The number of bins can be chosen automatically or specified explicitly.
Представление JSON |
---|
{ "series": [ { object ( |
Поля | |
---|---|
series[] | The series for a histogram may be either a single series of values to be bucketed or multiple series, each of the same length, containing the name of the series followed by the values to be bucketed for that series. |
legendPosition | The position of the chart legend. |
showItemDividers | Whether horizontal divider lines should be displayed between items in each column. |
bucketSize | By default the bucket size (the range of values stacked in a single column) is chosen automatically, but it may be overridden here. Eg, A bucket size of 1.5 results in buckets from 0 - 1.5, 1.5 - 3.0, etc. Cannot be negative. This field is optional. |
outlierPercentile | The outlier percentile is used to ensure that outliers do not adversely affect the calculation of bucket sizes. For example, setting an outlier percentile of 0.05 indicates that the top and bottom 5% of values when calculating buckets. The values are still included in the chart, they will be added to the first or last buckets instead of their own buckets. Must be between 0.0 and 0.5. |
HistogramSeries
A histogram series containing the series color and data.
Представление JSON |
---|
{ "barColor": { object ( |
Поля | |
---|---|
barColor | The color of the column representing this series in each bucket. This field is optional. Deprecated: Use |
barColorStyle | The color of the column representing this series in each bucket. This field is optional. If |
data | The data for this histogram series. |
HistogramChartLegendPosition
Where the legend of the chart should be positioned.
перечисления | |
---|---|
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED | Default value, do not use. |
BOTTOM_LEGEND | The legend is rendered on the bottom of the chart. |
LEFT_LEGEND | The legend is rendered on the left of the chart. |
RIGHT_LEGEND | The legend is rendered on the right of the chart. |
TOP_LEGEND | The legend is rendered on the top of the chart. |
NO_LEGEND | No legend is rendered. |
INSIDE_LEGEND | The legend is rendered inside the chart area. |
WaterfallChartSpec
A waterfall chart.
Представление JSON |
---|
{ "domain": { object ( |
Поля | |
---|---|
domain | The domain data (horizontal axis) for the waterfall chart. |
series[] | The data this waterfall chart is visualizing. |
stackedType | The stacked type. |
firstValueIsTotal | True to interpret the first value as a total. |
hideConnectorLines | True to hide connector lines between columns. |
connectorLineStyle | The line style for the connector lines. |
totalDataLabel | Controls whether to display additional data labels on stacked charts which sum the total value of all stacked values at each value along the domain axis. |
WaterfallChartDomain
The domain of a waterfall chart.
Представление JSON |
---|
{
"data": {
object ( |
Поля | |
---|---|
data | The data of the WaterfallChartDomain. |
reversed | True to reverse the order of the domain values (horizontal axis). |
WaterfallChartSeries
A single series of data for a waterfall chart.
Представление JSON |
---|
{ "data": { object ( |
Поля | |
---|---|
data | The data being visualized in this series. |
positiveColumnsStyle | Styles for all columns in this series with positive values. |
negativeColumnsStyle | Styles for all columns in this series with negative values. |
subtotalColumnsStyle | Styles for all subtotal columns in this series. |
hideTrailingSubtotal | True to hide the subtotal column from the end of the series. By default, a subtotal column will appear at the end of each series. Setting this field to true will hide that subtotal column for this series. |
customSubtotals[] | Custom subtotal columns appearing in this series. The order in which subtotals are defined is not significant. Only one subtotal may be defined for each data point. |
dataLabel | Information about the data labels for this series. |
WaterfallChartColumnStyle
Styles for a waterfall chart column.
Представление JSON |
---|
{ "label": string, "color": { object ( |
Поля | |
---|---|
label | The label of the column's legend. |
color | The color of the column. Deprecated: Use |
colorStyle | The color of the column. If |
WaterfallChartCustomSubtotal
A custom subtotal column for a waterfall chart series.
Представление JSON |
---|
{ "subtotalIndex": integer, "label": string, "dataIsSubtotal": boolean } |
Поля | |
---|---|
subtotalIndex | The zero-based index of a data point within the series. If |
label | A label for the subtotal column. |
dataIsSubtotal | True if the data point at |
WaterfallChartStackedType
Stacked type options for waterfall charts.
перечисления | |
---|---|
WATERFALL_STACKED_TYPE_UNSPECIFIED | Default value, do not use. |
STACKED | Values corresponding to the same domain (horizontal axis) value will be stacked vertically. |
SEQUENTIAL | Series will spread out along the horizontal axis. |
TreemapChartSpec
A Treemap chart .
Представление JSON |
---|
{ "labels": { object ( |
Поля | |
---|---|
labels | The data that contains the treemap cell labels. |
parentLabels | The data the contains the treemap cells' parent labels. |
sizeData | The data that determines the size of each treemap data cell. This data is expected to be numeric. The cells corresponding to non-numeric or missing data will not be rendered. If |
colorData | The data that determines the background color of each treemap data cell. This field is optional. If not specified, |
textFormat | The text format for all labels on the chart. The link field is not supported. |
levels | The number of data levels to show on the treemap chart. These levels are interactive and are shown with their labels. Defaults to 2 if not specified. |
hintedLevels | The number of additional data levels beyond the labeled levels to be shown on the treemap chart. These levels are not interactive and are shown without their labels. Defaults to 0 if not specified. |
minValue | The minimum possible data value. Cells with values less than this will have the same color as cells with this value. If not specified, defaults to the actual minimum value from |
maxValue | The maximum possible data value. Cells with values greater than this will have the same color as cells with this value. If not specified, defaults to the actual maximum value from |
headerColor | The background color for header cells. Deprecated: Use |
headerColorStyle | The background color for header cells. If |
colorScale | The color scale for data cells in the treemap chart. Data cells are assigned colors based on their color values. These color values come from |
hideTooltips | True to hide tooltips. |
TreemapChartColorScale
A color scale for a treemap chart.
Представление JSON |
---|
{ "minValueColor": { object ( |
Поля | |
---|---|
minValueColor | The background color for cells with a color value less than or equal to |
minValueColorStyle | The background color for cells with a color value less than or equal to |
midValueColor | The background color for cells with a color value at the midpoint between |
midValueColorStyle | The background color for cells with a color value at the midpoint between |
maxValueColor | The background color for cells with a color value greater than or equal to |
maxValueColorStyle | The background color for cells with a color value greater than or equal to |
noDataColor | The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. Deprecated: Use |
noDataColorStyle | The background color for cells that have no color data associated with them. Defaults to #000000 if not specified. If |
ScorecardChartSpec
A scorecard chart. Scorecard charts are used to highlight key performance indicators, known as KPIs, on the spreadsheet. A scorecard chart can represent things like total sales, average cost, or a top selling item. You can specify a single data value, or aggregate over a range of data. Percentage or absolute difference from a baseline value can be highlighted, like changes over time.
Представление JSON |
---|
{ "keyValueData": { object ( |
Поля | |
---|---|
keyValueData | The data for scorecard key value. |
baselineValueData | The data for scorecard baseline value. This field is optional. |
aggregateType | The aggregation type for key and baseline chart data in scorecard chart. This field is not supported for data source charts. Use the |
keyValueFormat | Formatting options for key value. |
baselineValueFormat | Formatting options for baseline value. This field is needed only if |
scaleFactor | Value to scale scorecard key and baseline value. For example, a factor of 10 can be used to divide all values in the chart by 10. This field is optional. |
numberFormatSource | The number format source used in the scorecard chart. This field is optional. |
customFormatOptions | Custom formatting options for numeric key/baseline values in scorecard chart. This field is used only when |
KeyValueFormat
Formatting options for key value.
Представление JSON |
---|
{ "textFormat": { object ( |
Поля | |
---|---|
textFormat | Text formatting options for key value. The link field is not supported. |
position | Specifies the horizontal text positioning of key value. This field is optional. If not specified, default positioning is used. |
BaselineValueFormat
Formatting options for baseline value.
Представление JSON |
---|
{ "comparisonType": enum ( |
Поля | |
---|---|
comparisonType | The comparison type of key value with baseline value. |
textFormat | Text formatting options for baseline value. The link field is not supported. |
position | Specifies the horizontal text positioning of baseline value. This field is optional. If not specified, default positioning is used. |
description | Description which is appended after the baseline value. This field is optional. |
positiveColor | Color to be used, in case baseline value represents a positive change for key value. This field is optional. Deprecated: Use |
positiveColorStyle | Color to be used, in case baseline value represents a positive change for key value. This field is optional. If |
negativeColor | Color to be used, in case baseline value represents a negative change for key value. This field is optional. Deprecated: Use |
negativeColorStyle | Color to be used, in case baseline value represents a negative change for key value. This field is optional. If |
ComparisonType
The comparison type of key value with baseline value.
перечисления | |
---|---|
COMPARISON_TYPE_UNDEFINED | Default value, do not use. |
ABSOLUTE_DIFFERENCE | Use absolute difference between key and baseline value. |
PERCENTAGE_DIFFERENCE | Use percentage difference between key and baseline value. |
ChartNumberFormatSource
The number formatting source options for chart attributes.
перечисления | |
---|---|
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED | Default value, do not use. |
FROM_DATA | Inherit number formatting from data. |
CUSTOM | Apply custom formatting as specified by ChartCustomNumberFormatOptions . |
ChartCustomNumberFormatOptions
Custom number formatting options for chart attributes.
Представление JSON |
---|
{ "prefix": string, "suffix": string } |
Поля | |
---|---|
prefix | Custom prefix to be prepended to the chart attribute. This field is optional. |
suffix | Custom suffix to be appended to the chart attribute. This field is optional. |
ChartHiddenDimensionStrategy
Determines how charts should handle source rows that are hidden. Hidden rows include both manually hidden and hidden by a filter.
перечисления | |
---|---|
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED | Default value, do not use. |
SKIP_HIDDEN_ROWS_AND_COLUMNS | Charts will skip hidden rows and columns. |
SKIP_HIDDEN_ROWS | Charts will skip hidden rows only. |
SKIP_HIDDEN_COLUMNS | Charts will skip hidden columns only. |
SHOW_ALL | Charts will not skip any hidden rows or columns. |
EmbeddedObjectBorder
A border along an embedded object.
Представление JSON |
---|
{ "color": { object ( |
Поля | |
---|---|
color | The color of the border. Deprecated: Use |
colorStyle | The color of the border. If |