عناصر الأحداث

مشغلات بسيطة تسمح المشغِّلات القابلة للتثبيت ببرمجة التطبيقات. تشغيل دالة تلقائيًا في حالة وقوع حدث معين. عندما يشتعل أحد المشغلات، تمرر "برمجة تطبيقات Google" الدالة كائن حدث كوسيطة، تُسمى عادةً e يحتوي كائن الحدث على معلومات حول السياق الذي تسبّب في إشعال النار فيها. على سبيل المثال، يعرض الرمز النموذجي التالي رمز onEdit(e) بسيطًا للنص البرمجي في "جداول بيانات Google" الذي يستخدم كائن الحدث لتحديد أي تم تحرير الخلية.

function onEdit(e){
  // Set a comment on the edited cell to indicate when it was changed.
  var range = e.range;
  range.setNote('Last modified: ' + new Date());
}

توضح هذه الصفحة تفاصيل الحقول في كائن الحدث لأنواع مختلفة من والمشغلات.

أحداث "جداول بيانات Google"

تسمح المشغلات المختلفة الخاصة بـ "جداول بيانات Google" للنصوص البرمجية بالاستجابة لطلبات المستخدم إجراءات في جدول بيانات.

فتح

(بسيط وقابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

LIMITED
source

Spreadsheet يمثل ملف "جداول بيانات Google" الذي يرتبط به النص البرمجي.

Spreadsheet
triggerUid

رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط)

4034124084959907503
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان).

amin@example.com

تغيير

(قابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

FULL
changeType

نوع التغيير (EDIT، INSERT_ROW، INSERT_COLUMN, REMOVE_ROW، REMOVE_COLUMN, INSERT_GRID, REMOVE_GRID, FORMAT أو OTHER).

INSERT_ROW
source

ملف Spreadsheet يمثل ملف "جداول بيانات Google" الذي يتم تعيين النص البرمجي إليه مرتبط.

Spreadsheet
triggerUid

رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث.

4034124084959907503
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان).

amin@example.com

تعديل

(بسيط وقابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

LIMITED
oldValue

قيمة الخلية قبل التعديل، إن وجدت. متاحة فقط إذا تم تعديلها النطاق عبارة عن خلية واحدة. ستكون غير محددة إذا لم تكن الخلية تحتوي على بيانات سابقة المحتوى.

1234
range

كائن Range، تمثل الخلية أو نطاق الخلايا التي تم تحريرها.

Range
source

Spreadsheet يمثل ملف "جداول بيانات Google" الذي يرتبط به النص البرمجي.

Spreadsheet
triggerUid

رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط)

4034124084959907503
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان)

amin@example.com
value

قيمة الخلية الجديدة بعد التعديل. متاحة فقط إذا كان النطاق الذي تم تعديله هو خلية واحدة.

10

إرسال النموذج

(قابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

FULL
namedValues

كائن يحتوي على أسماء الأسئلة وقيمها من عملية إرسال النموذج

{
  'First Name': ['Jane'],
  'Timestamp': ['6/7/2015 20:54:13'],
  'Last Name': ['Doe']
}
range

كائن Range، تمثل الخلية أو نطاق الخلايا التي تم تحريرها.

Range
triggerUid

رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث.

4034124084959907503
values

مصفوفة بالقيم بنفس الترتيب الذي تظهر به في جدول البيانات.

['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill',
'28', 'Susan', '25']

أحداث "مستندات Google"

تسمح العوامل المُشغِّلة لـ "مستندات Google" بالاستجابة عندما يفتح أحد المستخدمين مستندًا.

فتح

(بسيط وقابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

LIMITED
source

كائن Document، الذي يمثل ملف "مستندات Google" الذي يرتبط به النص البرمجي.

Document
triggerUid

رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط)

4034124084959907503
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان)

amin@example.com

أحداث "العروض التقديمية من Google"

تسمح المشغلات لتطبيق "العروض التقديمية من Google" بالاستجابة عند فتح المستخدم لعرض تقديمي.

فتح

(بسيط)
authMode

قيمة من التعداد ScriptApp.AuthMode.

LIMITED
source

كائن Presentation، الذي يمثل ملف العروض التقديمية من Google الذي يرتبط به النص البرمجي.

Presentation
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان)

amin@example.com

أحداث "نماذج Google"

تسمح عوامل التشغيل الخاصة بـ "نماذج Google" للنصوص البرمجية الاستجابة عندما يعدِّل أحد المستخدمين نموذجًا. أو يرسل ردًا.

فتح

* (بسيط وقابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

LIMITED
source

كائن Form، الذي يمثل ملف "نماذج Google" الذي يرتبط به النص البرمجي.

Form
triggerUid

رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط)

4034124084959907503
user

كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان)

amin@example.com

