مشغّلات بسيطة وعوامل تشغيل قابلة للتثبيت تتيح لبرمجة التطبيقات
تشغيل وظيفة تلقائيًا في حال وقوع حدث معيّن. عند تنشيط مشغِّل، تمرر "برمجة تطبيقات 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 |
قيمة من التعداد LIMITED |
source |
عنصر Spreadsheet |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503 |
user |
كائن amin@example.com |
تغيير(قابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد FULL |
changeType |
نوع التغيير ( INSERT_ROW |
source |
كائن
Spreadsheet |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث. 4034124084959907503 |
user |
كائن amin@example.com |
تعديل(بسيط وقابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد LIMITED |
oldValue |
قيمة الخلية قبل التعديل، إن وُجدت لا يتوفّر هذا الخيار إلا إذا كان النطاق الذي تم تعديله مكوّنًا من خلية واحدة. سيكون غير محدّد إذا لم تكن الخلية تحتوي على محتوى سابق. 1234 |
range |
كائن Range |
source |
عنصر Spreadsheet |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503 |
user |
كائن amin@example.com |
value |
قيمة الخلية الجديدة بعد التعديل. ولا يتوفّر هذا الخيار إلا إذا كان النطاق الذي تم تعديله مكوّنًا من خلية واحدة. 10 |
إرسال النموذج(قابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد FULL |
namedValues |
كائن يحتوي على أسماء الأسئلة وقيمها من عملية إرسال النموذج { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
كائن Range |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث. 4034124084959907503 |
values |
مصفوفة بالقيم بنفس الترتيب الذي تظهر به في جدول البيانات. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
أحداث "مستندات Google"
تسمح العوامل المُشغِّلة لـ "مستندات Google" بالاستجابة عندما يفتح أحد المستخدمين مستندًا.
فتح(بسيط وقابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد LIMITED |
source |
عنصر Document |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503 |
user |
كائن amin@example.com |
أحداث "العروض التقديمية من Google"
تسمح المشغلات لتطبيق "العروض التقديمية من Google" بالاستجابة عند فتح المستخدم لعرض تقديمي.
فتح(بسيط) |
|
---|---|
authMode |
قيمة من التعداد LIMITED |
source |
كائن Presentation |
user |
كائن amin@example.com |
أحداث "نماذج Google"
تسمح عوامل التشغيل الخاصة بـ "نماذج Google" للنصوص البرمجية الاستجابة عندما يعدِّل أحد المستخدمين نموذجًا أو يرسل ردًا.
فتح* (بسيط وقابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد LIMITED |
source |
عنصر Form |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدّى إلى إنشاء هذا الحدث (المشغِّلات القابلة للتثبيت فقط) 4034124084959907503 |
user |
كائن amin@example.com |
* لا يقع هذا الحدث عندما يفتح المستخدم نموذجًا للرد، وإنما عندما يفتح المحرِّر النموذج لتعديله.
إرسال النموذج(قابل للتثبيت) |
|
---|---|
authMode |
قيمة من التعداد FULL |
response |
تمثّل هذه السمة كائن FormResponse |
source |
عنصر Form |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث. 4034124084959907503 |
أحداث في "تقويم Google"
يتم تنشيط التقويم عندما يتم تحديث أحداث تقويم المستخدم (يتم إنشاؤها أو تعديلها أو حذفها).
ولا تُطلعك هذه العوامل على الحدث الذي تم تغييره أو تغييره. بدلاً من ذلك، تشير إلى أن الرمز يحتاج إلى إجراء عملية مزامنة تزايدية لاختيار التغييرات الأخيرة في التقويم. للحصول على وصف كامل لهذا الإجراء، يُرجى الاطّلاع على دليل مزامنة الموارد الخاص بواجهة برمجة تطبيقات التقويم.
للمزامنة مع "تقويم Google" في "برمجة تطبيقات Google"، عليك تنفيذ الخطوات التالية:
- فعِّل خدمة "تقويم Google" المتقدمة لمشروع النص البرمجي. ولا تكفي خدمة "تقويم Google" المدمجة لسير العمل هذا.
- حدِّد التقاويم التي يجب مزامنتها. بالنسبة إلى كل تقويم كهذا، يمكنك إجراء عملية مزامنة أولية باستخدام طريقة Events.list() في خدمة "تقويم Google" المتقدمة.
- تعرض نتيجة المزامنة الأولية رمز
nextSyncToken
لهذا التقويم. تخزين هذا الرمز المميّز لاستخدامه في وقت لاحق - عند تنشيط مشغِّل
EventUpdated
لبرمجة التطبيقات للإشارة إلى تغيير حدث في التقويم، يمكنك إجراء مزامنة تزايدية للتقويم المتأثر باستخدامnextSyncToken
المحفوظ. وهذا في الأساس طلب آخر من نوع Events.list()، إلا أنّ توفيرnextSyncToken
يحصر الاستجابة بالأحداث التي تغيّرت منذ آخر مزامنة فقط. - افحص استجابة المزامنة لمعرفة الأحداث التي تم تحديثها ولكي تستجيب التعليمات البرمجية لديك بشكل مناسب. على سبيل المثال، يمكنك تسجيل التغيير أو تحديث جدول بيانات أو إرسال إشعارات عبر البريد الإلكتروني أو اتخاذ إجراءات أخرى.
- يمكنك تحديث
nextSyncToken
الذي خزّنته لهذا التقويم باستخدام التقويم الذي يعرضه طلب المزامنة التزايدية. يفرض ذلك على عملية المزامنة التالية أن تعرض أحدث التغييرات فقط.
EventUpdated(قابل للتثبيت) |
|
---|---|
authMode |
تمثّل هذه السمة قيمة من التعداد
FULL |
calendarId |
رقم تعريف السلسلة للتقويم الذي حدث فيه تعديل الحدث. susan@example.com |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث. 4034124084959907503 |
أحداث إضافات Google Workspace
يتم تشغيل مشغّل onInstall()
تلقائيًا
عندما يثبّت المستخدم إضافة.
تثبيت(بسيط) |
|
---|---|
authMode |
قيمة من التعداد FULL |
أحداث تطبيقات Google Chat
للمزيد من المعلومات عن عناصر الأحداث في Google Chat، يُرجى الاطّلاع على تلقّي التفاعلات مع تطبيق Google Chat والردّ عليها.
الأحداث المستندة إلى الوقت
عوامل التشغيل المستندة إلى الوقت (المعروفة أيضًا باسم مشغلات الساعة) تسمح بتنفيذ النصوص البرمجية في وقت معيّن أو على فاصل زمني متكرر.
مستندة إلى الوقت (قابلة للتثبيت) | |
---|---|
authMode |
قيمة من التعداد FULL |
day-of-month |
بين بما أنّ اسم السمة هذا يحتوي على شرطات، يجب الوصول إليها من خلال
31 |
day-of-week |
بين بما أنّ اسم السمة هذا يحتوي على شرطات، يجب الوصول إليها من خلال
7 |
hour |
بين 23 |
minute |
بين 59 |
month |
بين 12 |
second |
بين 59 |
timezone |
المنطقة الزمنية. UTC |
triggerUid |
رقم تعريف العامل المشغِّل الذي أدى إلى إنشاء هذا الحدث. 4034124084959907503 |
week-of-year |
بين بما أنّ اسم السمة هذا يحتوي على شرطات، يجب الوصول إليها من خلال
52 |
year |
السنة 2015 |