توفّر هذه الخدمة إمكانية الوصول إلى مشغّلات النصوص البرمجية ونشر النصوص البرمجية.
صفوف
| الاسم | وصف قصير |
|---|---|
AuthMode | يشير ذلك المصطلح إلى تعداد يحدِّد فئات الخدمات المعتمَدة التي يمكن لبرمجة التطبيقات تنفيذها من خلال دالة مُفعَّلة. |
AuthorizationInfo | يشير هذا المصطلح إلى كائن يُستخدم لتحديد ما إذا كان المستخدم بحاجة إلى السماح لهذا النص البرمجي باستخدام خدمة واحدة أو أكثر، وتقديم عنوان URL لمربّع حوار التفويض. |
AuthorizationStatus | عدد يشير إلى حالة تفويض أحد النصوص البرمجية. |
CalendarTriggerBuilder | أداة إنشاء لعوامل تشغيل التقويم |
ClockTriggerBuilder | أداة إنشاء لمشغلات الساعة. |
DocumentTriggerBuilder | أداة إنشاء لمشغلات المستندات. |
EventType | تعداد يشير إلى نوع الحدث الذي تم تشغيله. |
FormTriggerBuilder | يشير هذا المصطلح إلى أداة لإنشاء مُشغِّلات النماذج. |
InstallationSource | يشير هذا التعداد إلى كيفية تثبيت النص البرمجي كإضافة للمستخدم الحالي. |
ScriptApp | الوصول إلى نشر النص البرمجي والمشغلات والتعامل معه |
Service | الوصول إلى نشر النص البرمجي والتعامل معه |
SpreadsheetTriggerBuilder | أداة إنشاء لمشغِّلات جداول البيانات. |
StateTokenBuilder | يسمح هذا الإذن للنصوص البرمجية بإنشاء رموز مميّزة للحالة يمكن استخدامها في واجهات برمجة تطبيقات معاودة الاتصال (مثل تدفقات OAuth). |
Trigger | مشغِّل النص البرمجي. |
TriggerBuilder | أداة إنشاء عامة لمشغِّلات النصوص البرمجية |
TriggerSource | تعداد يشير إلى مصدر الحدث الذي يؤدي إلى تنشيط المشغِّل. |
AuthMode
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
NONE | Enum | وضع لا يسمح بالوصول إلى أي من الخدمات التي تتطلب إذنًا. |
CUSTOM_FUNCTION | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في دوال جداول البيانات المخصصة. |
LIMITED | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات. |
FULL | Enum | وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب الحصول على إذن. |
AuthorizationInfo
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
getAuthorizationStatus() | AuthorizationStatus | يحصل على قيمة تشير إلى ما إذا كان المستخدم بحاجة إلى السماح لهذا النص البرمجي باستخدام خدمة واحدة أو أكثر (على سبيل المثال، ScriptApp.AuthorizationStatus.REQUIRED). |
getAuthorizationUrl() | String | يحصل على عنوان URL للتفويض الذي يمكن استخدامه لمنح الوصول إلى النص البرمجي. |
AuthorizationStatus
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
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
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
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
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
APPS_MARKETPLACE_DOMAIN_ADD_ON | Enum | ثبَّت المشرف الإضافة لنطاق المستخدم. |
NONE | Enum | لا يعمل النص البرمجي كإضافة. |
WEB_STORE_ADD_ON | Enum | ثبَّت المستخدم الإضافة من "سوق Chrome الإلكتروني". |
ScriptApp
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
AuthMode | AuthMode | يشير ذلك المصطلح إلى تعداد يحدِّد فئات الخدمات المعتمَدة التي يمكن لبرمجة التطبيقات تنفيذها من خلال دالة مُفعَّلة. |
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
أماكن إقامة
| الموقع | Type | الوصف |
|---|---|---|
SPREADSHEETS | Enum | تتسبب جداول بيانات Google في تنشيط المشغل. |
CLOCK | Enum | يؤدّي الحدث المستند إلى الوقت إلى تنشيط المشغِّل. |
FORMS | Enum | تسبب "نماذج Google" في تنشيط المشغِّل. |
DOCUMENTS | Enum | يتسبب "مستندات Google" في تنشيط العامل المشغِّل. |
CALENDAR | Enum | يؤدي "تقويم Google" إلى تنشيط المشغِّل. |