Class DataViewDefinitionBuilder

DataViewDefinitionBuilder

DataViewDefinition 객체의 빌더입니다.

다음은 빌더를 사용하는 예입니다. 데이터를 가져옴 가져올 수 있습니다. 

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.
  var 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.
  var originalChart = Charts.newTableChart()
      .setDimensions(600, 500)
      .setDataSourceUrl(dataSourceUrl)
      .build();

  // Create another chart to display a subset of the data (only columns 1 and 4).
  var dataViewDefinition = Charts.newDataViewDefinition().setColumns([0, 3]);
  var limitedChart = Charts.newTableChart()
      .setDimensions(200, 500)
      .setDataSourceUrl(dataSourceUrl)
      .setDataViewDefinition(dataViewDefinition)
      .build();

  var htmlOutput = HtmlService.createHtmlOutput();
  var originalChartData = Utilities.base64Encode(originalChart.getAs('image/png').getBytes());
  var originalChartUrl = "data:image/png;base64," + encodeURI(originalChartData);
  var limitedChartData = Utilities.base64Encode(limitedChart.getAs('image/png').getBytes());
  var 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;
}

메서드

메서드반환 유형간략한 설명
build()DataViewDefinition이 빌더를 사용하여 빌드된 데이터 뷰 정의 객체를 빌드하고 반환합니다.
setColumns(columns)DataViewDefinitionBuilder데이터 뷰에 포함할 열의 색인을 설정하고 역할 열을 지정합니다. 확인할 수 있습니다

자세한 문서

build()

이 빌더를 사용하여 빌드된 데이터 뷰 정의 객체를 빌드하고 반환합니다.

리턴

DataViewDefinition - 이 빌더를 사용하여 빌드된 데이터 뷰 정의 객체입니다.

setColumns(columns)

데이터 뷰에 포함할 열의 색인을 설정하고 역할 열을 지정합니다. 확인할 수 있습니다 열 색인의 하위 집합은 확인할 수 있습니다.

열 역할은 해당 열에 있는 데이터의 목적을 설명합니다. 예를 들어 열은 도움말 텍스트, 데이터 포인트 주석 또는 불확실성 지표를 설명하는 데이터를 보유 자세한 내용은 자세한 내용은 Google 차트의 DataTable 역할을 참고하세요. 문서를 참조하세요.

A1:C3에 다음 데이터가 포함된 스프레드시트가 있다고 가정합니다. 

"abc", 20, "blue"
"def", 30, "red"
"ghi", 40, "orange"
 드림 다음 코드는 각 막대의 색상이 서로 다른 막대 그래프를 만듭니다. 색상은 다음과 같습니다. 할 수 있습니다. 
var COLUMN_SPEC = [
  0, // categories
  1, // counts
  {sourceColumn: 2, role: 'style'}
];

function roleColumnChart() {
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = spreadsheet.getActiveSheet();
  var viewSpec = Charts.newDataViewDefinition()
      .setColumns(COLUMN_SPEC)
      .build();
  var 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());
};

매개변수

이름유형설명
columnsObject[]포함할 열 색인 또는 열 설명 (객체)의 배열입니다. 데이터 보기를 클릭합니다. 열 설명은 열 역할을 정의합니다. 데이터 표와 데이터 보기 열의 열거형은 0부터 시작합니다.

리턴

DataViewDefinitionBuilder - 체이닝에 유용한 빌더입니다.