Class FormTriggerBuilder
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
أداةإنشاءالإجراءات التي تسبّب بدء نماذج Google
أداة إنشاء لعوامل تشغيل النماذج
مستندات تفصيلية
create()
لإنشاء عامل التشغيل الجديد وإرجاعه
الإرجاع
Trigger
: عبارة التشغيل الجديدة.
onOpen()
تُستخدَم لتحديد عامل تشغيل سيتم تشغيله عند فتح طريقة عرض تعديل النموذج.
const form = FormApp.getActiveForm();
ScriptApp.newTrigger('myFunction').forForm(form).onOpen().create();
الإرجاع
FormTriggerBuilder
— هذا الرمز FormTriggerBuilder
، لإنشاء سلسلة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eFormTriggerBuilder helps in creating custom triggers for Google Forms.\u003c/p\u003e\n"],["\u003cp\u003eIt offers methods to set triggers for form submission (\u003ccode\u003eonFormSubmit()\u003c/code\u003e) and form opening (\u003ccode\u003eonOpen()\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ecreate()\u003c/code\u003e method finalizes and returns the new trigger.\u003c/p\u003e\n"],["\u003cp\u003eTriggers execute specified functions (\u003ccode\u003emyFunction\u003c/code\u003e in the examples) when the defined event (submit or open) occurs.\u003c/p\u003e\n"]]],[],null,["# Class FormTriggerBuilder\n\nFormTriggerBuilder\n\nA builder for form triggers. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------|--------------------------------------------------|------------------------------------------------------------------------------|\n| [create()](#create()) | [Trigger](/apps-script/reference/script/trigger) | Creates and returns the new trigger. |\n| [onFormSubmit()](#onFormSubmit()) | [FormTriggerBuilder](#) | Specifies a trigger that will fire when a response is submitted to the form. |\n| [onOpen()](#onOpen()) | [FormTriggerBuilder](#) | Specifies a trigger that will fire when the form's edit view is opened. |\n\nDetailed documentation\n----------------------\n\n### `create()`\n\nCreates and returns the new trigger.\n\n#### Return\n\n\n[Trigger](/apps-script/reference/script/trigger) --- The new trigger.\n\n*** ** * ** ***\n\n### `on``Form``Submit()`\n\nSpecifies a trigger that will fire when a response is submitted to the form.\n\n```javascript\nconst form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');\nScriptApp.newTrigger('myFunction').forForm(form).onFormSubmit().create();\n```\n\n#### Return\n\n\n[FormTriggerBuilder](#) --- this [FormTriggerBuilder](#), for chaining\n\n*** ** * ** ***\n\n### `on``Open()`\n\nSpecifies a trigger that will fire when the form's edit view is opened.\n\n```javascript\nconst form = FormApp.getActiveForm();\nScriptApp.newTrigger('myFunction').forForm(form).onOpen().create();\n```\n\n#### Return\n\n\n[FormTriggerBuilder](#) --- This [FormTriggerBuilder](#), for chaining."]]