Class TableCell

TableCell

Elemen yang merepresentasikan sel tabel. TableCell selalu dimuat dalam TableRow dan dapat berisi elemen ListItem, Paragraph, atau Table. Untuk informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas Google Dokumen.

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
appendHorizontalRule()	HorizontalRule	Membuat dan menambahkan HorizontalRule baru.
appendImage(image)	InlineImage	Membuat dan menambahkan InlineImage baru dari blob gambar yang ditentukan.
appendImage(image)	InlineImage	Menambahkan InlineImage yang diberikan.
appendListItem(listItem)	ListItem	Menambahkan ListItem yang diberikan.
appendListItem(text)	ListItem	Membuat dan menambahkan ListItem baru.
appendParagraph(paragraph)	Paragraph	Menambahkan Paragraph yang diberikan.
appendParagraph(text)	Paragraph	Membuat dan menambahkan Paragraph baru.
appendTable()	Table	Membuat dan menambahkan Table baru.
appendTable(cells)	Table	Menambahkan Table baru yang berisi sel yang ditentukan.
appendTable(table)	Table	Menambahkan Table yang diberikan.
clear()	TableCell	Menghapus konten elemen.
copy()	TableCell	Menampilkan salinan mendalam yang terlepas dari elemen saat ini.
editAsText()	Text	Mendapatkan versi Text dari elemen saat ini, untuk pengeditan.
findElement(elementType)	RangeElement|null	Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.
findElement(elementType, from)	RangeElement|null	Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari RangeElement yang ditentukan.
findText(searchPattern)	RangeElement|null	Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.
findText(searchPattern, from)	RangeElement|null	Menelusuri konten elemen untuk menemukan pola teks yang ditentukan, dimulai dari hasil penelusuran tertentu.
getAttributes()	Object	Mengambil atribut elemen.
getBackgroundColor()	String|null	Mengambil warna latar belakang.
getChild(childIndex)	Element	Mengambil elemen turunan pada indeks turunan yang ditentukan.
getChildIndex(child)	Integer	Mengambil indeks turunan untuk elemen turunan yang ditentukan.
getColSpan()	Integer	Mengambil rentang kolom, yaitu jumlah kolom sel tabel yang direntangkan oleh sel ini.
getLinkUrl()	String|null	Mengambil URL link.
getNextSibling()	Element|null	Mengambil elemen pasangan berikutnya dari elemen.
getNumChildren()	Integer	Mengambil jumlah anak.
getPaddingBottom()	Number|null	Mengambil padding bawah, dalam poin.
getPaddingLeft()	Number|null	Mengambil padding kiri, dalam poin.
getPaddingRight()	Number|null	Mengambil padding kanan, dalam poin.
getPaddingTop()	Number|null	Mengambil padding atas, dalam poin.
getParent()	ContainerElement|null	Mengambil elemen induk elemen.
getParentRow()	TableRow|null	Mengambil TableRow yang berisi TableCell saat ini.
getParentTable()	Table|null	Mengambil Table yang berisi TableCell saat ini.
getPreviousSibling()	Element|null	Mengambil elemen saudara sebelumnya dari elemen.
getRowSpan()	Integer	Mengambil rentang baris, yaitu jumlah baris sel tabel yang direntangkan oleh sel ini.
getText()	String	Mengambil konten elemen sebagai string teks.
getTextAlignment()	TextAlignment|null	Mendapatkan perataan teks.
getType()	ElementType	Mengambil ElementType elemen.
getVerticalAlignment()	VerticalAlignment|null	Mengambil VerticalAlignment.
getWidth()	Number|null	Mengambil lebar kolom yang berisi sel, dalam poin.
insertHorizontalRule(childIndex)	HorizontalRule	Membuat dan menyisipkan HorizontalRule baru pada indeks yang ditentukan.
insertImage(childIndex, image)	InlineImage	Membuat dan menyisipkan InlineImage dari blob gambar yang ditentukan, pada indeks yang ditentukan.
insertImage(childIndex, image)	InlineImage	Menyisipkan InlineImage yang diberikan pada indeks yang ditentukan.
insertListItem(childIndex, listItem)	ListItem	Menyisipkan ListItem yang diberikan pada indeks yang ditentukan.
insertListItem(childIndex, text)	ListItem	Membuat dan menyisipkan ListItem baru pada indeks yang ditentukan.
insertParagraph(childIndex, paragraph)	Paragraph	Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan.
insertParagraph(childIndex, text)	Paragraph	Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan.
insertTable(childIndex)	Table	Membuat dan menyisipkan Table baru pada indeks yang ditentukan.
insertTable(childIndex, cells)	Table	Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan.
insertTable(childIndex, table)	Table	Menyisipkan Table yang diberikan pada indeks yang ditentukan.
isAtDocumentEnd()	Boolean	Menentukan apakah elemen berada di akhir Document.
merge()	TableCell|null	Menggabungkan elemen dengan elemen saudara sebelumnya dengan jenis yang sama.
removeChild(child)	TableCell	Menghapus elemen turunan yang ditentukan.
removeFromParent()	TableCell|null	Menghapus elemen dari induknya.
replaceText(searchPattern, replacement)	Element	Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler.
setAttributes(attributes)	TableCell	Menetapkan atribut elemen.
setBackgroundColor(color)	TableCell	Menetapkan warna latar belakang.
setLinkUrl(url)	TableCell	Menetapkan URL link.
setPaddingBottom(paddingBottom)	TableCell	Menetapkan padding bawah, dalam poin.
setPaddingLeft(paddingLeft)	TableCell	Menetapkan padding kiri, dalam poin.
setPaddingRight(paddingRight)	TableCell	Menetapkan padding kanan, dalam poin.
setPaddingTop(paddingTop)	TableCell	Menetapkan padding atas, dalam poin.
setText(text)	TableCell	Menetapkan konten sebagai teks biasa.
setTextAlignment(textAlignment)	TableCell	Menetapkan perataan teks.
setVerticalAlignment(alignment)	TableCell	Menetapkan perataan vertikal.
setWidth(width)	TableCell	Menetapkan lebar kolom yang berisi sel saat ini, dalam poin.

