Se usó la API de Cloud Translation para traducir esta página.

Class EmbeddedChart

Representa un gráfico que se incorporó en una hoja de cálculo.

En este ejemplo, se muestra cómo modificar un gráfico existente:

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A2:B8');
let chart = sheet.getCharts()[0];
chart = chart.modify()
            .addRange(range)
            .setOption('title', 'Updated!')
            .setOption('animation.duration', 500)
            .setPosition(2, 2, 0, 0)
            .build();
sheet.updateChart(chart);

En este ejemplo, se muestra cómo crear un gráfico nuevo:

function newChart(range) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const chartBuilder = sheet.newChart();
  chartBuilder.addRange(range)
      .setChartType(Charts.ChartType.LINE)
      .setOption('title', 'My Line Chart!');
  sheet.insertChart(chartBuilder.build());
}

Métodos

Método	Tipo de datos que se muestra	Descripción breve
`asDataSourceChart()`	`DataSourceChart`	Convierte en una instancia de gráfico de fuente de datos si el gráfico es de fuente de datos o `null` en caso contrario.
`getAs(contentType)`	`Blob`	Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado.
`getBlob()`	`Blob`	Devuelve los datos dentro de este objeto como un blob.
`getChartId()`	`Integer`	Devuelve un identificador estable para el gráfico que es único en la hoja de cálculo que contiene el gráfico o `null` si el gráfico no está en una hoja de cálculo.
`getContainerInfo()`	`ContainerInfo`	Devuelve información sobre la posición del gráfico dentro de una hoja.
`getHiddenDimensionStrategy()`	`ChartHiddenDimensionStrategy`	Devuelve la estrategia que se usará para controlar las filas y columnas ocultas.
`getMergeStrategy()`	`ChartMergeStrategy`	Devuelve la estrategia de combinación que se usa cuando existe más de un rango.
`getNumHeaders()`	`Integer`	Devuelve la cantidad de filas o columnas del rango que se tratan como encabezados.
`getOptions()`	`ChartOptions`	Devuelve las opciones de este gráfico, como la altura, los colores y los ejes.
`getRanges()`	`Range[]`	Devuelve los rangos que usa este gráfico como fuente de datos.
`getTransposeRowsAndColumns()`	`Boolean`	Si es `true`, se intercambian las filas y las columnas que se usan para completar el gráfico.
`modify()`	`EmbeddedChartBuilder`	Devuelve un `EmbeddedChartBuilder` que se puede usar para modificar este gráfico.

Documentación detallada

`asDataSourceChart()`

Convierte en una instancia de gráfico de fuente de datos si el gráfico es de fuente de datos o null en caso contrario.

Volver

DataSourceChart: Es el gráfico de la fuente de datos.

`getAs(contentType)`

Devuelve los datos dentro de este objeto como un blob convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, "miarchivo.pdf". Sin embargo, supone que la parte del nombre de archivo que sigue al último punto (si hay alguno) es una extensión existente que se debe reemplazar. Por lo tanto, "ShoppingList.12.25.2014" se convierte en "ShoppingList.12.25.pdf".

Para ver las cuotas diarias de conversiones, consulta Cuotas para los servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos temporalmente a cuotas más estrictas.

Parámetros

Nombre	Tipo	Descripción
`contentType`	`String`	Es el tipo de MIME al que se convertirá el archivo. Para la mayoría de los BLOBs, `'application/pdf'` es la única opción válida. Para las imágenes en formato BMP, GIF, JPEG o PNG, cualquiera de `'image/bmp'`, `'image/gif'`, `'image/jpeg'` o `'image/png'` también son válidos. Para un documento de Documentos de Google, `'text/markdown'` también es válido.

Volver

Blob: Los datos como un BLOB.

`getBlob()`

Devuelve los datos dentro de este objeto como un blob.

Volver

Blob: Los datos como un BLOB.

`getChartId()`

Devuelve un identificador estable para el gráfico que es único en la hoja de cálculo que contiene el gráfico o null si el gráfico no está en una hoja de cálculo.

Volver

Integer: Es un identificador de gráfico estable.

`getContainerInfo()`

Devuelve información sobre la posición del gráfico dentro de una hoja.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const containerInfo = chart.getContainerInfo();

// Logs the values used in setPosition()
Logger.log(
    'Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s',
    containerInfo.getAnchorColumn(),
    containerInfo.getAnchorRow(),
    containerInfo.getOffsetX(),
    containerInfo.getOffsetY(),
);

