Class Body

Body

Một phần tử đại diện cho nội dung tài liệu. Body có thể chứa các phần tử ListItem, Paragraph, TableTableOfContents. Để biết thêm thông tin về cấu trúc tài liệu, hãy xem hướng dẫn mở rộng Google Tài liệu.

Body thường chứa toàn bộ nội dung tài liệu, ngoại trừ phần tử HeaderSection, FooterSection và bất kỳ phần tử FootnoteSection nào.

var doc = DocumentApp.getActiveDocument();
var body = doc.getBody();

// Append a paragraph and a page break to the document body section directly.
body.appendParagraph("A paragraph.");
body.appendPageBreak();

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
appendHorizontalRule()HorizontalRuleTạo và thêm một HorizontalRule mới.
appendImage(image)InlineImageTạo và thêm một InlineImage mới từ blob hình ảnh được chỉ định.
appendImage(image)InlineImageThêm InlineImage đã cho.
appendListItem(listItem)ListItemThêm ListItem đã cho.
appendListItem(text)ListItemTạo và thêm một ListItem mới chứa nội dung văn bản chỉ định.
appendPageBreak()PageBreakTạo và thêm một PageBreak mới.
appendPageBreak(pageBreak)PageBreakThêm PageBreak đã cho.
appendParagraph(paragraph)ParagraphThêm Paragraph đã cho.
appendParagraph(text)ParagraphTạo và thêm một Paragraph mới chứa nội dung văn bản chỉ định.
appendTable()TableTạo và thêm một Table mới.
appendTable(cells)TableThêm Table mới chứa TableCell cho từng giá trị chuỗi được chỉ định.
appendTable(table)TableThêm Table đã cho.
clear()BodyXoá nội dung của phần tử.
copy()BodyTrả về một bản sao sâu đã tách rời của phần tử hiện tại.
editAsText()TextLấy phiên bản Text của phần tử hiện tại để chỉnh sửa.
findElement(elementType)RangeElementTìm kiếm nội dung của phần tử để xem thành phần con của kiểu đã chỉ định.
findElement(elementType, from)RangeElementTìm kiếm nội dung của phần tử cho thành phần con của kiểu đã chỉ định, bắt đầu từ RangeElement được chỉ định.
findText(searchPattern)RangeElementTìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định bằng biểu thức chính quy.
findText(searchPattern, from)RangeElementTìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định, bắt đầu từ một kết quả tìm kiếm đã cho.
getAttributes()ObjectTruy xuất các thuộc tính của phần tử.
getChild(childIndex)ElementTruy xuất phần tử con tại chỉ mục con đã chỉ định.
getChildIndex(child)IntegerTruy xuất chỉ mục con cho phần tử con đã chỉ định.
getHeadingAttributes(paragraphHeading)ObjectTruy xuất tập hợp các thuộc tính cho ParagraphHeading được cung cấp.
getImages()InlineImage[]Truy xuất tất cả InlineImages có trong phần này.
getListItems()ListItem[]Truy xuất tất cả ListItems có trong phần này.
getMarginBottom()NumberTruy xuất lề dưới cùng, tính bằng điểm.
getMarginLeft()NumberTruy xuất lề trái, tính bằng điểm.
getMarginRight()NumberTruy xuất lề phải.
getMarginTop()NumberTruy xuất lề trên.
getNumChildren()IntegerTruy xuất số lượng phần tử con.
getPageHeight()NumberTruy xuất chiều cao của trang, tính theo điểm.
getPageWidth()NumberTruy xuất chiều rộng của trang, tính bằng điểm.
getParagraphs()Paragraph[]Truy xuất tất cả Paragraphs có trong phần này (bao gồm cả ListItems).
getParent()ContainerElementTruy xuất phần tử mẹ của phần tử.
getTables()Table[]Truy xuất tất cả Tables có trong phần này.
getText()StringTruy xuất nội dung của phần tử dưới dạng chuỗi văn bản.
getTextAlignment()TextAlignmentLấy căn chỉnh văn bản.
getType()ElementTypeTruy xuất ElementType của phần tử.
insertHorizontalRule(childIndex)HorizontalRuleTạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.
insertImage(childIndex, image)InlineImageTạo và chèn một InlineImage từ blob hình ảnh được chỉ định, tại chỉ mục đã chỉ định.
insertImage(childIndex, image)InlineImageChèn InlineImage đã cho vào chỉ mục đã chỉ định.
insertListItem(childIndex, listItem)ListItemChèn ListItem đã cho vào chỉ mục đã chỉ định.
insertListItem(childIndex, text)ListItemTạo và chèn một ListItem mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.
insertPageBreak(childIndex)PageBreakTạo và chèn một PageBreak mới tại chỉ mục đã chỉ định.
insertPageBreak(childIndex, pageBreak)PageBreakChèn PageBreak đã cho vào chỉ mục đã chỉ định.
insertParagraph(childIndex, paragraph)ParagraphChèn Paragraph đã cho vào chỉ mục đã chỉ định.
insertParagraph(childIndex, text)ParagraphTạo và chèn một Paragraph mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.
insertTable(childIndex)TableTạo và chèn một Table mới tại chỉ mục đã chỉ định.
insertTable(childIndex, cells)TableTạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định.
insertTable(childIndex, table)TableChèn Table đã cho vào chỉ mục đã chỉ định.
removeChild(child)BodyXoá phần tử con đã chỉ định.
replaceText(searchPattern, replacement)ElementThay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, sử dụng các biểu thức chính quy.
setAttributes(attributes)BodyThiết lập các thuộc tính của phần tử.
setHeadingAttributes(paragraphHeading, attributes)BodyThiết lập các thuộc tính cho ParagraphHeading đã cho.
setMarginBottom(marginBottom)BodyĐặt lề dưới cùng, tính bằng điểm.
setMarginLeft(marginLeft)BodyĐặt lề trái, tính bằng điểm.
setMarginRight(marginRight)BodyĐặt lề phải, tính bằng điểm.
setMarginTop(marginTop)BodyĐặt lề trên.
setPageHeight(pageHeight)BodyĐặt chiều cao của trang, tính theo điểm.
setPageWidth(pageWidth)BodyĐặt chiều rộng của trang, tính bằng điểm.
setText(text)BodyĐặt nội dung dưới dạng văn bản thuần tuý.
setTextAlignment(textAlignment)BodyĐặt cách căn chỉnh văn bản.

