تمت ترجمة هذه الصفحة بواسطة 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\|null`	تعرض هذه الدالة عنوان URL للتفويض يمكن استخدامه لمنح إذن الوصول إلى النص البرمجي.
`getAuthorizedScopes()`	`String[]\|null`	تعرض هذه الدالة قائمة بالنطاقات المصرّح بها للنص البرمجي.

`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\|null`	يحصل على رمز مميّز لهوية OpenID Connect للمستخدم الفعّال، إذا تم منح النطاق `openid`.
`getInstallationSource()`	`InstallationSource`	تعرض هذه الدالة قيمة تعدادية تشير إلى كيفية تثبيت البرنامج النصي كإضافة للمستخدم الحالي (على سبيل المثال، ما إذا كان المستخدم قد ثبّته شخصيًا من خلال "سوق Chrome الإلكتروني"، أو ما إذا كان مشرف النطاق قد ثبّته لجميع المستخدمين).
`getOAuthToken()`	`String`	تعرض هذه الطريقة رمز الدخول المميز من الإصدار 2.0 من OAuth للمستخدم الفعلي.
`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-12-11 (حسب التوقيت العالمي المتفَّق عليه)

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