Allow for arbitrary redirect URIs.

samples/Add-on/Code.gs

@@ -160,8 +160,7 @@ function authCallback(request) {
  * Logs the redict URI to register in the Google Developers Console.
  */
 function logRedirectUri() {
-  var service = getGitHubService();
-  Logger.log(service.getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }
 
 /**

samples/AdobeSign.gs

@@ -97,5 +97,5 @@ function authCallback(request) {
  * Logs the redict URI to register in the Dropbox application settings.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Basecamp.gs

@@ -69,5 +69,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/ChatWork.gs

@@ -81,5 +81,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/CloudIdentityAwareProxy.gs

@@ -98,5 +98,5 @@ function authCallback(request) {
  * Logs the redict URI to register in the Google Developers Console.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Dropbox.gs

@@ -74,5 +74,5 @@ function authCallback(request) {
  * Logs the redict URI to register in the Dropbox application settings.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Facebook.gs

@@ -73,5 +73,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/FitBit.gs

@@ -74,5 +74,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/GitHub.gs

@@ -67,5 +67,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/GooglePlus.gs

@@ -73,6 +73,6 @@ function authCallback(request) {
  * Logs the redict URI to register in the Google Developers Console.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }
 

samples/Harvest.gs

@@ -79,5 +79,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Jira.gs

@@ -109,5 +109,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/LinkedIn.gs

@@ -68,5 +68,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Medium.gs

@@ -75,5 +75,5 @@ function authCallback_(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Meetup.gs

@@ -73,5 +73,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/RingCentral.gs

@@ -82,5 +82,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Salesforce.gs

@@ -105,5 +105,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Smartsheet.gs

@@ -105,5 +105,5 @@ function smartsheetTokenHandler(payload) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Strava.gs

@@ -72,5 +72,5 @@ function authCallback_(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/UltraCart.gs

@@ -73,5 +73,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/VK.gs

@@ -73,5 +73,5 @@ function authCallback(request) {
  * Logs the redict URI to register in the VK Aps Page https://vk.com/apps?act=manage.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/WebApp/Code.gs

@@ -133,8 +133,7 @@ function authCallback(request) {
  * Logs the redict URI to register in the Google Developers Console.
  */
 function logRedirectUri() {
-  var service = getGitHubService();
-  Logger.log(service.getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }
 
 /**

samples/Wordpress.gs

@@ -68,5 +68,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Yahoo.gs

@@ -73,5 +73,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Yandex.gs

@@ -72,5 +72,5 @@ function authCallback(request) {
  * Logs the redict URI to register in the Yandex oAuth Page https://oauth.yandex.ru/client/new.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Zendesk.gs

@@ -78,5 +78,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/Zoom.gs

@@ -85,5 +85,5 @@ function authCallback(request) {
  * Logs the redict URI to register.
  */
 function logRedirectUri() {
-  Logger.log(getService().getRedirectUri());
+  Logger.log(OAuth2.getRedirectUri());
 }

samples/eBay.gs

@@ -0,0 +1,92 @@
+/*
+ * This sample demonstrates how to configure the library for the eBay API,
+ * using the authorization code flow to get a user access token.
+ * Instructions on how to generate OAuth credentuals is available here:
+ * https://developer.ebay.com/api-docs/static/oauth-qref-auth-code-grant.html
+ */
+
+var CLIENT_ID = '...'; // App ID
+var CLIENT_SECRET = '...'; // Cert ID
+var RU_NAME = '...'; // eBay Redirect URL name.
+
+/**
+ * Authorizes and makes a request to the Ebay API.
+ */
+function run() {
+  var service = getService();
+  if (service.hasAccess()) {
+    // Sandbox environment.
+    var url = 'https://api.sandbox.ebay.com/sell/inventory/v1/inventory_item';
+    var response = UrlFetchApp.fetch(url, {
+      headers: {
+        Authorization: 'Bearer ' + service.getAccessToken()
+      }
+    });
+    var result = JSON.parse(response.getContentText());
+    Logger.log(JSON.stringify(result, null, 2));
+  } else {
+    var authorizationUrl = service.getAuthorizationUrl();
+    Logger.log('Open the following URL and re-run the script: %s',
+        authorizationUrl);
+  }
+}
+
+/**
+ * Reset the authorization state, so that it can be re-tested.
+ */
+function reset() {
+  getService().reset();
+}
+
+/**
+ * Configures the service.
+ */
+function getService() {
+  return OAuth2.createService('eBay')
+      // Set the endpoint URLs (sandbox environment).
+      .setTokenUrl('https://api.sandbox.ebay.com/identity/v1/oauth2/token')
+      .setAuthorizationBaseUrl('https://signin.sandbox.ebay.com/authorize')
+
+      // Set the client ID and secret.
+      .setClientId(CLIENT_ID)
+      .setClientSecret(CLIENT_SECRET)
+
+      // Set the name of the callback function in the script referenced
+      // above 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 redirect URI to the RuName (eBay Redirect URL name).
+      .setRedirectUri(RU_NAME)
+
+      // Set the require scopes.
+      .setScope('https://api.ebay.com/oauth/api_scope/sell.inventory.readonly')
+
+      // Add a Basic Authorization header to token requests.
+      .setTokenHeaders({
+        Authorization: 'Basic ' +
+            Utilities.base64Encode(CLIENT_ID + ':' + CLIENT_SECRET)
+      });
+}
+
+/**
+ * Handles the OAuth2 callback.
+ */
+function authCallback(request) {
+  var service = getService();
+  var authorized = service.handleCallback(request);
+  if (authorized) {
+    return HtmlService.createHtmlOutput('Success!');
+  } else {
+    return HtmlService.createHtmlOutput('Denied.');
+  }
+}
+
+/**
+ * Logs the redict URI to register.
+ */
+function logRedirectUri() {
+  Logger.log(OAuth2.getRedirectUri());
+}

src/OAuth2.js

@@ -59,11 +59,13 @@ function createService(serviceName) {
 /**
  * Returns the redirect URI that will be used for a given script. Often this URI
  * needs to be entered into a configuration screen of your OAuth provider.
- * @param {string} scriptId The script ID of your script, which can be found in
- *     the Script Editor UI under "File > Project properties".
+ * @param {string} [optScriptId] The script ID of your script, which can be
+ *     found in the Script Editor UI under "File > Project properties". Defaults
+ *     to the script ID of the script being executed.
  * @return {string} The redirect URI.
  */
-function getRedirectUri(scriptId) {
+function getRedirectUri(optScriptId) {
+  var scriptId = optScriptId || ScriptApp.getScriptId();
   return 'https://script.google.com/macros/d/' + encodeURIComponent(scriptId) +
       '/usercallback';
 }

src/Service.js

@@ -33,7 +33,6 @@ var Service_ = function(serviceName) {
   this.params_ = {};
   this.tokenFormat_ = TOKEN_FORMAT.JSON;
   this.tokenHeaders_ = null;
-  this.scriptId_ = eval('Script' + 'App').getScriptId();
   this.expirationMinutes_ = 60;
 };
 
@@ -301,6 +300,27 @@ Service_.prototype.setGrantType = function(grantType) {
   return this;
 };
 
+/**
+ * Sets the URI to redirect to when the OAuth flow has completed. By default the
+ * library will provide this value automatically, but in some rare cases you may
+ * need to override it.
+ * @param {string} redirectUri The redirect URI.
+ * @return {Service_} This service, for chaining.
+ */
+Service_.prototype.setRedirectUri = function(redirectUri) {
+  this.redirectUri_ = redirectUri;
+  return this;
+};
+
+/**
+ * Returns the redirect URI that will be used for this service. Often this URI
+ * needs to be entered into a configuration screen of your OAuth provider.
+ * @return {string} The redirect URI.
+ */
+Service_.prototype.getRedirectUri = function() {
+  return this.redirectUri_ || getRedirectUri();
+};
+
 /**
  * Gets the authorization URL. The first step in getting an OAuth2 token is to
  * have the user visit this URL and approve the authorization request. The
@@ -313,12 +333,10 @@ Service_.prototype.setGrantType = function(grantType) {
 Service_.prototype.getAuthorizationUrl = function(optAdditionalParameters) {
   validate_({
     'Client ID': this.clientId_,
-    'Script ID': this.scriptId_,
     'Callback function name': this.callbackFunctionName_,
     'Authorization base URL': this.authorizationBaseUrl_
   });
 
-  var redirectUri = getRedirectUri(this.scriptId_);
   var stateTokenBuilder = eval('Script' + 'App').newStateToken()
       .withMethod(this.callbackFunctionName_)
       .withArgument('serviceName', this.serviceName_)
@@ -331,7 +349,7 @@ Service_.prototype.getAuthorizationUrl = function(optAdditionalParameters) {
   var params = {
     client_id: this.clientId_,
     response_type: 'code',
-    redirect_uri: redirectUri,
+    redirect_uri: this.getRedirectUri(),
     state: stateTokenBuilder.createToken()
   };
   params = extend_(params, this.params_);
@@ -358,15 +376,13 @@ Service_.prototype.handleCallback = function(callbackRequest) {
   validate_({
     'Client ID': this.clientId_,
     'Client Secret': this.clientSecret_,
-    'Script ID': this.scriptId_,
     'Token URL': this.tokenUrl_
   });
-  var redirectUri = getRedirectUri(this.scriptId_);
   var payload = {
     code: code,
     client_id: this.clientId_,
     client_secret: this.clientSecret_,
-    redirect_uri: redirectUri,
+    redirect_uri: this.getRedirectUri(),
     grant_type: 'authorization_code'
   };
   var token = this.fetchToken_(payload);
@@ -447,16 +463,6 @@ Service_.prototype.getLastError = function() {
   return this.lastError_;
 };
 
-/**
- * Returns the redirect URI that will be used for this service. Often this URI
- * needs to be entered into a configuration screen of your OAuth provider.
- * @return {string} The redirect URI.
- */
-Service_.prototype.getRedirectUri = function() {
-  return getRedirectUri(this.scriptId_);
-};
-
-
 /**
  * Fetches a new token from the OAuth server.
  * @param {Object} payload The token request payload.