Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/techstreams/TSDynamicUrls

Google Apps Scripts for leveraging the URL power of Google document! 💥
https://github.com/techstreams/TSDynamicUrls

google-apps-script google-docs google-drawings google-forms google-sheets google-slides

Last synced: about 2 months ago
JSON representation

Google Apps Scripts for leveraging the URL power of Google document! 💥

Host: GitHub
URL: https://github.com/techstreams/TSDynamicUrls
Owner: techstreams
License: mit
Created: 2019-12-31T15:50:02.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2022-03-28T19:12:42.000Z (over 2 years ago)
Last Synced: 2024-04-06T14:36:37.971Z (6 months ago)
Topics: google-apps-script, google-docs, google-drawings, google-forms, google-sheets, google-slides
Language: JavaScript
Homepage: https://medium.com/@techstreams/tsdynamicurls-1-leverage-the-url-power-of-google-docs-sheets-slides-drawings-forms-598b5dd53c98
Size: 144 KB
Stars: 20
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # TSDynamicUrls

*If you enjoy my [Google Workspace Apps Script](https://developers.google.com/apps-script) work, please consider buying me a cup of coffee!* 

[![](https://techstreams.github.io/images/bmac.svg)](https://www.buymeacoffee.com/techstreams)

---

**TSDynamicUrls** is an [Apps Script](https://www.google.com/script/start/) powered dynamic URL generator for ***Google Docs***, ***Sheets***, ***Slides***, ***Drawings*** & ***Forms*** which assists document creators and consumers in leveraging the ***URL power*** of Google documents. 💥

See the following blog posts for more information and getting started guides:

* **[Introduction to the URL power of Google documents](https://medium.com/@techstreams/google-document-urls-as-simple-machines-400baca6d014)**

* **[TSDynamicUrls Google Form](https://medium.com/@techstreams/tsdynamicurls-1-leverage-the-url-power-of-google-docs-sheets-slides-drawings-forms-598b5dd53c98)**   *([Code](/form/))*

* **[TSCreateUrlCheatsheet - Google Sheets Macro](https://techstreams.medium.com/tsdynamicurls-2-leverage-the-power-of-google-workspace-new-resource-urls-6b1da5ff49a7)**  *([Code](/macro/))*

* **[TSDynamicUrls Web App](https://techstreams.medium.com/tsdynamicurls-3-leverage-the-url-power-of-google-docs-sheets-slides-drawings-forms-22ab381de9d7)** *([Code](/webapp/))*

*__TSDynamicUrls__ is intended for use within a [G Suite for Business](https://gsuite.google.com/solutions/) or [G Suite for Education](https://edu.google.com/products/gsuite-for-education) domain.*




---

## Supported Formats & Options

**TSDynamicUrls** supports the Google document files types/formats and Google Sheets PDF options outlined in the tables below.




**TSDynamicUrls Supported Google Document File Types & Formats** - *`*`See below for more on sharing Google Forms.*

| FORMAT | DOCS | SHEETS | SLIDES | DRAWINGS | FORMS|

| ---- | :--: | :----: | :----: | :---: | :------: |

| Preview |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |

| Copy |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: `*` |

| Copy w/ Comments |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: | :heavy_minus_sign: |

| Template |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: `*` |

| MobileBasic |  :heavy_check_mark: |  :heavy_minus_sign: |  :heavy_minus_sign: |  :heavy_minus_sign: | :heavy_minus_sign: |

| PDF (Portable Document Format) |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: |  :heavy_check_mark: | :heavy_minus_sign: |

| JPEG (Joint Photographic Experts Group Image) | :heavy_minus_sign: |  :heavy_minus_sign: |  :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: |

| PNG (Portable Graphics Format Image) | :heavy_minus_sign: |  :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: |

| PNG (Portable Graphics Format Image) - Individual Slide Only |  :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |

| SVG (Scalable Vector Graphics Image) | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: |

| RTF (Rich Text Format) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| TXT (Plain Text) |  :heavy_check_mark: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |

| HTML (Web Page, Zipped) | :heavy_check_mark: |  :heavy_check_mark: |  :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| DOCX (Microsoft Word) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| ODT (OpenDocument Document) | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| EPUB (EPUB Publication) |  :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| XLSX (Microsoft Excel) | :heavy_minus_sign: |  :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| ODS (OpenDocument Spreadsheet) | :heavy_minus_sign: |  :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| CSV (Comma-separated values)  - Individual Sheet Only | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign: |

| TSV (Tab-separated values)  - Individual Sheet Only | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_minus_sign:|

| PPTX (Microsoft PowerPoint) | :heavy_minus_sign: | :heavy_minus_sign: | :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |

| ODP (OpenDocument Presentation) | :heavy_minus_sign: | :heavy_minus_sign: |  :heavy_check_mark: | :heavy_minus_sign: | :heavy_minus_sign: |




**TSDynamicUrls Supported Google Sheets PDF Options**

| GOOGLE SHEETS PDF OPTIONS |  |

| ---- | :--: | 

| Size  (Letter, Tabloid, Legal, Statement, Executive, Folio, A3, A4, A5, B4, B5)  | :heavy_check_mark: |

| Orientation (Portrait, Landscape) | :heavy_check_mark: |

| Scale  (Normal 100%, Fit to Width, Fit to Height, Fit to Page) | :heavy_check_mark: |

| Page Order  (Down, then over; Over, then down) | :heavy_check_mark: |

| Horizontal Alignment  (Left, Center, Right) | :heavy_check_mark: |

| Vertical Alignment  (Top, Middle, Bottom) | :heavy_check_mark: |

| Repeat Frozen Rows | :heavy_check_mark: |

| Repeat Frozen Columns | :heavy_check_mark: |

| Show Gridlines | :heavy_check_mark: |

| Show Spreadsheet Title | :heavy_check_mark: |

| Show Sheet Names | :heavy_check_mark: |

| Show Page Numbers | :heavy_check_mark: |

| Show Notes | :heavy_check_mark: |

| Custom Margins  (Top, Bottom, Left, Right) | :heavy_check_mark: |

| All Sheets / Single Sheet | :heavy_check_mark: |

| Named Range  (Single Sheet) | :heavy_check_mark: |

| Custom Range  (Single Sheet) | :heavy_check_mark: |




---

## Share Google Forms With View Only Access

*See __[this guide](https://docs.google.com/document/d/1kLo2kw5aBF7RYL_OV9kOxF7JkMjnTBfcuPbFsYUR-TM/template/preview)__ for more on sharing Google Forms.  Script below.*




```

function share() {

 

    var formId = "";

    var file = DriveApp.getFileById(formId);

    file.setSharing(

      DriveApp.Access.ANYONE_WITH_LINK, 

      DriveApp.Permission.VIEW

    );

  

}

```

*Change __`DriveApp.Access`__ to desired access level.*

| ACCESS LEVEL | DESCRIPTION |

| :---------- | :--------- |

| **ANYONE** | *Anyone on the Internet can find and access. No sign-in required.* |

| **ANYONE_WITH_LINK** | *Anyone who has the link can access it. No sign-in required.* |

| **DOMAIN** | *People in your G Suite domain can find and access it. Sign-in required.* |

| **DOMAIN_WITH_LINK** | *People in your G Suite  domain who have the link can access it. Sign-in required.* |

| **PRIVATE** | *Only people explicitly granted permission can access. Sign-in required.* |




---

## FAQ

How do I ask general questions about TSDynamicUrls?

For general questions, submit an issue through the issue tracker.




How do I submit bug reports for TSDynamicUrls

For bug reports, fork this repository, create a test which demonstrates the problem following the procedures outlined in the "Tests" section below and submit a pull request.  If possible, please submit a solution along with the pull request.

---

## Tests

**TSDynamicUrls** for Google Forms unit tests can be found in [form/tests](/form/tests/) folder.

To perform **TSDynamicUrls** for Google Forms unit tests:

* Add the appropriate test file from the [form/tests](/form/tests/) folder to the TSDynamicUrls form script editor.  ***IMPORTANT: Each test is configured as a web app so only install one test at a time to avoid conflicts.***

* Install [QUnit for Google Apps Script](https://github.com/simula-innovation/qunit/tree/gas/gas) by adding the project library *(see the project documentation for proper install instructions)*.

* [Deploy the script](https://developers.google.com/apps-script/guides/web#deploying_a_script_as_a_web_app) as a web app *(execute script as self)*.

* Set the desired unit test configuration entry in the `testConfig` object to `true` *(see each file for information on where to modify these values to enable tests)*.   NOTE: Some tests can take longer to run so best to run them individually.

* Access the deployed web app for test results.

---

## Change Log

* 2021-03-19 - Added **/mobilebasic** option for Google Docs.  To test:

  * Make a copy of this [Google Form](https://techstreams.page.link/TSDynamicUrlsForm).

  * Add a **MobileBasic** option to the **Google Docs URL Modification Type?** section.

  * Replace the [Code.gs](./form/Code.gs) in the copied form.

---

## License

**TSDynamicUrls License**

© Laura Taylor ([github.com/techstreams](https://github.com/techstreams)). Licensed under an MIT license.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.