1.41.0

Author: Eric Koleda

dist/OAuth2.gs

@@ -126,6 +126,7 @@ var Service_ = function(serviceName) {
   this.params_ = {};
   this.tokenFormat_ = TOKEN_FORMAT.JSON;
   this.tokenHeaders_ = null;
+  this.tokenMethod_ = 'post';
   this.expirationMinutes_ = 60;
 };
 
@@ -199,6 +200,17 @@ Service_.prototype.setTokenHeaders = function(tokenHeaders) {
   return this;
 };
 
+/**
+ * Sets the HTTP method to use when retrieving or refreshing the access token.
+ * Default: "post".
+ * @param {string} tokenMethod The HTTP method to use.
+ * @return {!Service_} This service, for chaining.
+ */
+Service_.prototype.setTokenMethod = function(tokenMethod) {
+  this.tokenMethod_ = tokenMethod;
+  return this;
+};
+
 /**
  * @callback tokenHandler
  * @param tokenPayload {Object} A hash of parameters to be sent to the token
@@ -601,7 +613,7 @@ Service_.prototype.fetchToken_ = function(payload, optUrl) {
     payload = this.tokenPayloadHandler_(payload);
   }
   var response = UrlFetchApp.fetch(url, {
-    method: 'post',
+    method: this.tokenMethod_,
     headers: headers,
     payload: payload,
     muteHttpExceptions: true

docs/Service_.html

@@ -4763,6 +4763,161 @@ <h5>Parameters:</h5>
 
 
 
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+</dl>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<h5>Returns:</h5>
+
+        
+<div class="param-desc">
+    This service, for chaining.
+</div>
+
+
+
+<dl>
+    <dt>
+        Type
+    </dt>
+    <dd>
+        
+<span class="param-type"><a href="Service_.html">Service_</a></span>
+
+
+    </dd>
+</dl>
+
+    
+
+
+
+
+
+        
+            
+
+    
+
+    
+    <h4 class="name" id="setTokenMethod"><span class="type-signature"></span>setTokenMethod<span class="signature">(tokenMethod)</span><span class="type-signature"> &rarr; (non-null) {<a href="Service_.html">Service_</a>}</span></h4>
+    
+
+    
+
+
+
+<div class="description">
+    Sets the HTTP method to use when retrieving or refreshing the access token.
+Default: "post".
+</div>
+
+
+
+
+
+
+
+
+
+    <h5>Parameters:</h5>
+    
+
+<table class="params">
+    <thead>
+    <tr>
+        
+        <th>Name</th>
+        
+
+        <th>Type</th>
+
+        
+
+        
+
+        <th class="last">Description</th>
+    </tr>
+    </thead>
+
+    <tbody>
+    
+
+        <tr>
+            
+                <td class="name"><code>tokenMethod</code></td>
+            
+
+            <td class="type">
+            
+                
+<span class="param-type">string</span>
+
+
+            
+            </td>
+
+            
+
+            
+
+            <td class="description last">The HTTP method to use.</td>
+        </tr>
+
+    
+    </tbody>
+</table>
+
+
+
+
+
+
+<dl class="details">
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
+
+    
 
 
 
@@ -5151,7 +5306,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Service_.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Mon Dec 14 2020 20:48:15 GMT-0500 (Eastern Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Fri May 14 2021 09:53:29 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/Storage_.html

@@ -1035,7 +1035,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Service_.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Mon Dec 14 2020 20:48:15 GMT-0500 (Eastern Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Fri May 14 2021 09:53:29 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/global.html

@@ -1716,7 +1716,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Service_.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Mon Dec 14 2020 20:48:15 GMT-0500 (Eastern Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Fri May 14 2021 09:53:29 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

docs/index.html

@@ -284,9 +284,14 @@ <h4>Setting additional token headers</h4>
 });
 </code></pre>
 <p>See the <a href="samples/FitBit.gs">FitBit sample</a> for the complete code.</p>
+<h4>Setting the token HTTP method</h4>
+<p>Almost all services use the <code>POST</code> HTTP method when retrieving the access token,
+but a few services deviate from the spec and use the <code>PUT</code> method instead. To
+accomodate those cases you can use the <code>setTokenMethod()</code> method to specify the
+HTTP method to use when making the request.</p>
 <h4>Modifying the access token payload</h4>
 <p>Some OAuth providers, such as the Smartsheet API, require you to
-<a href="">add a hash to the access token request payloads</a>.
+<a href="https://smartsheet-platform.github.io/api-docs/#request-an-access-token">add a hash to the access token request payloads</a>.
 The <code>setTokenPayloadHandler</code> 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:</p>
@@ -821,7 +826,7 @@ <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Service_.
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Mon Dec 14 2020 20:48:15 GMT-0500 (Eastern Standard Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.4</a> on Fri May 14 2021 09:53:29 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "apps-script-oauth2",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "OAuth2 for Apps Script is a library for Google Apps Script that provides the ability to create and authorize OAuth2 tokens as well as refresh them when they expire.",
   "repository": {
     "type": "git",