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

مشغلات بسيطة تسمح المشغِّلات القابلة للتثبيت ببرمجة التطبيقات. تشغيل دالة تلقائيًا في حالة وقوع حدث معين. عندما يشتعل أحد المشغلات، تمرر "برمجة تطبيقات 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());
}

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

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

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

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

فتح (بسيط وقابل للتثبيت)
authMode	قيمة من التعداد ScriptApp.AuthMode. LIMITED
source	Spreadsheet يمثل ملف "جداول بيانات Google" الذي يرتبط به النص البرمجي. Spreadsheet
triggerUid	رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503
user	كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان). [e-mail]

تغيير (قابل للتثبيت)
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، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان) [e-mail]

تعديل (بسيط وقابل للتثبيت)
authMode	قيمة من التعداد ScriptApp.AuthMode. LIMITED
oldValue	قيمة الخلية قبل التعديل، إن وجدت. متاحة فقط إذا تم تعديلها النطاق عبارة عن خلية واحدة. ستكون غير محددة إذا لم تكن الخلية تحتوي على بيانات سابقة المحتوى. 1234
range	كائن Range، تمثل الخلية أو نطاق الخلايا التي تم تحريرها. Range
source	Spreadsheet يمثل ملف "جداول بيانات Google" الذي يرتبط به النص البرمجي. Spreadsheet
triggerUid	رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503
user	كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان) [e-mail]
value	قيمة الخلية الجديدة بعد التعديل. متاحة فقط إذا كان النطاق الذي تم تعديله هو خلية واحدة. 10

إرسال النموذج (قابل للتثبيت)
تنبيه: تأكَّد من استخدام عامل تشغيل إرسال النموذج هذا مع SpreadsheetTriggerBuilder.
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', '[e-mail]', 'Bob', '27', 'Bill', '28', 'Susan', '25']

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

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

فتح (بسيط وقابل للتثبيت)
authMode	قيمة من التعداد ScriptApp.AuthMode. LIMITED
source	كائن Document، الذي يمثل ملف "مستندات Google" الذي يرتبط به النص البرمجي. Document
triggerUid	رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503
user	كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان). [e-mail]

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

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

فتح (بسيط)
authMode	قيمة من التعداد ScriptApp.AuthMode. LIMITED
source	كائن Presentation، الذي يمثل ملف العروض التقديمية من Google الذي يرتبط به النص البرمجي. Presentation
user	كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان). [e-mail]

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

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

فتح * (بسيط وقابل للتثبيت)
authMode	قيمة من التعداد ScriptApp.AuthMode. LIMITED
source	كائن Form، الذي يمثل ملف "نماذج Google" الذي يرتبط به النص البرمجي. Form
triggerUid	رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503
user	كائن User، التي تمثل المستخدم النشط، إن توفرت (اعتمادًا على مجموعة معقدة من قيود الأمان). [e-mail]

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

إرسال النموذج (قابل للتثبيت)
تنبيه: تأكَّد من استخدام عامل تشغيل إرسال النموذج هذا مع FormTriggerBuilder.
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 الذي خزَّنته لهذا التقويم مع التقويم الذي تم عرضه من خلال طلب المزامنة التزايدي. يؤدي هذا إلى فرض عملية المزامنة التالية بإرجاع أحدث التغييرات فقط.

تنبيه: في بعض الأحيان، يتم إلغاء صلاحية الرموز المميزة للمزامنة بواسطة الخادم، ما يؤدي إلى خطأ 410 عندما يحدث هذا، يجب أن تجري التعليمة البرمجية مزامنة كاملة واستبدال جميع البيانات المتزامنة والرموز المميزة الخاصة بهذا التقويم

EventUpdated (قابل للتثبيت)
authMode	قيمة من ScriptApp.AuthMode تعداد. FULL
calendarId	رقم تعريف السلسلة للتقويم الذي حدث فيه تعديل الحدث. [e-mail]
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