Dokumentasi mendetail

appendHorizontalRule()

Membuat dan menambahkan HorizontalRule baru.

HorizontalRule akan dimuat dalam Paragraph baru.

Pulang pergi

HorizontalRule — aturan horizontal baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendImage(image)

Membuat dan menambahkan InlineImage baru dari blob gambar yang ditentukan.

InlineImage akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
image	BlobSource	data gambar

Pulang pergi

InlineImage — gambar baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendImage(image)

Menambahkan InlineImage yang diberikan.

InlineImage akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
image	InlineImage	data gambar

Pulang pergi

InlineImage — gambar yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendListItem(listItem)

Menambahkan ListItem yang diberikan.

Parameter

Nama	Jenis	Deskripsi
listItem	ListItem	item daftar yang akan ditambahkan

Pulang pergi

ListItem — item daftar yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendListItem(text)

Membuat dan menambahkan ListItem baru.

Parameter

Nama	Jenis	Deskripsi
text	String	isi teks

Pulang pergi

ListItem — item daftar baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendParagraph(paragraph)

Menambahkan Paragraph yang diberikan.

Parameter

Nama	Jenis	Deskripsi
paragraph	Paragraph	paragraf yang akan ditambahkan

Pulang pergi

Paragraph — paragraf yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendParagraph(text)

Membuat dan menambahkan Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
text	String	isi teks

Pulang pergi

Paragraph — paragraf baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendTable()

Membuat dan menambahkan Table baru.

Pulang pergi

Table — tabel baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendTable(cells)

Menambahkan Table baru yang berisi sel yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
cells	String[][]	konten teks sel tabel yang akan ditambahkan ke tabel baru

Pulang pergi

Table — tabel yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

appendTable(table)

Menambahkan Table yang diberikan.

Parameter

Nama	Jenis	Deskripsi
table	Table	tabel yang akan ditambahkan

Pulang pergi

Table — tabel yang ditambahkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

clear()

Menghapus konten elemen.

Pulang pergi

TableCell — Elemen saat ini.

---

copy()

Menampilkan salinan mendalam yang terlepas dari elemen saat ini.

