تتيح هذه الخدمة الوصول إلى مشغِّلات النصوص البرمجية ونشر النصوص البرمجية.
صفوف
| الاسم | وصف قصير |
|---|---|
AuthMode | تعداد يحدد فئات خدمات "برمجة تطبيقات Google" المصرَّح بها التي يمكنها التنفيذ من خلال دالة تم تشغيلها. |
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 | تعداد يحدد فئات خدمات "برمجة تطبيقات Google" المصرَّح بها التي يمكنها التنفيذ من خلال دالة تم تشغيلها. |
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" في تنشيط المشغِّل. |