Перечисление, определяющее, какие категории авторизованных служб Apps Script может выполнять с помощью триггерной функции. Эти значения предоставляются в триггерных функциях как свойство authMode
параметра события , e
. Дополнительные сведения см. в руководстве по жизненному циклу авторизации для надстроек .
Чтобы вызвать перечисление, вы вызываете его родительский класс, имя и свойство. Например, 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 . |