تعداد يحدد فئات الخدمات المعتمَدة التي تستطيع "برمجة التطبيقات" تنفيذها
تنفيذه من خلال دالة مشغَّلة. تظهر هذه القيم في الدوال المشغّلة مثل authMode
سمة مَعلمة الحدث، e
. بالنسبة
على مزيد من المعلومات، راجِع دليل
دورة حياة التفويض للإضافات.
لاستدعاء تعداد، يمكنك استدعاء الفئة الأصل والاسم والخاصية. مثلاً:
ScriptApp.AuthMode.CUSTOM_FUNCTION
function onOpen(e) { var menu = SpreadsheetApp.getUi().createAddonMenu(); if (e && e.authMode == ScriptApp.AuthMode.NONE) { // Add a normal menu item (works in all authorization modes). menu.addItem('Start workflow', 'startWorkflow'); } else { // Add a menu item based on properties (doesn't work in AuthMode.NONE). var properties = PropertiesService.getDocumentProperties(); var workflowStarted = properties.getProperty('workflowStarted'); if (workflowStarted) { menu.addItem('Check workflow status', 'checkWorkflow'); } else { menu.addItem('Start workflow', 'startWorkflow'); } // Record analytics. UrlFetchApp.fetch('http://www.example.com/analytics?event=open'); } menu.addToUi(); }
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
NONE | Enum | وضع لا يسمح بالوصول إلى أي خدمات تتطلب إذنًا. يحدث هذا الوضع
عندما تنفّذ إحدى الإضافات مشغِّل onOpen(e) البسيط، ويثبّت المستخدم
في مستند مختلف ولكن لم يتم استخدام الإضافة في المستند الحالي. |
CUSTOM_FUNCTION | Enum | يشير هذا المصطلح إلى وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في جدول بيانات مخصّص. الأخرى. بعض هذه الخدمات — بما في ذلك حق الوصول للقراءة فقط إلى خدمة جدول البيانات — تتطلب عادةً إذنًا، ولكن يُسمح باستخدامها في ملف شخصي بدون إذن الأخرى. بما أنّ الدوال المخصّصة لا تتضمّن مَعلمة حدث، لا يمكن أن تكون هذه القيمة أبدًا returned; لا يتم توثيقه إلا لتوضيح أنّ الدوال المخصّصة تعمل بشكلٍ مستقل وضع التفويض. |
LIMITED | Enum | يشير هذا المصطلح إلى وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات. يحدث هذا الوضع عندما تحصل إضافة أو
ينفِّذ النص البرمجي bound إلى مستند مشغِّل onOpen(e) أو onEdit(e) بسيطًا، باستثناء الحالة الموضّحة للسمة NONE . |
FULL | Enum | يشير ذلك المصطلح إلى وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب إذنًا. يحدث هذا الوضع عندما
أو يتم تنفيذ نص برمجي كنتيجة لأي تشغيل بخلاف الحالات الموضحة
LIMITED أو NONE |