Charts

Gráfico incorporado

Un gráfico incorporado en una hoja.

Representación JSON
{
  "chartId": integer,
  "spec": {
    object (ChartSpec)
  },
  "position": {
    object (EmbeddedObjectPosition)
  },
  "border": {
    object (EmbeddedObjectBorder)
  }
}
Campos
chartId

integer

Es el ID del gráfico.

spec

object (ChartSpec)

Es la especificación del gráfico.

position

object (EmbeddedObjectPosition)

La posición del gráfico.

border

object (EmbeddedObjectBorder)

El borde del gráfico

Especificación del gráfico

Las especificaciones de un gráfico

Representación 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.
}
Campos
title

string

Es el título del gráfico.

altText

string

El texto alternativo que describe el gráfico. Por lo general, se usa para fines de accesibilidad.

titleTextFormat

object (TextFormat)

El formato del texto del título. No se admiten tachado, subrayado ni vínculo.

titleTextPosition

object (TextPosition)

Es la posición del texto del título. Este campo es opcional.

subtitle

string

Es el subtítulo del gráfico.

subtitleTextFormat

object (TextFormat)

El formato de texto de los subtítulos. No se admiten tachado, subrayado ni vínculo.

subtitleTextPosition

object (TextPosition)

Es la posición del texto del subtítulo. Este campo es opcional.

fontName

string

Es el nombre de la fuente que se utilizará de forma predeterminada para todo el texto del gráfico (p.ej., título, etiquetas de eje y leyenda). Si se especifica una fuente para una parte específica del gráfico, se anulará este nombre.

maximized

boolean

Verdadero para que un gráfico rellene todo el espacio en el que se renderiza con padding mínimo. Falso para utilizar el padding predeterminado. (no aplicable a los diagramas geográficos ni de la organización).

backgroundColor
(deprecated)

object (Color)

El color de fondo de todo el gráfico No se aplica a los organigramas. Obsoleto: Usa backgroundColorStyle.

backgroundColorStyle

object (ColorStyle)

El color de fondo de todo el gráfico No se aplica a los organigramas. Si también se configura backgroundColor, este campo tiene prioridad.

dataSourceChartProperties

object (DataSourceChartProperties)

Si está presente, el campo contiene propiedades específicas del gráfico de fuente de datos.

filterSpecs[]

object (FilterSpec)

Son los filtros aplicados a los datos de origen del gráfico. Solo es compatible con gráficos de fuentes de datos.

sortSpecs[]

object (SortSpec)

El orden en el que se deben ordenar los datos del gráfico. Solo se admite una especificación de orden. Solo es compatible con gráficos de fuentes de datos.

hiddenDimensionStrategy

enum (ChartHiddenDimensionStrategy)

Determina cómo los gráficos usarán filas o columnas ocultas.

Campo de unión chart. Se debe establecer exactamente un valor para la especificación del gráfico. chart puede ser solo una de las siguientes opciones:
basicChart

object (BasicChartSpec)

Una especificación de gráfico básica puede ser uno de muchos tipos de gráficos. Consulta BasicChartType para obtener una lista de todos los gráficos que admite esta opción.

pieChart

object (PieChartSpec)

Una especificación de gráfico circular.

bubbleChart

object (BubbleChartSpec)

Una especificación para un diagrama de burbujas.

candlestickChart

object (CandlestickChartSpec)

Una especificación del gráfico de velas.

orgChart

object (OrgChartSpec)

Una especificación del organigrama.

histogramChart

object (HistogramChartSpec)

Una especificación de gráfico de histograma.

waterfallChart

object (WaterfallChartSpec)

Una especificación de gráfico de cascada.

treemapChart

object (TreemapChartSpec)

Una especificación de gráfico de diagrama de árbol.

scorecardChart

object (ScorecardChartSpec)

Una especificación de gráfico de cuadro de evaluación

Posición de texto

Configuración de posición del texto.

Representación JSON
{
  "horizontalAlignment": enum (HorizontalAlign)
}
Campos
horizontalAlignment

enum (HorizontalAlign)

Configuración de alineación horizontal para la porción de texto.

DataSourceChartProperties

Propiedades de un gráfico de fuente de datos

Representación JSON
{
  "dataSourceId": string,
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  }
}
Campos
dataSourceId

string

ID de la fuente de datos con la que está asociado el gráfico.

dataExecutionStatus

object (DataExecutionStatus)

Solo salida. El estado de ejecución de los datos.

Especificación básica

La especificación para un gráfico básico. Consulta BasicChartType para obtener una lista de los gráficos que admite esta opción.

Representación 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)
  }
}
Campos
chartType

enum (BasicChartType)

Es el tipo de gráfico.

legendPosition

enum (BasicChartLegendPosition)

La posición de la leyenda del gráfico.

axis[]

object (BasicChartAxis)

Eje en el gráfico.

domains[]

object (BasicChartDomain)

Es el dominio de los datos que se muestran en el gráfico. Solo se admite un dominio.

series[]

object (BasicChartSeries)

Los datos que se muestran en este gráfico.

headerCount

integer

La cantidad de filas o columnas en los datos que son “encabezados”. Si no la estableces, Hojas de cálculo de Google adivinará cuántas filas son encabezados en función de los datos.

(Ten en cuenta que BasicChartAxis.title puede anular el título del eje inferido de los valores del encabezado).

threeDimensional

boolean

Verdadero para que el gráfico sea en 3D. Se aplica a los gráficos de barras y columnas.

interpolateNulls

boolean

Si faltan algunos valores en una serie, es posible que aparezcan espacios en el gráfico (p. ej., faltarán segmentos de líneas en un gráfico de líneas). Para eliminar estas brechas, establece esto como verdadero. Se aplica a los gráficos de líneas, de área y combinados.

stackedType

enum (BasicChartStackedType)

Es el tipo apilado para gráficos que admiten el apilamiento vertical. Se aplica a los gráficos de áreas, barras, columnas, combinaciones y áreas escalonadas.

lineSmoothing

boolean

Obtiene si las líneas se deben renderizar de forma fluida o recta de forma predeterminada. Se aplica a los gráficos de líneas.

compareMode

enum (BasicChartCompareMode)

Comportamiento de los datos y la información destacada cuando se coloca el cursor sobre datos y el área del gráfico.

totalDataLabel

object (DataLabel)