Tài liệu chi tiết

appendHorizontalRule()

Tạo và thêm một HorizontalRule mới.

HorizontalRule này sẽ nằm trong một Paragraph mới.

Cầu thủ trả bóng

HorizontalRule — quy tắc ngang mới

Ủ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

appendImage(image)

Tạo và thêm một InlineImage mới từ blob hình ảnh được chỉ định.

Hình ảnh đó sẽ được chứa trong một Paragraph mới.

Các tham số

TênLoạiNội dung mô tả
imageBlobSourcedữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage — hình ảnh được thêm vào

Ủ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

appendImage(image)

Thêm InlineImage đã cho.

InlineImage này sẽ nằm trong một Paragraph mới.

Sử dụng phiên bản appendImage này khi thêm bản sao của một InlineImage hiện có.

Các tham số

TênLoạiNội dung mô tả
imageInlineImagedữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage — hình ảnh được thêm vào

Ủ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

appendListItem(listItem)

Thêm ListItem đã cho.

Sử dụng phiên bản appendListItem này khi thêm bản sao của một ListItem hiện có.

Các tham số

TênLoạiNội dung mô tả
listItemListItemmục danh sách cần thêm

Cầu thủ trả bóng

ListItem – mục danh sách được thêm vào

Ủ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

appendListItem(text)

Tạo và thêm một ListItem mới chứa nội dung văn bản chỉ định.

Các mục danh sách liên tiếp được thêm vào cùng một danh sách.

Các tham số

TênLoạiNội dung mô tả
textStringnội dung văn bản của mục danh sách

Cầu thủ trả bóng

ListItem – mục danh sách mới

Ủ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

appendPageBreak()

Tạo và thêm một PageBreak mới.

PageBreak này sẽ nằm trong một Paragraph mới.

Cầu thủ trả bóng

PageBreak — ngắt trang mới

Ủ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

appendPageBreak(pageBreak)

Thêm PageBreak đã cho.

PageBreak này sẽ nằm trong một Paragraph mới.

Sử dụng phiên bản appendPageBreak này khi thêm bản sao của một PageBreak hiện có.

Các tham số

