Script Service

Script

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

صفوف

الاسم	وصف قصير
AuthMode	قائمة تحدّد فئات الخدمات المعتمَدة التي يمكن لخدمة Apps Script تنفيذها من خلال دالة يتم تنشيطها.
AuthorizationInfo	عنصر يُستخدَم لتحديد ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر، ولتقديم عنوان URL لمربّع حوار التفويض
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 للتفويض الذي يمكن استخدامه لمنح إذن الوصول إلى النص البرمجي.

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	تحصل على عنصر يُستخدَم لتحديد ما إذا كان المستخدم بحاجة إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر، ولتقديم عنوان URL لمربّع حوار التفويض.
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	تبدأ عملية إنشاء عامل تشغيل قابل للتثبيت يستدعي دالة معيّنة عند تشغيله.

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" في بدء تشغيل العامل المشغِّل.