gmail3 - Gmail Usage Analysis

This script analyzes your Gmail usage and provides a monthly report of where your email comes from. This is done using Google Apps Script which runs in Google's datacenters, consequently your email is not exported out of Google. The script populates a Google spreadsheet in your Drive and then performs queries against the data and sends you a monthly report.

Usage

1. Open the script: gmail3

2. Open up the main.gs file and run the main function, this will kick off the first run and when finished schedule a trigger in the future to run the script again. Once the first run is completed you can close the script and it should continue to run at regular intervals in Google's datacenters. Think of it as a cron job running at Google.

3. Wait for the report to arrive in your inbox. How long this will take depends on your email volume. For example if you receive 6000 emails a month, it may take two or more days to process your inbox and receive a report, this is because, Google restricts the amount of processing time you are allowed per day.

Removal

To remove the script open it up and run the resetScriptState function.

Development

1. Grab nodejs dependencies

npm install

1. Create a script project in your Google Drive called gmail3

• Create the following files in the gmail3 project, their contents do not matter, but the file must exist for gas-manager to upload successfully.
  • main
  • gmail3
  • gmail3MsgConsumers
  • vendor-moment
  • vendor-lodash
  • vendor-objDB

1. Setup gas-manager to allow uploading to Google Drive

gas init

1. Remove the files section from gas-project.json, as this information is provided by the Makefile

2. Run make to upload your checked out copy

3. Make some changes

4. Run make to upload your changes.

5. Test you changes

6. Submit a pull request