Controla si se muestran etiquetas de datos adicionales en gráficos apilados que sumen el valor total de todos los valores apilados en cada valor del eje de dominio. Estas etiquetas de datos solo se pueden configurar cuando chartType es uno de AREA, BAR, COLUMN, COMBO o STEPPED_AREA, y stackedType es STACKED o PERCENT_STACKED. Además, para COMBO, esto solo se admitirá si hay un solo tipo de serie apilable type o un tipo tiene más series que las otras y cada uno de los otros tipos no tiene más de una serie. Por ejemplo, si un gráfico tiene dos series de barras apiladas y una serie de áreas, se admitirán las etiquetas de datos totales. Si tiene tres series de barras y dos series de área, no se permiten etiquetas de datos totales. No se puede establecer CUSTOM ni placement en totalDataLabel.

Tipo de gráfico básico

Cómo debe visualizarse el gráfico

Enumeradores
BASIC_CHART_TYPE_UNSPECIFIED Valor predeterminado, no usar.
BAR Un gráfico de barras.
LINE Un gráfico de líneas.
AREA Un gráfico de áreas
COLUMN Un gráfico de columnas.
SCATTER Un gráfico de dispersión.
COMBO Un gráfico combinado
STEPPED_AREA Un gráfico de áreas escalonado

BasicChartLegendPosition

Dónde se debe colocar la leyenda del gráfico.

Enumeradores
BASIC_CHART_LEGEND_POSITION_UNSPECIFIED Valor predeterminado, no usar.
BOTTOM_LEGEND La leyenda se renderiza en la parte inferior del gráfico.
LEFT_LEGEND La leyenda se renderiza a la izquierda del gráfico.
RIGHT_LEGEND La leyenda se renderiza a la derecha del gráfico.
TOP_LEGEND La leyenda se renderiza en la parte superior del gráfico.
NO_LEGEND No se renderiza ninguna leyenda.

Eje de gráfico básico

Eje del gráfico. Un gráfico no puede tener más de un eje por axis position.

Representación JSON
{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}
Campos
position

enum (BasicChartAxisPosition)

Indica la posición de este eje.

title

string

El título de este eje. Si se configura, anula cualquier título inferido de los encabezados de los datos.

format

object (TextFormat)

Corresponde al formato del título. Solo es válido si el eje no está asociado con el dominio. El campo del vínculo no es compatible.

titleTextPosition

object (TextPosition)

Posición del texto del título del eje.

viewWindowOptions

object (ChartAxisViewWindowOptions)

Las opciones de ventana de vista para este eje.

Posición de BasicChartAxis

Indica la posición de un eje de gráfico.

Enumeradores
BASIC_CHART_AXIS_POSITION_UNSPECIFIED Valor predeterminado, no usar.
BOTTOM_AXIS Eje renderizado en la parte inferior de un gráfico. En la mayoría de los gráficos, este es el eje mayor estándar. En los gráficos de barras, este es un eje menor.
LEFT_AXIS Eje renderizado a la izquierda de un gráfico. Para la mayoría de los gráficos, este es un eje menor. En los gráficos de barras, este es el eje principal estándar.
RIGHT_AXIS Eje renderizado a la derecha de un gráfico. Para la mayoría de los gráficos, este es un eje menor. En los gráficos de barras, este es un eje mayor inusual.

Opciones de WindowAxisViewWindowOptions

Las opciones que definen una "ventana de vista" para un gráfico (como los valores visibles en un eje).

Representación JSON
{
  "viewWindowMin": number,
  "viewWindowMax": number,
  "viewWindowMode": enum (ViewWindowMode)
}
Campos
viewWindowMin

number

El valor numérico mínimo que se muestra en esta ventana de vista. Si no la estableces, se determinará automáticamente un valor mínimo adecuado para los datos.

viewWindowMax

number

El valor numérico máximo que se muestra en esta ventana de vista. Si no la estableces, se determinará automáticamente un valor máximo que se vea bien para los datos.

viewWindowMode

enum (ViewWindowMode)

El modo de la ventana de vista

Modo de ventana de vista

El modo de la ventana de vista Define cómo tratar el mín. y máx. de la ventana de vista.

Enumeradores
DEFAULT_VIEW_WINDOW_MODE El modo de ventana de vista predeterminado que se usa en el editor de Hojas de cálculo para este tipo de gráfico. En la mayoría de los casos, si se configura, el modo predeterminado es equivalente a PRETTY.
VIEW_WINDOW_MODE_UNSUPPORTED No lo utilices. Representa que la API no admite el modo establecido actualmente.
EXPLICIT Sigue el mínimo y el máximo exactamente si se especifica. Si no se especifica un valor, se recurrirá al valor PRETTY.
PRETTY Elige un mínimo y un máximo para que el gráfico se vea bien. En este modo, se ignoran tanto los valores mín. como máx.

Dominio de gráfico básico

Es el dominio de un gráfico. Por ejemplo, si registras los precios de las acciones a lo largo del tiempo, esa es la fecha.

Representación JSON
{
  "domain": {
    object (ChartData)
  },
  "reversed": boolean
}
Campos
domain

object (ChartData)

Los datos del dominio. Por ejemplo, si se muestra un gráfico de precios de acciones a lo largo del tiempo, estos son los datos que representan las fechas.

reversed

boolean

Verdadero para invertir el orden de los valores de dominio (eje horizontal).

Datos del gráfico

Los datos incluidos en un dominio o una serie.

Representación 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.
}
Campos
groupRule

object (ChartGroupRule)

La regla para agrupar los datos por si ChartData respalda el dominio de un gráfico de fuente de datos. Solo es compatible con gráficos de fuentes de datos.

aggregateType

enum (ChartAggregateType)

El tipo de agregación para la serie de un gráfico de fuente de datos. Solo es compatible con gráficos de fuentes de datos.

Campo de unión type. Se debe establecer exactamente un tipo de datos incluidos. type puede ser solo una de las siguientes opciones:
sourceRange

object (ChartSourceRange)

Los rangos de origen de los datos.

columnReference

object (DataSourceColumnReference)

Referencia a la columna de la fuente de datos desde la que se leen los datos.

Rango de origen del gráfico

Rangos de origen de un gráfico

Representación JSON
{
  "sources": [
    {
      object (GridRange)
    }
  ]
}
Campos
sources[]

object (GridRange)

Los rangos de datos para una serie o dominio. Exactamente una dimensión debe tener una longitud de 1, y todas las fuentes de la lista deben tener la misma dimensión con la longitud 1. El dominio (si existe) y todas las series deben tener la misma cantidad de rangos de origen. Si se usa más de un rango de origen, el rango de origen en un desplazamiento determinado debe estar en orden y contiguo en el dominio y la serie.

Por ejemplo, estos son parámetros de configuración válidos:

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

Regla de grupo del gráfico

Es una configuración opcional en el ChartData del dominio de un gráfico de fuente de datos que define buckets para los valores del dominio, en lugar de desglosar cada valor individual.

