Google Docs 透過 Apps Script 能夠自動化處理各種文檔操作，
像是自動化編輯段落、插入圖片、設置格式等等，能夠大大提升文檔的處理效率!
那我們就來進入 Google doc App Script 的世界吧～

操作文件

建立新文件 DocumentApp.create

建立一個新的 Google Docs 文檔。

// Create a document
var doc = DocumentApp.create('My New Document');
Logger.log('新文檔已創建，文件ID: ' + doc.getId());

開啟文件 DocumentApp.openById

// Open a document by ID.
var doc = DocumentApp.openById('DOCUMENT_ID');

取得當前文件

// Get the document to which this script is bound.
var doc = DocumentApp.getActiveDocument();

透過url開啟文件

var doc = DocumentApp.openByUrl('https://docs.google.com/document/d/{doc_id}/edit');

內文 Body

在 Google Docs 中，Body 是整個文檔的主要內容部分！它包含文檔中的所有段落、圖片、表格等元素。
你可以通過 DocumentApp.getActiveDocument().getBody() 來取得文檔的 Body，並且使用多種方法來操作和修改其內容。

Body 的主要結構是按以下層級組織的：

• Paragraph（段落）：Doc 的最基礎單元，通常是一行文字或文字的段落
• Table（表格）：表格，表格由多個 TableRow 組成，每行包含多個 TableCell
• ListItem（清單項目）：段落的一種變體，呈現為有序或無序列表項目
• Image（圖片）：Doc 中的圖片
• HorizontalRule（水平線）：分隔線
• FootnoteSection（註腳部分）：註腳
• PageBreak（分頁符號）：分頁符號

取得段落文字 getParagraphs

var body = DocumentApp.getActiveDocument().getBody();
// 獲取所有段落
var paragraphs = body.getParagraphs();
for (var i = 0; i < paragraphs.length; i++) {
Logger.log(paragraphs[i].getText());
}

插入段落文字 appendParagraph

將文字插入到文檔中。

var doc = DocumentApp.getActiveDocument();
var body = doc.getBody();
body.appendParagraph('我是被插入的段落文字');

格式化文字 editAsText

設置文字的樣式，如粗體、斜體、字體大小等。

var doc = DocumentApp.getActiveDocument();
var body = doc.getBody();
var paragraph = body.appendParagraph('我需要格式化！');

// 設置粗體和字體大小
paragraph.editAsText().setBold(true).setFontSize(14);

插入圖片 appendImage

在文檔中插入圖片。

var doc = DocumentApp.getActiveDocument();
var body = doc.getBody();

var imageUrl = 'https://www.example.com/image.jpg'; // 替換為實際圖片URL
var imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();

body.appendImage(imageBlob);

插入表格 appendTable()

插入一個表格並填充數據。

var doc = DocumentApp.getActiveDocument();
var body = doc.getBody();

var table = body.appendTable();

// 插入表頭
table.appendTableRow().appendTableCell('Name').appendTableCell('Age');

// 插入數據
table.appendTableRow().appendTableCell('John').appendTableCell('25');
table.appendTableRow().appendTableCell('Jane').appendTableCell('30');

常用 API

以下整理了一些 Body 常用的方法：

詳細可以再看 google doc App Script 官方文件唷！

學完基本的文檔操作跟 Body 介紹後，
明天就來教大家認識 文字樣式（TextStyle） 和 段落樣式（ParagraphStyle） ！