قائمة تحدّد فئات الخدمات المعتمَدة التي يمكن لخدمة Apps Script
تنفيذها من خلال دالة يتم تنشيطها. يتم عرض هذه القيم في الدوالّ التي يتم تنشيطها على أنّها السمة auth
لمَعلمة الحدث، e
. لمزيد من المعلومات، يُرجى الاطّلاع على دليل دورة حياة
التفويض في الإضافات.
لاستدعاء قائمة أرقام صحيحة، عليك استدعاء الصف الرئيسي والاسم والخاصية. مثلاً:
ScriptApp.AuthMode.CUSTOM_FUNCTION
function onOpen(e) { const 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). const properties = PropertiesService.getDocumentProperties(); const 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 | وضع لا يسمح بالوصول إلى أي خدمات تتطلّب تفويضًا يحدث هذا الوضع
عندما تنفِّذ إضافة on مشغِّل بسيطًا، ويثبِّت المستخدم
إضافة في مستند مختلف ولكن لم يتم استخدام الإضافة في المستند الحالي. |
CUSTOM_FUNCTION | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في وظائف جدول البيانات المخصّصة تتطلّب بعض هذه الخدمات، بما في ذلك الوصول للقراءة فقط إلى خدمة "جداول بيانات Google"، عادةً الحصول على إذن، ولكن يُسمح باستخدامها بدون إذن عند استخدامها في دالة مخصّصة. بما أنّ الدوالّ المخصّصة لا تتضمّن مَعلمة حدث، لا يتم أبدًا عرض هذه القيمة، ويتم توثيقها فقط لإثبات أنّ الدوالّ المخصّصة يتم تنفيذها في وضع التفويض الخاص بها. |
LIMITED | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات يحدث هذا الوضع عندما تنفِّذ إضافة أو
نص برمجي مرتبط بمستند عامل تشغيل بسيطًا من النوع on أو on ، باستثناء الحالة الموضّحة في NONE . |
FULL | Enum | وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب تفويضًا يحدث هذا الوضع عند تنفيذ
إضافة أو نص برمجي نتيجةً لأي عامل تشغيل غير الحالات الموضّحة في
LIMITED أو NONE . |