Por ejemplo, cuando se traza un gráfico de fuente de datos, se puede especificar una regla de histograma del dominio (solo debe contener valores numéricos) y se agrupan sus valores en buckets. Todos los valores de una serie de gráficos que pertenecen al mismo bucket se agregan según el aggregateType.

Representación 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.
}
Campos
Campo de unión rule. Es la regla que se aplica a ChartData. rule puede ser solo una de las siguientes opciones:
dateTimeRule

object (ChartDateTimeRule)

Un objeto ChartDateTimeRule.

histogramRule

object (ChartHistogramRule)

Un ChartHistogramRule

Regla de gráfico de fecha

Te permite organizar los valores de fecha y hora de una columna de datos de origen en buckets según las partes seleccionadas de sus valores de fecha o de hora.

Representación JSON
{
  "type": enum (ChartDateTimeRuleType)
}
Campos
type

enum (ChartDateTimeRuleType)

El tipo de agrupación de fecha y hora que se aplicará.

Tipo de regla de fecha del gráfico

Los tipos disponibles de reglas de agrupación de fecha y hora.

Enumeradores
CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED El tipo predeterminado, no usar.
SECOND Agrupa las fechas por segundo, del 0 al 59.
MINUTE Agrupa las fechas por minuto, del 0 al 59.
HOUR Agrupa fechas por hora con un sistema de 24 horas, de 0 a 23.
HOUR_MINUTE Agrupa las fechas por hora y minuto con un sistema de 24 horas, por ejemplo, 19:45.
HOUR_MINUTE_AMPM Agrupa las fechas por hora y minuto con un sistema de 12 horas, por ejemplo, a las 7:45 p.m. La designación de a.m./p.m. se traduce según la configuración regional de la hoja de cálculo.
DAY_OF_WEEK Agrupa las fechas por día de la semana, por ejemplo, los domingos. Los días de la semana se traducirán según la configuración regional de la hoja de cálculo.
DAY_OF_YEAR Agrupa las fechas por día del año, de 1 a 366. Tenga en cuenta que las fechas posteriores al 29 de febrero se encuentran en segmentos diferentes en años bisiestos y en años no bisiestos.
DAY_OF_MONTH Agrupa las fechas por día del mes, del 1 al 31.
DAY_MONTH Agrupa las fechas por día y mes, por ejemplo, del 22 de nov. El mes se traduce según la configuración regional de la hoja de cálculo.
MONTH Agrupa las fechas por mes, por ejemplo, noviembre. El mes se traduce según la configuración regional de la hoja de cálculo.
QUARTER Agrupa las fechas por trimestre, por ejemplo, el primer trimestre (que representa ene-mar).
YEAR Agrupa las fechas por año, por ejemplo, 2008.
YEAR_MONTH Agrupa las fechas por año y mes, por ejemplo, de 2008 a noviembre. El mes se traduce en función de la configuración regional de la hoja de cálculo.
YEAR_QUARTER Agrupa las fechas por año y trimestre, por ejemplo, T4 2008.
YEAR_MONTH_DAY Agrupa las fechas por año, mes y día, por ejemplo, 2011-2018.

Regla de ChartHistogram

Permite organizar los valores numéricos de una columna de datos de origen en buckets de tamaño constante.

Representación JSON
{
  "minValue": number,
  "maxValue": number,
  "intervalSize": number
}
Campos
minValue

number

El valor mínimo en el que se colocan los elementos en buckets. Los valores que son inferiores al mínimo se agrupan en un solo bucket. Si se omite, se determina por el valor mínimo del elemento.

maxValue

number

El valor máximo en el que se colocan los elementos en buckets. Los valores mayores que el máximo se agrupan en un solo bucket. Si se omite, se determina por el valor máximo del elemento.

intervalSize

number

El tamaño de los buckets que se crean. Debe ser positivo.

Tipo de conjunto de gráficos

El tipo de agregación para las series de gráficos.

Enumeradores
CHART_AGGREGATE_TYPE_UNSPECIFIED Valor predeterminado, no usar.
AVERAGE Función de agregación promedio.
COUNT Cuenta la función de agregación.
MAX Función agregada máxima.
MEDIAN Mediana de función agregada.
MIN Función agregada mínima.
SUM Sumar la función agregada

BasicChartSeries

Es una sola serie de datos en un gráfico. Por ejemplo, si grafica los precios de las acciones a lo largo del tiempo, puede haber varias series, una para “Precio abierto”, “Precio alto”, “Precio bajo” y “Precio de cierre”.

Representación 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)
    }
  ]
}
Campos
series

object (ChartData)

Los datos que se visualizan en esta serie de gráficos.

targetAxis

enum (BasicChartAxisPosition)

Eje menor que especificará el rango de valores para esta serie. Por ejemplo, si registras acciones en el tiempo, es posible que la serie "Volumen" esté fijada a la derecha con los precios fijados a la izquierda, porque la escala del volumen de comercio es diferente de la de precios. Es un error especificar un eje que no es un eje menor válido para el type del gráfico.

type

enum (BasicChartType)

Es el tipo de esta serie. Solo es válido si el chartType es COMBO. Los diferentes tipos cambiarán la forma en que se visualiza la serie. Solo se admiten LINE, AREA y COLUMN.

lineStyle

object (LineStyle)

Corresponde al estilo de línea de esta serie. Solo es válido si el chartType es AREA, LINE o SCATTER. También se admiten los gráficos COMBO si el series chart type es AREA o LINE.

dataLabel

object (DataLabel)

Información sobre las etiquetas de datos de esta serie.

color
(deprecated)

object (Color)

El color de los elementos (como barras, líneas y puntos) asociados con esta serie. Si está vacío, se usa un color predeterminado. Obsoleto: Usa colorStyle.

colorStyle

object (ColorStyle)

El color de los elementos (como barras, líneas y puntos) asociados con esta serie. Si está vacío, se usa un color predeterminado. Si también se configura color, este campo tiene prioridad.

pointStyle

object (PointStyle)

El estilo de los puntos asociados con esta serie. Solo es válido si el chartType es AREA, LINE o SCATTER. Los gráficos COMBO también son compatibles si series chart type es AREA, LINE o SCATTER. Si está vacío, se usa un estilo de punto predeterminado.

styleOverrides[]

object (BasicSeriesDataPointStyleOverride)

Configuración de anulación de estilo para datos de la serie.

Estilo de línea

Propiedades que describen el estilo de una línea

Representación JSON
{
  "width": integer,
  "type": enum (LineDashType)
}
Campos
width

integer

Espesor de la línea, en píxeles.

type

enum (LineDashType)

El tipo de guion de la línea

TipoDeLíneaDeDash

