ga-service-acct
v2.5.0
Published
Google Analytics REST API via service account
Downloads
68
Maintainers
Readme
Google Analytics REST API via service accounts
This library provides tools to use the Google Analytics REST API (GET only).
Use of the REST API requires authentication, and this module provides an implementation of Google's oAuth instructions for 'service accounts' (instead of using the Google api for Node library).
There are two additional steps you need to setup to use this code:
1. Convert secret key
After creating the service email, you will download a .p12
key file that needs to be converted to a .pem
file using:
openssl pkcs12 -in privatekey.p12 -nodes -nocerts > privatekey.pem
openssl will ask for the private key, which Google has probably told you is 'notasecret'
The code relies upon Json Web tokens and uses the contents of the .pem
file to sign the request object which is sent to Google for an access token.
2. Provide service user access
Use the online GA Admin tools "User Management" module to give your service user read access to your GA data (you will need yourself to have management rights to make this change).
Example of usage
var fs = require('fs');
var Report = require('ga-service-cert');
var SERVICE_EMAIL = "[email protected]";
var query = {
'ids': 'ga:123456', // Update ids with your own view information
'start-date': '2015-02-24',
'end-date': '2015-03-10',
'metrics': 'ga:users'
};
var private_key = fs.readFileSync(__dirname+'/privatekey.pem', "utf8");
var report = new Report(private_key, SERVICE_EMAIL, true);
report.on('ready', function() {
report.get(query, function(err, data) {
if (err) throw err
console.log(data); // e.g. [ [ '5140' ] ]
});
// Alternative version using a Promise
report.get(query)
.then( data => console.log(data) ) // e.g. [ [ '5140' ] ]
.catch( err => console.error(err) );
});
report.on('auth_error', function(err) {
console.log(".test: auth_error", err);
router.get('/*', (req, res) => res.status(500).send("Unable to connect to Google"));
});
Management data
From version version 0.4, the code implements the simplest management API call (more to follow once I find a use case).
report.getManagement(null, function(err, data) {
if (err) throw err
console.log(data.kind); // e.g. 'analytics#accounts'
});
Change log
- 2.4.0 - .get can also return a Promise
- 2.3.0 - Replaced babel polyfill with runtime
- 2.2.1 - Removed private data from tests
- 2.2.0 - Added tests (unusable without my private key)
- 2.1.1 - Removed console statements from production code
- 2.1.0 - Code improvements
- 2.0.0 - Switch to ES6 Promises (with Babel polyfill for Node 0.10) from async
- 1.2.0 - Switched to ES6 for development; shipping with transpiled file
- 1.0.0 - Breaking change: constructor bow takes the key, rather than filename (to work better with e.g. system variables)
- 0.4.1 - updated jwt to 5.0 and fixed bug in iat time
- 0.4.0 - Added management data method
ToDo
- Factor out token acquisition into separate module