iT邦幫忙

2021 iThome 鐵人賽

DAY 1
0
IT管理

「Google Apps Script」 學習筆記系列 第 1

【Day 1】Google Apps Script - 前言與系列介紹

重複的文書作業令你苦惱嗎,如果你們文書作業是運用 Google 文件(Docs),那透過 Google Apps Script 平台搭配Google Docs API 讓文件管理加一點自動化,也許可以減輕你的煩惱。


今日要點:
》開賽
》介紹
》Q&A


Jason 阿,API文件傳給前端了,但前端說比他們習慣用 Apiary 來查閱,問我們能幫他們轉一下嗎?
好的!交給我研究一下。

前言

執行專案工作時,經常要與文件為伍,如果是外部專案,文件會有交付需求,會用 Microsoft Word 看起來專業的排版後再交付。如果是內部專案要看,通常 Google Docs 就很夠用,雖然排版沒有 Word 那麼多功能,但是就多人協作方便。

平常專案 API 文件是使用 Google Docs 的表格來詳細描述後端 API,前後端工程師們就可以按表施工了。這次剛好合作的前端想用 Apiary 來看 API 文件,所以就試著轉換一下 Google Docs 用 Google App Script 自動產生 API Blueprint markdown 格式內容, 再放到 Apiary 去讓前端工程師去查閱,讓他們工作的更順利。

未來等 API 實作好,可以直接用 Apiary 去呼叫後端 API,也是蠻便利的。這項需求不但練習了 Google App Script 的使用,也熟悉了一下 API Blueprint 的知識,增廣見聞阿。

這系列文主要任務?

把寫在 Google 文件上的 專案後端API的說明內容,轉存放到 Apiary 去,讓前端查閱。

這系列的貢獻?

介紹 Google Apps Script 平台與 Google Docs API 應用介紹

在研究過程, 發現網路上有許多 Google Sheet API 的應用介紹與教學,但 Google Docs API 的文章相對來說比較少,可能希望透過這次鐵人賽機會,也貢獻一些 Google Docs API 應用心得。

適合哪些人看?

  • 常用 Google Docs寫文件的人
  • 想練習 JavaScript 的人
  • 對 Google App Script 平台有興趣的人
  • 對 API Blueprint 有興趣的人

這系列預計會包含的內容?

環境篇【Day 1~10】

 第 1 章 Google Apps Script 平台環境介紹
  》【Day 1】前言與系列介紹
  》【Day 2】平台介紹
  》【Day 3】建立 Apps Script 的三種方式
  》【Day 4】Hello World 建立通知單並寄送
  》【Day 5】變數與函式呼叫與GS檔的順序影響

 第 2 章 部署網頁應用程式介紹
  》【Day 6】觸發條件與簡單觸發器(Simple Triggers)
  》【Day 7】使用 Google Docs 撰寫 Demo 用的 API 文件
  》【Day 8】依文件實作 Demo 用的 API
  》【Day 9】部署網頁應用程式與觸發doGet(e)測試
  》【Day 10】環境篇回顧整理


API篇【Day 11~20】

 第 3 章 Drive API 使用介紹
  》【Day 11】轉換流程架構與相關服務
  》【Day 12】Drive Service - 雲端硬碟服務介紹
  》【Day 13】Drive Service - 雲端硬碟服務範例

 第 4 章 Docs API 使用介紹
  》【Day 14】Document Service - 文件服務介紹
  》【Day 15】Document Service - 文件服務範例-新增內容
  》【Day 16】Document Service - 文件服務範例-讀取表格

 第 5 章 Sheet API 使用介紹
  》【Day 17】Spreadsheet Service - 電子試算表服務介紹
  》【Day 18】Spreadsheet Service - 電子試算表服務範例-新增標題
  》【Day 19】Spreadsheet Service - 電子試算表服務範例-新增內容
  》【Day 20】API 篇回顧整理


API Blueprint 篇【Day 21~28】

 第 6 章 API Blueprint 格式介紹
  》【Day 21】API Blueprint 介紹
  》【Day 22】API Blueprint 格式範例

 第 7 章 Google Docs 轉換 API Blueprint 格式介紹
  》【Day 23】Google Docs 轉換 API Blueprint 格式(1)
  》【Day 24】Google Docs 轉換 API Blueprint 格式(2)
  》【Day 25】執行專案取得 .apib 檔

 第 8 章 Apiary 的使用介紹
  》【Day 26】Apiary 介面介紹
  》【Day 27】Apiary 建立專案與版本控制
  》【Day 28】Apiary 測試 API 介紹


延伸篇【Day 29~30】

 第 9 章 其他介紹(Google Charts Service, 協作平台 ...)
  》【Day 29】Google sites 協作平台與 Charts Service 圖表繪製服務
  》【Day 30】系列回顧與學習資源整理


 
 
這次在報名的組別有點掙扎,這系列內容可能會比較偏程式入門應用介紹,覺得應該報 Software Development 比較適合,但又覺得是偏IT專案文件溝通上的需求。最後我報名了IT管理組,除了整理好筆記,也許能幫有這個專案需求的人多一點靈感。

那就開始囉,努力完賽吧!

2021 iT邦幫忙鐵人賽,Go ~


下一篇
【Day 2】Google Apps Script - 平台介紹
系列文
「Google Apps Script」 學習筆記30

尚未有邦友留言

立即登入留言