Semua elemen turunan yang ada dalam elemen juga disalin. Elemen baru tidak memiliki induk.

Pulang pergi

TableCell — Salinan baru.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

editAsText()

Mendapatkan versi Text dari elemen saat ini, untuk pengeditan.

Gunakan editAsText untuk memanipulasi konten elemen sebagai teks kaya. Mode editAsText mengabaikan elemen non-teks (seperti InlineImage dan HorizontalRule).

Elemen turunan yang sepenuhnya berada dalam rentang teks yang dihapus akan dihapus dari elemen.

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

Pulang pergi

Text — versi teks dari elemen saat ini

---

findElement(elementType)

Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
elementType	ElementType	Jenis elemen yang akan ditelusuri.

Pulang pergi

RangeElement|null — Hasil penelusuran yang menunjukkan posisi elemen penelusuran.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

findElement(elementType, from)

Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari RangeElement yang ditentukan.

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;
  }
}

Parameter

Nama	Jenis	Deskripsi
elementType	ElementType	Jenis elemen yang akan ditelusuri.
from	RangeElement	Hasil penelusuran yang akan ditelusuri.

Pulang pergi

RangeElement|null — Hasil penelusuran yang menunjukkan posisi berikutnya dari elemen penelusuran.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

findText(searchPattern)

Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.

Sebagian fitur ekspresi reguler JavaScript tidak sepenuhnya didukung, seperti grup pengambilan dan pengubah mode.

Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.

Parameter

Nama	Jenis	Deskripsi
searchPattern	String	pola yang akan ditelusuri

Pulang pergi

RangeElement|null — hasil penelusuran yang menunjukkan posisi teks penelusuran, atau null jika tidak ada kecocokan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

findText(searchPattern, from)

Menelusuri konten elemen untuk menemukan pola teks yang ditentukan, dimulai dari hasil penelusuran tertentu.

Sebagian fitur ekspresi reguler JavaScript tidak sepenuhnya didukung, seperti grup pengambilan dan pengubah mode.

Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.

Parameter

Nama	Jenis	Deskripsi
searchPattern	String	pola yang akan ditelusuri
from	RangeElement	hasil penelusuran yang akan digunakan untuk memulai penelusuran

Pulang pergi

RangeElement|null — hasil penelusuran yang menunjukkan posisi berikutnya dari teks penelusuran, atau null jika tidak ada kecocokan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getAttributes()

Mengambil atribut elemen.

Hasilnya adalah objek yang berisi properti untuk setiap atribut elemen yang valid, dengan setiap nama properti sesuai dengan item dalam enumerasi 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]}`);
}

Pulang pergi

Object — Atribut elemen.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getBackgroundColor()

Mengambil warna latar belakang.

Pulang pergi

String|null — warna latar belakang, diformat dalam notasi CSS (seperti '#ffffff')

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getChild(childIndex)

Mengambil elemen turunan pada indeks turunan yang ditentukan.

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

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	Indeks elemen turunan yang akan diambil.

Pulang pergi

Element — Elemen turunan pada indeks yang ditentukan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getChildIndex(child)

Mengambil indeks turunan untuk elemen turunan yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
child	Element	Elemen turunan yang indeksnya akan diambil.

Pulang pergi

Integer — Indeks turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getColSpan()

Mengambil rentang kolom, yaitu jumlah kolom sel tabel yang direntangkan oleh sel ini. Sel yang tidak digabungkan memiliki rentang kolom 1.

Pulang pergi

Integer — rentang kolom atau 0 untuk sel yang digabungkan dengan sel lain

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getLinkUrl()

Mengambil URL link.

Pulang pergi

String|null — URL link, atau null jika elemen berisi beberapa nilai untuk atribut ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getNextSibling()

Mengambil elemen pasangan berikutnya dari elemen.

Saudara berikutnya memiliki induk yang sama dan mengikuti elemen saat ini.

Pulang pergi

Element|null — Elemen saudara berikutnya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getNumChildren()

Mengambil jumlah anak.

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.`);

Pulang pergi

Integer — Jumlah turunan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPaddingBottom()

Mengambil padding bawah, dalam poin.

Pulang pergi

Number|null — padding bawah, dalam poin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPaddingLeft()

