处理 Gmail 插件中特定于用户的持久值

Question

我已经创建了简单的Gmail插件，现在我正在努力使用以下策略。

安装插件后，当第一个收件箱打开时，我们会询问用户的基本信息输入，当他打开第二个邮件时，我们不会再询问基本信息详细信息。

我该如何处理？

我试过物业服务，但没有运气。

更新

var MAX_THREADS = 5;
/**
* Returns the array of cards that should be rendered for the current
* e-mail thread. The name of this function is specified in the
* manifest 'onTriggerFunction' field, indicating that this function
* runs every time the add-on is started.
*
* @param {Object} e data provided by the Gmail UI.
* @returns {Card[]}
*/
function buildAddOn(e) {
// Activate temporary Gmail add-on scopes.
//Logger.log('E', Session.getActiveUser());
var accessToken = e.messageMetadata.accessToken;
GmailApp.setCurrentMessageAccessToken(accessToken);
var userProperties = PropertiesService.getUserProperties();
var Token = userProperties.getProperty('Token');
Logger.log('Token value:',typeof Token);
if(Token != null ){
var messageId = e.messageMetadata.messageId;
var senderData = extractSenderData(messageId);
var cards = [];
// Build a card for each recent thread from this email's sender.
if (senderData.recents.length > 0) {
senderData.recents.forEach(function(threadData) {
cards.push(buildRecentThreadCard(senderData.email, threadData));
});
} else {
// Present a blank card if there are no recent threads from
// this sender.
cards.push(CardService.newCardBuilder()
.setHeader(CardService.newCardHeader()
.setTitle('No recent threads from this sender')).build());
}
return cards;
} 
else{
var cards = []
var login_card = build_login_card()
cards.push(login_card);
return cards;
}
}
/**
*  This function builds a set of data about this sender's presence in your
*  inbox.
*
*  @param {String} messageId The message ID of the open message.
*  @return {Object} a collection of sender information to display in cards.
*/
function extractSenderData(messageId) {
// Use the Gmail service to access information about this message.
var mail = GmailApp.getMessageById(messageId);
var threadId = mail.getThread().getId();
var senderEmail = extractEmailAddress(mail.getFrom());
var recentThreads = GmailApp.search('from:' + senderEmail);
var recents = [];
// Retrieve information about up to 5 recent threads from the same sender.
recentThreads.slice(0,MAX_THREADS).forEach(function(thread) {
if (thread.getId() != threadId && ! thread.isInChats()) {
recents.push({
'subject': thread.getFirstMessageSubject(),
'count': thread.getMessageCount(),
'link': 'https://mail.google.com/mail/u/0/#inbox/' + thread.getId(),
'lastDate': thread.getLastMessageDate().toDateString()
});
}
});
var senderData = {
"email": senderEmail,
'recents': recents
};
return senderData;
}
/**
*  Given the result of GmailMessage.getFrom(), extract only the email address.
*  getFrom() can return just the email address or a string in the form
*  "Name <myemail@domain>".
*
*  @param {String} sender The results returned from getFrom().
*  @return {String} Only the email address.
*/
function extractEmailAddress(sender) {
var regex = /<([^@]+@[^>]+)>/;
var email = sender;  // Default to using the whole string.
var match = regex.exec(sender);
if (match) {
email = match[1];
}
return email;
}
/**
*  Builds a card to display information about a recent thread from this sender.
*
*  @param {String} senderEmail The sender email.
*  @param {Object} threadData Infomation about the thread to display.
*  @return {Card} a card that displays thread information.
*/
function buildRecentThreadCard(senderEmail, threadData) {
var card = CardService.newCardBuilder();
card.setHeader(CardService.newCardHeader().setTitle(threadData.subject));
var section = CardService.newCardSection()
.setHeader("<font color="#1257e0">Recent thread</font>");
section.addWidget(CardService.newTextParagraph().setText(threadData.subject));
section.addWidget(CardService.newKeyValue()
.setTopLabel('Sender')
.setContent(senderEmail));
section.addWidget(CardService.newKeyValue()
.setTopLabel('Number of messages')
.setContent(threadData.count.toString()));
section.addWidget(CardService.newKeyValue()
.setTopLabel('Last updated')
.setContent(threadData.lastDate.toString()));
var threadLink = CardService.newOpenLink()
.setUrl(threadData.link)
.setOpenAs(CardService.OpenAs.FULL_SIZE);
var button = CardService.newTextButton()
.setText('Open Thread')
.setOpenLink(threadLink);
section.addWidget(CardService.newButtonSet().addButton(button));
card.addSection(section);
return card.build();
}
function build_login_card(){
var card = CardService.newCardBuilder();
card.setHeader(CardService.newCardHeader().setTitle("Login Here"));
var userProperties = PropertiesService.getUserProperties();
var Token = userProperties.setProperty('Token',"Token");
return card.build()
}

Answer 1

根据注释，这里的主要问题是卸载加载项不会从 UserProperties 数据存储中删除位，因此如果重新安装加载项，则无法再次执行加载项配置步骤。

通用附加解决方案

如果这不是Gmail插件，则可以使用基于时间的触发器简单地解决此问题，因为根据文档：

附加组件触发器将在以下任何一种情况下停止触发：
- 如果用户卸载
了加载项 - 如果在文档中禁用了加载项(如果重新启用，触发器将再次运行)
- 如果开发人员取消发布加载项或将损坏的版本提交到加载项存储

即，您只需将当天的日期写到一个键上(例如LAST_SEEN) 每天PropertiesService#UserProperties，然后在决定显示哪张卡时检查 TOKEN 和 LAST_SEEN。

---

Gmail插件解决方案：

根据 Gmail 插件文档，您无法在 Gmail 插件中创建或使用应用脚本简单/可安装的触发器。因此，该解决方案的最简单实现不可用。但是，我们仍然可以使用此方法，方法是移动更新该LAST_SEEN键的区域。

目前(2018 年 3 月)，Gmail 插件唯一可用的触发器是上下文触发器unconditional：

目前，唯一可用的上下文触发器类型是无条件触发器，它触发器适用于所有电子邮件，而不考虑内容。

因此，如果您绑定到此上下文触发器，则在安装加载项时，每当用户打开电子邮件时，它都会运行一个函数。然后，解决方案是让上下文触发的函数包含代码段

PropertiesService.getUserProperties().setProperty("LAST_SEEN", String(new Date().getTime()));

如果您在上下文触发的函数中还有其他事情要做，则该代码将不受此添加的影响。如果您没有上下文触发的函数，则需要return [](空卡组)以避免显示任何 UI。

若要使用此新属性，除了正在使用的 TOKEN 属性外，还要在buildAddon(e)方法中查询此值：

var userProps = PropertiesService.getUserProperties().getAll();
var Token = userProps["Token"];
var lastSeen = userProps["LAST_SEEN"] || 0; // If found, will be milliseconds since epoch.
var absence = new Date().getTime() - lastSeen; // Time in ms since last use of add-on.
if (Token == null || absence > /* some duration you choose */ ) {
// New install, or user has started using app again.
return [build_login_card()];
} else {
// User is still using add-on, so do normal stuff.
}

---

• 这显然不是一个完美的解决方案(即uninstall上下文触发器会好得多)，但可以帮助检测缺乏使用的情况
• 写入属性服务的频率有速率限制。如果您有快速/"高级"用户，他们可能会触发配额。
  • 可以结合 CacheService 和 PropertiesService，在"短"会话(自上次存储到缓存以来长达 6 小时)中处理频繁读取。

Answer 2

罗伯特，你试过缓存用户输入吗？

我在事件处理程序中进行缓存。

function onDomainChange(e){
var cache = CacheService.getScriptCache();
Logger.log(e.formInput);
cache.put('domain',e.formInput.domain);
Logger.log(cache.get('domain'));
}

参考缓存文档