หน้านี้ได้รับการแปลโดย Cloud Translation API

Class HeaderSection

องค์ประกอบที่แสดงส่วนหัว Document โดยทั่วไปจะมี HeaderSection อย่างน้อย 1 รายการ HeaderSection อาจมีองค์ประกอบ ListItem, Paragraph และ Table ดูข้อมูลเพิ่มเติมเกี่ยวกับโครงสร้างเอกสารได้ที่คำแนะนำในการขยาย Google เอกสาร

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`appendHorizontalRule()`	`HorizontalRule`	สร้างและต่อท้าย `HorizontalRule` ใหม่
`appendImage(image)`	`InlineImage`	สร้างและต่อท้าย `InlineImage` ใหม่จาก Blob รูปภาพที่ระบุ
`appendImage(image)`	`InlineImage`	เพิ่ม `InlineImage` ที่ระบุต่อท้าย
`appendListItem(listItem)`	`ListItem`	เพิ่ม `ListItem` ที่ระบุต่อท้าย
`appendListItem(text)`	`ListItem`	สร้างและต่อท้าย `ListItem` ใหม่ซึ่งมีเนื้อหาข้อความที่ระบุ
`appendParagraph(paragraph)`	`Paragraph`	เพิ่ม `Paragraph` ที่ระบุต่อท้าย
`appendParagraph(text)`	`Paragraph`	สร้างและต่อท้าย `Paragraph` ใหม่ซึ่งมีเนื้อหาข้อความที่ระบุ
`appendTable()`	`Table`	สร้างและต่อท้าย `Table` ใหม่
`appendTable(cells)`	`Table`	ผนวก `Table` ใหม่ที่มี `TableCell` สำหรับค่าสตริงที่ระบุแต่ละค่า
`appendTable(table)`	`Table`	เพิ่ม `Table` ที่ระบุต่อท้าย
`clear()`	`HeaderSection`	ล้างเนื้อหาขององค์ประกอบ
`copy()`	`HeaderSection`	แสดงผลสำเนาแบบลึกที่แยกออกมาขององค์ประกอบปัจจุบัน
`editAsText()`	`Text`	รับองค์ประกอบปัจจุบันเวอร์ชัน `Text` เพื่อแก้ไข
`findElement(elementType)`	`RangeElement\|null`	ค้นหาเนื้อหาขององค์ประกอบสำหรับองค์ประกอบย่อยของประเภทที่ระบุ
`findElement(elementType, from)`	`RangeElement\|null`	ค้นหาเนื้อหาขององค์ประกอบสำหรับองค์ประกอบย่อยของประเภทที่ระบุ โดยเริ่มจาก `RangeElement` ที่ระบุ
`findText(searchPattern)`	`RangeElement\|null`	ค้นหารูปแบบข้อความที่ระบุในเนื้อหาขององค์ประกอบโดยใช้นิพจน์ทั่วไป
`findText(searchPattern, from)`	`RangeElement\|null`	ค้นหารูปแบบข้อความที่ระบุในเนื้อหาขององค์ประกอบ โดยเริ่มจากผลการค้นหาที่ระบุ
`getAttributes()`	`Object`	ดึงแอตทริบิวต์ขององค์ประกอบ
`getChild(childIndex)`	`Element`	ดึงข้อมูลองค์ประกอบย่อยที่ดัชนีขององค์ประกอบย่อยที่ระบุ
`getChildIndex(child)`	`Integer`	ดึงข้อมูลดัชนีขององค์ประกอบย่อยสำหรับองค์ประกอบย่อยที่ระบุ
`getImages()`	`InlineImage[]\|null`	ดึงข้อมูล `InlineImages` ทั้งหมดที่อยู่ในส่วน
`getListItems()`	`ListItem[]\|null`	ดึงข้อมูล `ListItems` ทั้งหมดที่อยู่ในส่วน
`getNumChildren()`	`Integer`	ดึงข้อมูลจำนวนเด็ก
`getParagraphs()`	`Paragraph[]\|null`	ดึงข้อมูล`Paragraphs`ทั้งหมดที่อยู่ในส่วน (รวมถึง `ListItems`)
`getParent()`	`ContainerElement\|null`	ดึงองค์ประกอบหลักขององค์ประกอบ
`getTables()`	`Table[]\|null`	ดึงข้อมูล `Tables` ทั้งหมดที่อยู่ในส่วน
`getText()`	`String`	ดึงเนื้อหาขององค์ประกอบเป็นสตริงข้อความ
`getTextAlignment()`	`TextAlignment\|null`	รับการจัดข้อความ
`getType()`	`ElementType`	ดึง `ElementType` ขององค์ประกอบ
`insertHorizontalRule(childIndex)`	`HorizontalRule`	สร้างและแทรก `HorizontalRule` ใหม่ที่ดัชนีที่ระบุ
`insertImage(childIndex, image)`	`InlineImage`	สร้างและแทรก `InlineImage` จาก Blob รูปภาพที่ระบุที่ดัชนีที่ระบุ
`insertImage(childIndex, image)`	`InlineImage`	แทรก `InlineImage` ที่ระบุในดัชนีที่ระบุ
`insertListItem(childIndex, listItem)`	`ListItem`	แทรก `ListItem` ที่ระบุในดัชนีที่ระบุ
`insertListItem(childIndex, text)`	`ListItem`	สร้างและแทรก `ListItem` ใหม่ที่ดัชนีที่ระบุ ซึ่งมีเนื้อหาข้อความที่ระบุ
`insertParagraph(childIndex, paragraph)`	`Paragraph`	แทรก `Paragraph` ที่ระบุในดัชนีที่ระบุ
`insertParagraph(childIndex, text)`	`Paragraph`	สร้างและแทรก `Paragraph` ใหม่ที่ดัชนีที่ระบุ ซึ่งมีเนื้อหาข้อความที่ระบุ
`insertTable(childIndex)`	`Table`	สร้างและแทรก `Table` ใหม่ที่ดัชนีที่ระบุ
`insertTable(childIndex, cells)`	`Table`	สร้างและแทรก `Table` ใหม่ซึ่งมีเซลล์ที่ระบุที่ดัชนีที่ระบุ
`insertTable(childIndex, table)`	`Table`	แทรก `Table` ที่ระบุในดัชนีที่ระบุ
`removeChild(child)`	`HeaderSection`	นำองค์ประกอบย่อยที่ระบุออก
`removeFromParent()`	`HeaderSection\|null`	นำองค์ประกอบออกจากองค์ประกอบหลัก
`replaceText(searchPattern, replacement)`	`Element`	แทนที่รูปแบบข้อความที่กำหนดทั้งหมดด้วยสตริงทดแทนที่กำหนดโดยใช้นิพจน์ทั่วไป
`setAttributes(attributes)`	`HeaderSection`	ตั้งค่าแอตทริบิวต์ขององค์ประกอบ
`setText(text)`	`HeaderSection`	ตั้งค่าเนื้อหาเป็นข้อความธรรมดา
`setTextAlignment(textAlignment)`	`HeaderSection`	ตั้งค่าการจัดข้อความ

