Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ojarva/google-backup

Drive/Gmail/Calendar backups
https://github.com/ojarva/google-backup

backup google-calendar google-drive gsuite

Last synced: 9 days ago
JSON representation

Drive/Gmail/Calendar backups

Host: GitHub
URL: https://github.com/ojarva/google-backup
Owner: ojarva
License: bsd-3-clause
Archived: true
Created: 2013-07-16T01:45:40.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2021-01-25T07:58:28.000Z (almost 4 years ago)
Last Synced: 2024-08-14T07:09:39.716Z (4 months ago)
Topics: backup, google-calendar, google-drive, gsuite
Language: Python
Size: 17.6 KB
Stars: 29
Watchers: 5
Forks: 5
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE.txt

Awesome Lists containing this project

jimsghstars - ojarva/google-backup - Drive/Gmail/Calendar backups (Python)

README

Backup for Google services
==========================

Current status
--------------

This collection of programs is no longer maintained, and contains multiple bugs. This was in use around 2014, but many things have changed since.

Overview
--------

Backs up Gmail/Drive/Calendar. Uses domain wide authentication, so no authorization
from Google Apps users is necessary. Emails are downloaded using modified offlineimap
and [XOAUTH2](https://developers.google.com/gmail/xoauth2_protocol).

Installation
------------

Google API authorization
------------------------

* Go to [Google API Console](https://code.google.com/apis/console/)
* Create new project
* Open "Services" and enable "Admin SDK" (for downloading list of users), "Calendar API", "Drive API" and "Drive SDK".
* Open "API Access" and create new client ID. Select "Service account". Save the private key to program folder. Remember to protect the private key appropriately.
* Take note of the first client ID and email address.
* Create a second client ID for getting list of users from directory API. Select "Installed application", "Other".
* Download second "client_secrets.json" using "Download JSON" link. Put "client_secrets.json" to program folder.

Next, domain-wide authorization:

* Open [Google Admin Console](https://admin.google.com/)
* Go to "Advanced tools", "Manage third party OAuth Client access" (https://www.google.com/a/cpanel/yourdomain.tld/ManageOauthClients). [More information.](http://support.google.com/a/bin/answer.py?hl=en&answer=162105)
* Paste the first client ID to "Client Name" and "https://mail.google.com/,https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/drive.readonly" to API scopes. Click "Authorize"

On the first run, authorization URL is printed out. Open the URL with admin user, check that only readonly access to your user list is required and click "Authorize". Copy authentication token and paste it back to the terminal.

Dependencies and settings
-------------------------

* pip install -r requirements.txt
* Move settings.py.sample to settings.py. Modify it with values obtained above from API console.

System Requirements
-------------------------
* Currently hardcoded to use zfs utility
* Requires [OfflineIMAP](http://offlineimap.org/) for email sync