El tipo de guion de una línea

Enumeradores
LINE_DASH_TYPE_UNSPECIFIED Valor predeterminado, no usar.
INVISIBLE Sin tipo de guion, que equivale a una línea no visible.
CUSTOM Un guion personalizado para una línea Por el momento, no se admite la modificación del estilo de guion personalizado exacto.
SOLID Una línea continua
DOTTED Una línea punteada
MEDIUM_DASHED Línea punteada en la que los guiones tienen una longitud “media”.
MEDIUM_DASHED_DOTTED Línea que alterna entre un guion "medio" y un punto.
LONG_DASHED Línea punteada en la que los guiones tienen una longitud “larga”.
LONG_DASHED_DOTTED Línea que alterna entre un guion "largo" y un punto.

Etiqueta de datos

Configuración para un conjunto de etiquetas de datos. Las etiquetas de datos son anotaciones que aparecen junto a un conjunto de datos, como los puntos en un gráfico de líneas, y proporcionan información adicional sobre lo que representan los datos, como una representación de texto del valor detrás de ese punto en el gráfico.

Representación JSON
{
  "type": enum (DataLabelType),
  "textFormat": {
    object (TextFormat)
  },
  "placement": enum (DataLabelPlacement),
  "customLabelData": {
    object (ChartData)
  }
}
Campos
type

enum (DataLabelType)

Es el tipo de la etiqueta de datos.

textFormat

object (TextFormat)

El formato de texto que se usa para la etiqueta de datos. El campo del vínculo no es compatible.

placement

enum (DataLabelPlacement)

La posición de la etiqueta de datos en relación con los datos etiquetados.

customLabelData

object (ChartData)

Datos para usar en etiquetas personalizadas Solo se usa si type se configura como CUSTOM. Estos datos deben tener la misma longitud que la serie o algún otro elemento al que se aplique esta etiqueta de datos. Además, si la serie está dividida en varios rangos de origen, estos datos de origen deben provenir de la siguiente columna. Por ejemplo, si la serie es B2:B4,E6:E8, estos datos deben provenir de C2:C4,F6:F8.

Tipo de etiqueta de datos

El tipo de una etiqueta de datos.

Enumeradores
DATA_LABEL_TYPE_UNSPECIFIED El tipo de etiqueta de datos no se especifica y se interpretará según el contexto de la etiqueta de datos en el gráfico.
NONE No se muestra la etiqueta de datos.
DATA La etiqueta de datos se muestra con los valores de los datos de la serie.
CUSTOM La etiqueta de datos se muestra con valores de una fuente de datos personalizada que indica customLabelData.

Posición de la etiqueta de datos

La posición de una etiqueta de datos en relación con los datos etiquetados.

Enumeradores
DATA_LABEL_PLACEMENT_UNSPECIFIED El procesador determina automáticamente el posicionamiento.
CENTER Centro dentro de una barra o columna, tanto horizontal como verticalmente.
LEFT A la izquierda de un dato
RIGHT A la derecha de un dato
ABOVE Arriba de un dato
BELOW Debajo de un dato
INSIDE_END Dentro de una barra o columna al final (parte superior si es positivo, y inferior si es negativo)
INSIDE_BASE Dentro de una barra o columna en la base
OUTSIDE_END Fuera de una barra o columna al final

Estilo de punto

El estilo de un punto del gráfico.

Representación JSON
{
  "size": number,
  "shape": enum (PointShape)
}
Campos
size

number

Es el tamaño del punto. Si está vacío, se usa un tamaño predeterminado.

shape

enum (PointShape)

La forma de punto. Si está vacía o no se especifica, se usa una forma predeterminada.

Forma de punto

Forma de un punto

Enumeradores
POINT_SHAPE_UNSPECIFIED Valor predeterminado
CIRCLE Forma de círculo
DIAMOND Forma de diamante.
HEXAGON Forma hexagonal.
PENTAGON Forma de pentágono.
SQUARE Forma cuadrada.
STAR Una forma de estrella
TRIANGLE Forma de triángulo.
X_MARK Una forma de marca X.

BasicSeriesDataPointStyleOverride

Configuración de anulación de estilo para datos individuales.

Representación JSON
{
  "index": integer,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  }
}
Campos
index

integer

El índice basado en cero de los datos de la serie.

color
(deprecated)

object (Color)

Color del dato de la serie. Si está vacío, se usa el valor predeterminado de la serie. Obsoleto: Usa colorStyle.

colorStyle

object (ColorStyle)

Color del dato de la serie. Si está vacío, se usa el valor predeterminado de la serie. Si también se configura color, este campo tiene prioridad.

pointStyle

object (PointStyle)

Estilo de dato de los datos de serie. Solo es válido si el chartType es AREA, LINE o SCATTER. Los gráficos COMBO también son compatibles si series chart type es AREA, LINE o SCATTER. Si está vacío, se usa el valor predeterminado de la serie.

Tipo de gráfico básicoapilado

Cuando se apilan los gráficos, los valores de rango (eje vertical) se renderizan uno encima del otro en lugar de hacerlo desde el eje horizontal. Por ejemplo, los valores 20 y 80 se extraen de 0, donde 80 son 80 unidades del eje horizontal. Si se apilan, 80 se renderizarán a partir de 20, es decir, 100 unidades del eje horizontal.

Enumeradores
BASIC_CHART_STACKED_TYPE_UNSPECIFIED Valor predeterminado, no usar.
NOT_STACKED Las series no están apiladas.
STACKED Los valores de la serie se apilan, cada uno se renderiza de forma vertical a partir de la parte superior.
PERCENT_STACKED Las pilas verticales se estiran para alcanzar la parte superior del gráfico, con valores establecidos como porcentajes entre sí.

Modo de comparación de gráficos

El tipo de modo de comparación, que describe el comportamiento de la información sobre la herramienta y el destacado de datos cuando se coloca el cursor sobre los datos y el área del gráfico.

Enumeradores
BASIC_CHART_COMPARE_MODE_UNSPECIFIED Valor predeterminado, no usar.
DATUM Solo el elemento de datos enfocado se destaca y se muestra en la información sobre la herramienta.
CATEGORY Todos los elementos de datos con la misma categoría (p.ej., valor de dominio) aparecen destacados y aparecen en la información sobre la herramienta.

PiePieSpec

Un gráfico circular

Representación JSON
{
  "legendPosition": enum (PieChartLegendPosition),
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "threeDimensional": boolean,
  "pieHole": number
}
Campos
legendPosition

enum (PieChartLegendPosition)

Donde se debe dibujar la leyenda del gráfico circular.

domain

object (ChartData)

Los datos que cubren el dominio del gráfico circular

