تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Script Service

توفّر هذه الخدمة إمكانية الوصول إلى عوامل تشغيل النصوص البرمجية ونشرها.

صفوف

الاسم	وصف قصير
`AuthMode`	قائمة تحدّد فئات الخدمات المعتمَدة التي يمكن لخدمة Apps Script تنفيذها من خلال دالة يتم تنشيطها.
`AuthorizationInfo`	عنصر يتحقّق مما إذا كان المستخدم قد منح الإذن بالنطاقات المطلوبة للملف البرمجي.
`AuthorizationStatus`	تشير هذه السمة إلى حالة التفويض لنص برمجي.
`CalendarTriggerBuilder`	أداة إنشاء عوامل تشغيل التقويم
`ClockTriggerBuilder`	أداة إنشاء لتشغيل المهام استنادًا إلى الساعة
`DocumentTriggerBuilder`	أداة إنشاء لعوامل تشغيل المستندات
`EventType`	تشير هذه السمة إلى نوع الحدث الذي تم تشغيله.
`FormTriggerBuilder`	أداة إنشاء لعوامل تشغيل النماذج
`InstallationSource`	تشير هذه السمة إلى كيفية تثبيت النص البرمجي كإضافة للمستخدِم الحالي.
`ScriptApp`	الوصول إلى نشر النصوص البرمجية وعناصر التفعيل وتعديلها
`Service`	الوصول إلى نشر النصوص البرمجية وتعديله
`SpreadsheetTriggerBuilder`	أداة إنشاء عوامل تشغيل جداول البيانات
`StateTokenBuilder`	السماح للبرامج النصية بإنشاء رموز مميزة للحالة يمكن استخدامها في واجهات برمجة تطبيقات عمليات تسجيل الإحالات الناجحة (مثل عمليات OAuth)
`Trigger`	مشغِّل نص برمجي
`TriggerBuilder`	أداة إنشاء عامة لعوامل تشغيل النصوص البرمجية
`TriggerSource`	تشير هذه السمة إلى مصدر الحدث الذي يؤدي إلى بدء تشغيل العامل المشغِّل.

`AuthMode`

الخصائص

الموقع	النوع	الوصف
`NONE`	`Enum`	وضع لا يسمح بالوصول إلى أي خدمات تتطلّب تفويضًا
`CUSTOM_FUNCTION`	`Enum`	وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في وظائف جدول بيانات مخصّصة
`LIMITED`	`Enum`	وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات
`FULL`	`Enum`	وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب تفويضًا

