Enum AuthMode

AuthMode

تعداد يحدّد فئات الخدمات المعتمَدة التي يمكن لبرمجة تطبيقات تنفيذها من خلال دالة يتم تشغيلها. يتم عرض هذه القيم في الدوال التي يتم تشغيلها كسمة 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();
}

الخصائص

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