Charts Service
Listy przebojów
Ta usługa umożliwia użytkownikom tworzenie wykresów za pomocą narzędzi Google Charts i ich renderowanie po stronie serwera.
Jeśli chcesz renderować wykresy w przeglądarce, użyj interfejsu Google Charts API.
W tym przykładzie tworzymy podstawową tabelę danych, wypełniamy nią wykres obszarowy i dodajemy go do strony internetowej jako obraz:
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;
}
Zajęcia
Metody
Metoda | Zwracany typ | Krótki opis |
build() | Chart | Tworzy wykres. |
reverseCategories() | BarChartBuilder | Odwraca kolejność rysowania serii na osi domeny. |
reverseDirection() | BarChartBuilder | Odwraca kierunek, w którym kreski rosną wzdłuż osi poziomej. |
setBackgroundColor(cssValue) | BarChartBuilder | Ustawia kolor tła wykresu. |
setColors(cssValues) | BarChartBuilder | Ustawia kolory linii na wykresie. |
setDataSourceUrl(url) | BarChartBuilder | Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google. |
setDataTable(tableBuilder) | BarChartBuilder | Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu. |
setDataTable(table) | BarChartBuilder | Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X. |
setDataViewDefinition(dataViewDefinition) | BarChartBuilder | Określa definicję widoku danych używanego na wykresie. |
setDimensions(width, height) | BarChartBuilder | Określa wymiary wykresu. |
setLegendPosition(position) | BarChartBuilder | Określa położenie legendy względem wykresu. |
setLegendTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu legendy wykresu. |
setOption(option, value) | BarChartBuilder | Ustawia zaawansowane opcje wykresu. |
setRange(start, end) | BarChartBuilder | Określa zakres wykresu. |
setStacked() | BarChartBuilder | Używa nakładanych linii, co oznacza, że wartości linii i pasków są nakładane (kumulowane). |
setTitle(chartTitle) | BarChartBuilder | Ustawia tytuł wykresu. |
setTitleTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu tytułu wykresu. |
setXAxisTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu osi poziomej. |
setXAxisTitle(title) | BarChartBuilder | Dodaje tytuł do osi poziomej. |
setXAxisTitleTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu tytułu osi poziomej. |
setYAxisTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu osi pionowej. |
setYAxisTitle(title) | BarChartBuilder | Dodaje tytuł do osi pionowej. |
setYAxisTitleTextStyle(textStyle) | BarChartBuilder | Ustawia styl tekstu tytułu osi pionowej. |
useLogScale() | BarChartBuilder | Przekształca oś zakresu w skalę logarytmiczną (wymaga, aby wszystkie wartości były dodatnie). |
Właściwości
Właściwość | Typ | Opis |
IGNORE_BOTH | Enum | Domyślna; wykres pomija wszystkie ukryte kolumny i ukryte wiersze. |
IGNORE_ROWS | Enum | Wykresy pomijają tylko ukryte wiersze. |
IGNORE_COLUMNS | Enum | wykresy pomijają tylko kolumny ukryte. |
SHOW_BOTH | Enum | Wykresy nie pomijają ukrytych kolumn ani ukrytych wierszy. |
Właściwości
Właściwość | Typ | Opis |
MERGE_COLUMNS | Enum | Domyślny: |
MERGE_ROWS | Enum | Wykresy scalają wiersze z wielu zakresów. |
Metody
Metoda | Zwracany typ | Krótki opis |
get(option) | Object | Zwraca skonfigurowaną opcję dla tego wykresu. |
getOrDefault(option) | Object | Zwraca skonfigurowaną opcję dla tego wykresu. |
Właściwości
Właściwość | Typ | Opis |
TIMELINE | Enum | Wykres z osią czasu. |
AREA | Enum | Wykres warstwowy |
BAR | Enum | Wykres słupkowy |
BUBBLE | Enum | Wykres bąbelkowy. |
CANDLESTICK | Enum | Wykres świecowy. |
COLUMN | Enum | Wykres kolumnowy |
COMBO | Enum | Wykres kombi |
GAUGE | Enum | Wykres wskaźnikowy. |
GEO | Enum | Wykres geograficzny. |
HISTOGRAM | Enum | Histogram |
RADAR | Enum | Wykres radarowy. |
LINE | Enum | Wykres liniowy |
ORG | Enum | Wykres organizacyjny. |
PIE | Enum | Wykres kołowy |
SCATTER | Enum | Wykres rozproszony |
SPARKLINE | Enum | Miniwykres. |
STEPPED_AREA | Enum | Wykres warstwowy krokowy. |
TABLE | Enum | Wykres tabelaryczny |
TREEMAP | Enum | Wykres mapy drzewa. |
WATERFALL | Enum | Wykres kaskadowy. |
Właściwości
Właściwość | Typ | Opis |
ChartHiddenDimensionStrategy | ChartHiddenDimensionStrategy | Wyliczenie sposobów, w jaki ukryte wymiary źródła są wyrażane na wykresie. |
ChartMergeStrategy | ChartMergeStrategy | Wyliczenie sposobów, w jaki sposób na wykresie są wyrażane różne zakresy w źródle. |
ChartType | ChartType | Wyliczenie typów wykresów obsługiwanych przez usługę wykresów. |
ColumnType | ColumnType | Wyliczenie prawidłowych typów danych kolumn w DataTable . |
CurveStyle | CurveStyle | Wyliczenie stylów krzywych na wykresie. |
PointStyle | PointStyle | Wyliczenie stylów punktów na linii. |
Position | Position | Wyliczenie pozycji legendy na wykresie. |
Właściwości
Właściwość | Typ | Opis |
DATE | Enum | Odpowiada wartościom daty. |
NUMBER | Enum | Odpowiada wartościom liczbowym. |
STRING | Enum | Odpowiada wartościom ciągu znaków. |
Właściwości
Właściwość | Typ | Opis |
NORMAL | Enum | Linie proste bez krzywizn. |
SMOOTH | Enum | Kąty linii są wygładzone. |
Właściwości
Właściwość | Typ | Opis |
EXACT | Enum | Dopasuj tylko do wartości dokładnych |
PREFIX | Enum | dopasowywać prefiksy od początku wartości, |
ANY | Enum | Dopasuj dowolny podciąg |
Metody
Metoda | Zwracany typ | Krótki opis |
getName() | String | Zwraca nazwę typu dopasowania, który ma być używany w pliku JSON opcji. |
Właściwości
Właściwość | Typ | Opis |
HORIZONTAL | Enum | Orientacja pozioma. |
VERTICAL | Enum | Orientacja pionowa. |
Właściwości
Właściwość | Typ | Opis |
ASIDE | Enum | Wybrane wartości są wyświetlane w pojedynczej linii tekstowej obok widżetu selektora wartości. |
BELOW | Enum | Wybrane wartości są wyświetlane w pojedynczej linii tekstowej pod widżetem. |
BELOW_WRAPPING | Enum | Podobnie jak w przypadku poniżej, ale wpisy, które nie mieszczą się w selektorze, są przenoszone na nową linię. |
BELOW_STACKED | Enum | Wybrane wartości wyświetlają się w kolumnie pod widżetem. |
Właściwości
Właściwość | Typ | Opis |
NONE | Enum | Nie wyświetlaj punktów linii. |
TINY | Enum | Używaj małych punktów linii. |
MEDIUM | Enum | Użyj punktów linii o średnim rozmiarze. |
LARGE | Enum | Użyj dużych punktów linii. |
HUGE | Enum | Użyj punktów linii o największym rozmiarze. |
Właściwości
Właściwość | Typ | Opis |
TOP | Enum | Nad wykresem. |
RIGHT | Enum | po prawej stronie wykresu. |
BOTTOM | Enum | Pod wykresem. |
NONE | Enum | Nie wyświetla się legenda. |
Metody
Metoda | Zwracany typ | Krótki opis |
build() | Chart | Tworzy wykres. |
enablePaging(enablePaging) | TableChartBuilder | Określa, czy należy włączyć przewijanie danych. |
enablePaging(pageSize) | TableChartBuilder | Włącza podział na strony i ustala liczbę wierszy na stronie. |
enablePaging(pageSize, startPage) | TableChartBuilder | Umożliwia podział na strony, ustawia liczbę wierszy na każdej stronie i pierwszą stronę tabeli do wyświetlenia (numery stron są liczone od zera). |
enableRtlTable(rtlEnabled) | TableChartBuilder | Dodaje podstawową obsługę języków zapisywanych od prawej do lewej (np. arabskiego lub hebrajskiego) przez odwrócenie kolejności kolumn tabeli, tak aby kolumna 0 była kolumną najbardziej na prawo, a ostatnia kolumna – najbardziej na lewo. |
enableSorting(enableSorting) | TableChartBuilder | Określa, czy kolumny mają być sortowane, gdy użytkownik kliknie nagłówek kolumny. |
setDataSourceUrl(url) | TableChartBuilder | Ustawia adres URL źródła danych, który służy do pobierania danych z zewnętrznego źródła, np. z Arkuszy Google. |
setDataTable(tableBuilder) | TableChartBuilder | Za pomocą klasy DataTableBuilder ustawia tabelę danych, która ma być używana na potrzeby wykresu. |
setDataTable(table) | TableChartBuilder | Ustawia tabelę danych zawierającą linie wykresu oraz etykiety osi X. |
setDataViewDefinition(dataViewDefinition) | TableChartBuilder | Określa definicję widoku danych używanego na wykresie. |
setDimensions(width, height) | TableChartBuilder | Określa wymiary wykresu. |
setFirstRowNumber(number) | TableChartBuilder | Ustawia numer wiersza dla pierwszego wiersza w tabeli danych. |
setInitialSortingAscending(column) | TableChartBuilder | Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (w kolejności rosnącej). |
setInitialSortingDescending(column) | TableChartBuilder | Ustawia indeks kolumny, według której tabela ma być początkowo sortowana (malejąco). |
setOption(option, value) | TableChartBuilder | Ustawia zaawansowane opcje wykresu. |
showRowNumberColumn(showRowNumber) | TableChartBuilder | Określa, czy numer wiersza ma być wyświetlany jako pierwsza kolumna tabeli. |
useAlternatingRowStyle(alternate) | TableChartBuilder | Określa, czy styl naprzemiennych kolorów jest przypisany do nieparzystych i parzystych wierszy wykresu tabeli. |
Metody
Metoda | Zwracany typ | Krótki opis |
getColor() | String | Pobiera kolor stylu tekstu. |
getFontName() | String | Pobiera nazwę czcionki stylu tekstu. |
getFontSize() | Number | Pobiera rozmiar czcionki stylu tekstu. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-12-06 UTC.
[null,null,["Ostatnia aktualizacja: 2024-12-06 UTC."],[[["The Google Apps Script Charts Service enables server-side rendering of charts using Google Charts Tools, offering an alternative to the client-side Google Charts API."],["Charts are built using a structured process involving data table creation, chart construction with specific configurations like type, data source, and styling, and HTML output generation for display."],["The Charts Service provides a range of chart types, including AreaChart, BarChart, ColumnChart, LineChart, PieChart, ScatterChart, and TableChart, each with corresponding builder classes for customization."],["Comprehensive documentation details various classes and methods for data manipulation, visual styling, axes configuration, and interactive element creation, empowering developers to tailor charts to their needs."],["Developers can leverage methods from ScatterChartBuilder, StringFilterBuilder, TableChartBuilder, TextStyle, and TextStyleBuilder to fine-tune chart axes, filtering, table layouts, and text styles, enhancing chart customization and functionality."]]],[]]