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();
}

أماكن إقامة

الموقعالنوعالوصف
NONEEnumوضع لا يسمح بالوصول إلى أي خدمات تتطلب إذنًا. يحدث هذا الوضع عندما تنفّذ إحدى الإضافات مشغِّل onOpen(e) البسيط، ويثبّت المستخدم في مستند مختلف ولكن لم يتم استخدام الإضافة في المستند الحالي.
CUSTOM_FUNCTIONEnumيشير هذا المصطلح إلى وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات لاستخدامها في جدول بيانات مخصّص. الأخرى. بعض هذه الخدمات — بما في ذلك حق الوصول للقراءة فقط إلى خدمة جدول البيانات — تتطلب عادةً إذنًا، ولكن يُسمح باستخدامها في ملف شخصي بدون إذن الأخرى. بما أنّ الدوال المخصّصة لا تتضمّن مَعلمة حدث، لا يمكن أن تكون هذه القيمة أبدًا returned; لا يتم توثيقه إلا لتوضيح أنّ الدوال المخصّصة تعمل بشكلٍ مستقل وضع التفويض.
LIMITEDEnumيشير هذا المصطلح إلى وضع يسمح بالوصول إلى مجموعة فرعية محدودة من الخدمات. يحدث هذا الوضع عندما تحصل إضافة أو ينفِّذ النص البرمجي bound إلى مستند مشغِّل onOpen(e) أو onEdit(e) بسيطًا، باستثناء الحالة الموضّحة للسمة NONE.
FULLEnumيشير ذلك المصطلح إلى وضع يسمح بالوصول إلى جميع الخدمات التي تتطلّب إذنًا. يحدث هذا الوضع عندما أو يتم تنفيذ نص برمجي كنتيجة لأي تشغيل بخلاف الحالات الموضحة LIMITED أو NONE