Enum AuthMode

AuthMode

قائمة تحدّد فئات الخدمات المعتمَدة التي يمكن لخدمة Apps Script تنفيذها من خلال دالة يتم تنشيطها. يتم عرض هذه القيم في الدوالّ التي يتم تنشيطها على أنّها السمة authMode لمَعلمة الحدث، 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();
}

أماكن إقامة

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