TênLoạiNội dung mô tả
pageBreakPageBreakngắt trang cần nối

Cầu thủ trả bóng

PageBreak — ngắt trang được thêm vào

Ủ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

appendParagraph(paragraph)

Thêm Paragraph đã cho.

Sử dụng phiên bản appendParagraph này khi thêm bản sao của một Paragraph hiện có.

Các tham số

TênLoạiNội dung mô tả
paragraphParagraphđoạn cần nối

Cầu thủ trả bóng

Paragraph — đoạn được thêm vào

Ủ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

appendParagraph(text)

Tạo và thêm một Paragraph mới chứa nội dung văn bản chỉ định.

Các tham số

TênLoạiNội dung mô tả
textStringnội dung văn bản của đoạn

Cầu thủ trả bóng

Paragraph — đoạn mới

Ủ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

appendTable()

Tạo và thêm một Table mới.

Phương thức này cũng sẽ nối một đoạn trống sau bảng vì tài liệu Google Tài liệu không thể kết thúc bằng bảng.

Cầu thủ trả bóng

Table – bảng mới

Ủ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

appendTable(cells)

Thêm Table mới chứa TableCell cho từng giá trị chuỗi được chỉ định.

Phương thức này cũng sẽ nối một đoạn trống sau bảng vì tài liệu Google Tài liệu không thể kết thúc bằng bảng.

Các tham số

TênLoạiNội dung mô tả
cellsString[][]nội dung văn bản của các ô trong bảng cần thêm vào bảng mới

Cầu thủ trả bóng

Table – bảng được thêm vào

Ủ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

appendTable(table)

Thêm Table đã cho.

Sử dụng phiên bản appendTable này khi thêm bản sao của một Table hiện có. Phương thức này cũng sẽ nối một đoạn trống sau bảng vì tài liệu Google Tài liệu không thể kết thúc bằng bảng.

Các tham số

TênLoạiNội dung mô tả
tableTablebảng để thêm

Cầu thủ trả bóng

Table – bảng được thêm vào

Ủ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

clear()

Xoá nội dung của phần tử.

Cầu thủ trả bóng

Body – phần tử hiện tại


copy()

Trả về một bản sao sâu đã tách rời của phần tử hiện tại.

Mọi phần tử con có trong phần tử cũng được sao chép. Phần tử mới không có phần tử mẹ.

Cầu thủ trả bóng

Body – Bản sao mới.

Ủ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

editAsText()

Lấy phiên bản Text của phần tử hiện tại để chỉnh sửa.

Sử dụng editAsText để thao tác với nội dung các phần tử dưới dạng văn bản đa dạng thức. Chế độ editAsText bỏ qua các phần tử không phải văn bản (chẳng hạn như InlineImageHorizontalRule).

Các phần tử con nằm trong phạm vi văn bản đã xoá sẽ bị xoá khỏi phần tử đó.

var body = DocumentApp.getActiveDocument().getBody();

// Insert two paragraphs separated by a paragraph containing an
// horizontal rule.
body.insertParagraph(0, "An editAsText sample.");
body.insertHorizontalRule(0);
body.insertParagraph(0, "An example.");

// Delete " sample.\n\n An" removing the horizontal rule in the process.
body.editAsText().deleteText(14, 25);

Cầu thủ trả bóng

Text – phiên bản văn bản của phần tử hiện tại


findElement(elementType)

Tìm kiếm nội dung của phần tử để xem thành phần con của kiểu đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
elementTypeElementTypeloại phần tử cần tìm kiếm

Cầu thủ trả bóng

RangeElement — một kết quả tìm kiếm cho biết vị trí của phần tử tìm kiếm

Ủ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

findElement(elementType, from)

Tìm kiếm nội dung của phần tử cho thành phần con của kiểu đã chỉ định, bắt đầu từ RangeElement được chỉ định.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

Các tham số

TênLoạiNội dung mô tả
elementTypeElementTypeloại phần tử cần tìm kiếm
fromRangeElementkết quả tìm kiếm để tìm kiếm

Cầu thủ trả bóng

RangeElement — một kết quả tìm kiếm cho biết vị trí tiếp theo của phần tử tìm kiếm

Ủ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

findText(searchPattern)

Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định bằng biểu thức chính quy.