วิธีการที่เลิกใช้งานแล้ว

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`getFootnotes()`	`Footnote[]\|null`	ดึงข้อมูล `Footnotes` ทั้งหมดที่อยู่ในส่วน
`getLinkUrl()`	`String\|null`	เรียก URL ของลิงก์
`getNextSibling()`	`Element`	ดึงองค์ประกอบพี่น้องถัดไปขององค์ประกอบ
`getPreviousSibling()`	`Element`	ดึงองค์ประกอบพี่น้องก่อนหน้าขององค์ประกอบ
`isAtDocumentEnd()`	`Boolean`	กำหนดว่าองค์ประกอบอยู่ท้าย `Document` หรือไม่
`setLinkUrl(url)`	`HeaderSection`	ตั้งค่า URL ของลิงก์

เอกสารโดยละเอียด

`appendHorizontalRule()`

สร้างและต่อท้าย HorizontalRule ใหม่

HorizontalRule จะอยู่ใน Paragraph ใหม่

รีเทิร์น

HorizontalRule — เส้นคั่นแนวนอนใหม่

การให้สิทธิ์

สคริปต์ที่ใช้วิธีนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

`appendImage(image)`

สร้างและต่อท้าย InlineImage ใหม่จาก Blob รูปภาพที่ระบุ

รูปภาพจะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`image`	`BlobSource`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพที่ต่อท้าย

การให้สิทธิ์

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

`appendImage(image)`

