How to interpret and resolve the "Invalid Grant" error for Google Data Sources

THE "INVALID GRANT" ERROR MAY BE RETURNED FOR THE FOLLOWING REASONS

The user revoked your access

HOW TO

How to interpret this error

This happens when the user that connected the Google Data Source in Databox has their permissions changed or revoked to the Google Account. Since Databox gains access to your Google data through this user, it is imperative that they have the necessary permissions.

How to resolve this error

Contact an Admin in your Google Account to restore your original user permissions. Once that's complete, navigate to the Data Manager and click the Reconnect button to reconnect your Google Data Source.

The refresh token has not been used for six months

HOW TO

How to interpret this error

This happens when your refresh token is inactive. It is rare that this will be the reason for the error in Databox. However, if your Account expires or you have no Google Metrics used anywhere in your Account, this could be the case. 

How to resolve this error

Navigate to the Data Manager and click the Reconnect button to reconnect your Google Data Source and establish an active refresh token.

The user changed passwords and the refresh token contains Gmail scopes

HOW TO

How to interpret this error

This happens when the user that connected the Google Data Source in Databox changes their Google password. Since Databox gains access to your Google data through this user's credentials, it is imperative that they are up-to-date. 

How to resolve this error

Navigate to the Data Manager and click the Reconnect button to reconnect your Google Data Source with your updated credentials. 

The user has exceeded the maximum number of granted (live) refresh tokens

This is the most common reason why the "Invalid Grant" error is returned from Google Analytics. 

HOW TO

How to interpret this error

Once the 101st connection is initiated, the user's connection limit is exceeded. When this happens, the oldest Google connection (i.e., the 1st connection by the user) is automatically disconnected. If the same user connects a 102nd Google Account, the 2nd connection they made will automatically become disconnected as well. This will continue in order to ensure that a single Google user only has a maximum of 100 active Google connections at any given time.

How to resolve this error

In order to resolve this error and prevent future occurrences, you'll need to limit the number of connections that each Google user makes. If needed, you can create additional users in Google and use those to add more Google connections. For example, you may make it part of your process to create a new Google user for every 85 connections. (this will give you some margin for error). Once you've established 85 connections with that Google user, you can create a new user and continue adding connections.