// Opens the spreadsheet file by its ID. If you created your script from a// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().// TODO(developer): Replace the ID with your own.constss=SpreadsheetApp.openById('abc123456');// Gets Sheet1 by its name.constsheet=ss.getSheetByName('Sheet1');// Gets the range A1:B7 on Sheet1.constrange=sheet.getRange('A1:B7');// Gets the range A1:B7 as a data table. The values in each column must be of// the same type.constdatatable=range.getDataTable();// Uses the Charts service to build a bar chart from the data table.// This doesn't build an embedded chart. To do that, use// sheet.newChart().addRange() instead.constchart=Charts.newBarChart().setDataTable(datatable).setOption('title','Your Chart Title Here').build();
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eDataTableSource\u003c/code\u003e is an interface for objects that can present their data as a \u003ccode\u003eDataTable\u003c/code\u003e for use in Google Charts.\u003c/p\u003e\n"],["\u003cp\u003eClasses such as \u003ccode\u003eDataTable\u003c/code\u003e and \u003ccode\u003eRange\u003c/code\u003e implement the \u003ccode\u003eDataTableSource\u003c/code\u003e interface.\u003c/p\u003e\n"],["\u003cp\u003eThe primary method of \u003ccode\u003eDataTableSource\u003c/code\u003e is \u003ccode\u003egetDataTable()\u003c/code\u003e, which returns the object's data formatted as a \u003ccode\u003eDataTable\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eYou can access data from spreadsheet ranges and use it to create charts using the \u003ccode\u003eDataTableSource\u003c/code\u003e and the Charts service.\u003c/p\u003e\n"]]],["The `DataTableSource` interface allows objects to represent data as a `DataTable`. It includes the `getDataTable()` method, which returns the object's data in `DataTable` format. Classes like `DataTable` and `Range` implement this interface. The provided example demonstrates retrieving a `Range` from a spreadsheet, converting it to a `DataTable` using `getDataTable()`, and then utilizing this data to construct a bar chart with the Charts service.\n"],null,["DataTableSource\n\nInterface for objects that can represent their data as a [DataTable](/apps-script/reference/charts/data-table).\n\nImplementing classes \n\n| Name | Brief description |\n|-------------------------------------------------------|---------------------------------------|\n| [DataTable](/apps-script/reference/charts/data-table) | A Data Table to be used in charts. |\n| [Range](../spreadsheet/range.html) | Access and modify spreadsheet ranges. |\n\nMethods\n\n| Method | Return type | Brief description |\n|-----------------------------------|-------------------------------------------------------|----------------------------------------------------|\n| [getDataTable()](#getDataTable()) | [DataTable](/apps-script/reference/charts/data-table) | Return the data inside this object as a DataTable. |\n\nDetailed documentation \n\n`get``Data``Table()` \nReturn the data inside this object as a DataTable.\n\n```javascript\n// Opens the spreadsheet file by its ID. If you created your script from a\n// Google Sheets file, use SpreadsheetApp.getActiveSpreadsheet().\n// TODO(developer): Replace the ID with your own.\nconst ss = SpreadsheetApp.openById('abc123456');\n\n// Gets Sheet1 by its name.\nconst sheet = ss.getSheetByName('Sheet1');\n\n// Gets the range A1:B7 on Sheet1.\nconst range = sheet.getRange('A1:B7');\n\n// Gets the range A1:B7 as a data table. The values in each column must be of\n// the same type.\nconst datatable = range.getDataTable();\n\n// Uses the Charts service to build a bar chart from the data table.\n// This doesn't build an embedded chart. To do that, use\n// sheet.newChart().addRange() instead.\nconst chart = Charts.newBarChart()\n .setDataTable(datatable)\n .setOption('title', 'Your Chart Title Here')\n .build();\n```\n\nReturn\n\n\n[DataTable](/apps-script/reference/charts/data-table) --- the data as a datatable."]]