เพิ่ม InlineImage ที่ระบุต่อท้าย

InlineImage จะอยู่ใน Paragraph ใหม่

ใช้ appendImage เวอร์ชันนี้เมื่อต่อท้ายสำเนาของ InlineImage ที่มีอยู่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`image`	`InlineImage`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพที่ต่อท้าย

การให้สิทธิ์

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

`appendListItem(listItem)`

เพิ่ม ListItem ที่ระบุต่อท้าย

ใช้ appendListItem เวอร์ชันนี้เมื่อต่อท้ายสำเนาของ ListItem ที่มีอยู่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`listItem`	`ListItem`	รายการที่จะต่อท้าย

รีเทิร์น

ListItem — รายการที่ต่อท้าย

การให้สิทธิ์

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

`appendListItem(text)`

สร้างและต่อท้าย ListItem ใหม่ซึ่งมีเนื้อหาข้อความที่ระบุ

ระบบจะเพิ่มรายการในลิสต์ที่ต่อเนื่องกันเป็นส่วนหนึ่งของลิสต์เดียวกัน

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาข้อความของรายการในลิสต์

รีเทิร์น

ListItem — รายการใหม่

การให้สิทธิ์

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

`appendParagraph(paragraph)`

เพิ่ม Paragraph ที่ระบุต่อท้าย

ใช้ appendParagraph เวอร์ชันนี้เมื่อต่อท้ายสำเนาของ Paragraph ที่มีอยู่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`paragraph`	`Paragraph`	ย่อหน้าที่จะเพิ่ม

รีเทิร์น

Paragraph — ย่อหน้าที่เพิ่ม

การให้สิทธิ์

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

`appendParagraph(text)`

สร้างและต่อท้าย Paragraph ใหม่ซึ่งมีเนื้อหาข้อความที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาข้อความของย่อหน้า

รีเทิร์น

Paragraph — ย่อหน้าใหม่

การให้สิทธิ์

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

`appendTable()`

สร้างและต่อท้าย Table ใหม่

นอกจากนี้ วิธีนี้จะเพิ่มย่อหน้าที่ว่างเปล่าหลังตารางด้วย เนื่องจากเอกสาร Google เอกสาร ไม่สามารถลงท้ายด้วยตารางได้

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`appendTable(cells)`

ผนวก Table ใหม่ที่มี TableCell สำหรับค่าสตริงที่ระบุแต่ละค่า

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`cells`	`String[][]`	เนื้อหาข้อความของเซลล์ตารางที่จะเพิ่มลงในตารางใหม่

รีเทิร์น

Table — ตารางที่ต่อท้าย

การให้สิทธิ์

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

`appendTable(table)`

เพิ่ม Table ที่ระบุต่อท้าย

ใช้ appendTable เวอร์ชันนี้เมื่อต่อท้ายสำเนาของ Table ที่มีอยู่ นอกจากนี้ วิธีนี้จะเพิ่มย่อหน้าที่ว่างเปล่าหลังตารางด้วย เนื่องจากเอกสาร Google เอกสาร ไม่สามารถลงท้ายด้วยตารางได้

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`table`	`Table`	ตารางที่จะต่อท้าย

รีเทิร์น

Table — ตารางที่ต่อท้าย

การให้สิทธิ์

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

`clear()`

ล้างเนื้อหาขององค์ประกอบ

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

`copy()`

แสดงผลสำเนาแบบลึกที่แยกออกมาขององค์ประกอบปัจจุบัน

ระบบจะคัดลอกองค์ประกอบย่อยที่อยู่ในองค์ประกอบด้วย องค์ประกอบใหม่ไม่มี องค์ประกอบหลัก

รีเทิร์น

HeaderSection — สำเนาใหม่

การให้สิทธิ์

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

`editAsText()`

รับองค์ประกอบปัจจุบันเวอร์ชัน Text เพื่อแก้ไข

ใช้ editAsText เพื่อจัดการเนื้อหาขององค์ประกอบเป็น Rich Text editAsText จะไม่สนใจองค์ประกอบที่ไม่ใช่ข้อความ (เช่น InlineImage และ HorizontalRule)

ระบบจะนำองค์ประกอบย่อยที่อยู่ในช่วงข้อความที่ถูกลบออกอย่างสมบูรณ์ออกจากองค์ประกอบ

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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);