* لا يقع هذا الحدث عندما يفتح المستخدم نموذجًا للرد، وإنما يحدث عندما يفتح أحد المحررين النموذج لتعديله.

إرسال النموذج

(قابل للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

FULL
response

كائن FormResponse، تمثل رد المستخدم على النموذج ككل.

FormResponse
source

كائن Form، الذي يمثل ملف "نماذج Google" الذي يرتبط به النص البرمجي.

Form
triggerUid

رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث.

4034124084959907503

أحداث في "تقويم Google"

يتم تنشيط التقويم عند تحديث أحداث تقويم المستخدم (يتم إنشاؤه، أو تعديلها أو حذفها).

ولا تُطلعك هذه العوامل على الحدث الذي تم تغييره أو تغييره. بدلاً من ذلك، تشير إلى أن الرمز يحتاج إلى إجراء عملية مزامنة تزايدية لمعرفة التغييرات الأخيرة في التقويم. للحصول على وصف كامل من هذا الإجراء، راجع دليل مزامنة الموارد واجهة برمجة تطبيقات "تقويم Google".

للمزامنة مع "تقويم Google" في "برمجة تطبيقات Google"، عليك تنفيذ الخطوات التالية:

  1. تفعيل خدمة التقويم المتقدمة لـ لمشروع النص. يأتي الإصدار المدمَج خدمة التقويم غير كافية سير العمل هذا.
  2. حدِّد التقاويم التي يجب مزامنتها. لكل تقويم من هذا القبيل، إجراء مزامنة أولية باستخدام واجهة برمجة تطبيقات "تقويم Google" المتقدمة Events.list().
  3. تعرض نتيجة المزامنة الأولية رمز nextSyncToken لهذا التقويم. تخزين هذا الرمز المميّز لاستخدامه في وقت لاحق
  4. عند تنشيط مشغِّل "برمجة تطبيقات Google" EventUpdated للإشارة إلى تقويم تغيير الحدث، يمكنك إجراء مزامنة تزايدية للتقويم المتأثر باستخدام nextSyncToken المخزنة. هذا هو سيكون هناك أساسًا آخر Events.list() ، ولكن توفير nextSyncToken يحد من الاستجابة إلى الأحداث التي تغيرت منذ آخر مزامنة.
  5. فحص استجابة المزامنة لمعرفة الأحداث التي تم تعديلها وجعل التعليمات البرمجية تستجيب بشكل مناسب. على سبيل المثال، يمكنك تسجيل التغيير، تحديث جدول بيانات أو إرسال إشعارات عبر البريد الإلكتروني أو اتخاذ إجراءات أخرى.
  6. تحديث nextSyncToken الذي خزّنته لهذا التقويم باستخدام التقويم الذي تم عرضه من خلال طلب المزامنة التزايدي. يؤدي هذا إلى فرض عملية المزامنة التالية بإرجاع التغييرات الأحدث فقط.

EventUpdated

(قابل للتثبيت)
authMode

قيمة من ScriptApp.AuthMode تعداد.

FULL
calendarId

رقم تعريف السلسلة للتقويم الذي حدث فيه تعديل الحدث.

susan@example.com
triggerUid

رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث.

4034124084959907503

أحداث إضافات Google Workspace

يعمل مشغِّل onInstall() تلقائيًا عندما يثبّت المستخدم إضافة.

تثبيت

(بسيط)
authMode

قيمة من التعداد ScriptApp.AuthMode.

FULL

أحداث تطبيقات Google Chat

لمعرفة المزيد عن عناصر الأحداث في Google Chat، يُرجى مراجعة تلقّي التفاعلات والردّ عليها باستخدام تطبيق Google Chat

الأحداث المستندة إلى الوقت

عوامل التفعيل المستندة إلى الوقت (تسمى أيضًا مشغلات الساعة) تتيح تنفيذ النصوص البرمجية في وقت معين أو على فترة متكررة.

مستندة إلى الوقت (قابلة للتثبيت)
authMode

قيمة من التعداد ScriptApp.AuthMode.

FULL
day-of-month

بين 1 و31

نظرًا لأن اسم الخاصية يحتوي على شرطات، يجب الوصول إليها من خلال e['day-of-month'] بدلاً من الترميز النقطي

31
day-of-week

بين 1 (الاثنين) و7 (الأحد).

نظرًا لأن اسم الخاصية يحتوي على شرطات، يجب الوصول إليها من خلال e['day-of-week'] بدلاً من الترميز النقطي

7
hour

بين 0 و23

23
minute

بين 0 و59

59
month

بين 1 و12

12
second

بين 0 و59

59
timezone

المنطقة الزمنية.

UTC
triggerUid

رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث.

4034124084959907503
week-of-year

بين 1 و52

نظرًا لأن اسم الخاصية يحتوي على شرطات، يجب الوصول إليها من خلال e['week-of-year'] بدلاً من الترميز النقطي

52
year

السنة

2015