文件服務會建立並開啟可編輯的 Documents
。
// Open a document by ID. var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE'); // Create and open a document. doc = DocumentApp.create('Document Name');
屬性
屬性 | 類型 | 說明 |
---|---|---|
Attribute | Attribute | Attribute 列舉。 |
ElementType | ElementType | ElementType 列舉。 |
FontFamily |
| 列舉。 |
GlyphType | GlyphType | GlyphType 列舉。 |
HorizontalAlignment | HorizontalAlignment | HorizontalAlignment 列舉。 |
ParagraphHeading | ParagraphHeading | ParagraphHeading 列舉。 |
PositionedLayout | PositionedLayout | PositionedLayout 列舉。 |
TextAlignment | TextAlignment | TextAlignment 列舉。 |
VerticalAlignment | VerticalAlignment | VerticalAlignment 列舉。 |
方法
方法 | 傳回類型 | 簡短說明 |
---|---|---|
create(name) | Document | 建立並傳回新文件。 |
getActiveDocument() | Document | 傳回指令碼要 container-bound 的文件。 |
getUi() | Ui | 傳回文件使用者介面環境的執行個體,該環境可讓指令碼新增選單、對話方塊和側欄等功能。 |
openById(id) | Document | 傳回含有指定 ID 的文件。 |
openByUrl(url) | Document | 開啟並傳回含有指定網址的文件。 |
內容詳盡的說明文件
create(name)
getActiveDocument()
傳回指令碼要 container-bound 的文件。如要與指令碼未繫結的文件互動,請改用 openById(id)
或 openByUrl(url)
。
// Get the document to which this script is bound. var doc = DocumentApp.getActiveDocument();
回攻員
Document
:文件執行個體
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getUi()
傳回文件使用者介面環境的執行個體,該環境可讓指令碼新增選單、對話方塊和側欄等功能。指令碼只能針對已開啟文件目前的執行個體與 UI 互動,且只有在指令碼繫結至文件時。詳情請參閱「選單」和「對話方塊和側欄」指南。
// Add a custom menu to the active document, including a separator and a sub-menu. function onOpen(e) { DocumentApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(DocumentApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
回攻員
Ui
:這份文件的使用者介面環境的執行個體
openById(id)
傳回含有指定 ID 的文件。如果指令碼是繫結至文件,請改用 getActiveDocument()
。
// Open a document by ID. var doc = DocumentApp.openById('DOCUMENT_ID_GOES_HERE');
參數
名稱 | 類型 | 說明 |
---|---|---|
id | String | 要開啟的文件 ID |
回攻員
Document
:文件執行個體
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/documents
openByUrl(url)
開啟並傳回含有指定網址的文件。如果指令碼是與文件繫結的指令碼,請改用 getActiveDocument()
。
// Open a document by URL. var doc = DocumentApp.openByUrl( 'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit');
參數
名稱 | 類型 | 說明 |
---|---|---|
url | String | 要開啟的文件網址 |
回攻員
Document
:文件執行個體
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/documents