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 secteurs avec les données et l'ajoute à une page Web en tant qu'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 | Outil de compilation 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 | Permet d'exposer 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 des scripts. |
Column | Outil de création de graphiques à colonnes. |
Column | Énumération des types de données valides pour les colonnes d'un Data . |
Curve | Énumération des styles des courbes dans un graphique. |
Data | Tableau de données à utiliser dans les graphiques. |
Data | Compilateur d'objets DataTable. |
Data | Interface pour les objets pouvant représenter leurs données sous la forme d'un Data . |
Data | Définition d'une vue de données pour visualiser les données du graphique. |
Data | Compilateur pour les objets Data . |
Line | Compilateur pour les graphiques en courbes. |
Match | Énumération de la façon dont une valeur de chaîne doit être mise en correspondance. |
Number | Outil de création de sélecteurs de filtre de plage de nombres. |
Orientation | Énumération de l'orientation d'un objet. |
Picker | Énumération des méthodes permettant d'afficher les valeurs sélectionnées dans le widget de sélecteur. |
Pie | Compilateur pour les graphiques circulaires. |
Point | Énumération des styles de points d'une ligne. |
Position | Énumération des positions de la légende dans un graphique. |
Scatter | Outil de création de graphiques à nuage de points. |
String | Compilateur pour les commandes de filtrage de chaîne. |
Table | Un générateur de graphiques sous forme de tableaux. |
Text | Objet de configuration de 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 le dessin des séries sur l'axe des domaines. |
set | Area | Définit la couleur d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 (accumulées). |
set | Area | Définit le titre du graphique. |
set | Area | Définit le style de texte du titre du graphique. |
set | Area | Définit le style de texte de l'axe horizontal. |
set | Area | Ajoute un titre à l'axe horizontal. |
set | Area | Définit le style de texte du titre de l'axe horizontal. |
set | Area | Définit le style de 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 des valeurs 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 le dessin des séries sur l'axe des domaines. |
reverse | Bar | Inverse la direction de croissance des barres le long de l'axe horizontal. |
set | Bar | Définit la couleur d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 (accumulées). |
set | Bar | Définit le titre du graphique. |
set | Bar | Définit le style de texte du titre du graphique. |
set | Bar | Définit le style de texte de l'axe horizontal. |
set | Bar | Ajoute un titre à l'axe horizontal. |
set | Bar | Définit le style de texte du titre de l'axe horizontal. |
set | Bar | Définit le style de 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 des valeurs 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 | Renvoyez les données de cet objet sous la forme d'un objet blob. |
get | Chart | Affiche 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 | Les graphiques ne sautent 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 | Les graphiques fusionnent 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 | Graphique en forme de 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 des courbes dans un graphique. |
Point | Point | Énumération des styles de points d'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 | Lance la création d'un graphique en secteurs, comme décrit dans la documentation sur les outils Google Charts. |
new | Bar | Lance la création d'un graphique à barres, comme décrit dans la documentation sur les outils Google Charts. |
new | Column | Commence à créer un graphique en colonnes, comme décrit dans la documentation sur les outils Google Charts. |
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 | Lance la création d'un graphique linéaire, comme décrit dans la documentation sur les outils Google Charts. |
new | Pie | Commence à créer un graphique en secteurs, comme décrit dans la documentation sur les outils Google Charts. |
new | Scatter | Lance la création d'un graphique en nuage de points, comme décrit dans la documentation sur les outils Google Charts. |
new | Table | Commence à créer un graphique sous forme de tableau, comme décrit dans la documentation sur les outils de graphiques Google. |
new | Text | Crée un générateur de styles de texte. |
ColumnChartBuilder
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | Chart | Crée le graphique. |
reverse | Column | Inverse le dessin des séries sur l'axe des domaines. |
set | Column | Définit la couleur d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 (accumulées). |
set | Column | Définit le titre du graphique. |
set | Column | Définit le style de texte du titre du graphique. |
set | Column | Définit le style de texte de l'axe horizontal. |
set | Column | Ajoute un titre à l'axe horizontal. |
set | Column | Définit le style de texte du titre de l'axe horizontal. |
set | Column | Définit le style de 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 des valeurs 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 à des 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 au tableau de données. |
add | Data | Ajoute une ligne au tableau de données. |
build() | Data | Crée et affiche 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 | Renvoyez les données de cet objet sous la forme d'une 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 créé à l'aide de ce compilateur. |
set | Data | Définit les indices des colonnes à inclure dans la vue des données, ainsi que 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 le dessin des séries sur l'axe des domaines. |
set | Line | Définit la couleur d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 de texte du titre du graphique. |
set | Line | Définit le style de texte de l'axe horizontal. |
set | Line | Ajoute un titre à l'axe horizontal. |
set | Line | Définit le style de texte du titre de l'axe horizontal. |
set | Line | Définit le style de 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 des valeurs en échelle logarithmique (toutes les valeurs doivent être positives). |
MatchType
Propriétés
Propriété | Type | Description |
---|---|---|
EXACT | Enum | Correspondre uniquement aux valeurs exactes |
PREFIX | Enum | Correspondre aux préfixes à partir du début de la valeur |
ANY | Enum | Correspondre à 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 fichier JSON des options. |
NumberRangeFilterBuilder
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
set | Number | Définit la valeur maximale autorisée pour l'étendue inférieure de la plage. |
set | Number | Définit la valeur minimale autorisée pour l'étendue inférieure de la plage. |
set | Number | Définit l'orientation du curseur. |
set | Number | Détermine si des libellés doivent être affichés à côté du curseur pour indiquer les étendues de la plage sélectionnée. |
set | Number | Définit le nombre de repères (positions fixes dans une barre de plage) dans lesquels les curseurs du curseur de 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 widget de 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 à l'exemple ci-dessous, mais les entrées qui ne rentrent pas dans le sélecteur sont renvoyées à une nouvelle 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 le dessin des séries sur l'axe des domaines. |
set3D() | Pie | Définit le graphique en trois dimensions. |
set | Pie | Définit la couleur d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 de 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 de minuscules points de ligne. |
MEDIUM | Enum | Utilisez des points de ligne de taille moyenne. |
LARGE | Enum | Utilisez des points de ligne de grande taille. |
HUGE | Enum | Utilisez les points de ligne de 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 d'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 des données à partir d'une source externe, telle que 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 des abscisses. |
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 de 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 de 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 de texte de l'axe horizontal. |
set | Scatter | Ajoute un titre à l'axe horizontal. |
set | Scatter | Définit le style de 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 de 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 à toute 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 si la pagination des données doit être activée. |
enable | Table | Active la pagination et définit le nombre de lignes de chaque page. |
enable | Table | Active la pagination, définit le nombre de lignes sur 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 compatibilité de base avec les 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 soit la colonne la plus à droite et la dernière colonne la plus à gauche. |
enable | Table | Indique si les colonnes doivent être triées lorsque l'utilisateur clique sur un titre de colonne. |
set | Table | Définit l'URL de la source de données utilisée pour extraire des données à partir d'une source externe, telle que 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 des abscisses. |
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 la première ligne du tableau de données. |
set | Table | Définit l'index de la colonne en fonction de laquelle le tableau doit être trié initialement (par ordre croissant). |
set | Table | Définit l'index de la colonne en fonction de laquelle le tableau doit être trié initialement (décroissant). |
set | Table | Définit les options avancées de ce graphique. |
show | Table | Indique si le numéro de ligne doit être affiché dans la première colonne du tableau. |
use | Table | Indique si un style de couleur alterné 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 | Récupère 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 compilateur. |
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. |