series

object (ChartData)

Los datos que cubren la única serie del gráfico circular.

threeDimensional

boolean

Verdadero si el pastel es tridimensional.

pieHole

number

El tamaño del agujero en el gráfico circular

Posición del gráfico circular

Dónde se debe colocar la leyenda del gráfico.

Enumeradores
PIE_CHART_LEGEND_POSITION_UNSPECIFIED Valor predeterminado, no usar.
BOTTOM_LEGEND La leyenda se renderiza en la parte inferior del gráfico.
LEFT_LEGEND La leyenda se renderiza a la izquierda del gráfico.
RIGHT_LEGEND La leyenda se renderiza a la derecha del gráfico.
TOP_LEGEND La leyenda se renderiza en la parte superior del gráfico.
NO_LEGEND No se renderiza ninguna leyenda.
LABELED_LEGEND Cada porción de pastel tiene una etiqueta adjunta.

Especificación de BubbleChart

Un gráfico de burbujas

Representación 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)
  }
}
Campos
legendPosition

enum (BubbleChartLegendPosition)

Donde se debe dibujar la leyenda del gráfico.

bubbleLabels

object (ChartData)

Los datos que contienen las etiquetas de burbujas. No es necesario que sean únicos.

domain

object (ChartData)

Los datos que contienen los valores X de las burbujas Estos valores ubican las burbujas en el gráfico de forma horizontal.

series

object (ChartData)

Los datos que contienen los valores de Y de burbujas. Estos valores ubican las burbujas en el gráfico de forma vertical.

groupIds

object (ChartData)

Los datos que contienen los ID del grupo de burbujas. Todas las burbujas con el mismo ID de grupo se dibujan con el mismo color. Si se especifica bubbleSizes, también se debe especificar este campo, pero puede contener valores en blanco. Este campo es opcional.

bubbleSizes

object (ChartData)

Los datos que contienen los tamaños de las burbujas. Los tamaños de las burbujas se usan para dibujar las burbujas en diferentes tamaños entre sí. Si se especifica, también se debe especificar groupIds. Este campo es opcional.

bubbleOpacity

number

La opacidad de las burbujas entre 0 y 1.0. 0 es completamente transparente y 1 es completamente opaco.

bubbleBorderColor
(deprecated)

object (Color)

El color del borde de la burbuja Obsoleto: Usa bubbleBorderColorStyle.

bubbleBorderColorStyle

object (ColorStyle)

El color del borde de la burbuja Si también se configura bubbleBorderColor, este campo tiene prioridad.

bubbleMaxRadiusSize

integer

El tamaño máximo del radio de las burbujas, en píxeles. Si se especifica, el campo debe ser un valor positivo.

bubbleMinRadiusSize

integer

El tamaño mínimo del radio de las burbujas, en píxeles. Si es específico, el campo debe ser un valor positivo.

bubbleTextStyle

object (TextFormat)

El formato del texto dentro de las burbujas. No se admiten tachado, subrayado ni vínculo.

BubbleChartLegendPosition

Dónde se debe colocar la leyenda del gráfico.

Enumeradores
BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED Valor predeterminado, no usar.
BOTTOM_LEGEND La leyenda se renderiza en la parte inferior del gráfico.
LEFT_LEGEND La leyenda se renderiza a la izquierda del gráfico.
RIGHT_LEGEND La leyenda se renderiza a la derecha del gráfico.
TOP_LEGEND La leyenda se renderiza en la parte superior del gráfico.
NO_LEGEND No se renderiza ninguna leyenda.
INSIDE_LEGEND La leyenda se renderiza dentro del área del gráfico.

Especificación del gráfico de velas

Un gráfico de velas

Representación JSON
{
  "domain": {
    object (CandlestickDomain)
  },
  "data": [
    {
      object (CandlestickData)
    }
  ]
}
Campos
domain

object (CandlestickDomain)

Los datos de dominio (eje horizontal) del gráfico de velas. Los datos de string se tratarán como etiquetas discretas, mientras que otros se considerarán valores continuos.

data[]

object (CandlestickData)

Los datos del gráfico de velas Solo se admite un CandlestickData.

CandlestickDomain

Es el dominio de un CandlestickChart.

Representación JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Campos
data

object (ChartData)

Los datos del CandlestickDomain.

reversed

boolean

Verdadero para invertir el orden de los valores de dominio (eje horizontal).

Datos de la vela

Los datos del gráfico de velas, cada uno con los valores bajos, abiertos, cercanos y altos de una serie.

Representación JSON
{
  "lowSeries": {
    object (CandlestickSeries)
  },
  "openSeries": {
    object (CandlestickSeries)
  },
  "closeSeries": {
    object (CandlestickSeries)
  },
  "highSeries": {
    object (CandlestickSeries)
  }
}
Campos
lowSeries

object (CandlestickSeries)

Los datos del rango (eje vertical) para el valor bajo/mínimo de cada vela. Esta es la parte inferior de la línea central de la vela.

openSeries

object (CandlestickSeries)

Los datos del rango (eje vertical) del valor abierto/inicial de cada vela. Esta es la parte inferior del cuerpo de la vela. Si es menor que el valor de cierre, se llenará la vela. De lo contrario, la vela estará vacía.

closeSeries

object (CandlestickSeries)

Los datos del rango (eje vertical) del valor de cierre/final de cada vela. Esta es la parte superior del cuerpo de la vela. Si es mayor que el valor de apertura, se llenará la vela. De lo contrario, la vela estará vacía.

highSeries

object (CandlestickSeries)

Los datos del rango (eje vertical) para el valor alto y máximo de cada vela. Esta es la parte superior de la línea central de la vela.

CandlestickSeries

Serie de un CandlestickData.

Representación JSON
{
  "data": {
    object (ChartData)
  }
}
Campos
data

object (ChartData)

Los datos de CandlestickSeries.

Especificación del gráfico

Un organigrama Los organigramas requieren un conjunto único de etiquetas en labels y, de forma opcional, pueden incluir parentLabels y tooltips. parentLabels contiene, para cada nodo, la etiqueta que identifica al nodo superior. tooltips contiene una información opcional sobre cada nodo.

Por ejemplo, para describir un orgChart con Alice como director general, Bob como presidente (que le informa a Alice) y Cathy como vicepresidente de ventas (que también le informa a Alice), labels contiene "Alice", "Bob", "Cathy", parentLabels contiene "", "Alice", "Alice" y tooltips contienen "CEO", "Presidente", "Sales Sales".

Representación 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)
  }
}
Campos
nodeSize

enum (OrgChartNodeSize)

Es el tamaño de los nodos del organigrama.

nodeColor
(deprecated)

