Add a RingCentral samples.

Author: Eric Koleda

samples/RingCentral.gs

@@ -0,0 +1,86 @@
+/**
+ * Demonstrates how to authorize access to the RingCentral API using the sandbox
+ * environment.
+ * @see http://ringcentral-api-docs.readthedocs.io/en/latest/oauth/
+ */
+
+var CLIENT_ID = '...';
+var CLIENT_SECRET = '...';
+
+// The server to send requests to, currently the sandbox.
+var SERVER = 'https://platform.devtest.ringcentral.com';
+
+/**
+ * Authorizes and makes a request to the RingCentral API.
+ */
+function run() {
+  var service = getService();
+  if (service.hasAccess()) {
+    var url = SERVER + '/restapi/v1.0/account/~';
+    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('RingCentral')
+      // Set the endpoint URLs.
+      .setAuthorizationBaseUrl(SERVER + '/restapi/oauth/authorize')
+      .setTokenUrl(SERVER + '/restapi/oauth/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 required authorization header.
+      .setTokenHeaders({
+        'Authorization': 'Basic ' +
+            Utilities.base64EncodeWebSafe(CLIENT_ID + ':' + CLIENT_SECRET)
+      });
+}
+
+/**
+ * Handles the OAuth 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(getService().getRedirectUri());
+}