Add getRedirectUri() method and note the issue mismatched project keys. Fixes issue #44.

Author: Eric Koleda

README.md

@@ -38,6 +38,13 @@ Where `{PROJECT KEY}` is the key of the script that is using this library. You
 can find your script's project key in the Apps Script code editor by clicking on
 the menu item "File > Project properties".
 
+**Warning**: Due to an
+[open issue](https://code.google.com/p/google-apps-script-issues/issues/detail?id=6098)
+in Apps Script, the project key shown in the Project properties dialog
+doesn't match the version the library uses. You can call the service's
+`getRedirectUri()` method to view the exact URL that the service will use when
+performing the OAuth flow. Register this version in addition to or in place of
+the version that uses the key shown in the dialog.
 
 ## Usage
 
@@ -190,8 +197,8 @@ See the [FitBit sample](samples/FitBit.gs) for the complete code.
 
 #### Modifying the access token payload
 Similar to Setting additional token headers, some services, such as the Smartsheet API, require you to [add a hash to the access token request payloads](http://smartsheet-platform.github.io/api-docs/?javascript#oauth-flow). The `setTokenPayloadHandler` method allows you to pass in a function to modify the payload of an access token request before the request is sent to the token endpoint:
- 
- 
+
+
     // Set the handler for modifying the access token request payload:
     .setTokenPayloadHandler(myTokenHandler)
 

samples/GooglePlus.gs

@@ -38,18 +38,18 @@ function getService() {
       // Set the endpoint URLs.
       .setAuthorizationBaseUrl('https://accounts.google.com/o/oauth2/auth')
       .setTokenUrl('https://accounts.google.com/o/oauth2/token')
-  
+
       // Set the client ID and secret.
       .setClientId(CLIENT_ID)
       .setClientSecret(CLIENT_SECRET)
-  
+
       // Set the name of the callback function that should be invoked to complete
       // the OAuth flow.
       .setCallbackFunction('authCallback')
 
       // Set the property store where authorized tokens should be persisted.
       .setPropertyStore(PropertiesService.getUserProperties())
-  
+
       // Set the scope and additional Google-specific parameters.
       .setScope('profile')
       .setParam('access_type', 'offline')
@@ -68,4 +68,12 @@ function authCallback(request) {
   } else {
     return HtmlService.createHtmlOutput('Denied');
   }
-}
+}
+
+/**
+ * Logs the redict URI to register in the Google Developers Console.
+ */
+function logRedirectUri() {
+  var service = getService();
+  Logger.log(service.getRedirectUri());
+}

src/Service.gs

@@ -94,7 +94,7 @@ Service_.prototype.setTokenHeaders = function(tokenHeaders) {
  */
 Service_.prototype.setTokenPayloadHandler = function(tokenHandler) {
   this.tokenPayloadHandler_ = tokenHandler;
-  return this; 
+  return this;
 };
 
 /**
@@ -257,7 +257,7 @@ Service_.prototype.getAuthorizationUrl = function() {
     'Authorization base URL': this.authorizationBaseUrl_
   });
 
-  var redirectUri = getRedirectUri(this.projectKey_);
+  var redirectUri = this.getRedirectUri();
   var state = eval('Script' + 'App').newStateToken()
       .withMethod(this.callbackFunctionName_)
       .withArgument('serviceName', this.serviceName_)
@@ -294,7 +294,7 @@ Service_.prototype.handleCallback = function(callbackRequest) {
     'Project key': this.projectKey_,
     'Token URL': this.tokenUrl_
   });
-  var redirectUri = getRedirectUri(this.projectKey_);
+  var redirectUri = this.getRedirectUri();
   var headers = {
     'Accept': this.tokenFormat_
   };
@@ -386,11 +386,21 @@ Service_.prototype.getLastError = function() {
   return this.lastError_;
 };
 
+/**
+ * Gets the last error that occurred this execution when trying to automatically refresh
+ * or generate an access token.
+ * @return {Exception} An error, if any.
+ */
+Service_.prototype.getRedirectUri = function() {
+  return getRedirectUri(this.projectKey_);
+};
+
 /**
  * Gets the token from a UrlFetchApp response.
  * @param {UrlFetchApp.HTTPResponse} response The response object.
  * @return {Object} The parsed token.
  * @throws If the token cannot be parsed or the response contained an error.
+ * @private
  */
 Service_.prototype.getTokenFromResponse_ = function(response) {
   var token = this.parseToken_(response.getContentText());