gdrive-appdata
Javascript utility to store application data to Google Drive app data folder.
Including it in your app
The distribution file is inside the dist
folder (gdad.js
).
Including that file in your html file will expose a global variable named gdad
which is a factory.
Creating app data API
var appData =
API
The API consists of 2 straight forward methods: read
and save
.
Usually, the flow is: reading app data at the start of your app, and then save the data at some point in your app life cycle.
Reading app data
appData;
When the user has not authorized your app to save data in the google drive, read
will fail on first call.
When this happens, you must show an UI element (usually a button), on click of this element you should call appData.read()
again, and this time it will show the authorize popup.
Saving app data
appData.save(data);
data
must be a serializable object (JSON.stringify
must not fail on it)
What happens under the hood
read
has the following flow: authorize, load drive api, get app data file id or create app data file and get its id, and, finally, read app data.
save
has the same flow, except it saves the app data at the end.