文档服务会创建并打开可以编辑的 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 | 返回脚本与容器绑定的文档。 |
getUi() | Ui | 返回文档界面环境的实例,允许脚本添加菜单、对话框和边栏等功能。 |
openById(id) | Document | 返回具有指定 ID 的文档。 |
openByUrl(url) | Document | 打开并返回具有指定网址的文档。 |
详细文档
create(name)
getActiveDocument()
返回脚本与容器绑定的文档。如需与脚本未绑定至容器的文档交互,请改用 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. 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