Data
nesneleri için oluşturucu.
Oluşturucuyu kullanma örneğini aşağıda bulabilirsiniz. Veriler bir Google e-tablosundan içe aktarılır.
function doGet() { // This example creates two table charts side by side. One uses a data view // definition to restrict the number of displayed columns. // Get sample data from a spreadsheet. const dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AF' + '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=4&headers=-1'; // Create a chart to display all of the data. const originalChart = Charts.newTableChart() .setDimensions(600, 500) .setDataSourceUrl(dataSourceUrl) .build(); // Create another chart to display a subset of the data (only columns 1 and // 4). const dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]); const limitedChart = Charts.newTableChart() .setDimensions(200, 500) .setDataSourceUrl(dataSourceUrl) .setDataViewDefinition(dataViewDefinition) .build(); const htmlOutput = HtmlService.createHtmlOutput(); const originalChartData = Utilities.base64Encode( originalChart.getAs('image/png').getBytes(), ); const originalChartUrl = `data:image/png;base64,${encodeURI(originalChartData)}`; const limitedChartData = Utilities.base64Encode( limitedChart.getAs('image/png').getBytes(), ); const limitedChartUrl = `data:image/png;base64,${encodeURI(limitedChartData)}`; htmlOutput.append('<table><tr><td>'); htmlOutput.append(`<img border="1" src="${originalChartUrl}">`); htmlOutput.append('</td><td>'); htmlOutput.append(`<img border="1" src="${limitedChartUrl}">`); htmlOutput.append('</td></tr></table>'); return htmlOutput; }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
build() | Data | Bu oluşturucu kullanılarak oluşturulan veri görünümü tanımı nesnesini oluşturur ve döndürür. |
set | Data | Veri görünümüne dahil edilecek sütunların dizinlerini ayarlar ve rol sütunu bilgilerini belirtir. |
Ayrıntılı dokümanlar
build()
Bu oluşturucu kullanılarak oluşturulan veri görünümü tanımı nesnesini oluşturur ve döndürür.
Return
Data
: Bu oluşturucu kullanılarak oluşturulan bir veri görünümü tanımı nesnesi.
set Columns(columns)
Veri görünümüne dahil edilecek sütunların dizinlerini ayarlar ve rol sütunu bilgilerini belirtir. Bu sütun dizini alt kümesi, veri görünümünün türetildiği veri kaynağının sütunlarını ifade eder.
Sütun rolü, ilgili sütundaki verilerin amacını açıklar. Örneğin, bir sütunda ipucu metnini, veri noktası ek açıklamalarını veya belirsizlik göstergelerini açıklayan veriler bulunabilir. Daha fazla bilgi için Google Grafikler belgelerindeki Veri
A1:C3 alanında aşağıdaki verileri içeren bir e-tablo olduğunu varsayalım:
'abc', 20, 'blue'; 'def', 30, 'red'; 'ghi', 40, 'orange';
const COLUMN_SPEC = [ 0, // categories 1, // counts {sourceColumn: 2, role: 'style'}, ]; function roleColumnChart() { const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const sheet = spreadsheet.getActiveSheet(); const viewSpec = Charts.newDataViewDefinition().setColumns(COLUMN_SPEC).build(); const chartBuilder = sheet.newChart() .setChartType(Charts.ChartType.BAR) .setDataViewDefinition(viewSpec) .setOption('useFirstColumnAsDomain', true) .setPosition(5, 1, 0, 0) .setOption('hAxis', {title: 'Counts'}) .setOption('vAxis', {title: 'Categories'}) .addRange(sheet.getRange('A1:C3')); sheet.insertChart(chartBuilder.build()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Object[] | Veri görünümüne dahil edilecek bir sütun dizini veya sütun açıklaması (nesne) dizisi. Sütun açıklamaları, sütun rolünü tanımlar. Veri tablosu ve veri görünümü sütunlarının dizilişi sıfır tabanlı olmalıdır. |
Return
Data
: Zincirleme için yararlı olan bu oluşturucu.