يشير ذلك المصطلح إلى تعداد يحدِّد فئات الخدمات المعتمَدة التي يمكن لبرمجة التطبيقات تنفيذها من خلال دالة مُفعَّلة. ويتم عرض هذه القيم في الدوال المُفعّلة باعتبارها السمة 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(); }
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
NONE | Enum | وضع لا يسمح بالوصول إلى أي من الخدمات التي تتطلب إذنًا. يحدث هذا الوضع عندما تنفّذ إضافة عامل تشغيل onOpen(e) بسيط، ويثبّت المستخدم
إضافة في مستند مختلف ولكن لم يتم استخدام الإضافة في المستند الحالي. |
CUSTOM_FUNCTION | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في دوال جداول البيانات المخصصة. عادةً ما تتطلب بعض هذه الخدمات، بما في ذلك الوصول للقراءة فقط إلى خدمة جدول البيانات، الحصول على تفويض، ولكن يُسمح بها بدون إذن عند استخدامها في وظيفة مخصّصة. ولأن الدوال المخصَّصة لا تتضمن معلَمة حدث، لا يتم عرض هذه القيمة مطلقًا، ويتم توثيقها فقط لتوضيح أنّ الدوال المخصّصة تعمل في وضع التفويض الخاص بها. |
LIMITED | Enum | وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات. يحدث هذا الوضع عند تنفيذ إضافة أو نص برمجي مرتبط بمستند عامل تشغيل بسيط onOpen(e) أو onEdit(e) ، باستثناء الحالة الموضّحة في NONE . |
FULL | Enum | وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب الحصول على إذن. يحدث هذا الوضع عند تنفيذ إضافة أو نص برمجي كنتيجة لأي عامل تشغيل غير الحالات الموضّحة في LIMITED أو NONE . |