Enum AuthMode

AuthMode

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