object (Color)

El color de los nodos del organigrama Obsoleto: Usa nodeColorStyle.

nodeColorStyle

object (ColorStyle)

El color de los nodos del organigrama Si también se configura nodeColor, este campo tiene prioridad.

selectedNodeColor
(deprecated)

object (Color)

El color de los nodos del organigrama seleccionados. Obsoleto: Usa selectedNodeColorStyle.

selectedNodeColorStyle

object (ColorStyle)

El color de los nodos del organigrama seleccionados. Si también se configura selectedNodeColor, este campo tiene prioridad.

labels

object (ChartData)

Los datos que contienen las etiquetas de todos los nodos del gráfico. Las etiquetas deben ser únicas.

parentLabels

object (ChartData)

Los datos que contienen la etiqueta del elemento superior del nodo correspondiente. Un valor en blanco indica que el nodo no tiene un nodo superior y es un nodo de nivel superior. Este campo es opcional.

tooltips

object (ChartData)

Los datos que contienen la información sobre la herramienta del nodo correspondiente. Un valor en blanco no hace que se muestre información sobre la herramienta para el nodo. Este campo es opcional.

Tamaño del nodo del gráfico

Es el tamaño de los nodos del organigrama.

Enumeradores
ORG_CHART_LABEL_SIZE_UNSPECIFIED Valor predeterminado, no usar.
SMALL El tamaño pequeño del nodo del organigrama.
MEDIUM El tamaño medio del nodo de organigrama.
LARGE Es el gran tamaño del nodo del organigrama.

Especificación del histograma

Un gráfico de histograma Un gráfico de histograma agrupa los elementos de datos en discretizaciones, que muestran cada discretización como una columna de elementos apilados. Los histogramas se usan para mostrar la distribución de un conjunto de datos. Cada columna de elementos representa un rango al que pertenecen esos elementos. La cantidad de contenedores se puede elegir automáticamente o especificar de forma explícita.

Representación JSON
{
  "series": [
    {
      object (HistogramSeries)
    }
  ],
  "legendPosition": enum (HistogramChartLegendPosition),
  "showItemDividers": boolean,
  "bucketSize": number,
  "outlierPercentile": number
}
Campos
series[]

object (HistogramSeries)

La serie de un histograma puede ser una sola serie de valores que se agruparán o varias series, cada una de la misma longitud, que contenga el nombre de la serie seguida de los valores que se agruparán para esa serie.

legendPosition

enum (HistogramChartLegendPosition)

La posición de la leyenda del gráfico.

showItemDividers

boolean

Indica si se deben mostrar líneas divisorias horizontales entre los elementos de cada columna.

bucketSize

number

De forma predeterminada, el tamaño del bucket (el rango de valores apilados en una sola columna) se elige automáticamente, pero se puede anular aquí. P. ej.: Un tamaño de bucket de 1.5 da como resultado buckets de 0 a 1.5, de 1.5 a 3.0, etc. No puede ser negativo. Este campo es opcional.

outlierPercentile

number

El percentil de valores atípicos se usa para garantizar que los valores atípicos no afecten de manera adversa el cálculo de los tamaños de los buckets. Por ejemplo, establecer un percentil de valores atípicos de 0.05 indica que el 5% superior y el inferior de los valores cuando se calculan buckets. Los valores aún se incluyen en el gráfico; se agregarán al primero o al último segmento en lugar de al suyo. Debe estar comprendido entre 0.0 y 0.5.

Serie de histograma

Una serie de histogramas que contienen el color y los datos de la serie.

Representación JSON
{
  "barColor": {
    object (Color)
  },
  "barColorStyle": {
    object (ColorStyle)
  },
  "data": {
    object (ChartData)
  }
}
Campos
barColor
(deprecated)

object (Color)

El color de la columna que representa esta serie en cada bucket. Este campo es opcional. Obsoleto: Usa barColorStyle.

barColorStyle

object (ColorStyle)

El color de la columna que representa esta serie en cada bucket. Este campo es opcional. Si también se configura barColor, este campo tiene prioridad.

data

object (ChartData)

Los datos de esta serie de histogramas.

HistogramChartLegendPosition

Dónde se debe colocar la leyenda del gráfico.

Enumeradores
HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED Valor predeterminado, no usar.
BOTTOM_LEGEND La leyenda se renderiza en la parte inferior del gráfico.
LEFT_LEGEND La leyenda se renderiza a la izquierda del gráfico.
RIGHT_LEGEND La leyenda se renderiza a la derecha del gráfico.
TOP_LEGEND La leyenda se renderiza en la parte superior del gráfico.
NO_LEGEND No se renderiza ninguna leyenda.
INSIDE_LEGEND La leyenda se renderiza dentro del área del gráfico.

Especificación de WaterfallChart

Un gráfico de cascada

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

object (WaterfallChartDomain)

Los datos de dominio (eje horizontal) del gráfico de cascada.

series[]

object (WaterfallChartSeries)

Los datos que este gráfico de cascada está visualizando.

stackedType

enum (WaterfallChartStackedType)

El tipo apilado.

firstValueIsTotal

boolean

Verdadero para interpretar el primer valor como un total.

hideConnectorLines

boolean

Verdadero para ocultar las líneas del conector entre las columnas.

connectorLineStyle

object (LineStyle)

El estilo de línea para las líneas del conector.

totalDataLabel

object (DataLabel)

Controla si se muestran etiquetas de datos adicionales en gráficos apilados que sumen el valor total de todos los valores apilados en cada valor del eje de dominio. stackedType debe ser STACKED, y no se pueden establecer CUSTOM ni placement en totalDataLabel.

Dominio de gráfico de cascada

Es el dominio de un gráfico de cascada.

Representación JSON
{
  "data": {
    object (ChartData)
  },
  "reversed": boolean
}
Campos
data

object (ChartData)

Los datos del WaterfallChartDomain.

reversed

boolean

Verdadero para invertir el orden de los valores de dominio (eje horizontal).

Serie de gráficos de cascada

Es una sola serie de datos para un gráfico de cascada.

Representación JSON
{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}
Campos
data

object (ChartData)

Los datos que se visualizan en esta serie.

positiveColumnsStyle

object (WaterfallChartColumnStyle)

Estilos para todas las columnas de esta serie con valores positivos.

negativeColumnsStyle

object (WaterfallChartColumnStyle)

Estilos para todas las columnas de esta serie con valores negativos.

subtotalColumnsStyle

object (WaterfallChartColumnStyle)

Estilos de todas las columnas del subtotal de esta serie.

hideTrailingSubtotal

boolean

