【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 ～