Ce service permet aux utilisateurs de créer des graphiques à l'aide des outils Google Charts et de les afficher côté serveur. Si vous souhaitez afficher des graphiques dans un navigateur Web, utilisez plutôt l'API Google Charts.
Cet exemple crée un tableau de données de base, remplit un graphique en aires avec les données et l'ajoute à une page Web sous forme d'image :
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
| Nom | Brève description |
|---|---|
Area | Compilateur pour les graphiques en aires. |
Bar | Compilateur pour les graphiques à barres. |
Chart | Objet Chart, qui peut être converti en image statique. |
Chart | Énumération de la façon dont les dimensions masquées d'une source sont exprimées dans un graphique. |
Chart | Énumération de la façon dont plusieurs plages de la source sont exprimées dans un graphique. |
Chart | Affiche les options actuellement configurées pour un Chart, telles que la hauteur, la couleur, etc. |
Chart | Types de graphiques compatibles avec le service Charts. |
Charts | Point d'entrée pour créer des graphiques dans les scripts. |
Column | Compilateur pour les graphiques à colonnes. |
Column | Énumération des types de données valides pour les colonnes d'un Data. |
Curve | Énumération des styles pour les courbes d'un graphique. |
Data | Table de données à utiliser dans les graphiques. |
Data | Compilateur d'objets DataTable. |
Data | Interface pour les objets qui peuvent représenter leurs données sous la forme d'un Data. |
Data | Définition d'une vue de données permettant de visualiser les données d'un graphique. |
Data | Compilateur pour les objets Data. |
Line | Compilateur pour les graphiques linéaires. |
Match | Énumération de la façon dont une valeur de chaîne doit correspondre. |
Number | Composant permettant de créer des sélecteurs de filtre de plage de nombres. |
Orientation | Énumération de l'orientation d'un objet. |
Picker | Énumération de la façon d'afficher les valeurs sélectionnées dans le sélecteur. |
Pie | Compilateur pour les graphiques circulaires. |
Point | Énumération des styles de points dans une ligne. |
Position | Énumération des positions de la légende dans un graphique. |
Scatter | Compilateur pour les graphiques à nuage de points. |
String | Compilateur pour les commandes de filtre de chaîne. |
Table | Compilateur pour les tableaux. |
Text | Objet de configuration du style de texte. |
Text | Compilateur utilisé pour créer des objets Text. |
AreaChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
reverse | Area | Inverse l'ordre de tracé des séries sur l'axe du domaine. |
set | Area | Définit la couleur de l'arrière-plan du graphique. |
set | Area | Définit les couleurs des lignes du graphique. |
set | Area | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Area | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Area | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Area | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Area | Définit les dimensions du graphique. |
set | Area | Définit la position de la légende par rapport au graphique. |
set | Area | Définit le style du texte de la légende du graphique. |
set | Area | Définit les options avancées de ce graphique. |
set | Area | Définit le style des points de la ligne. |
set | Area | Définit la plage du graphique. |
set | Area | Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (cumulées). |
set | Area | Définit le titre du graphique. |
set | Area | Définit le style du texte du titre du graphique. |
set | Area | Définit le style du texte de l'axe horizontal. |
set | Area | Ajoute un titre à l'axe horizontal. |
set | Area | Définit le style du texte du titre de l'axe horizontal. |
set | Area | Définit le style du texte de l'axe vertical. |
set | Area | Ajoute un titre à l'axe vertical. |
set | Area | Définit le style du texte du titre de l'axe vertical. |
use | Area | Convertit l'axe de plage en échelle logarithmique (toutes les valeurs doivent être positives). |
BarChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
reverse | Bar | Inverse l'ordre de tracé des séries sur l'axe du domaine. |
reverse | Bar | Inverse le sens de croissance des barres le long de l'axe horizontal. |
set | Bar | Définit la couleur de l'arrière-plan du graphique. |
set | Bar | Définit les couleurs des lignes du graphique. |
set | Bar | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Bar | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Bar | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Bar | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Bar | Définit les dimensions du graphique. |
set | Bar | Définit la position de la légende par rapport au graphique. |
set | Bar | Définit le style du texte de la légende du graphique. |
set | Bar | Définit les options avancées de ce graphique. |
set | Bar | Définit la plage du graphique. |
set | Bar | Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (cumulées). |
set | Bar | Définit le titre du graphique. |
set | Bar | Définit le style du texte du titre du graphique. |
set | Bar | Définit le style du texte de l'axe horizontal. |
set | Bar | Ajoute un titre à l'axe horizontal. |
set | Bar | Définit le style du texte du titre de l'axe horizontal. |
set | Bar | Définit le style du texte de l'axe vertical. |
set | Bar | Ajoute un titre à l'axe vertical. |
set | Bar | Définit le style du texte du titre de l'axe vertical. |
use | Bar | Convertit l'axe de plage en échelle logarithmique (toutes les valeurs doivent être positives). |
Chart
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | Blob | Renvoie les données de cet objet sous forme de blob converti au type de contenu spécifié. |
get | Blob | Renvoie les données de cet objet sous forme de blob. |
get | Chart | Renvoie les options de ce graphique, telles que la hauteur, les couleurs et les axes. |
ChartHiddenDimensionStrategy
Propriétés
| Propriété | Type | Description |
|---|---|---|
IGNORE_BOTH | Enum | Par défaut, les graphiques ignorent les colonnes et les lignes masquées. |
IGNORE_ROWS | Enum | Les graphiques ignorent uniquement les lignes masquées. |
IGNORE_COLUMNS | Enum | Les graphiques ignorent uniquement les colonnes masquées. |
SHOW_BOTH | Enum | Charts n'ignore pas les colonnes ni les lignes masquées. |
ChartMergeStrategy
Propriétés
| Propriété | Type | Description |
|---|---|---|
MERGE_COLUMNS | Enum | Par défaut. |
MERGE_ROWS | Enum | Charts fusionne les lignes de plusieurs plages. |
ChartOptions
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get(option) | Object | Renvoie une option configurée pour ce graphique. |
get | Object | Renvoie une option configurée pour ce graphique. |
ChartType
Propriétés
| Propriété | Type | Description |
|---|---|---|
TIMELINE | Enum | Graphique chronologique. |
AREA | Enum | Graphique en aires |
BAR | Enum | Graphique à barres |
BUBBLE | Enum | Graphique à bulles. |
CANDLESTICK | Enum | Graphique en chandeliers japonais. |
COLUMN | Enum | Graphique à colonnes |
COMBO | Enum | Graphique combiné |
GAUGE | Enum | Graphique jauge. |
GEO | Enum | Graphique géographique. |
HISTOGRAM | Enum | Histogramme |
RADAR | Enum | Graphique en radar. |
LINE | Enum | Graphique en courbes |
ORG | Enum | Organigramme |
PIE | Enum | Graphique à secteurs |
SCATTER | Enum | Graphique à nuage de points |
SPARKLINE | Enum | Graphique sparkline. |
STEPPED_AREA | Enum | Graphique en aires en escalier. |
TABLE | Enum | Tableau |
TREEMAP | Enum | Carte proportionnelle. |
WATERFALL | Enum | Graphique en cascade. |
Charts
Propriétés
| Propriété | Type | Description |
|---|---|---|
Chart | Chart | Énumération de la façon dont les dimensions masquées d'une source sont exprimées dans un graphique. |
Chart | Chart | Énumération de la façon dont plusieurs plages de la source sont exprimées dans un graphique. |
Chart | Chart | Énumération des types de graphiques compatibles avec le service Charts. |
Column | Column | Énumération des types de données valides pour les colonnes d'un Data. |
Curve | Curve | Énumération des styles pour les courbes d'un graphique. |
Point | Point | Énumération des styles de points dans une ligne. |
Position | Position | Énumération des positions de la légende dans un graphique. |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
new | Area | Commence à créer un graphique en aires, comme décrit dans la documentation Google Chart Tools. |
new | Bar | Commence à créer un graphique à barres, comme décrit dans la documentation Google Chart Tools. |
new | Column | Commence à créer un graphique à colonnes, comme décrit dans la documentation Google Chart Tools. |
new | Data | Crée un tableau de données vide, dont les valeurs peuvent être définies manuellement. |
new | Data | Crée une définition de vue de données. |
new | Line | Commence à créer un graphique linéaire, comme décrit dans la documentation Google Chart Tools. |
new | Pie | Commence à créer un graphique à secteurs, comme décrit dans la documentation Google Chart Tools. |
new | Scatter | Commence à créer un graphique en nuage de points, comme décrit dans la documentation Google Chart Tools. |
new | Table | Commence à créer un tableau, comme décrit dans la documentation Google Chart Tools. |
new | Text | Crée un générateur de style de texte. |
ColumnChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
reverse | Column | Inverse l'ordre de tracé des séries sur l'axe du domaine. |
set | Column | Définit la couleur de l'arrière-plan du graphique. |
set | Column | Définit les couleurs des lignes du graphique. |
set | Column | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Column | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Column | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Column | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Column | Définit les dimensions du graphique. |
set | Column | Définit la position de la légende par rapport au graphique. |
set | Column | Définit le style du texte de la légende du graphique. |
set | Column | Définit les options avancées de ce graphique. |
set | Column | Définit la plage du graphique. |
set | Column | Utilise des lignes empilées, ce qui signifie que les valeurs des lignes et des barres sont empilées (cumulées). |
set | Column | Définit le titre du graphique. |
set | Column | Définit le style du texte du titre du graphique. |
set | Column | Définit le style du texte de l'axe horizontal. |
set | Column | Ajoute un titre à l'axe horizontal. |
set | Column | Définit le style du texte du titre de l'axe horizontal. |
set | Column | Définit le style du texte de l'axe vertical. |
set | Column | Ajoute un titre à l'axe vertical. |
set | Column | Définit le style du texte du titre de l'axe vertical. |
use | Column | Convertit l'axe de plage en échelle logarithmique (toutes les valeurs doivent être positives). |
ColumnType
Propriétés
| Propriété | Type | Description |
|---|---|---|
DATE | Enum | Correspond aux valeurs de date. |
NUMBER | Enum | Correspond aux valeurs numériques. |
STRING | Enum | Correspond aux valeurs de chaîne. |
CurveStyle
Propriétés
| Propriété | Type | Description |
|---|---|---|
NORMAL | Enum | Lignes droites sans courbe. |
SMOOTH | Enum | Les angles de la ligne sont lissés. |
DataTable
DataTableBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
add | Data | Ajoute une colonne à la table de données. |
add | Data | Ajoute une ligne au tableau de données. |
build() | Data | Crée et renvoie un tableau de données. |
set | Data | Définit une valeur spécifique dans le tableau. |
DataTableSource
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | Data | Renvoie les données de cet objet sous la forme d'un DataTable. |
DataViewDefinition
DataViewDefinitionBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Data | Crée et renvoie l'objet de définition de la vue de données qui a été créé à l'aide de ce compilateur. |
set | Data | Définit les index des colonnes à inclure dans la vue de données et spécifie les informations sur les colonnes de rôle. |
LineChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
reverse | Line | Inverse l'ordre de tracé des séries sur l'axe du domaine. |
set | Line | Définit la couleur de l'arrière-plan du graphique. |
set | Line | Définit les couleurs des lignes du graphique. |
set | Line | Définit le style à utiliser pour les courbes du graphique. |
set | Line | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Line | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Line | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Line | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Line | Définit les dimensions du graphique. |
set | Line | Définit la position de la légende par rapport au graphique. |
set | Line | Définit le style du texte de la légende du graphique. |
set | Line | Définit les options avancées de ce graphique. |
set | Line | Définit le style des points de la ligne. |
set | Line | Définit la plage du graphique. |
set | Line | Définit le titre du graphique. |
set | Line | Définit le style du texte du titre du graphique. |
set | Line | Définit le style du texte de l'axe horizontal. |
set | Line | Ajoute un titre à l'axe horizontal. |
set | Line | Définit le style du texte du titre de l'axe horizontal. |
set | Line | Définit le style du texte de l'axe vertical. |
set | Line | Ajoute un titre à l'axe vertical. |
set | Line | Définit le style du texte du titre de l'axe vertical. |
use | Line | Convertit l'axe de plage en échelle logarithmique (toutes les valeurs doivent être positives). |
MatchType
Propriétés
| Propriété | Type | Description |
|---|---|---|
EXACT | Enum | Correspondance avec des valeurs exactes uniquement |
PREFIX | Enum | Faire correspondre les préfixes à partir du début de la valeur |
ANY | Enum | Correspond à n'importe quelle sous-chaîne |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | String | Renvoie le nom du type de correspondance à utiliser dans le JSON des options. |
NumberRangeFilterBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
set | Number | Définit la valeur maximale autorisée pour la limite inférieure de la plage. |
set | Number | Définit la valeur minimale autorisée pour la limite inférieure de la plage. |
set | Number | Définit l'orientation du curseur. |
set | Number | Indique si des libellés doivent être affichés à côté du curseur pour indiquer les limites de la plage sélectionnée. |
set | Number | Définit le nombre de graduations (positions fixes dans une barre de plage) dans lesquelles les curseurs du filtre de plage numérique peuvent se trouver. |
Orientation
Propriétés
| Propriété | Type | Description |
|---|---|---|
HORIZONTAL | Enum | Orientation horizontale. |
VERTICAL | Enum | Orientation verticale. |
PickerValuesLayout
Propriétés
| Propriété | Type | Description |
|---|---|---|
ASIDE | Enum | Les valeurs sélectionnées s'affichent sur une seule ligne de texte à côté du sélecteur de valeurs. |
BELOW | Enum | Les valeurs sélectionnées s'affichent sur une seule ligne de texte sous le widget. |
BELOW_WRAPPING | Enum | Semblable à ce qui suit, mais les entrées qui ne tiennent pas dans le sélecteur sont renvoyées à la ligne. |
BELOW_STACKED | Enum | Les valeurs sélectionnées s'affichent dans une colonne sous le widget. |
PieChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
reverse | Pie | Inverse l'ordre de tracé des séries sur l'axe du domaine. |
set3D() | Pie | Définit le graphique sur trois dimensions. |
set | Pie | Définit la couleur de l'arrière-plan du graphique. |
set | Pie | Définit les couleurs des lignes du graphique. |
set | Pie | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Pie | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Pie | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Pie | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Pie | Définit les dimensions du graphique. |
set | Pie | Définit la position de la légende par rapport au graphique. |
set | Pie | Définit le style du texte de la légende du graphique. |
set | Pie | Définit les options avancées de ce graphique. |
set | Pie | Définit le titre du graphique. |
set | Pie | Définit le style du texte du titre du graphique. |
PointStyle
Propriétés
| Propriété | Type | Description |
|---|---|---|
NONE | Enum | Ne pas afficher les points de la ligne. |
TINY | Enum | Utilisez des points de ligne minuscules. |
MEDIUM | Enum | Utilisez des points de taille moyenne pour les lignes. |
LARGE | Enum | Utilisez des points de ligne de grande taille. |
HUGE | Enum | Utilisez les points de ligne de la plus grande taille. |
Position
Propriétés
| Propriété | Type | Description |
|---|---|---|
TOP | Enum | Au-dessus du graphique. |
RIGHT | Enum | À droite du graphique. |
BOTTOM | Enum | Sous le graphique |
NONE | Enum | Aucune légende ne s'affiche. |
ScatterChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
set | Scatter | Définit la couleur de l'arrière-plan du graphique. |
set | Scatter | Définit les couleurs des lignes du graphique. |
set | Scatter | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Scatter | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Scatter | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Scatter | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Scatter | Définit les dimensions du graphique. |
set | Scatter | Définit la position de la légende par rapport au graphique. |
set | Scatter | Définit le style du texte de la légende du graphique. |
set | Scatter | Définit les options avancées de ce graphique. |
set | Scatter | Définit le style des points de la ligne. |
set | Scatter | Définit le titre du graphique. |
set | Scatter | Définit le style du texte du titre du graphique. |
set | Scatter | Convertit l'axe horizontal en échelle logarithmique (toutes les valeurs doivent être positives). |
set | Scatter | Définit la plage de l'axe horizontal du graphique. |
set | Scatter | Définit le style du texte de l'axe horizontal. |
set | Scatter | Ajoute un titre à l'axe horizontal. |
set | Scatter | Définit le style du texte du titre de l'axe horizontal. |
set | Scatter | Convertit l'axe vertical en échelle logarithmique (toutes les valeurs doivent être positives). |
set | Scatter | Définit la plage de l'axe vertical du graphique. |
set | Scatter | Définit le style du texte de l'axe vertical. |
set | Scatter | Ajoute un titre à l'axe vertical. |
set | Scatter | Définit le style du texte du titre de l'axe vertical. |
StringFilterBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
set | String | Indique si la correspondance doit être sensible à la casse ou non. |
set | String | Indique si le contrôle doit correspondre uniquement à des valeurs exactes (Match), à des préfixes commençant au début de la valeur (Match) ou à n'importe quelle sous-chaîne (Match). |
set | String | Indique si le contrôle doit correspondre à chaque fois qu'une touche est enfoncée ou uniquement lorsque le champ de saisie "change" (perte de focus ou appui sur la touche Entrée). |
TableChartBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Chart | Crée le graphique. |
enable | Table | Indique s'il faut activer la pagination dans les données. |
enable | Table | Active la pagination et définit le nombre de lignes sur chaque page. |
enable | Table | Active la pagination, définit le nombre de lignes dans chaque page et la première page du tableau à afficher (les numéros de page sont basés sur zéro). |
enable | Table | Ajoute une prise en charge de base des langues de droite à gauche (comme l'arabe ou l'hébreu) en inversant l'ordre des colonnes du tableau, de sorte que la colonne 0 est la colonne la plus à droite et la dernière colonne est la colonne la plus à gauche. |
enable | Table | Indique s'il faut trier les colonnes lorsque l'utilisateur clique sur un en-tête de colonne. |
set | Table | Définit l'URL de la source de données utilisée pour extraire les données d'une source externe, comme Google Sheets. |
set | Table | Définit le tableau de données à utiliser pour le graphique à l'aide d'un DataTableBuilder. |
set | Table | Définit le tableau de données contenant les lignes du graphique, ainsi que les libellés de l'axe X. |
set | Table | Définit la définition de la vue de données à utiliser pour le graphique. |
set | Table | Définit les dimensions du graphique. |
set | Table | Définit le numéro de ligne de la première ligne du tableau de données. |
set | Table | Définit l'index de la colonne selon laquelle le tableau doit être trié initialement (ordre croissant). |
set | Table | Définit l'index de la colonne selon laquelle le tableau doit être trié initialement (ordre décroissant). |
set | Table | Définit les options avancées de ce graphique. |
show | Table | Indique s'il faut afficher le numéro de ligne comme première colonne du tableau. |
use | Table | Indique si un style de couleur en alternance est attribué aux lignes impaires et paires d'un tableau. |
TextStyle
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
get | String | Récupère la couleur du style de texte. |
get | String | Récupère le nom de la police du style de texte. |
get | Number | Obtient la taille de police du style de texte. |
TextStyleBuilder
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Text | Crée et renvoie un objet de configuration de style de texte créé à l'aide de ce générateur. |
set | Text | Définit la couleur du style de texte. |
set | Text | Définit le nom de la police du style de texte. |
set | Text | Définit la taille de police du style de texte. |