`AuthorizationInfo`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`getAuthorizationStatus()`	`AuthorizationStatus`	تحصل على قيمة تشير إلى ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر (على سبيل المثال، `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String`	تحصل على عنوان URL للتفويض الذي يمكن استخدامه لمنح إذن الوصول إلى النص البرمجي.
`getAuthorizedScopes()`	`String[]`	تحصل على قائمة بالنطاقات المعتمَدة للنص البرمجي.

`AuthorizationStatus`

الخصائص

الموقع	النوع	الوصف
`REQUIRED`	`Enum`	على المستخدم تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر.
`NOT_REQUIRED`	`Enum`	منح المستخدم هذا النص البرمجي جميع الأذونات التي يتطلبها حاليًا.

`CalendarTriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`create()`	`Trigger`	تُنشئ هذه الدالة مشغِّل التفعيل وتُرجعه.
`onEventUpdated()`	`CalendarTriggerBuilder`	تُحدِّد عامل تشغيل يتم تشغيله عند إنشاء إدخال تقويم أو تعديله أو حذفه.

`ClockTriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`after(durationMilliseconds)`	`ClockTriggerBuilder`	تحدّد الحدّ الأدنى لمدة (بالملي ثانية) بعد الوقت الحالي الذي يتم فيه تشغيل المشغِّل.
`at(date)`	`ClockTriggerBuilder`	تُحدِّد وقت تشغيل عامل التفعيل.
`atDate(year, month, day)`	`ClockTriggerBuilder`	يحدِّد هذا الخيار أنّ العامل المشغِّل يتم تفعيله في التاريخ المحدَّد، تلقائيًا بالقرب من منتصف الليل (+/- 15 دقيقة).
`atHour(hour)`	`ClockTriggerBuilder`	تُحدِّد الساعة التي يتم فيها تشغيل عامل التفعيل.
`create()`	`Trigger`	لإنشاء مشغِّل.
`everyDays(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` يوم.
`everyHours(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` ساعة.
`everyMinutes(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` دقيقة.
`everyWeeks(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل المشغِّل كل `n` أسبوع.
`inTimezone(timezone)`	`ClockTriggerBuilder`	تحدّد المنطقة الزمنية للتواريخ أو الوقت المحدّدَين عند تشغيل المشغّل.
`nearMinute(minute)`	`ClockTriggerBuilder`	تحدِّد الدقيقة التي يتم فيها تشغيل عامل التفعيل (بالإضافة إلى 15 دقيقة أو ناقصها).
`onMonthDay(day)`	`ClockTriggerBuilder`	تُحدِّد التاريخ في الشهر الذي يتم فيه تشغيل عامل التفعيل.
`onWeekDay(day)`	`ClockTriggerBuilder`	تُستخدَم لتحديد يوم الأسبوع الذي يتم فيه تشغيل عامل التفعيل.

`DocumentTriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`create()`	`Trigger`	لإنشاء عامل التشغيل الجديد وإرجاعه
`onOpen()`	`DocumentTriggerBuilder`	تُحدِّد عامل تشغيل سيتم تنشيطها عند فتح المستند.

`EventType`

الخصائص

الموقع	النوع	الوصف
`CLOCK`	`Enum`	يتم تنشيط عامل التشغيل بعد وصول الحدث المستنِد إلى الوقت إلى وقت محدّد.
`ON_OPEN`	`Enum`	يتم تشغيل العامل المشغِّل بعد أن يفتح المستخدم ملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google".
`ON_EDIT`	`Enum`	يتم تنشيط العامل المشغِّل بعد أن يعدّل المستخدم ملف "جداول بيانات Google" (على سبيل المثال، من خلال إدخال قيمة جديدة في خلية، ما يُعدّ تعديلاً بدلاً من تغيير).
`ON_FORM_SUBMIT`	`Enum`	يتم بدء الإجراء المشغِّل بعد أن يردّ المستخدم على نموذج Google.
`ON_CHANGE`	`Enum`	يتم تنشيط العامل المشغِّل بعد أن يغيّر المستخدم ملف "جداول بيانات Google" (على سبيل المثال، من خلال إضافة صف، يُحتسَب ذلك كتغيير بدلاً من تعديل).
`ON_EVENT_UPDATED`	`Enum`	يتم تشغيل عامل التفعيل بعد إنشاء حدث أو تعديله أو حذفه في "تقويم Google" المحدّد.

`FormTriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`create()`	`Trigger`	لإنشاء عامل التشغيل الجديد وإرجاعه
`onFormSubmit()`	`FormTriggerBuilder`	تُحدِّد عامل تشغيل سيتم تفعيله عند إرسال ردّ إلى النموذج.
`onOpen()`	`FormTriggerBuilder`	تُستخدَم لتحديد عامل تشغيل سيتم تشغيله عند فتح طريقة عرض تعديل النموذج.

`InstallationSource`

الخصائص

الموقع	النوع	الوصف
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	تم تثبيت الإضافة من قِبل المشرف لنطاق المستخدم.
`NONE`	`Enum`	لا يتم تشغيل النص البرمجي كإضافة.
`WEB_STORE_ADD_ON`	`Enum`	ثبَّت المستخدم الإضافة من "سوق Chrome الإلكتروني".

`ScriptApp`

الخصائص

الموقع	النوع	الوصف
`AuthMode`	`AuthMode`	قائمة تحدّد فئات الخدمات المعتمَدة التي يمكن لخدمة Apps Script تنفيذها من خلال دالة يتم تنشيطها.
`AuthorizationStatus`	`AuthorizationStatus`	تشير هذه السمة إلى حالة التفويض لنص برمجي.
`EventType`	`EventType`	تشير هذه السمة إلى نوع الحدث الذي تم تشغيله.
`InstallationSource`	`InstallationSource`	تشير هذه السمة إلى كيفية تثبيت النص البرمجي للمستخدم كإضافة.
`TriggerSource`	`TriggerSource`	تشير هذه السمة إلى مصدر الحدث الذي يؤدي إلى بدء تشغيل العامل المشغِّل.
`WeekDay`	`Weekday`	قائمة تمثل أيام الأسبوع

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`deleteTrigger(trigger)`	`void`	تزيل هذه العملية عامل التفعيل المحدّد كي لا يتم تشغيله بعد ذلك.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	تحصل على عنصر يتحقّق مما إذا كان المستخدم قد منح الإذن لجميع متطلبات الرمز البرمجي.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	تحصل على عنصر يتحقّق مما إذا كان المستخدم قد منح تفويضًا بالنطاقات المطلوبة.
`getIdentityToken()`	`String`	الحصول على رمز تعريف OpenID Connect للمستخدِم الفعّال، في حال منح نطاق `openid`
`getInstallationSource()`	`InstallationSource`	تعرِض هذه السمة قيمة عنصر محدّد تشير إلى كيفية تثبيت النص البرمجي كإضافة للمستخدِم الحالي (على سبيل المثال، ما إذا كان المستخدِم قد ثبَّته شخصيًا من خلال "سوق Chrome الإلكتروني"، أو ما إذا كان مشرف نطاق قد ثبَّته لجميع المستخدِمين).
`getOAuthToken()`	`String`	تحصل على رمز الوصول لبروتوكول OAuth 2.0 للمستخدم الفعلي.
`getProjectTriggers()`	`Trigger[]`	تحصل على جميع مشغِّلات الأحداث القابلة للتثبيت المرتبطة بالمشروع الحالي والمستخدم الحالي.
`getScriptId()`	`String`	للحصول على المعرّف الفريد لمشروع النصوص البرمجية
`getService()`	`Service`	تحصل على عنصر يُستخدَم للتحكّم في نشر النص البرمجي كتطبيق ويب.
`getUserTriggers(document)`	`Trigger[]`	تحصل على جميع عوامل التشغيل القابلة للتثبيت التي يملكها هذا المستخدم في المستند المحدّد، لهذا النص البرمجي أو الإضافة فقط.
`getUserTriggers(form)`	`Trigger[]`	تحصل على جميع عوامل التشغيل القابلة للتثبيت التي يملكها هذا المستخدم في النموذج المحدّد، لهذا النص البرمجي أو الإضافة فقط.
`getUserTriggers(spreadsheet)`	`Trigger[]`	تحصل على جميع عوامل التشغيل القابلة للتثبيت التي يملكها هذا المستخدم في جدول البيانات المحدّد، لهذا النص البرمجي أو الملحق فقط.
`invalidateAuth()`	`void`	تؤدي هذه العملية إلى إلغاء صلاحية التفويض الذي يحصل عليه المستخدم الفعلي لتنفيذ النص البرمجي الحالي.
`newStateToken()`	`StateTokenBuilder`	لإنشاء أداة إنشاء لرمز حالة يمكن استخدامه في واجهة برمجة تطبيقات طلب إعادة الاتصال (مثل عملية OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	يبدأ عملية إنشاء عامل تشغيل قابل للتثبيت يستدعي دالة معيّنة عند تشغيله.
`requireAllScopes(authMode)`	`void`	للتحقّق مما إذا كان المستخدم قد منح موافقته على جميع النطاقات التي طلبها النص البرمجي.
`requireScopes(authMode, oAuthScopes)`	`void`	للتحقّق مما إذا كان المستخدم قد منح موافقته على النطاقات المطلوبة.

`Service`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`getUrl()`	`String`	تعرِض هذه السمة عنوان URL لتطبيق الويب في حال تم نشره، وتعرض `null` في حال عدم نشره.
`isEnabled()`	`Boolean`	تعرِض القيمة `true` إذا كان بالإمكان الوصول إلى النص البرمجي كتطبيق ويب.

`SpreadsheetTriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`create()`	`Trigger`	تُنشئ هذه الدالة مشغِّل التفعيل وتُرجعه.
`onChange()`	`SpreadsheetTriggerBuilder`	تُحدِّد عامل تشغيل سيتم تشغيله عند تغيير محتوى جدول البيانات أو بنيته.
`onEdit()`	`SpreadsheetTriggerBuilder`	تحدِّد عامل تشغيل سيتم تنشيطها عند تعديل جدول البيانات.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	تحدِّد هذه السمة عامل تشغيل يتم تشغيله عندما يتم إرسال نموذج إلى جدول البيانات.
`onOpen()`	`SpreadsheetTriggerBuilder`	تُحدِّد عامل تشغيل سيتم تنشيطها عند فتح جدول البيانات.

`StateTokenBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`createToken()`	`String`	تُنشئ تمثيلاً مشفَّرًا لسلسلة الرمز المميّز للحالة.
`withArgument(name, value)`	`StateTokenBuilder`	تضيف وسيطة إلى الرمز المميّز.
`withMethod(method)`	`StateTokenBuilder`	تُستخدَم لضبط دالة ردّ اتصال.
`withTimeout(seconds)`	`StateTokenBuilder`	تُستخدَم لضبط المدة (بالثواني) التي يكون فيها الرمز المميّز صالحًا.

`Trigger`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`getEventType()`	`EventType`	تعرِض هذه السمة نوع الحدث الذي يتم تشغيل العامل المشغِّل عند حدوثه.
`getHandlerFunction()`	`String`	تُرجِع الدالة التي سيتمّ استدعاؤها عند بدء الإجراء المشغِّل.
`getTriggerSource()`	`TriggerSource`	تعرِض هذه الدالة مصدر الأحداث التي ستؤدي إلى تنشيط العامل المشغِّل.
`getTriggerSourceId()`	`String`	لعرض رقم التعريف الخاص بالمصدر.
`getUniqueId()`	`String`	تعرِض هذه السمة معرّفًا فريدًا يمكن استخدامه للتمييز بين عوامل التشغيل.

`TriggerBuilder`

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`forDocument(document)`	`DocumentTriggerBuilder`	تُنشئ هذه الدالة `DocumentTriggerBuilder` وتُرجعها مرتبطة بالمستند المحدّد.
`forDocument(key)`	`DocumentTriggerBuilder`	تُنشئ هذه الدالة `DocumentTriggerBuilder` وتُرجعها مرتبطة بالمستند الذي يحمل المعرّف المحدّد.
`forForm(form)`	`FormTriggerBuilder`	لإنشاء `FormTriggerBuilder` مرتبط بالنموذج المحدّد وعرضه
`forForm(key)`	`FormTriggerBuilder`	لإنشاء `FormTriggerBuilder` مرتبط بالنموذج باستخدام المعرّف المحدّد وإرجاع هذا العنصر.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	لإنشاء `SpreadsheetTriggerBuilder` مرتبط بجدول البيانات المحدّد وإرجاعه.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	لإنشاء `SpreadsheetTriggerBuilder` مرتبط بجدول البيانات باستخدام الرقم التعريفي المحدّد وإرجاعه.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	تعرِض هذه الدالة أداة إنشاء لإنشاء عوامل تشغيل التقويم.
`timeBased()`	`ClockTriggerBuilder`	تُنشئ هذه الدالة `ClockTriggerBuilder` وتُرجعها لإنشاء عوامل تشغيل مستندة إلى الوقت.

`TriggerSource`

الخصائص

الموقع	النوع	الوصف
`SPREADSHEETS`	`Enum`	تؤدي "جداول بيانات Google" إلى بدء تشغيل العامل المشغِّل.
`CLOCK`	`Enum`	يؤدي الحدث المستنِد إلى الوقت إلى تشغيل عامل التشغيل.
`FORMS`	`Enum`	تؤدي "نماذج Google" إلى بدء تشغيل عامل التفعيل.
`DOCUMENTS`	`Enum`	تؤدي "مستندات Google" إلى بدء تشغيل عامل التفعيل.
`CALENDAR`	`Enum`	يتسبب "تقويم Google" في بدء تشغيل العامل المشغِّل.

إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0‏ ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0‏. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers‏. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.

تاريخ التعديل الأخير: 2025-01-08 (حسب التوقيت العالمي المتفَّق عليه)

المدوّنة
الاطّلاع على مدونة Google Workspace Developers
Stack Overflow
طرح سؤال ضمن علامة google-apps-script
تعليمات برمجية نموذجية
استكشِف عيّنات التعليمات البرمجية لدينا أو انسخها لإنشاء رمزك الخاص.
الفيديوهات الطويلة
مشاهدة البرامج التعليمية لبرمجة التطبيقات