Unofficial Gmail Policy

Features

• Outlook-like retention policies for Gmail
• Trigger Google API jobs for threads, messages, and labels

Install using clasp 🔗

git clone --recurse-submodules https://github.com/skeletony007/UnofficialGmailPolicy.git
cd GmailPolicy

clasp create --type standalone
sed -i '' 's#}#,"filePushOrder":["'"$PWD"'/BatchRequest/BatchRequests.js","'"$PWD"'/GoogleApi.js","'"$PWD"'/GmailApi.js","'"$PWD"'/GmailUtil.js","'"$PWD"'/GmailPolicy.js","'"$PWD"'/GmailPolicyUI.js"]}#' .clasp.json
clasp push -f

Configure using Apps Script online 📜

Place the Config.gs as the final execution order file.

We define a function with time-based triggers to run the GmailPolicyUI instance. Visit https://script.google.com/home/triggers to set triggers. Since policies effect emails in day units, it is recommended to a the trigger to run daily.

Example config: using an anonymous function to speed up the policy execution

// the initialQuery parameter is optional and we will use it to only fetch
// threads from the last 28 days.
ui = new GmailPolicyUI({
  initialQuery: (() => {
    const dateWithinDays = new Date();
    dateWithinDays.setDate(dateWithinDays.getDate() - 28);
    // format dd/mm/yyyy
    return `after:${dateWithinDays.getDate()}/${dateWithinDays.getMonth() + 1}/${dateWithinDays.getFullYear()}`
  })()
});

Q&A

Q: Why use tanaikech/BatchRequest over Google JavaScript client library batching?

A: The Google Apps Script compiler does not seem to support the setup

Q: Why map users.threads.get over users.threads.list?

A: users.threads.get does not return message.internalDate, users.threads.get does. See message resource