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