Enum AuthMode

AuthMode

شمارشی که مشخص می‌کند کدام دسته از سرویس‌های مجاز Apps Script می‌تواند از طریق یک تابع راه‌اندازی شده اجرا شود. این مقادیر در توابع راه اندازی شده به عنوان ویژگی authMode پارامتر رویداد ، e . برای اطلاعات بیشتر، راهنمای چرخه عمر مجوز برای افزونه‌ها را ببینید.

برای فراخوانی یک enum، کلاس والد، نام و ویژگی آن را فراخوانی می کنید. به عنوان مثال، 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();
}

خواص

اموال تایپ کنید توضیحات
NONE Enum حالتی که اجازه دسترسی به خدماتی که نیاز به مجوز دارند را نمی دهد. این حالت زمانی اتفاق می‌افتد که یک افزونه یک راه‌انداز ساده onOpen(e) را اجرا می‌کند، و کاربر افزونه‌ای را در سند دیگری نصب کرده است اما این افزونه در سند فعلی استفاده نشده است.
CUSTOM_FUNCTION Enum حالتی که امکان دسترسی به زیرمجموعه محدودی از خدمات را برای استفاده در عملکردهای صفحه گسترده سفارشی فراهم می کند. برخی از این سرویس‌ها - از جمله دسترسی فقط خواندنی به سرویس صفحه‌گسترده - معمولاً به مجوز نیاز دارند، اما وقتی در یک عملکرد سفارشی استفاده می‌شوند، بدون مجوز مجاز هستند. از آنجایی که توابع سفارشی شامل پارامتر رویداد نیستند، این مقدار هرگز برگردانده نمی شود. فقط برای نشان دادن اینکه توابع سفارشی در حالت مجوز خودشان اجرا می شوند مستند شده است.
LIMITED Enum حالتی که امکان دسترسی به زیرمجموعه محدودی از خدمات را فراهم می کند. این حالت زمانی رخ می‌دهد که یک افزونه یا یک اسکریپت متصل به یک سند، یک راه‌انداز ساده onOpen(e) یا onEdit(e) را اجرا می‌کند، به جز در موردی که برای NONE توضیح داده شده است.
FULL Enum حالتی که امکان دسترسی به تمام خدماتی که نیاز به مجوز دارند را می دهد. این حالت زمانی رخ می‌دهد که یک افزونه یا یک اسکریپت در نتیجه هر راه‌اندازی غیر از مواردی که برای LIMITED یا NONE توضیح داده شده است، اجرا می‌شود.