Một số tính năng của biểu thức chính quy JavaScript chưa được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập dữ liệu và đối tượng sửa đổi chế độ.

Mẫu biểu thức chính quy đã cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

Các tham số

TênLoạiNội dung mô tả
searchPatternStringmẫu cần tìm kiếm

Cầu thủ trả bóng

RangeElement – một kết quả tìm kiếm cho biết vị trí của văn bản tìm kiếm hoặc để trống nếu không có kết quả nào trùng khớp

Ủ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

findText(searchPattern, from)

Tìm kiếm nội dung của phần tử cho mẫu văn bản được chỉ định, bắt đầu từ một kết quả tìm kiếm đã cho.

Một số tính năng của biểu thức chính quy JavaScript chưa được hỗ trợ đầy đủ, chẳng hạn như nhóm thu thập dữ liệu và đối tượng sửa đổi chế độ.

Mẫu biểu thức chính quy đã cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

Các tham số

TênLoạiNội dung mô tả
searchPatternStringmẫu cần tìm kiếm
fromRangeElementkết quả tìm kiếm để tìm kiếm

Cầu thủ trả bóng

RangeElement – một kết quả tìm kiếm cho biết vị trí tiếp theo của văn bản tìm kiếm hoặc để trống nếu không có kết quả nào phù hợp

Ủ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

getAttributes()

Truy xuất các thuộc tính của phần tử.

Kết quả là một đối tượng chứa thuộc tính cho mỗi thuộc tính phần tử hợp lệ, trong đó mỗi tên thuộc tính tương ứng với một mục trong bảng liệt kê DocumentApp.Attribute.

var body = DocumentApp.getActiveDocument().getBody();

// Append a styled paragraph.
var par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
var atts = par.getAttributes();

// Log the paragraph attributes.
for (var att in atts) {
  Logger.log(att + ":" + atts[att]);
}

Cầu thủ trả bóng

Object – Các thuộc tính của phần tử.

Ủ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

getChild(childIndex)

Truy xuất phần tử con tại chỉ mục con đã chỉ định.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
var firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText("This is the first paragraph.");
}

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục của phần tử con cần truy xuất

Cầu thủ trả bóng

Element – phần tử con tại chỉ mục được chỉ định

Ủ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

getChildIndex(child)

Truy xuất chỉ mục con cho phần tử con đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childElementphần tử con cần truy xuất chỉ mục

Cầu thủ trả bóng

Integer – chỉ mục con

Ủ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

getHeadingAttributes(paragraphHeading)

Truy xuất tập hợp các thuộc tính cho ParagraphHeading được cung cấp.

Các tham số

TênLoạiNội dung mô tả
paragraphHeadingParagraphHeadingtiêu đề có các thuộc tính sẽ được truy xuất

Cầu thủ trả bóng

Object – bản đồ các thuộc tính và giá trị hiện tại của các thuộc tính đó

Ủ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

getImages()

Truy xuất tất cả InlineImages có trong phần này.

Cầu thủ trả bóng

InlineImage[] – hình ảnh phần

Ủ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

getListItems()

Truy xuất tất cả ListItems có trong phần này.

Cầu thủ trả bóng

ListItem[] – mục danh sách mục

Ủ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

getMarginBottom()

Truy xuất lề dưới cùng, tính bằng điểm.

Cầu thủ trả bóng

Number – lề dưới cùng, tính bằng điểm

Ủ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

getMarginLeft()

Truy xuất lề trái, tính bằng điểm.

Cầu thủ trả bóng

Number – lề trái, tính bằng điểm

Ủ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

getMarginRight()

Truy xuất lề phải.

Cầu thủ trả bóng

Number – lề phải, tính bằng điểm

Ủ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

getMarginTop()

Truy xuất lề trên.

Cầu thủ trả bóng

Number – lề trên cùng, tính bằng điểm

Ủ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

getNumChildren()

Truy xuất số lượng phần tử con.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Log the number of elements in the document.
Logger.log("There are " + body.getNumChildren() +
    " elements in the document body.");

Cầu thủ trả bóng

Integer – số lượng trẻ em

Ủ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

getPageHeight()

Truy xuất chiều cao của trang, tính theo điểm.

Cầu thủ trả bóng

Number – chiều cao của trang, tính bằng điểm

Ủ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

getPageWidth()