Verdadero para ocultar la columna del subtotal al final de la serie. De forma predeterminada, aparecerá una columna de subtotal al final de cada serie. Si estableces este campo como verdadero, se ocultará esa columna del subtotal para esta serie.

customSubtotals[]

object (WaterfallChartCustomSubtotal)

Columnas del subtotal personalizadas que aparecen en esta serie. El orden en el que se definen los subtotales no es significativo. Solo se puede definir un subtotal por cada dato.

dataLabel

object (DataLabel)

Información sobre las etiquetas de datos de esta serie.

Estilo de gráfico de cascada de estilo

Estilos para una columna de gráfico de cascada

Representación JSON
{
  "label": string,
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Campos
label

string

La etiqueta de la leyenda de la columna.

color
(deprecated)

object (Color)

El color de la columna. Obsoleto: Usa colorStyle.

colorStyle

object (ColorStyle)

El color de la columna. Si también se configura color, este campo tiene prioridad.

Gráfico de cascada personalizado

Una columna personalizada de subtotales para una serie de gráficos de cascada.

Representación JSON
{
  "subtotalIndex": integer,
  "label": string,
  "dataIsSubtotal": boolean
}
Campos
subtotalIndex

integer

El índice basado en cero de un dato dentro de la serie. Si dataIsSubtotal es verdadero, los datos de este índice son el subtotal. De lo contrario, el subtotal aparecerá después de los datos con este índice. Una serie puede tener varios subtotales en índices arbitrarios, pero no afectan los índices de los datos. Por ejemplo, si una serie tiene tres datos, sus índices siempre serán 0, 1 y 2, independientemente de la cantidad de subtotales que existan en la serie o de los datos con los que estén asociados.

label

string

Una etiqueta para la columna del subtotal

dataIsSubtotal

boolean

Verdadero si el dato en subtotalIndex es el subtotal. Si es falso, se calculará el subtotal y aparecerá después del dato.

Tipo de gráfico de cascada

Opciones de tipo apiladas para gráficos de cascada.

Enumeradores
WATERFALL_STACKED_TYPE_UNSPECIFIED Valor predeterminado, no usar.
STACKED Los valores correspondientes al mismo valor de dominio (eje horizontal) se apilan verticalmente.
SEQUENTIAL La serie se extenderá a lo largo del eje horizontal.

Especificación de TreemapChart

Un gráfico de Treemap

Representación 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
}
Campos
labels

object (ChartData)

Los datos que contienen las etiquetas de celda de mapa de árboles.

parentLabels

object (ChartData)

Los datos que contienen las etiquetas superiores de las celdas del mapa del árbol.

sizeData

object (ChartData)

Los datos que determinan el tamaño de cada celda de datos del mapa de árboles. Se espera que estos datos sean numéricos. No se procesarán las celdas correspondientes a datos no numéricos o faltantes. Si no se especifica colorData, estos datos también se usan para determinar los colores de fondo de las celdas de datos.

colorData

object (ChartData)

Los datos que determinan el color de fondo de cada celda de datos del mapa de árboles. Este campo es opcional. Si no se especifica, se usa sizeData para determinar los colores de fondo. Si se especifica, se espera que los datos sean numéricos. colorScale determinará cómo se asignan los valores de estos datos a los colores de fondo de las celdas de datos.

textFormat

object (TextFormat)

El formato de texto para todas las etiquetas del gráfico. El campo del vínculo no es compatible.

levels

integer

La cantidad de niveles de datos que se muestran en el gráfico de mapa de árbol. Estos niveles son interactivos y se muestran con sus etiquetas. El valor predeterminado es 2 si no se especifica.

hintedLevels

integer

La cantidad de niveles de datos adicionales más allá de los niveles etiquetados que se mostrarán en el gráfico de diagrama de árbol. Estos niveles no son interactivos y se muestran sin sus etiquetas. El valor predeterminado es 0 si no se especifica.

minValue

number

El valor de datos mínimo posible. Las celdas con valores inferiores a este tienen el mismo color que las celdas con este valor. Si no se especifica, se establece de forma predeterminada como el valor mínimo real de colorData o el valor mínimo de sizeData si no se especifica colorData.

maxValue

number

El valor de datos máximo posible. Las celdas con valores superiores a este tienen el mismo color que las celdas con este valor. Si no se especifica, el valor predeterminado es el valor máximo real de colorData o el valor máximo de sizeData si no se especifica colorData.

headerColor
(deprecated)

object (Color)

El color de fondo para las celdas de encabezado Obsoleto: Usa headerColorStyle.

headerColorStyle

object (ColorStyle)

El color de fondo para las celdas de encabezado Si también se configura headerColor, este campo tiene prioridad.

colorScale

object (TreemapChartColorScale)

Escala de colores para las celdas de datos en el gráfico de diagrama de árbol A las celdas de datos se les asignan colores según sus valores. Estos valores de color provienen de colorData o de sizeData si no se especifica colorData. Las celdas con valores de color inferiores o iguales a minValue tendrán minValueColor como color de fondo. Las celdas con valores de color mayores o iguales a maxValue tendrán el color de fondo maxValueColor. Las celdas con valores de color entre minValue y maxValue tendrán colores de fondo en un gradiente entre minValueColor y maxValueColor, el punto medio del gradiente será midValueColor. Las celdas con valores de color faltantes o no numéricos tendrán noDataColor como color de fondo.

hideTooltips

boolean

Verdadero para ocultar información sobre la herramienta.

Gráfico de colores de árboles

Una escala de color para un gráfico de mapa de árbol.

Representación 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)
  }
}
Campos
minValueColor
(deprecated)

object (Color)

El color de fondo para las celdas con un valor de color inferior o igual a minValue. El valor predeterminado es #dc3912 si no se especifica. Obsoleto: Usa minValueColorStyle.

minValueColorStyle

object (ColorStyle)

El color de fondo para las celdas con un valor de color inferior o igual a minValue. El valor predeterminado es #dc3912 si no se especifica. Si también se configura minValueColor, este campo tiene prioridad.

midValueColor
(deprecated)

object (Color)

El color de fondo para las celdas con un valor de color en el punto medio entre minValue y maxValue. El valor predeterminado es #efe6dc si no se especifica. Obsoleto: Usa midValueColorStyle.

midValueColorStyle

object (ColorStyle)

El color de fondo para las celdas con un valor de color en el punto medio entre minValue y maxValue. El valor predeterminado es #efe6dc si no se especifica. Si también se configura midValueColor, este campo tiene prioridad.

maxValueColor
(deprecated)

object (Color)

El color de fondo para las celdas con un valor de color mayor o igual que maxValue. El valor predeterminado es #109618 si no se especifica. Obsoleto: Usa maxValueColorStyle.

