Class DocumentApp

DocumentApp

文档服务会创建并打开可以编辑的 Documents

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

// Create and open a document.
doc = DocumentApp.create('Document Name');

属性

媒体资源类型说明
AttributeAttributeAttribute 枚举。
ElementTypeElementTypeElementType 枚举。
FontFamilyFontFamilyFontFamily 枚举。
GlyphTypeGlyphTypeGlyphType 枚举。
HorizontalAlignmentHorizontalAlignmentHorizontalAlignment 枚举。
ParagraphHeadingParagraphHeadingParagraphHeading 枚举。
PositionedLayoutPositionedLayoutPositionedLayout 枚举。
TextAlignmentTextAlignmentTextAlignment 枚举。
VerticalAlignmentVerticalAlignmentVerticalAlignment 枚举。

方法

方法返回类型简介
create(name)Document创建并返回新文档。
getActiveDocument()Document返回脚本与容器绑定的文档。
getUi()Ui返回文档界面环境的实例,允许脚本添加菜单、对话框和边栏等功能。
openById(id)Document返回具有指定 ID 的文档。
openByUrl(url)Document打开并返回具有指定网址的文档。

详细文档

create(name)

创建并返回新文档。

// Create and open a new document.
var doc = DocumentApp.create('Document Name');

参数

名称类型说明
nameString新文档的名称

弃踢回攻

Document - 新的文档实例

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/documents

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');

参数

名称类型说明
idString要打开的文档的 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');

参数

名称类型说明
urlString要打开的文档的网址

弃踢回攻

Document - 文档实例

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/documents