Class OptionBuilder
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
選項建構工具用於建立 SelectSingle
和 SelectMultiple
選項的建構工具。
const cc = DataStudioApp.createCommunityConnector();
const config = cc.getConfig();
const option1 =
config.newOptionBuilder().setLabel('option label').setValue('option_value');
const option2 = config.newOptionBuilder()
.setLabel('second option label')
.setValue('option_value_2');
const info1 = config.newSelectSingle()
.setId('api_endpoint')
.setName('Data Type')
.setHelpText('Select the data type you\'re interested in.')
.addOption(option1)
.addOption(option2);
內容詳盡的說明文件
setLabel(label)
設定這個選項建構工具的標籤。標籤是指使用者從下拉式選單中選取一或多個選項時,看到的文字。
參數
名稱 | 類型 | 說明 |
label | String | 要設定的標籤。 |
回攻員
OptionBuilder
:這個建構工具可用於鏈結。
setValue(value)
設定這個選項建構工具的值。當使用者從下拉式選單中選取一或多個選項時,系統會將值傳遞至程式碼。
參數
回攻員
OptionBuilder
:這個建構工具可用於鏈結。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eOptionBuilder\u003c/code\u003e facilitates the creation of options for \u003ccode\u003eSelectSingle\u003c/code\u003e and \u003ccode\u003eSelectMultiple\u003c/code\u003e elements in Data Studio.\u003c/p\u003e\n"],["\u003cp\u003eIt provides methods like \u003ccode\u003esetLabel\u003c/code\u003e and \u003ccode\u003esetValue\u003c/code\u003e to define the display text and underlying value of each option.\u003c/p\u003e\n"],["\u003cp\u003eThese options are then added to \u003ccode\u003eSelectSingle\u003c/code\u003e or \u003ccode\u003eSelectMultiple\u003c/code\u003e components for user interaction within a Data Studio connector.\u003c/p\u003e\n"],["\u003cp\u003eUsing \u003ccode\u003eOptionBuilder\u003c/code\u003e simplifies the process of creating interactive dropdown menus in your custom connectors.\u003c/p\u003e\n"]]],[],null,["# Class OptionBuilder\n\nOptionBuilder\n\nA builder for creating options for [SelectSingle](/apps-script/reference/data-studio/select-single)s and [SelectMultiple](/apps-script/reference/data-studio/select-multiple)s.\n\n```javascript\nconst cc = DataStudioApp.createCommunityConnector();\nconst config = cc.getConfig();\n\nconst option1 =\n config.newOptionBuilder().setLabel('option label').setValue('option_value');\n\nconst option2 = config.newOptionBuilder()\n .setLabel('second option label')\n .setValue('option_value_2');\n\nconst info1 = config.newSelectSingle()\n .setId('api_endpoint')\n .setName('Data Type')\n .setHelpText('Select the data type you\\'re interested in.')\n .addOption(option1)\n .addOption(option2);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|--------------------------------------|--------------------|----------------------------------------|\n| [setLabel(label)](#setLabel(String)) | [OptionBuilder](#) | Sets the label of this option builder. |\n| [setValue(value)](#setValue(String)) | [OptionBuilder](#) | Sets the value of this option builder. |\n\nDetailed documentation\n----------------------\n\n### `set``Label(label)`\n\nSets the label of this option builder. Labels are the text that the user sees when selecting\none or more options from the dropdown.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|-------------------|\n| `label` | `String` | The label to set. |\n\n#### Return\n\n\n[OptionBuilder](#) --- This builder, for chaining.\n\n*** ** * ** ***\n\n### `set``Value(value)`\n\nSets the value of this option builder. Values are what is passed to the code when a user\nselects one or more options from the dropdown.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|-------------------|\n| `value` | `String` | The value to set. |\n\n#### Return\n\n\n[OptionBuilder](#) --- This builder, for chaining."]]