Merge pull request googleworkspace#105 from gsuitedevs/docs

Add samples for the Docs advanved service.

Author: asrivas

advanced/docs.gs

@@ -0,0 +1,126 @@
+/**
+ * Copyright Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// [START apps_script_docs_create_document]
+/**
+ * Create a new document.
+ */
+function createDocument() {
+  var document = Docs.Documents.create({'title': 'My New Document'});
+  Logger.log('Created document with ID: ' + document.documentId);
+}
+// [END apps_script_docs_create_document]
+
+// [START apps_script_docs_find_and_replace]
+/**
+ * Performs "replace all".
+ * @param {string} documentId The document to perform the replace text
+ *     operations on.
+ * @param {Object} findTextToReplacementMap A map from the "find text" to the
+ *     "replace text".
+ */
+function findAndReplace(documentId, findTextToReplacementMap) {
+  var requests = [];
+  for (var findText in findTextToReplacementMap) {
+    var replaceText = findTextToReplacementMap[findText];
+    var request = {
+      replaceAllText: {
+        containsText: {
+          text: findText,
+          matchCase: true,
+        },
+        replaceText: replaceText
+      }
+    };
+    requests.push(request);
+  }
+
+  var response = Docs.Documents.batchUpdate({'requests': requests}, documentId);
+  var replies = response.replies;
+  for (var i = 0; i < replies.length; i++) {
+    var reply = replies[i];
+    var numReplacements = reply.replaceAllText.occurrencesChanged || 0;
+    Logger.log('Request %s performed %s replacements.', i, numReplacements);
+  }
+}
+// [END apps_script_docs_find_and_replace]
+
+// [START apps_script_docs_insert_and_style_text]
+/**
+ * Insert text at the beginning of the document and then style the inserted
+ * text.
+ * @param {string} documentId The document the text is inserted into.
+ * @param {string} text The text to insert into the document.
+ */
+function insertAndStyleText(documentId, text) {
+  var requests = [{
+    insertText: {
+      location: {
+        index: 1
+      },
+      text: text
+    }
+  },
+  {
+    updateTextStyle: {
+      range: {
+        startIndex: 1,
+        endIndex: text.length + 1
+      },
+      text_style: {
+        fontSize: {
+          magnitude: 12,
+          unit: 'PT'
+        },
+        weightedFontFamily: {
+          fontFamily: 'Calibri'
+        }
+      },
+      fields: 'weightedFontFamily, fontSize'
+    }
+  }];
+  Docs.Documents.batchUpdate({'requests': requests}, documentId);
+}
+// [END apps_script_docs_insert_and_style_text]
+
+// [START apps_script_docs_read_first_paragraph]
+ /**
+ * Read the first paragraph of the body of a document.
+ * @param {string} documentId The ID of the document to read.
+ */
+function readFirstParagraph(documentId) {
+  var document = Docs.Documents.get(documentId);
+  var bodyElements = document.body.content;
+
+  for (var i = 0; i < bodyElements.length; i++) {
+    var structuralElement = bodyElements[i];
+    if (structuralElement.paragraph !== null) {
+      var paragraphElements = structuralElement.paragraph.elements;
+      var paragraphText = '';
+
+      for (var j = 0; j < paragraphElements.length; j++) {
+        var paragraphElement = paragraphElements[j];
+        if (paragraphElement.textRun !== null) {
+          paragraphText += paragraphElement.textRun.content;
+        }
+      }
+
+      Logger.log(paragraphText);
+      return;
+    }
+  }
+}
+// [END apps_script_docs_read_first_paragraph]

docs/quickstart/quickstart.gs

@@ -0,0 +1,26 @@
+/**
+ * Copyright Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// [START docs_quickstart]
+/**
+ * Prints the title of the sample document:
+ * https://docs.google.com/document/d/195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE/edit
+ */
+function printDocTitle() {
+  var documentId = '195j9eDD3ccgjQRttHhJPymLJUCOUjs-jmwTrekvdjFE'
+  var doc = Docs.Documents.get(documentId)
+  Logger.log('The title of the doc is: %s', doc.title)
+}
+// [END docs_quickstart]