Enum AuthMode

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
وضع المصادقة

تعداد يحدد فئات خدمات "برمجة تطبيقات 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();
}

أماكن إقامة

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