รีเทิร์น

Text - ข้อความขององค์ประกอบปัจจุบัน

`findElement(elementType)`

ค้นหาเนื้อหาขององค์ประกอบสำหรับองค์ประกอบย่อยของประเภทที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`elementType`	`ElementType`	ประเภทขององค์ประกอบที่จะค้นหา

รีเทิร์น

RangeElement|null — ผลการค้นหาที่ระบุตำแหน่งขององค์ประกอบการค้นหา

การให้สิทธิ์

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

`findElement(elementType, from)`

ค้นหาเนื้อหาขององค์ประกอบสำหรับองค์ประกอบย่อยของประเภทที่ระบุ โดยเริ่มจาก RangeElement ที่ระบุ

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Define the search parameters.

let searchResult = null;

// Search until the paragraph is found.
while (
    (searchResult = body.findElement(
         DocumentApp.ElementType.PARAGRAPH,
         searchResult,
         ))) {
  const par = searchResult.getElement().asParagraph();
  if (par.getHeading() === DocumentApp.ParagraphHeading.HEADING1) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    break;
  }
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`elementType`	`ElementType`	ประเภทขององค์ประกอบที่จะค้นหา
`from`	`RangeElement`	ผลการค้นหาที่จะค้นหา

รีเทิร์น

RangeElement|null — ผลการค้นหาที่ระบุตำแหน่งถัดไปขององค์ประกอบการค้นหา

การให้สิทธิ์

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

`findText(searchPattern)`

ค้นหารูปแบบข้อความที่ระบุในเนื้อหาขององค์ประกอบโดยใช้นิพจน์ทั่วไป

ระบบไม่รองรับฟีเจอร์นิพจน์ทั่วไปของ JavaScript บางส่วนอย่างเต็มที่ เช่น กลุ่มจับภาพและตัวแก้ไขโหมด

รูปแบบนิพจน์ทั่วไปที่ระบุจะได้รับการจับคู่กับบล็อกข้อความแต่ละบล็อก ที่อยู่ในองค์ประกอบปัจจุบันโดยอิสระ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบที่จะค้นหา

รีเทิร์น

RangeElement|null — ผลการค้นหาที่ระบุตำแหน่งของข้อความค้นหา หรือ null หากไม่มี รายการที่ตรงกัน

การให้สิทธิ์

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

`findText(searchPattern, from)`

ค้นหารูปแบบข้อความที่ระบุในเนื้อหาขององค์ประกอบ โดยเริ่มจากผลการค้นหาที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบที่จะค้นหา
`from`	`RangeElement`	ผลการค้นหาที่จะค้นหา

รีเทิร์น

RangeElement|null — ผลการค้นหาที่ระบุตำแหน่งถัดไปของข้อความค้นหา หรือ null หากไม่มี รายการที่ตรงกัน

การให้สิทธิ์

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

`getAttributes()`

ดึงแอตทริบิวต์ขององค์ประกอบ

ผลลัพธ์คือออบเจ็กต์ที่มีพร็อพเพอร์ตี้สำหรับแอตทริบิวต์ขององค์ประกอบที่ถูกต้องแต่ละรายการ โดยที่ชื่อพร็อพเพอร์ตี้แต่ละชื่อจะสอดคล้องกับรายการในDocumentApp.Attributeการแจงนับ

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

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

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

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

รีเทิร์น

Object — แอตทริบิวต์ขององค์ประกอบ

การให้สิทธิ์

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

`getChild(childIndex)`

ดึงข้อมูลองค์ประกอบย่อยที่ดัชนีขององค์ประกอบย่อยที่ระบุ

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Obtain the first element in the tab.
const 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.');
}

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีขององค์ประกอบย่อยที่จะดึงข้อมูล

รีเทิร์น

Element - องค์ประกอบย่อยที่ดัชนีที่ระบุ

การให้สิทธิ์

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

`getChildIndex(child)`

