یک شمارش که مشخص میکند کدام دسته از سرویسهای مجاز 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 توضیح داده شد، اجرا شود. |