Mengambil padding kiri, dalam poin.

Pulang pergi

Number|null — padding kiri, dalam poin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPaddingRight()

Mengambil padding kanan, dalam poin.

Pulang pergi

Number|null — padding kanan, dalam poin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPaddingTop()

Mengambil padding atas, dalam poin.

Pulang pergi

Number|null — padding atas, dalam poin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getParent()

Mengambil elemen induk elemen.

Elemen induk berisi elemen saat ini.

Pulang pergi

ContainerElement|null — Elemen induk.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getParentRow()

Mengambil TableRow yang berisi TableCell saat ini.

Pulang pergi

TableRow|null — baris tabel yang berisi sel saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getParentTable()

Mengambil Table yang berisi TableCell saat ini.

Pulang pergi

Table|null — tabel yang berisi sel saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getPreviousSibling()

Mengambil elemen saudara sebelumnya dari elemen.

Saudara sebelumnya memiliki induk yang sama dan mendahului elemen saat ini.

Pulang pergi

Element|null — Elemen saudara sebelumnya.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getRowSpan()

Mengambil rentang baris, yaitu jumlah baris sel tabel yang direntangkan oleh sel ini. Sel yang tidak digabungkan memiliki rentang baris 1.

Pulang pergi

Integer — rentang baris atau 0 untuk sel yang digabungkan dengan sel lain

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getText()

Mengambil konten elemen sebagai string teks.

Pulang pergi

String — konten elemen sebagai string teks

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getTextAlignment()

Mendapatkan perataan teks. Jenis perataan yang tersedia adalah DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, dan DocumentApp.TextAlignment.SUPERSCRIPT.

Pulang pergi

TextAlignment|null — jenis perataan teks, atau null jika teks berisi beberapa jenis perataan teks atau jika perataan teks belum pernah ditetapkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getType()

Mengambil ElementType elemen.

Gunakan getType() untuk menentukan jenis pasti elemen tertentu.

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

Pulang pergi

ElementType — Jenis elemen.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getVerticalAlignment()

Mengambil VerticalAlignment.

Pulang pergi

VerticalAlignment|null — perataan vertikal

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

getWidth()

Mengambil lebar kolom yang berisi sel, dalam poin.

Pulang pergi

Number|null — lebar kolom, dalam poin

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertHorizontalRule(childIndex)

Membuat dan menyisipkan HorizontalRule baru pada indeks yang ditentukan.

Aturan horizontal akan berada dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan

Pulang pergi

HorizontalRule — aturan horizontal baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertImage(childIndex, image)

Membuat dan menyisipkan InlineImage dari blob gambar yang ditentukan, pada indeks yang ditentukan.

Gambar akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
image	BlobSource	data gambar

Pulang pergi

InlineImage — gambar sebaris yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertImage(childIndex, image)

Menyisipkan InlineImage yang diberikan pada indeks yang ditentukan.

Gambar akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
image	InlineImage	gambar yang akan disisipkan

Pulang pergi

InlineImage — gambar sebaris yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertListItem(childIndex, listItem)

Menyisipkan ListItem yang diberikan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
listItem	ListItem	item daftar yang akan disisipkan

Pulang pergi

ListItem — item daftar baru disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertListItem(childIndex, text)

Membuat dan menyisipkan ListItem baru pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
text	String	isi teks

Pulang pergi

ListItem — item daftar baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertParagraph(childIndex, paragraph)

Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
paragraph	Paragraph	paragraf yang akan disisipkan

Pulang pergi

Paragraph — paragraf yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertParagraph(childIndex, text)

Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
text	String	isi teks

Pulang pergi

Paragraph — paragraf baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertTable(childIndex)

Membuat dan menyisipkan Table baru pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan

Pulang pergi

Table — tabel baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertTable(childIndex, cells)

Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat penyisipan
cells	String[][]	konten teks sel tabel yang akan ditambahkan ke tabel baru

Pulang pergi

Table — tabel baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

insertTable(childIndex, table)

Menyisipkan Table yang diberikan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
childIndex	Integer	indeks tempat elemen akan disisipkan
table	Table	tabel yang akan disisipkan

