Enum AuthMode

حالت احراز هویت

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

برای فراخوانی یک enum، کلاس والد، نام و ویژگی آن را فراخوانی می‌کنید. برای مثال، 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 حالتی که اجازه دسترسی به هیچ سرویسی که نیاز به مجوز دارد را نمی‌دهد. این حالت زمانی اتفاق می‌افتد که یک افزونه، یک تریگر ساده on Open(e) اجرا می‌کند و کاربر افزونه‌ای را در سند دیگری نصب کرده است اما آن افزونه در سند فعلی استفاده نشده است.
CUSTOM_FUNCTION Enum حالتی که امکان دسترسی به زیرمجموعه محدودی از سرویس‌ها را برای استفاده در توابع سفارشی صفحه‌گسترده فراهم می‌کند. برخی از این سرویس‌ها - از جمله دسترسی فقط خواندنی به سرویس صفحه‌گسترده - معمولاً نیاز به مجوز دارند، اما هنگام استفاده در یک تابع سفارشی، بدون مجوز مجاز هستند. از آنجا که توابع سفارشی شامل پارامتر رویداد نیستند، این مقدار هرگز بازگردانده نمی‌شود. این فقط برای نشان دادن اینکه توابع سفارشی در حالت مجوز خود اجرا می‌شوند، مستند شده است.
LIMITED Enum حالتی که امکان دسترسی به زیرمجموعه محدودی از سرویس‌ها را فراهم می‌کند. این حالت زمانی اتفاق می‌افتد که یک افزونه یا اسکریپت متصل به یک سند، یک تریگر ساده را on Open(e) یا on Edit(e) اجرا کند، به جز در موردی که برای NONE توضیح داده شد.
FULL Enum حالتی که امکان دسترسی به تمام سرویس‌هایی که نیاز به مجوز دارند را فراهم می‌کند. این حالت زمانی اتفاق می‌افتد که یک افزونه یا اسکریپت در نتیجه‌ی هر تریگر دیگری غیر از مواردی که برای LIMITED یا NONE توضیح داده شد، اجرا شود.