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)
لضبط قيمة أداة إنشاء الخيارات هذه. القيم هي ما يتم تمريره إلى الرمز عندما يختار المستخدِم
خيارًا واحدًا أو أكثر من القائمة المنسدلة.
المعلمات
الاسم | النوع | الوصف |
value | String | القيمة المطلوب ضبطها |
الإرجاع
OptionBuilder
: هذا المُنشئ، لتسلسل العناصر.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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."]]