Pulang pergi

Table — tabel yang disisipkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

isAtDocumentEnd()

Menentukan apakah elemen berada di akhir Document.

Pulang pergi

Boolean — Apakah elemen berada di akhir tab.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

merge()

Menggabungkan elemen dengan elemen saudara sebelumnya dengan jenis yang sama.

Hanya elemen dengan ElementType yang sama yang dapat digabungkan. Semua elemen turunan yang ada dalam elemen saat ini dipindahkan ke elemen saudara sebelumnya.

Elemen saat ini dihapus dari dokumen.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

Pulang pergi

TableCell|null — Elemen gabungan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

removeChild(child)

Menghapus elemen turunan yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
child	Element	elemen turunan yang akan dihapus

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

removeFromParent()

Menghapus elemen dari induknya.

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

Pulang pergi

TableCell|null — Elemen yang dihapus.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

replaceText(searchPattern, replacement)

Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler.

Pola penelusuran diteruskan sebagai string, bukan objek ekspresi reguler JavaScript. Oleh karena itu, Anda harus meng-escape semua garis miring terbalik dalam pola.

Metode ini menggunakan library ekspresi reguler RE2 Google, yang membatasi sintaksis yang didukung.

Pola ekspresi reguler yang diberikan dicocokkan secara terpisah dengan setiap blok teks yang ada dalam elemen saat ini.

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

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

Parameter

Nama	Jenis	Deskripsi
searchPattern	String	pola regex yang akan dicari
replacement	String	teks yang akan digunakan sebagai pengganti

Pulang pergi

Element — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setAttributes(attributes)

Menetapkan atribut elemen.

Parameter atribut yang ditentukan harus berupa objek dengan setiap nama properti adalah item dalam enumerasi DocumentApp.Attribute dan setiap nilai properti adalah nilai baru yang akan diterapkan.

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

Parameter

Nama	Jenis	Deskripsi
attributes	Object	Atribut elemen.

Pulang pergi

TableCell — Elemen saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setBackgroundColor(color)

Menetapkan warna latar belakang.

Parameter

Nama	Jenis	Deskripsi
color	String	warna latar belakang, diformat dalam notasi CSS (seperti '#ffffff')

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setLinkUrl(url)

Menetapkan URL link.

Parameter

Nama	Jenis	Deskripsi
url	String	URL link

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setPaddingBottom(paddingBottom)

Menetapkan padding bawah, dalam poin.

Parameter

Nama	Jenis	Deskripsi
paddingBottom	Number	padding bawah, dalam poin

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setPaddingLeft(paddingLeft)

Menetapkan padding kiri, dalam poin.

Parameter

Nama	Jenis	Deskripsi
paddingLeft	Number	padding kiri, dalam poin

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setPaddingRight(paddingRight)

Menetapkan padding kanan, dalam poin.

Parameter

Nama	Jenis	Deskripsi
paddingRight	Number	Padding kanan, dalam poin.

Pulang pergi

TableCell — Elemen saat ini.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setPaddingTop(paddingTop)

Menetapkan padding atas, dalam poin.

Parameter

Nama	Jenis	Deskripsi
paddingTop	Number	padding atas, dalam poin

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setText(text)

Menetapkan konten sebagai teks biasa.

Catatan: konten yang ada akan dihapus.

Parameter

Nama	Jenis	Deskripsi
text	String	konten teks baru

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setTextAlignment(textAlignment)

Menetapkan perataan teks. Jenis perataan yang tersedia adalah DocumentApp.TextAlignment.NORMAL, DocumentApp.TextAlignment.SUBSCRIPT, dan 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);

Parameter

Nama	Jenis	Deskripsi
textAlignment	TextAlignment	jenis perataan teks yang akan diterapkan

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setVerticalAlignment(alignment)

Menetapkan perataan vertikal.

Parameter

Nama	Jenis	Deskripsi
alignment	VerticalAlignment	perataan vertikal

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

---

setWidth(width)

Menetapkan lebar kolom yang berisi sel saat ini, dalam poin.

Parameter

Nama	Jenis	Deskripsi
width	Number	lebar kolom, dalam poin

Pulang pergi

TableCell — elemen saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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