Volver

ContainerInfo: Es un objeto que contiene la posición del contenedor del gráfico.

`getHiddenDimensionStrategy()`

Devuelve la estrategia que se usará para controlar las filas y columnas ocultas. La configuración predeterminada es IGNORE_ROWS.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setHiddenDimensionStrategy(
                      Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS,
                      )
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs the strategy to use for hidden rows and columns which is
// Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS in this case.
Logger.log(chart.getHiddenDimensionStrategy());

Volver

ChartHiddenDimensionStrategy: Es la estrategia que se usará para las filas y columnas ocultas.

`getMergeStrategy()`

Devuelve la estrategia de combinación que se usa cuando existe más de un rango. Si es MERGE_ROWS, se combinan las filas; si es MERGE_COLUMNS, se combinan las columnas. La configuración predeterminada es MERGE_COLUMNS.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B10');
const range2 = sheet.getRange('C1:C10');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .addRange(range2)
                  .setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs whether rows of multiple ranges are merged, which is MERGE_ROWS in this
// case.
Logger.log(chart.getMergeStrategy());

Volver

ChartMergeStrategy — MERGE_ROWS si las filas se combinan en varios rangos; MERGE_COLUMNS si las columnas se combinan en varios rangos

`getNumHeaders()`

Devuelve la cantidad de filas o columnas del rango que se tratan como encabezados.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(range)
                  .setNumHeaders(1)
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs the number of rows or columns to use as headers, which is 1 in this
// case.
Logger.log(chart.getHeaders());

Volver

Integer: Es la cantidad de filas o columnas que se tratan como encabezados. Los valores negativos indican que los encabezados se detectaron automáticamente.

`getOptions()`

Devuelve las opciones de este gráfico, como la altura, los colores y los ejes.

Las opciones que se devuelven son inmutables.

Volver

ChartOptions: Son las opciones de este gráfico, como la altura, los colores y los ejes.

`getRanges()`

Devuelve los rangos que usa este gráfico como fuente de datos.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const chart = sheet.newChart()
                  .setChartType(Charts.ChartType.BAR)
                  .addRange(sheet.getRange('A1:B8'))
                  .setPosition(5, 5, 0, 0)
                  .build();

const ranges = chart.getRanges();

// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (const i in ranges) {
  const range = ranges[i];
  Logger.log(range.getA1Notation());
}

Volver

Range[]: Es un array de rangos que sirven como fuente de datos de este gráfico.

`getTransposeRowsAndColumns()`

Si es true, se intercambian las filas y las columnas que se usan para completar el gráfico. La configuración predeterminada es false.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

const range = sheet.getRange('A1:B5');
const chart = sheet.newChart()
                  .addRange(range)
                  .setChartType(Charts.ChartType.BAR)
                  .setTransposeRowsAndColumns(true)
                  .setPosition(5, 5, 0, 0)
                  .build();

// Logs whether rows and columns should be transposed, which is true in this
// case.
Logger.log(chart.getTransposeRowsAndColumns());

Volver

Boolean: True si se transponen las filas y las columnas que se usan para construir el gráfico

`modify()`

Devuelve un EmbeddedChartBuilder que se puede usar para modificar este gráfico. Invoca sheet.updateChart(chart) para guardar los cambios.

const sheet = SpreadsheetApp.getActiveSheet();
let chart = sheet.getCharts()[0];
chart = chart.modify()
            .setOption('width', 800)
            .setOption('height', 640)
            .setPosition(5, 5, 0, 0)
            .build();
sheet.updateChart(chart);

Volver

EmbeddedChartBuilder: Es un compilador para crear gráficos incorporados.

Class EmbeddedChart Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Métodos

Documentación detallada

asDataSourceChart()

Volver

getAs(contentType)

Parámetros

Volver

getBlob()

Volver

getChartId()

Volver

getContainerInfo()

Volver

getHiddenDimensionStrategy()

Volver

getMergeStrategy()

Volver

getNumHeaders()

Volver

getOptions()

Volver

getRanges()

Volver

getTransposeRowsAndColumns()

Volver

modify()

Volver

Class EmbeddedChart

`asDataSourceChart()`

`getAs(contentType)`

`getBlob()`

`getChartId()`

`getContainerInfo()`

`getHiddenDimensionStrategy()`

`getMergeStrategy()`

`getNumHeaders()`

`getOptions()`

`getRanges()`

`getTransposeRowsAndColumns()`

`modify()`