Com esse serviço, os usuários podem criar gráficos usando as Ferramentas de Gráficos Google e renderizá-los no lado do servidor. Se 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 o 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 fonte 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 opções configuradas no momento para um Chart, como altura, cor etc. |
Chart | Tipos de gráficos compatíveis com o serviço Charts. |
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 para 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 seus 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 deve 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 seleção. |
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 criador de 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 a ordem das séries no eixo de domínio. |
set | Area | Define a cor do plano 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 da 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 do 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 linha e barra são empilhados (acumulados). |
set | Area | Define o título do gráfico. |
set | Area | Define o estilo do texto do título do gráfico. |
set | Area | Define o estilo do 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 do 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 a ordem das séries no eixo de domínio. |
reverse | Bar | Inverte a direção em que as barras crescem ao longo do eixo horizontal. |
set | Bar | Define a cor do plano 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 da 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 do 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 linha e barra são empilhados (acumulados). |
set | Bar | Define o título do gráfico. |
set | Bar | Define o estilo do texto do título do gráfico. |
set | Bar | Define o estilo do 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 do 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 desse objeto como um blob convertido para o tipo de conteúdo especificado. |
get | Blob | Retorna os dados dentro desse 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 colunas e linhas ocultas. |
IGNORE_ROWS | Enum | Os gráficos ignoram apenas as linhas ocultas. |
IGNORE_COLUMNS | Enum | Os gráficos ignoram apenas as colunas ocultas. |
SHOW_BOTH | Enum | O Google Charts não pula 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 de cascata. |
Charts
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
Chart | Chart | Uma enumeração de como as dimensões ocultas em uma fonte 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 compatíveis com o 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 para 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 do Google Chart Tools. |
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 definição de visualização de dados. |
new | Line | Começa a criar um gráfico de linhas, conforme descrito na documentação do Google Chart Tools. |
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 do Google Chart Tools. |
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 a ordem das séries no eixo de domínio. |
set | Column | Define a cor do plano 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 da 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 do 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 linha e barra são empilhados (acumulados). |
set | Column | Define o título do gráfico. |
set | Column | Define o estilo do texto do título do gráfico. |
set | Column | Define o estilo do 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 do 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 desse 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 da visualização de dados criado usando este builder. |
set | Data | Define os índices das colunas a serem incluídas na visualização de dados e especifica informações de função-coluna. |
LineChartBuilder
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
build() | Chart | Cria o gráfico. |
reverse | Line | Inverte a ordem das séries no eixo de domínio. |
set | Line | Define a cor do plano 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 da 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 do 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 do texto do título do gráfico. |
set | Line | Define o estilo do 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 do 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 somente a valores exatos |
PREFIX | Enum | Corresponder prefixos começando 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 a extensão inferior do intervalo. |
set | Number | Define a orientação do controle deslizante. |
set | Number | Define se os rótulos devem ficar ao lado do controle deslizante mostrando as extensões do intervalo selecionado. |
set | Number | Define o número de marcações (posições fixas em uma barra de intervalo) em que os controles deslizantes de um filtro de intervalo numérico podem ficar. |
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 seletor de valores. |
BELOW | Enum | Os valores selecionados aparecem em uma única linha de texto abaixo do widget. |
BELOW_WRAPPING | Enum | Semelhante ao 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 a ordem das séries no eixo de domínio. |
set3D() | Pie | Define o gráfico como tridimensional. |
set | Pie | Define a cor do plano 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 da 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 do 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 do texto do título do gráfico. |
PointStyle
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
NONE | Enum | Não mostrar pontos de linha. |
TINY | Enum | Use pontos de linha minúsculos. |
MEDIUM | Enum | Use pontos de linha de tamanho médio. |
LARGE | Enum | Use pontos de linha grandes. |
HUGE | Enum | Use os 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 do plano 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 da 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 do 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 do 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 do 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 do 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 deve corresponder apenas a valores exatos (Match), prefixos
que começam no início do valor (Match) ou qualquer substring
(Match). |
set | String | Define se o controle deve corresponder sempre 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 exibida (os números das páginas são baseados em zero). |
enable | Table | Adiciona suporte básico para idiomas da direita para a esquerda (como árabe ou hebraico) invertendo a ordem das colunas da tabela. Assim, a coluna zero é a mais à direita, e a última coluna é 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 da 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 classificada inicialmente (em ordem decrescente). |
set | Table | Define opções avançadas para este gráfico. |
show | Table | Define se o número da linha vai aparecer como a primeira coluna da tabela. |
use | Table | Define se o estilo de cores alternadas é atribuído a linhas pares e ímpares 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 este 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. |