文件服務會建立並開啟可編輯的「Documents
」。
// Open a document by ID. // TODO(developer): Replace the ID with your own. var doc = DocumentApp.openById('DOCUMENT_ID'); // 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()
傳回文件使用者介面環境的執行個體,該環境可讓指令碼新增 例如選單、對話方塊和側欄指令碼只能與以下項目的使用者介面互動: 目前開啟的文件例項,且前提是指令碼已繫結至文件。詳情請參閱 選單和對話方塊和側欄的指南。
// 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. // TODO(developer): Replace the ID with your own. var doc = DocumentApp.openById('DOCUMENT_ID');
參數
名稱 | 類型 | 說明 |
---|---|---|
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