Class DocumentApp

DocumentApp

Dịch vụ tài liệu tạo và mở Documents mà bạn có thể chỉnh sửa.

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

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

Thuộc tính

Tài sảnLoạiNội dung mô tả
AttributeAttributeBảng liệt kê Attribute.
ElementTypeElementTypeBảng liệt kê ElementType.
FontFamilyFontFamilyBảng liệt kê FontFamily.
GlyphTypeGlyphTypeBảng liệt kê GlyphType.
HorizontalAlignmentHorizontalAlignmentBảng liệt kê HorizontalAlignment.
ParagraphHeadingParagraphHeadingBảng liệt kê ParagraphHeading.
PositionedLayoutPositionedLayoutBảng liệt kê PositionedLayout.
TextAlignmentTextAlignmentBảng liệt kê TextAlignment.
VerticalAlignmentVerticalAlignmentBảng liệt kê VerticalAlignment.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
create(name)DocumentTạo và trả lại tài liệu mới.
getActiveDocument()DocumentTrả về tài liệu có tập lệnh liên kết với vùng chứa (container-bound).
getUi()UiTrả về một thực thể của môi trường giao diện người dùng của tài liệu cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên.
openById(id)DocumentTrả về tài liệu có ID được chỉ định.
openByUrl(url)DocumentMở và trả lại tài liệu có URL đã chỉ định.

Tài liệu chi tiết

create(name)

Tạo và trả lại tài liệu mới.

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

Các tham số

TênLoạiNội dung mô tả
nameStringtên của tài liệu mới

Cầu thủ trả bóng

Document — phiên bản mới của tài liệu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getActiveDocument()

Trả về tài liệu có tập lệnh liên kết với vùng chứa (container-bound). Để tương tác với tài liệu mà tập lệnh không liên kết với vùng chứa, hãy sử dụng openById(id) hoặc openByUrl(url).

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

Cầu thủ trả bóng

Document – bản sao tài liệu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

getUi()

Trả về một thực thể của môi trường giao diện người dùng của tài liệu cho phép tập lệnh thêm các tính năng như trình đơn, hộp thoại và thanh bên. Một tập lệnh chỉ có thể tương tác với giao diện người dùng cho bản sao hiện tại của tài liệu đang mở và chỉ khi tập lệnh được liên kết với tài liệu đó. Để biết thêm thông tin, hãy xem hướng dẫn về trình đơnhộp thoại cũng như thanh bên.

// 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();
}

Cầu thủ trả bóng

Ui — một phiên bản của môi trường giao diện người dùng của tài liệu này


openById(id)

Trả về tài liệu có ID được chỉ định. Nếu tập lệnh được liên kết với vùng chứa với tài liệu, hãy sử dụng getActiveDocument().

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

Các tham số

TênLoạiNội dung mô tả
idStringmã của tài liệu cần mở

Cầu thủ trả bóng

Document – bản sao tài liệu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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

openByUrl(url)

Mở và trả lại tài liệu có URL đã chỉ định. Nếu tập lệnh được liên kết với vùng chứa với tài liệu, hãy sử dụng getActiveDocument().

// Open a document by URL.
var doc = DocumentApp.openByUrl(
    'https://docs.google.com/document/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit');

Các tham số

TênLoạiNội dung mô tả
urlStringURL của tài liệu cần mở

Cầu thủ trả bóng

Document – bản sao tài liệu

Ủy quyền

Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:

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