maxValueColorStyle

object (ColorStyle)

El color de fondo para las celdas con un valor de color mayor o igual que maxValue. El valor predeterminado es #109618 si no se especifica. Si también se configura maxValueColor, este campo tiene prioridad.

noDataColor
(deprecated)

object (Color)

El color de fondo para las celdas que no tienen datos de color asociados a ellas. El valor predeterminado es #000000 si no se especifica. Obsoleto: Usa noDataColorStyle.

noDataColorStyle

object (ColorStyle)

El color de fondo para las celdas que no tienen datos de color asociados a ellas. El valor predeterminado es #000000 si no se especifica. Si también se configura noDataColor, este campo tiene prioridad.

Especificación del cuadro de evaluación

Un cuadro de resalte Los gráficos de cuadro de evaluación se usan para destacar en la hoja de cálculo indicadores clave de rendimiento, conocidos como KPI. Un cuadro de resalte puede representar aspectos como el total de ventas, el costo promedio o un producto más vendido. Puedes especificar un solo valor de datos o agregar un rango de datos. Se puede destacar el porcentaje o la diferencia absoluta respecto de un valor de referencia, como los cambios en el tiempo.

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

object (ChartData)

Los datos del par clave-valor del cuadro de evaluación.

baselineValueData

object (ChartData)

Los datos del valor del modelo de referencia del cuadro de evaluación. Este campo es opcional.

aggregateType

enum (ChartAggregateType)

El tipo de agregación para los datos del gráfico de claves y de referencia en el cuadro de resalte. Este campo no es compatible con gráficos de fuente de datos. En su lugar, usa el campo ChartData.aggregateType de keyValueData o baselineValueData para los gráficos de fuente de datos. Este campo es opcional.

keyValueFormat

object (KeyValueFormat)

Opciones de formato para el par clave-valor

baselineValueFormat

object (BaselineValueFormat)

Opciones de formato para el valor del modelo de referencia Este campo solo es necesario si se especifica baselineValueData.

scaleFactor

number

Valor para escalar la clave del cuadro de evaluación y el valor del modelo de referencia. Por ejemplo, se puede usar un factor de 10 para dividir todos los valores del gráfico por 10. Este campo es opcional.

numberFormatSource

enum (ChartNumberFormatSource)

La fuente de formato de número que se usa en el gráfico del cuadro de evaluación. Este campo es opcional.

customFormatOptions

object (ChartCustomNumberFormatOptions)

Opciones de formato personalizadas para los valores numéricos clave o de referencia en el cuadro de resalte. Este campo se usa solo cuando numberFormatSource se establece en CUSTOM. Este campo es opcional.

Formato de clave-valor

Opciones de formato para el par clave-valor

Representación JSON
{
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  }
}
Campos
textFormat

object (TextFormat)

Opciones de formato de texto para los pares clave-valor. El campo del vínculo no es compatible.

position

object (TextPosition)

Especifica el posicionamiento de texto horizontal del valor de la clave. Este campo es opcional. Si no se especifica, se usa el posicionamiento predeterminado.

Formato de referencia de valor

Opciones de formato para el valor del modelo de referencia

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

enum (ComparisonType)

El tipo de comparación de un par clave-valor con un valor de referencia.

textFormat

object (TextFormat)

Opciones de formato de texto para el valor del modelo de referencia. El campo del vínculo no es compatible.

position

object (TextPosition)

Especifica el posicionamiento de texto horizontal del valor del modelo de referencia. Este campo es opcional. Si no se especifica, se usa el posicionamiento predeterminado.

description

string

Descripción que se agrega después del valor del modelo de referencia Este campo es opcional.

positiveColor
(deprecated)

object (Color)

Color que se usará, en caso de que el valor del modelo de referencia represente un cambio positivo para el par clave-valor. Este campo es opcional. Obsoleto: Usa positiveColorStyle.

positiveColorStyle

object (ColorStyle)

Color que se usará, en caso de que el valor del modelo de referencia represente un cambio positivo para el par clave-valor. Este campo es opcional. Si también se configura positiveColor, este campo tiene prioridad.

negativeColor
(deprecated)

object (Color)

Color que se usará, en caso de que el valor del modelo de referencia represente un cambio negativo en el valor de la clave. Este campo es opcional. Obsoleto: Usa negativeColorStyle.

negativeColorStyle

object (ColorStyle)

Color que se usará, en caso de que el valor del modelo de referencia represente un cambio negativo en el valor de la clave. Este campo es opcional. Si también se configura negativeColor, este campo tiene prioridad.

Tipo de comparación

El tipo de comparación de un par clave-valor con un valor de referencia.

Enumeradores
COMPARISON_TYPE_UNDEFINED Valor predeterminado, no usar.
ABSOLUTE_DIFFERENCE Usa la diferencia absoluta entre el valor de la clave y el valor de referencia.
PERCENTAGE_DIFFERENCE Usar la diferencia de porcentaje entre el valor de la clave y el de referencia

Fuente del formato de gráfico

Las opciones de fuente de formato de número para los atributos de gráfico.

Enumeradores
CHART_NUMBER_FORMAT_SOURCE_UNDEFINED Valor predeterminado, no usar.
FROM_DATA Heredar formato de números de los datos.
CUSTOM Aplica el formato personalizado según lo que especifica ChartCustomNumberFormatOptions.

Opciones de número de gráfico personalizado

Opciones de formato de número personalizado para los atributos de gráfico

Representación JSON
{
  "prefix": string,
  "suffix": string
}
Campos
prefix

string

Prefijo personalizado que se agrega al atributo del gráfico. Este campo es opcional.

suffix

string

Sufijo personalizado que se agregará al atributo del gráfico. Este campo es opcional.

Estrategia de dimensión oculta

Determina cómo los gráficos deben manejar las filas de origen que están ocultas. Las filas ocultas incluyen ocultas y ocultas de forma manual.

Enumeradores
CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED Valor predeterminado, no usar.
SKIP_HIDDEN_ROWS_AND_COLUMNS Los gráficos omitirán las filas y columnas ocultas.
SKIP_HIDDEN_ROWS Los gráficos solo omitirán las filas ocultas.
SKIP_HIDDEN_COLUMNS Los gráficos solo omitirán las columnas ocultas.
SHOW_ALL Los gráficos no omitirán las filas o columnas ocultas.

BordeDeObjetoIncorporado

Un borde a lo largo de un objeto incorporado

Representación JSON
{
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  }
}
Campos
color
(deprecated)

object (Color)

El color del borde. Obsoleto: Usa colorStyle.

colorStyle

object (ColorStyle)

El color del borde. Si también se configura color, este campo tiene prioridad.