Script Service

Script

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

صفوف

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

AuthMode

أماكن إقامة

الخاصيةالنوعالوصف
NONEEnumوضع لا يسمح بالوصول إلى أي خدمات تتطلب تفويضًا.
CUSTOM_FUNCTIONEnumوضع يتيح الوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في دوال جداول البيانات المخصّصة.
LIMITEDEnumوضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات.
FULLEnumوضع يسمح بالوصول إلى جميع الخدمات التي تتطلب تفويضًا.

AuthorizationInfo

الطُرق

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

AuthorizationStatus

أماكن إقامة

الخاصيةالنوعالوصف
REQUIREDEnumيحتاج المستخدم إلى تفويض هذا النص البرمجي لاستخدام خدمة واحدة أو أكثر.
NOT_REQUIREDEnumمنح المستخدم هذا النص البرمجي كل التفويض الذي يتطلبه حاليًا.

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

أماكن إقامة

الخاصيةالنوعالوصف
CLOCKEnumيتم تنشيط المشغِّل عند وصول الحدث المستند إلى الوقت في وقت محدد.
ON_OPENEnumيتم تنشيط المشغِّل بعد أن يفتح المستخدم ملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google".
ON_EDITEnumيتم تنشيط المشغِّل بعد أن يعدِّل المستخدم ملف "جداول بيانات Google" (على سبيل المثال، من خلال إدخال قيمة جديدة في خلية، يتم احتسابها كتعديل بدلاً من تغيير).
ON_FORM_SUBMITEnumيتم تنشيط المشغِّل بعد رد المستخدم على "نموذج Google".
ON_CHANGEEnumيتم تنشيط المشغِّل بعد تغيير المستخدم لملف "جداول بيانات Google" (على سبيل المثال، من خلال إضافة صف، والذي يتم احتسابه تغييرًا بدلاً من تعديل).
ON_EVENT_UPDATEDEnumيتم تنشيط المشغّل بعد إنشاء حدث أو تعديله أو حذفه في تقويم Google المحدّد.

FormTriggerBuilder

الطُرق

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

InstallationSource

أماكن إقامة

الخاصيةالنوعالوصف
APPS_MARKETPLACE_DOMAIN_ADD_ONEnumتم تثبيت الإضافة بواسطة مشرف نطاق المستخدم.
NONEEnumالنص البرمجي لا يعمل كإضافة.
WEB_STORE_ADD_ONEnumتم تثبيت الإضافة بواسطة المستخدم من سوق Chrome الإلكتروني.

ScriptApp

أماكن إقامة

الخاصيةالنوعالوصف
AuthModeAuthModeتعداد يحدد فئات خدمات "برمجة تطبيقات Google" المصرَّح بها التي يمكنها التنفيذ من خلال دالة تم تشغيلها.
AuthorizationStatusAuthorizationStatusقائمة تعداد تشير إلى حالة تفويض نص برمجي
EventTypeEventTypeقائمة تعداد تشير إلى نوع الحدث الذي تم تشغيله
InstallationSourceInstallationSourceقائمة تعداد تشير إلى كيفية تثبيت النص البرمجي للمستخدم كإضافة
TriggerSourceTriggerSourceقائمة تعداد تشير إلى مصدر الحدث الذي يؤدي إلى إطلاق المشغّل.
WeekDayWeekdayقائمة تعداد تمثّل أيام الأسبوع

الطُرق

الطريقةنوع الإرجاعوصف قصير
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

أماكن إقامة

الخاصيةالنوعالوصف
SPREADSHEETSEnumيتسبب تطبيق "جداول بيانات Google" في تنشيط المشغّل.
CLOCKEnumيؤدي الحدث المستند إلى الوقت إلى تنشيط العامل المشغِّل.
FORMSEnumيؤدي استخدام "نماذج Google" إلى تنشيط العامل المشغِّل.
DOCUMENTSEnumيتسبب تطبيق "مستندات Google" في تنشيط المشغِّل.
CALENDAREnumيتسبب "تقويم Google" في تنشيط المشغِّل.