ดึงข้อมูลดัชนีขององค์ประกอบย่อยสำหรับองค์ประกอบย่อยที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Element`	องค์ประกอบย่อยที่จะดึงดัชนี

รีเทิร์น

Integer — ดัชนีขององค์ประกอบย่อย

การให้สิทธิ์

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

`getImages()`

ดึงข้อมูล InlineImages ทั้งหมดที่อยู่ในส่วน

รีเทิร์น

InlineImage[]|null — รูปภาพส่วน

การให้สิทธิ์

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

`getListItems()`

ดึงข้อมูล ListItems ทั้งหมดที่อยู่ในส่วน

รีเทิร์น

ListItem[]|null — รายการในส่วน

การให้สิทธิ์

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

`getNumChildren()`

ดึงข้อมูลจำนวนเด็ก

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

// Log the number of elements in the tab.
Logger.log(`There are ${body.getNumChildren()} elements in the tab's body.`);

รีเทิร์น

Integer — จำนวนเด็ก

การให้สิทธิ์

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

`getParagraphs()`

ดึงข้อมูลParagraphsทั้งหมดที่อยู่ในส่วน (รวมถึง ListItems)

รีเทิร์น

Paragraph[]|null — ย่อหน้าของส่วน

การให้สิทธิ์

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

`getParent()`

ดึงองค์ประกอบหลักขององค์ประกอบ

องค์ประกอบหลักมีองค์ประกอบปัจจุบัน

รีเทิร์น

ContainerElement|null — องค์ประกอบระดับบนสุด

การให้สิทธิ์

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

`getTables()`

ดึงข้อมูล Tables ทั้งหมดที่อยู่ในส่วน

รีเทิร์น

Table[]|null — ตารางส่วน

การให้สิทธิ์

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

`getText()`

ดึงเนื้อหาขององค์ประกอบเป็นสตริงข้อความ

รีเทิร์น

String — เนื้อหาขององค์ประกอบเป็นสตริงข้อความ

การให้สิทธิ์

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

`getTextAlignment()`

รับการจัดข้อความ ประเภทการจัดแนวที่ใช้ได้คือ DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT และ DocumentApp.TextAlignment.SUPERSCRIPT

รีเทิร์น

TextAlignment|null — ประเภทการจัดแนวข้อความ หรือ null หากข้อความมีการจัดแนวข้อความหลายประเภท หรือหากไม่เคยตั้งค่าการจัดแนวข้อความ

การให้สิทธิ์

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

`getType()`

ดึง ElementType ขององค์ประกอบ

ใช้ getType() เพื่อระบุประเภทที่แน่นอนขององค์ประกอบที่กำหนด

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Obtain the first element in the active tab's body.

const 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.');
}

รีเทิร์น

ElementType — ประเภทองค์ประกอบ

การให้สิทธิ์

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

`insertHorizontalRule(childIndex)`

สร้างและแทรก HorizontalRule ใหม่ที่ดัชนีที่ระบุ

HorizontalRule จะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ

รีเทิร์น

HorizontalRule — เส้นคั่นแนวนอนใหม่

การให้สิทธิ์

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

`insertImage(childIndex, image)`

สร้างและแทรก InlineImage จาก Blob รูปภาพที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`image`	`BlobSource`	ข้อมูลรูปภาพ

รีเทิร์น

InlineImage — รูปภาพในบรรทัดที่แทรก

การให้สิทธิ์

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

`insertImage(childIndex, image)`

แทรก InlineImage ที่ระบุในดัชนีที่ระบุ

รูปภาพจะอยู่ใน Paragraph ใหม่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรกองค์ประกอบ
`image`	`InlineImage`	รูปภาพที่จะแทรก

รีเทิร์น

InlineImage — รูปภาพในบรรทัดที่แทรก

การให้สิทธิ์

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

`insertListItem(childIndex, listItem)`

แทรก ListItem ที่ระบุในดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`listItem`	`ListItem`	รายการที่จะแทรก

รีเทิร์น

ListItem — รายการที่แทรก

การให้สิทธิ์

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

`insertListItem(childIndex, text)`

สร้างและแทรก ListItem ใหม่ที่ดัชนีที่ระบุ ซึ่งมีเนื้อหาข้อความที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`text`	`String`	เนื้อหาข้อความของรายการในลิสต์

รีเทิร์น

ListItem — รายการใหม่

การให้สิทธิ์

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

`insertParagraph(childIndex, paragraph)`

แทรก Paragraph ที่ระบุในดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`paragraph`	`Paragraph`	ย่อหน้าที่จะแทรก

รีเทิร์น

Paragraph — ย่อหน้าที่แทรก

การให้สิทธิ์

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

`insertParagraph(childIndex, text)`