Truy xuất chiều rộng của trang, tính bằng điểm.

Cầu thủ trả bóng

Number – chiều rộng của trang, tính bằng điểm

Ủ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

getParagraphs()

Truy xuất tất cả Paragraphs có trong phần này (bao gồm cả ListItems).

Cầu thủ trả bóng

Paragraph[] – các đoạn văn

Ủ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

getParent()

Truy xuất phần tử mẹ của phần tử.

Phần tử mẹ chứa phần tử hiện tại.

Cầu thủ trả bóng

ContainerElement – Phần tử mẹ.

Ủ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

getTables()

Truy xuất tất cả Tables có trong phần này.

Cầu thủ trả bóng

Table[] — bảng mục

Ủ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

getText()

Truy xuất nội dung của phần tử dưới dạng chuỗi văn bản.

Cầu thủ trả bóng

String – nội dung của phần tử dưới dạng chuỗi văn bản

Ủ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

getTextAlignment()

Lấy căn chỉnh văn bản. Có các loại căn chỉnh là DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPTDocumentApp.TextAlignment.SUPERSCRIPT.

Cầu thủ trả bóng

TextAlignment – loại căn chỉnh văn bản, hoặc null nếu văn bản chứa nhiều loại căn chỉnh văn bản hoặc nếu chưa từng đặt cách căn chỉnh văn bản

Ủ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

getType()

Truy xuất ElementType của phần tử.

Sử dụng getType() để xác định loại chính xác của một phần tử nhất định.

var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document body.

var firstChild = body.getChild(0);

// Use getType() to determine the element's type.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  Logger.log('The first element is a paragraph.');
} else {
  Logger.log('The first element is not a paragraph.');
}

Cầu thủ trả bóng

ElementType – Loại phần tử.

Ủ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

insertHorizontalRule(childIndex)

Tạo và chèn một HorizontalRule mới tại chỉ mục đã chỉ định.

HorizontalRule này sẽ nằm trong một Paragraph mới.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử

Cầu thủ trả bóng

HorizontalRule — quy tắc ngang mới

Ủ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

insertImage(childIndex, image)

Tạo và chèn một InlineImage từ blob hình ảnh được chỉ định, tại chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
imageBlobSourcedữ liệu hình ảnh

Cầu thủ trả bóng

InlineImage – hình ảnh cùng dòng được chèn

Ủ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

insertImage(childIndex, image)

Chèn InlineImage đã cho vào chỉ mục đã chỉ định.

Hình ảnh đó sẽ được chứa trong một Paragraph mới.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
imageInlineImagehình ảnh cần chèn

Cầu thủ trả bóng

InlineImage – hình ảnh cùng dòng được chèn

Ủ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

insertListItem(childIndex, listItem)

Chèn ListItem đã cho vào chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
listItemListItemmục danh sách cần chèn

Cầu thủ trả bóng

ListItem – mục danh sách được chèn

Ủ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

insertListItem(childIndex, text)

Tạo và chèn một ListItem mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
textStringnội dung văn bản của mục danh sách

Cầu thủ trả bóng

ListItem – mục danh sách mới

Ủ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

insertPageBreak(childIndex)

Tạo và chèn một PageBreak mới tại chỉ mục đã chỉ định.

PageBreak này sẽ nằm trong một Paragraph mới.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử

Cầu thủ trả bóng

PageBreak — ngắt trang mới

Ủ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

insertPageBreak(childIndex, pageBreak)

Chèn PageBreak đã cho vào chỉ mục đã chỉ định.

PageBreak này sẽ nằm trong một Paragraph mới.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục để chèn phần tử
pageBreakPageBreakCANNOT TRANSLATE

Cầu thủ trả bóng

PageBreak — ngắt trang được chèn

Ủ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

insertParagraph(childIndex, paragraph)

Chèn Paragraph đã cho vào chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
paragraphParagraphđoạn cần chèn

Cầu thủ trả bóng

Paragraph – đoạn được chèn

Ủ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

insertParagraph(childIndex, text)

Tạo và chèn một Paragraph mới tại chỉ mục đã chỉ định, chứa nội dung văn bản đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
textStringnội dung văn bản của đoạn

Cầu thủ trả bóng

Paragraph — đoạn mới

Ủ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

insertTable(childIndex)

