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