Esse serviço permite que os usuários criem gráficos usando as Ferramentas de gráficos do Google e os renderizem no servidor. Se você quiser renderizar gráficos em um navegador da Web, use a API Google Charts.
Este exemplo cria uma tabela de dados básica, preenche um gráfico de área com os dados e os adiciona a uma página da Web como uma imagem:
function doGet() {
var data = Charts.newDataTable()
.addColumn(Charts.ColumnType.STRING, 'Month')
.addColumn(Charts.ColumnType.NUMBER, 'In Store')
.addColumn(Charts.ColumnType.NUMBER, 'Online')
.addRow(['January', 10, 1])
.addRow(['February', 12, 1])
.addRow(['March', 20, 2])
.addRow(['April', 25, 3])
.addRow(['May', 30, 4])
.build();
var chart = Charts.newAreaChart()
.setDataTable(data)
.setStacked()
.setRange(0, 40)
.setTitle('Sales per Month')
.build();
var htmlOutput = HtmlService.createHtmlOutput().setTitle('My Chart');
var imageData = Utilities.base64Encode(chart.getAs('image/png').getBytes());
var imageUrl = "data:image/png;base64," + encodeURI(imageData);
htmlOutput.append("Render chart server side: <br/>");
htmlOutput.append("<img border=\"1\" src=\"" + imageUrl + "\">");
return htmlOutput;
}
Classes
Nome | Breve descrição |
---|---|
Area | Builder para gráficos de área. |
Bar | Builder para gráficos de barras. |
Chart | Um objeto de gráfico, que pode ser convertido em uma imagem estática. |
Chart | Uma enumeração de como as dimensões ocultas em uma origem são expressas em um gráfico. |
Chart | Uma enumeração de como vários intervalos na origem são expressos em um gráfico. |
Chart | Expõe as opções configuradas atualmente para um Chart , como altura, cor etc. |
Chart | Tipos de gráficos compatíveis com o serviço de gráficos. |
Charts | Ponto de entrada para criar gráficos em scripts. |
Column | Builder para gráficos de colunas. |
Column | Uma enumeração dos tipos de dados válidos para colunas em um Data . |
Curve | Uma enumeração dos estilos de curvas em um gráfico. |
Data | Uma tabela de dados a ser usada em gráficos. |
Data | Builder de objetos DataTable. |
Data | Interface para objetos que podem representar os dados como um Data . |
Data | Uma definição de visualização de dados para visualizar dados de gráficos. |
Data | Builder para objetos Data . |
Line | Builder para gráficos de linhas. |
Match | Uma enumeração de como um valor de string precisa ser correspondido. |
Number | Um builder para controles de filtro de intervalo de números. |
Orientation | Uma enumeração da orientação de um objeto. |
Picker | Uma enumeração de como mostrar os valores selecionados no widget de seletor. |
Pie | Um builder para gráficos de pizza. |
Point | Uma enumeração dos estilos de pontos em uma linha. |
Position | Uma enumeração de posições de legenda em um gráfico. |
Scatter | Builder para gráficos de dispersão. |
String | Um builder para controles de filtro de string. |
Table | Um builder para gráficos de tabela. |
Text | Um objeto de configuração de estilo de texto. |
Text | Um builder usado para criar objetos Text . |
AreaChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Area | Inverte o desenho das séries no eixo do domínio. |
set | Area | Define a cor de fundo do gráfico. |
set | Area | Define as cores das linhas no gráfico. |
set | Area | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Area | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Area | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Area | Define a definição de visualização de dados a ser usada no gráfico. |
set | Area | Define as dimensões do gráfico. |
set | Area | Define a posição da legenda em relação ao gráfico. |
set | Area | Define o estilo de texto da legenda do gráfico. |
set | Area | Define opções avançadas para este gráfico. |
set | Area | Define o estilo dos pontos na linha. |
set | Area | Define o intervalo do gráfico. |
set | Area | Usa linhas empilhadas, ou seja, os valores de linhas e barras são empilhados (acumulados). |
set | Area | Define o título do gráfico. |
set | Area | Define o estilo de texto do título do gráfico. |
set | Area | Define o estilo de texto do eixo horizontal. |
set | Area | Adiciona um título ao eixo horizontal. |
set | Area | Define o estilo do texto do título do eixo horizontal. |
set | Area | Define o estilo de texto do eixo vertical. |
set | Area | Adiciona um título ao eixo vertical. |
set | Area | Define o estilo do texto do título do eixo vertical. |
use | Area | Transforma o eixo de intervalo em uma escala logarítmica (exige que todos os valores sejam positivos). |
BarChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Bar | Inverte o desenho das séries no eixo do domínio. |
reverse | Bar | Inverte a direção em que as barras crescem ao longo do eixo horizontal. |
set | Bar | Define a cor de fundo do gráfico. |
set | Bar | Define as cores das linhas no gráfico. |
set | Bar | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Bar | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Bar | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Bar | Define a definição de visualização de dados a ser usada no gráfico. |
set | Bar | Define as dimensões do gráfico. |
set | Bar | Define a posição da legenda em relação ao gráfico. |
set | Bar | Define o estilo de texto da legenda do gráfico. |
set | Bar | Define opções avançadas para este gráfico. |
set | Bar | Define o intervalo do gráfico. |
set | Bar | Usa linhas empilhadas, ou seja, os valores de linhas e barras são empilhados (acumulados). |
set | Bar | Define o título do gráfico. |
set | Bar | Define o estilo de texto do título do gráfico. |
set | Bar | Define o estilo de texto do eixo horizontal. |
set | Bar | Adiciona um título ao eixo horizontal. |
set | Bar | Define o estilo do texto do título do eixo horizontal. |
set | Bar | Define o estilo de texto do eixo vertical. |
set | Bar | Adiciona um título ao eixo vertical. |
set | Bar | Define o estilo do texto do título do eixo vertical. |
use | Bar | Transforma o eixo de intervalo em uma escala logarítmica (exige que todos os valores sejam positivos). |
Chart
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get | Blob | Retorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado. |
get | Blob | Retorne os dados dentro deste objeto como um blob. |
get | Chart | Retorna as opções do gráfico, como altura, cores e eixos. |
ChartHiddenDimensionStrategy
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
IGNORE_BOTH | Enum | Padrão: os gráficos ignoram as linhas e colunas ocultas. |
IGNORE_ROWS | Enum | Os gráficos pulam apenas as linhas ocultas. |
IGNORE_COLUMNS | Enum | Os gráficos pulam apenas as colunas ocultas. |
SHOW_BOTH | Enum | Os gráficos não pulam colunas ou linhas ocultas. |
ChartMergeStrategy
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
MERGE_COLUMNS | Enum | Padrão. |
MERGE_ROWS | Enum | Os gráficos mesclam as linhas de vários intervalos. |
ChartOptions
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get(option) | Object | Retorna uma opção configurada para este gráfico. |
get | Object | Retorna uma opção configurada para este gráfico. |
ChartType
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
TIMELINE | Enum | Gráfico de linha do tempo. |
AREA | Enum | Gráfico de área |
BAR | Enum | Gráfico de barras |
BUBBLE | Enum | Gráfico de bolhas. |
CANDLESTICK | Enum | Gráfico candlestick. |
COLUMN | Enum | Gráfico de colunas |
COMBO | Enum | Gráfico de combinação |
GAUGE | Enum | Gráfico de medidor. |
GEO | Enum | Gráfico de mapa. |
HISTOGRAM | Enum | Histograma |
RADAR | Enum | Gráfico de radar. |
LINE | Enum | Gráfico de linhas |
ORG | Enum | Organograma. |
PIE | Enum | Gráfico de pizza |
SCATTER | Enum | Gráfico de dispersão |
SPARKLINE | Enum | Minigráfico. |
STEPPED_AREA | Enum | Gráfico de áreas em degraus. |
TABLE | Enum | Gráfico de tabela |
TREEMAP | Enum | Gráfico de mapa de árvore. |
WATERFALL | Enum | Gráfico em cascata. |
Charts
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
Chart | Chart | Uma enumeração de como as dimensões ocultas em uma origem são expressas em um gráfico. |
Chart | Chart | Uma enumeração de como vários intervalos na origem são expressos em um gráfico. |
Chart | Chart | Uma enumeração de tipos de gráficos aceitos pelo serviço de gráficos. |
Column | Column | Uma enumeração dos tipos de dados válidos para colunas em um Data . |
Curve | Curve | Uma enumeração dos estilos de curvas em um gráfico. |
Point | Point | Uma enumeração dos estilos de pontos em uma linha. |
Position | Position | Uma enumeração de posições de legenda em um gráfico. |
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
new | Area | Começa a criar um gráfico de área, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Bar | Começa a criar um gráfico de barras, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Column | Começa a criar um gráfico de colunas, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Data | Cria uma tabela de dados vazia, que pode ter os valores definidos manualmente. |
new | Data | Cria uma nova definição de visualização de dados. |
new | Line | Começa a criar um gráfico de linhas, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Pie | Começa a criar um gráfico de pizza, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Scatter | Começa a criar um gráfico de dispersão, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Table | Começa a criar um gráfico de tabela, conforme descrito na documentação das Ferramentas de gráficos do Google. |
new | Text | Cria um novo builder de estilo de texto. |
ColumnChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Column | Inverte o desenho das séries no eixo do domínio. |
set | Column | Define a cor de fundo do gráfico. |
set | Column | Define as cores das linhas no gráfico. |
set | Column | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Column | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Column | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Column | Define a definição de visualização de dados a ser usada no gráfico. |
set | Column | Define as dimensões do gráfico. |
set | Column | Define a posição da legenda em relação ao gráfico. |
set | Column | Define o estilo de texto da legenda do gráfico. |
set | Column | Define opções avançadas para este gráfico. |
set | Column | Define o intervalo do gráfico. |
set | Column | Usa linhas empilhadas, ou seja, os valores de linhas e barras são empilhados (acumulados). |
set | Column | Define o título do gráfico. |
set | Column | Define o estilo de texto do título do gráfico. |
set | Column | Define o estilo de texto do eixo horizontal. |
set | Column | Adiciona um título ao eixo horizontal. |
set | Column | Define o estilo do texto do título do eixo horizontal. |
set | Column | Define o estilo de texto do eixo vertical. |
set | Column | Adiciona um título ao eixo vertical. |
set | Column | Define o estilo do texto do título do eixo vertical. |
use | Column | Transforma o eixo de intervalo em uma escala logarítmica (exige que todos os valores sejam positivos). |
ColumnType
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
DATE | Enum | Corresponde a valores de data. |
NUMBER | Enum | Corresponde a valores numéricos. |
STRING | Enum | Corresponde a valores de string. |
CurveStyle
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
NORMAL | Enum | Linhas retas sem curva. |
SMOOTH | Enum | Os ângulos da linha são suavizados. |
DataTable
DataTableBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
add | Data | Adiciona uma coluna à tabela de dados. |
add | Data | Adiciona uma linha à tabela de dados. |
build() | Data | Cria e retorna uma tabela de dados. |
set | Data | Define um valor específico na tabela. |
DataTableSource
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get | Data | Retorna os dados dentro deste objeto como uma DataTable. |
DataViewDefinition
DataViewDefinitionBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Data | Cria e retorna o objeto de definição de visualização de dados que foi criado usando esse builder. |
set | Data | Define os índices das colunas a serem incluídas na visualização de dados, além de especificar informações de coluna de função. |
LineChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Line | Inverte o desenho das séries no eixo do domínio. |
set | Line | Define a cor de fundo do gráfico. |
set | Line | Define as cores das linhas no gráfico. |
set | Line | Define o estilo a ser usado para curvas no gráfico. |
set | Line | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Line | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Line | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Line | Define a definição de visualização de dados a ser usada no gráfico. |
set | Line | Define as dimensões do gráfico. |
set | Line | Define a posição da legenda em relação ao gráfico. |
set | Line | Define o estilo de texto da legenda do gráfico. |
set | Line | Define opções avançadas para este gráfico. |
set | Line | Define o estilo dos pontos na linha. |
set | Line | Define o intervalo do gráfico. |
set | Line | Define o título do gráfico. |
set | Line | Define o estilo de texto do título do gráfico. |
set | Line | Define o estilo de texto do eixo horizontal. |
set | Line | Adiciona um título ao eixo horizontal. |
set | Line | Define o estilo do texto do título do eixo horizontal. |
set | Line | Define o estilo de texto do eixo vertical. |
set | Line | Adiciona um título ao eixo vertical. |
set | Line | Define o estilo do texto do título do eixo vertical. |
use | Line | Transforma o eixo de intervalo em uma escala logarítmica (exige que todos os valores sejam positivos). |
MatchType
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
EXACT | Enum | Corresponder apenas a valores exatos |
PREFIX | Enum | Fazer correspondência de prefixos a partir do início do valor |
ANY | Enum | Corresponder a qualquer substring |
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get | String | Retorna o nome do tipo de correspondência a ser usado no JSON de opções. |
NumberRangeFilterBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
set | Number | Define o valor máximo permitido para o limite inferior do intervalo. |
set | Number | Define o valor mínimo permitido para o limite inferior do intervalo. |
set | Number | Define a orientação do controle deslizante. |
set | Number | Define se os rótulos ao lado do controle deslizante vão mostrar as extensões do intervalo selecionado. |
set | Number | Define o número de marcas (posições fixas em uma barra de intervalo) em que os indicadores de filtro de intervalo de números podem cair. |
Orientation
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
HORIZONTAL | Enum | Orientação horizontal. |
VERTICAL | Enum | Orientação vertical. |
PickerValuesLayout
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
ASIDE | Enum | Os valores selecionados aparecem em uma única linha de texto ao lado do widget do seletor de valores. |
BELOW | Enum | Os valores selecionados são exibidos em uma única linha de texto abaixo do widget. |
BELOW_WRAPPING | Enum | Semelhante ao exemplo abaixo, mas as entradas que não cabem no seletor são concluídas em uma nova linha. |
BELOW_STACKED | Enum | Os valores selecionados aparecem em uma coluna abaixo do widget. |
PieChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Pie | Inverte o desenho das séries no eixo do domínio. |
set3D() | Pie | Define o gráfico como tridimensional. |
set | Pie | Define a cor de fundo do gráfico. |
set | Pie | Define as cores das linhas no gráfico. |
set | Pie | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Pie | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Pie | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Pie | Define a definição de visualização de dados a ser usada no gráfico. |
set | Pie | Define as dimensões do gráfico. |
set | Pie | Define a posição da legenda em relação ao gráfico. |
set | Pie | Define o estilo de texto da legenda do gráfico. |
set | Pie | Define opções avançadas para este gráfico. |
set | Pie | Define o título do gráfico. |
set | Pie | Define o estilo de texto do título do gráfico. |
PointStyle
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
NONE | Enum | Não mostra pontos de linha. |
TINY | Enum | Use pontos de linha pequenos. |
MEDIUM | Enum | Use pontos de linha de tamanho médio. |
LARGE | Enum | Use pontos de linha de tamanho grande. |
HUGE | Enum | Use pontos de linha de maior tamanho. |
Position
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
TOP | Enum | Acima do gráfico. |
RIGHT | Enum | À direita do gráfico. |
BOTTOM | Enum | Abaixo do gráfico. |
NONE | Enum | Nenhuma legenda é exibida. |
ScatterChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
set | Scatter | Define a cor de fundo do gráfico. |
set | Scatter | Define as cores das linhas no gráfico. |
set | Scatter | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Scatter | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Scatter | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Scatter | Define a definição de visualização de dados a ser usada no gráfico. |
set | Scatter | Define as dimensões do gráfico. |
set | Scatter | Define a posição da legenda em relação ao gráfico. |
set | Scatter | Define o estilo de texto da legenda do gráfico. |
set | Scatter | Define opções avançadas para este gráfico. |
set | Scatter | Define o estilo dos pontos na linha. |
set | Scatter | Define o título do gráfico. |
set | Scatter | Define o estilo de texto do título do gráfico. |
set | Scatter | Transforma o eixo horizontal em uma escala logarítmica (exige que todos os valores sejam positivos). |
set | Scatter | Define o intervalo do eixo horizontal do gráfico. |
set | Scatter | Define o estilo de texto do eixo horizontal. |
set | Scatter | Adiciona um título ao eixo horizontal. |
set | Scatter | Define o estilo do texto do título do eixo horizontal. |
set | Scatter | Transforma o eixo vertical em uma escala logarítmica (exige que todos os valores sejam positivos). |
set | Scatter | Define o intervalo do eixo vertical do gráfico. |
set | Scatter | Define o estilo de texto do eixo vertical. |
set | Scatter | Adiciona um título ao eixo vertical. |
set | Scatter | Define o estilo do texto do título do eixo vertical. |
StringFilterBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
set | String | Define se a correspondência deve diferenciar maiúsculas de minúsculas ou não. |
set | String | Define se o controle precisa corresponder apenas a valores exatos (Match ), prefixos
a partir do início do valor (Match ) ou qualquer substring
(Match ). |
set | String | Define se o controle precisa corresponder a cada vez que uma tecla é pressionada ou apenas quando o campo de entrada "muda" (perda de foco ou pressionamento da tecla Enter). |
TableChartBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Chart | Cria o gráfico. |
enable | Table | Define se a paginação dos dados será ativada. |
enable | Table | Ativa a paginação e define o número de linhas em cada página. |
enable | Table | Ativa a paginação, define o número de linhas em cada página e a primeira página da tabela a ser mostrada (os números de página são baseados em zero). |
enable | Table | Adiciona suporte básico para idiomas da direita para a esquerda (como árabe ou hebraico) revertendo a ordem das colunas da tabela, de modo que a coluna zero seja a mais à direita e a última coluna seja a mais à esquerda. |
enable | Table | Define se as colunas serão classificadas quando o usuário clicar em um cabeçalho de coluna. |
set | Table | Define o URL da fonte de dados usado para extrair dados de uma fonte externa, como as Planilhas Google. |
set | Table | Define a tabela de dados a ser usada no gráfico usando um DataTableBuilder. |
set | Table | Define a tabela de dados que contém as linhas do gráfico, bem como os rótulos do eixo X. |
set | Table | Define a definição de visualização de dados a ser usada no gráfico. |
set | Table | Define as dimensões do gráfico. |
set | Table | Define o número da primeira linha na tabela de dados. |
set | Table | Define o índice da coluna de acordo com a qual a tabela deve ser classificada inicialmente (em ordem crescente). |
set | Table | Define o índice da coluna de acordo com a qual a tabela deve ser inicialmente classificada (descendente). |
set | Table | Define opções avançadas para este gráfico. |
show | Table | Define se o número da linha será mostrado como a primeira coluna da tabela. |
use | Table | Define se o estilo de cor alternada é atribuído a linhas ímpares e pares de um gráfico de tabela. |
TextStyle
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
get | String | Recebe a cor do estilo de texto. |
get | String | Recebe o nome da fonte do estilo de texto. |
get | Number | Recebe o tamanho da fonte do estilo de texto. |
TextStyleBuilder
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
build() | Text | Cria e retorna um objeto de configuração de estilo de texto criado usando esse builder. |
set | Text | Define a cor do estilo de texto. |
set | Text | Define o nome da fonte do estilo de texto. |
set | Text | Define o tamanho da fonte do estilo de texto. |