Tạo và chèn một Table mới tại chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn

Cầu thủ trả bóng

Table – bảng mới

Ủ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

insertTable(childIndex, cells)

Tạo và chèn một Table mới chứa các ô đã chỉ định, tại chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
cellsString[][]nội dung văn bản của các ô trong bảng cần thêm vào bảng mới

Cầu thủ trả bóng

Table – bảng mới

Ủ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

insertTable(childIndex, table)

Chèn Table đã cho vào chỉ mục đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childIndexIntegerchỉ mục cần chèn
tableTablebảng để chèn

Cầu thủ trả bóng

Table — bảng được chèn

Ủ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

removeChild(child)

Xoá phần tử con đã chỉ định.

Các tham số

TênLoạiNội dung mô tả
childElementphần tử con cần xoá

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

replaceText(searchPattern, replacement)

Thay thế tất cả các lần xuất hiện của một mẫu văn bản nhất định bằng một chuỗi thay thế nhất định, sử dụng các biểu thức chính quy.

Mẫu tìm kiếm được chuyển dưới dạng chuỗi, không phải đối tượng biểu thức chính quy JavaScript. Do đó, bạn sẽ cần phải thoát mọi dấu gạch chéo ngược trong mẫu.

Phương thức này sử dụng thư viện biểu thức chính quy RE2 của Google. Thư viện này giới hạn cú pháp được hỗ trợ.

Mẫu biểu thức chính quy đã cung cấp được so khớp độc lập với từng khối văn bản có trong phần tử hiện tại.

var body = DocumentApp.getActiveDocument().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

Các tham số

TênLoạiNội dung mô tả
searchPatternStringmẫu biểu thức chính quy để tìm kiếm
replacementStringvăn bản để thay thế

Cầu thủ trả bóng

Element – phần tử hiện tại

Ủ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

setAttributes(attributes)

Thiết lập các thuộc tính của phần tử.

Tham số thuộc tính được chỉ định phải là một đối tượng, trong đó mỗi tên thuộc tính là một mục trong bảng liệt kê DocumentApp.Attribute và mỗi giá trị thuộc tính là một giá trị mới sẽ được áp dụng.

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

Các tham số

TênLoạiNội dung mô tả
attributesObjectThuộc tính của phần tử.

Cầu thủ trả bóng

Body – Phần tử hiện tại.

Ủ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

setHeadingAttributes(paragraphHeading, attributes)

Thiết lập các thuộc tính cho ParagraphHeading đã cho.

Các tham số

TênLoạiNội dung mô tả
paragraphHeadingParagraphHeadingtiêu đề có các thuộc tính sẽ được đặt
attributesObjecttập hợp các thuộc tính và giá trị để thiết lập

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setMarginBottom(marginBottom)

Đặt lề dưới cùng, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
marginBottomNumberlề dưới, tính bằng điểm

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setMarginLeft(marginLeft)

Đặt lề trái, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
marginLeftNumberlề trái, tính bằng điểm

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setMarginRight(marginRight)

Đặt lề phải, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
marginRightNumberlề phải

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setMarginTop(marginTop)

Đặt lề trên.

Các tham số

TênLoạiNội dung mô tả
marginTopNumberlề trên, tính bằng điểm

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setPageHeight(pageHeight)

Đặt chiều cao của trang, tính theo điểm.

Các tham số

TênLoạiNội dung mô tả
pageHeightNumberchiều cao trang, tính bằng điểm

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setPageWidth(pageWidth)

Đặt chiều rộng của trang, tính bằng điểm.

Các tham số

TênLoạiNội dung mô tả
pageWidthNumberchiều rộng trang, tính bằng điểm

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setText(text)

Đặt nội dung dưới dạng văn bản thuần tuý.

Lưu ý: những nội dung hiện có sẽ bị xoá.

Các tham số

TênLoạiNội dung mô tả
textStringnội dung văn bản mới

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

setTextAlignment(textAlignment)

Đặt cách căn chỉnh văn bản. Có các loại căn chỉnh là DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPTDocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

Các tham số

TênLoạiNội dung mô tả
textAlignmentTextAlignmentloại căn chỉnh văn bản cần áp dụng

Cầu thủ trả bóng

Body – phần tử hiện tại

Ủ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

Các phương thức ngừng hoạt động