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

مشغّلات بسيطة وعوامل تشغيل قابلة للتثبيت تتيح لبرمجة التطبيقات تشغيل وظيفة تلقائيًا في حال وقوع حدث معيّن. عند تنشيط مشغِّل، تمرر "برمجة تطبيقات 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"، عليك تنفيذ الخطوات التالية:

  1. فعِّل خدمة "تقويم Google" المتقدمة لمشروع النص البرمجي. ولا تكفي خدمة "تقويم Google" المدمجة لسير العمل هذا.
  2. حدِّد التقاويم التي يجب مزامنتها. بالنسبة إلى كل تقويم كهذا، يمكنك إجراء عملية مزامنة أولية باستخدام طريقة Events.list() في خدمة "تقويم Google" المتقدمة.
  3. تعرض نتيجة المزامنة الأولية رمز nextSyncToken لهذا التقويم. تخزين هذا الرمز المميّز لاستخدامه في وقت لاحق
  4. عند تنشيط مشغِّل 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