สร้างและแทรก Paragraph ใหม่ที่ดัชนีที่ระบุ ซึ่งมีเนื้อหาข้อความที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`text`	`String`	เนื้อหาข้อความของย่อหน้า

รีเทิร์น

Paragraph — ย่อหน้าใหม่

การให้สิทธิ์

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

`insertTable(childIndex)`

สร้างและแทรก Table ใหม่ที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`insertTable(childIndex, cells)`

สร้างและแทรก Table ใหม่ซึ่งมีเซลล์ที่ระบุที่ดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`cells`	`String[][]`	เนื้อหาข้อความของเซลล์ตารางที่จะเพิ่มลงในตารางใหม่

รีเทิร์น

Table — ตารางใหม่

การให้สิทธิ์

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

`insertTable(childIndex, table)`

แทรก Table ที่ระบุในดัชนีที่ระบุ

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`childIndex`	`Integer`	ดัชนีที่จะแทรก
`table`	`Table`	ตารางที่จะแทรก

รีเทิร์น

Table — ตารางที่แทรก

การให้สิทธิ์

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

`removeChild(child)`

นำองค์ประกอบย่อยที่ระบุออก

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`child`	`Element`	องค์ประกอบย่อยที่จะนำออก

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`removeFromParent()`

นำองค์ประกอบออกจากองค์ประกอบหลัก

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Remove all images in the active tab's body.
const imgs = body.getImages();
for (let i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

รีเทิร์น

HeaderSection|null — องค์ประกอบที่นำออก

การให้สิทธิ์

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

`replaceText(searchPattern, replacement)`

แทนที่รูปแบบข้อความที่กำหนดทั้งหมดด้วยสตริงทดแทนที่กำหนดโดยใช้นิพจน์ทั่วไป

ระบบจะส่งรูปแบบการค้นหาเป็นสตริง ไม่ใช่ออบเจ็กต์นิพจน์ทั่วไปของ JavaScript ด้วยเหตุนี้ คุณจึงต้องหลีกเลี่ยงการใช้แบ็กสแลชในรูปแบบ

วิธีการนี้ใช้ไลบรารีนิพจน์ทั่วไป RE2 ของ Google ซึ่งจำกัดไวยากรณ์ที่รองรับ

const body =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody();

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`searchPattern`	`String`	รูปแบบนิพจน์ทั่วไปที่จะค้นหา
`replacement`	`String`	ข้อความที่จะใช้แทน

รีเทิร์น

Element — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setAttributes(attributes)`

ตั้งค่าแอตทริบิวต์ขององค์ประกอบ

พารามิเตอร์แอตทริบิวต์ที่ระบุต้องเป็นออบเจ็กต์ที่ชื่อพร็อพเพอร์ตี้แต่ละรายการเป็นรายการใน การแจงนับ DocumentApp.Attribute และค่าพร็อพเพอร์ตี้แต่ละรายการเป็นค่าใหม่ที่จะ ใช้

const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const body = documentTab.getBody();

// Define a custom paragraph style.
const 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.
const par = body.appendParagraph('A paragraph with custom style.');

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

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`attributes`	`Object`	แอตทริบิวต์ขององค์ประกอบ

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setText(text)`

ตั้งค่าเนื้อหาเป็นข้อความธรรมดา

หมายเหตุ: ระบบจะล้างเนื้อหาที่มีอยู่

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`text`	`String`	เนื้อหาข้อความใหม่

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

`setTextAlignment(textAlignment)`

ตั้งค่าการจัดข้อความ ประเภทการจัดแนวที่ใช้ได้คือ DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT และ DocumentApp.TextAlignment.SUPERSCRIPT

// Make the entire first paragraph in the active tab be superscript.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const text = documentTab.getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`textAlignment`	`TextAlignment`	ประเภทการจัดแนวข้อความที่จะใช้

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

วิธีการที่เลิกใช้งานแล้ว

`getFootnotes()`

เลิกใช้งานแล้ว องค์ประกอบนี้ต้องไม่มี Footnote

ดึงข้อมูล Footnotes ทั้งหมดที่อยู่ในส่วน

รีเทิร์น

Footnote[]|null - เชิงอรรถของส่วน

การให้สิทธิ์

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

`getLinkUrl()`

เลิกใช้งานแล้ว แทนที่จะใช้ลิงก์กับทั้งส่วน ให้ใช้ลิงก์กับองค์ประกอบ ภายในส่วนแทน

เรียก URL ของลิงก์

รีเทิร์น

String|null — URL ของลิงก์ หรือ null หากองค์ประกอบมีค่าหลายค่าสำหรับแอตทริบิวต์นี้

การให้สิทธิ์

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

`getNextSibling()`

เลิกใช้งานแล้ว องค์ประกอบนี้ไม่มีองค์ประกอบที่อยู่ระดับเดียวกัน

ดึงองค์ประกอบพี่น้องถัดไปขององค์ประกอบ

องค์ประกอบระดับข้างเคียงถัดไปมีองค์ประกอบหลักเดียวกันและอยู่ต่อจากองค์ประกอบปัจจุบัน

รีเทิร์น

Element — องค์ประกอบร่วมถัดไป

การให้สิทธิ์

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

`getPreviousSibling()`

เลิกใช้งานแล้ว องค์ประกอบนี้ไม่มีองค์ประกอบที่อยู่ระดับเดียวกัน

ดึงองค์ประกอบพี่น้องก่อนหน้าขององค์ประกอบ

องค์ประกอบระดับข้างเคียงก่อนหน้ามีองค์ประกอบระดับบนสุดเดียวกันและอยู่ก่อนองค์ประกอบปัจจุบัน

รีเทิร์น

Element — องค์ประกอบระดับข้างเคียงก่อนหน้า

การให้สิทธิ์

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

`isAtDocumentEnd()`

เลิกใช้งานแล้ว วิธีนี้ไม่น่าเชื่อถือสำหรับ HeaderSection

กำหนดว่าองค์ประกอบอยู่ท้าย Document หรือไม่

รีเทิร์น

Boolean — องค์ประกอบอยู่ที่ส่วนท้ายของแท็บหรือไม่

การให้สิทธิ์

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

`setLinkUrl(url)`

ตั้งค่า URL ของลิงก์

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL ของลิงก์

รีเทิร์น

HeaderSection — องค์ประกอบปัจจุบัน

การให้สิทธิ์

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

Class HeaderSection จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

เมธอด

วิธีการที่เลิกใช้งานแล้ว

เอกสารโดยละเอียด

appendHorizontalRule()

รีเทิร์น

การให้สิทธิ์

appendImage(image)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendImage(image)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendListItem(listItem)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendListItem(text)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendParagraph(paragraph)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendParagraph(text)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendTable()

รีเทิร์น

การให้สิทธิ์

appendTable(cells)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

appendTable(table)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

clear()

รีเทิร์น

copy()

รีเทิร์น

การให้สิทธิ์

editAsText()

รีเทิร์น

findElement(elementType)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

findElement(elementType, from)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

findText(searchPattern)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

findText(searchPattern, from)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

getAttributes()

รีเทิร์น

การให้สิทธิ์

getChild(childIndex)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

getChildIndex(child)

พารามิเตอร์

รีเทิร์น

การให้สิทธิ์

getImages()

รีเทิร์น

การให้สิทธิ์

getListItems()

Class HeaderSection

`appendHorizontalRule()`

`appendImage(image)`

`appendImage(image)`

`appendListItem(listItem)`

`appendListItem(text)`

`appendParagraph(paragraph)`

`appendParagraph(text)`

`appendTable()`

`appendTable(cells)`

`appendTable(table)`

`clear()`

`copy()`

`editAsText()`

`findElement(elementType)`

`findElement(elementType, from)`

`findText(searchPattern)`

`findText(searchPattern, from)`

`getAttributes()`

`getChild(childIndex)`

`getChildIndex(child)`

`getImages()`

`getListItems()`

`getNumChildren()`

`getParagraphs()`

`getParent()`

`getTables()`

`getText()`

`getTextAlignment()`

`getType()`

`insertHorizontalRule(childIndex)`

`insertImage(childIndex, image)`

`insertImage(childIndex, image)`

`insertListItem(childIndex, listItem)`

`insertListItem(childIndex, text)`

`insertParagraph(childIndex, paragraph)`

`insertParagraph(childIndex, text)`

`insertTable(childIndex)`

`insertTable(childIndex, cells)`

`insertTable(childIndex, table)`

`removeChild(child)`

`removeFromParent()`