Halaman ini diterjemahkan oleh Cloud Translation API.

Class Body

Konten tab dalam dokumen Google Dokumen. Body dapat berisi ListItem, Elemen Paragraph, Table, dan TableOfContents. Untuk mengetahui informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas kemampuan Google Dokumen.

Body biasanya berisi konten tab lengkap kecuali untuk elemen HeaderSection, FooterSection, dan FootnoteSection.

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

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

Metode

Metode	Jenis hasil 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 ditentukan.
`appendListItem(listItem)`	`ListItem`	Menambahkan `ListItem` yang ditentukan.
`appendListItem(text)`	`ListItem`	Membuat dan menambahkan `ListItem` baru yang berisi konten teks yang ditentukan.
`appendPageBreak()`	`PageBreak`	Membuat dan menambahkan `PageBreak` baru.
`appendPageBreak(pageBreak)`	`PageBreak`	Menambahkan `PageBreak` yang ditentukan.
`appendParagraph(paragraph)`	`Paragraph`	Menambahkan `Paragraph` yang ditentukan.
`appendParagraph(text)`	`Paragraph`	Membuat dan menambahkan `Paragraph` baru yang berisi konten teks yang ditentukan.
`appendTable()`	`Table`	Membuat dan menambahkan `Table` baru.
`appendTable(cells)`	`Table`	Menambahkan `Table` baru yang berisi `TableCell` untuk setiap nilai string yang ditentukan.
`appendTable(table)`	`Table`	Menambahkan `Table` yang ditentukan.
`clear()`	`Body`	Mengosongkan isi elemen.
`copy()`	`Body`	Menampilkan salinan mendalam yang terpisah dari elemen saat ini.
`editAsText()`	`Text`	Mendapatkan versi `Text` dari elemen saat ini, untuk diedit.
`findElement(elementType)`	`RangeElement`	Menelusuri konten elemen untuk turunan dari jenis yang ditentukan.
`findElement(elementType, from)`	`RangeElement`	Menelusuri konten elemen untuk turunan dari jenis yang ditentukan, mulai dari `RangeElement` yang ditentukan.
`findText(searchPattern)`	`RangeElement`	Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler.
`findText(searchPattern, from)`	`RangeElement`	Menelusuri konten elemen untuk pola teks yang ditentukan, mulai dari teks tertentu hasil penelusuran.
`getAttributes()`	`Object`	Mengambil atribut elemen.
`getChild(childIndex)`	`Element`	Mengambil elemen turunan pada indeks turunan yang ditentukan.
`getChildIndex(child)`	`Integer`	Mengambil indeks turunan untuk elemen turunan yang ditentukan.
`getHeadingAttributes(paragraphHeading)`	`Object`	Mengambil kumpulan atribut untuk `ParagraphHeading` yang disediakan.
`getImages()`	`InlineImage[]`	Mengambil semua `InlineImages` yang terdapat dalam bagian.
`getListItems()`	`ListItem[]`	Mengambil semua `ListItems` yang terdapat dalam bagian.
`getMarginBottom()`	`Number`	Mengambil margin bawah, dalam poin.
`getMarginLeft()`	`Number`	Mengambil margin kiri, dalam satuan poin.
`getMarginRight()`	`Number`	Mengambil margin kanan.
`getMarginTop()`	`Number`	Mengambil margin atas.
`getNumChildren()`	`Integer`	Mengambil jumlah turunan.
`getPageHeight()`	`Number`	Mengambil tinggi halaman, dalam poin.
`getPageWidth()`	`Number`	Mengambil lebar halaman, dalam poin.
`getParagraphs()`	`Paragraph[]`	Mengambil semua `Paragraphs` yang ada dalam bagian (termasuk `ListItems`).
`getParent()`	`ContainerElement`	Mengambil elemen induk elemen.
`getTables()`	`Table[]`	Mengambil semua `Tables` yang terdapat dalam bagian.
`getText()`	`String`	Mengambil konten elemen sebagai string teks.
`getTextAlignment()`	`TextAlignment`	Mendapatkan perataan teks.
`getType()`	`ElementType`	Mengambil `ElementType` elemen.
`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 Google Cloud.
`insertImage(childIndex, image)`	`InlineImage`	Menyisipkan `InlineImage` yang ditentukan pada indeks yang ditentukan.
`insertListItem(childIndex, listItem)`	`ListItem`	Menyisipkan `ListItem` yang ditentukan pada indeks yang ditentukan.
`insertListItem(childIndex, text)`	`ListItem`	Membuat dan menyisipkan `ListItem` baru pada indeks yang ditentukan, yang berisi class yang ditentukan konten teks.
`insertPageBreak(childIndex)`	`PageBreak`	Membuat dan menyisipkan `PageBreak` baru pada indeks yang ditentukan.
`insertPageBreak(childIndex, pageBreak)`	`PageBreak`	Menyisipkan `PageBreak` yang ditentukan pada indeks yang ditentukan.
`insertParagraph(childIndex, paragraph)`	`Paragraph`	Menyisipkan `Paragraph` yang ditentukan pada indeks yang ditentukan.
`insertParagraph(childIndex, text)`	`Paragraph`	Membuat dan menyisipkan `Paragraph` baru pada indeks yang ditentukan, yang berisi class yang ditentukan konten teks.
`insertTable(childIndex)`	`Table`	Membuat dan menyisipkan `Table` baru pada indeks yang ditentukan.
`insertTable(childIndex, cells)`	`Table`	Membuat dan menyisipkan `Table` baru yang berisi sel tertentu, pada indeks yang ditentukan.
`insertTable(childIndex, table)`	`Table`	Menyisipkan `Table` yang ditentukan pada indeks yang ditentukan.
`removeChild(child)`	`Body`	Menghapus elemen turunan yang ditentukan.
`replaceText(searchPattern, replacement)`	`Element`	Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi.
`setAttributes(attributes)`	`Body`	Menetapkan atribut elemen.
`setHeadingAttributes(paragraphHeading, attributes)`	`Body`	Menetapkan atribut untuk `ParagraphHeading` yang disediakan.
`setMarginBottom(marginBottom)`	`Body`	Menetapkan margin bawah, dalam poin.
`setMarginLeft(marginLeft)`	`Body`	Menetapkan margin kiri, dalam poin.
`setMarginRight(marginRight)`	`Body`	Menetapkan margin kanan, dalam poin.
`setMarginTop(marginTop)`	`Body`	Menetapkan margin atas.
`setPageHeight(pageHeight)`	`Body`	Menetapkan tinggi halaman, dalam poin.
`setPageWidth(pageWidth)`	`Body`	Menetapkan lebar halaman, dalam poin.
`setText(text)`	`Body`	Menetapkan konten sebagai teks biasa.
`setTextAlignment(textAlignment)`	`Body`	Menetapkan perataan teks.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getFootnotes()`	`Footnote[]`	Mengambil semua `Footnotes` yang terdapat dalam bagian.
`getLinkUrl()`	`String`	Mengambil URL link.
`getNextSibling()`	`Element`	Mengambil elemen yang seinduk berikutnya dari elemen.
`getPreviousSibling()`	`Element`	Mengambil elemen yang seinduk sebelumnya dari elemen.
`isAtDocumentEnd()`	`Boolean`	Menentukan apakah elemen berada di akhir `Document`.
`setLinkUrl(url)`	`Body`	Menetapkan URL link.

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.

Gambar akan dimuat di Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
`image`	`BlobSource`	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

`appendImage(image)`

Menambahkan InlineImage yang ditentukan.

InlineImage akan dimuat dalam Paragraph baru.

Gunakan versi appendImage ini saat menambahkan salinan InlineImage yang ada.

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 ditentukan.

Gunakan versi appendListItem ini saat menambahkan salinan ListItem yang ada.

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 yang berisi konten teks yang ditentukan.

Item daftar berurutan ditambahkan sebagai bagian dari daftar yang sama.

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Konten teks item daftar.

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

`appendPageBreak()`

Membuat dan menambahkan PageBreak baru.

PageBreak akan dimuat dalam Paragraph baru.

Pulang pergi

PageBreak — Batas halaman 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

`appendPageBreak(pageBreak)`

Menambahkan PageBreak yang ditentukan.

PageBreak akan dimuat dalam Paragraph baru.

Gunakan versi appendPageBreak ini saat menambahkan salinan PageBreak yang ada.

Parameter

Nama	Jenis	Deskripsi
`pageBreak`	`PageBreak`	Batas halaman yang akan ditambahkan.

Pulang pergi

PageBreak — Batas halaman 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(paragraph)`

Menambahkan Paragraph yang ditentukan.

Gunakan versi appendParagraph ini saat menambahkan salinan Paragraph yang ada.

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 yang berisi konten teks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`text`	`String`	Konten teks paragraf.

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.

Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.

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 TableCell untuk setiap nilai string yang ditentukan.

Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.

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 ditentukan.

Gunakan versi appendTable ini saat menambahkan salinan Table yang ada. Metode ini juga akan menambahkan paragraf kosong setelah tabel, karena dokumen Google Dokumen tidak boleh diakhiri dengan tabel.

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()`

Mengosongkan isi elemen.

Pulang pergi

Body — Elemen saat ini.

`copy()`

Menampilkan salinan mendalam yang terpisah dari elemen saat ini.

Setiap elemen turunan yang ada dalam elemen tersebut juga akan disalin. Elemen baru ini tidak memiliki orang tua.

Pulang pergi

Body — 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 diedit.

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

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

var 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 turunan dari jenis yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`elementType`	`ElementType`	Jenis elemen yang akan ditelusuri.

Pulang pergi

RangeElement — 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 turunan dari jenis yang ditentukan, mulai dari RangeElement yang ditentukan.

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

Parameter

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

Pulang pergi

RangeElement — 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 tangkapan dan pengubah mode.

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

Parameter

Nama	Jenis	Deskripsi
`searchPattern`	`String`	pola untuk mencari

Pulang pergi

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

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 pola teks yang ditentukan, mulai dari teks tertentu hasil penelusuran.

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

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

Parameter

Nama	Jenis	Deskripsi
`searchPattern`	`String`	pola untuk mencari
`from`	`RangeElement`	hasil pencarian untuk mencari

Pulang pergi

RangeElement — hasil penelusuran yang menunjukkan posisi teks penelusuran berikutnya, atau null jika tidak ada kompensasi

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 di mana masing-masing nama properti sesuai dengan item dalam enumerasi DocumentApp.Attribute.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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]);
}

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

`getChild(childIndex)`

Mengambil elemen turunan pada indeks turunan yang ditentukan.

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

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

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

`getHeadingAttributes(paragraphHeading)`

Mengambil kumpulan atribut untuk ParagraphHeading yang disediakan.

Parameter

Nama	Jenis	Deskripsi
`paragraphHeading`	`ParagraphHeading`	Judul yang atributnya harus diambil.

Pulang pergi

Object — Peta atribut dan nilainya 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

`getImages()`

Mengambil semua InlineImages yang terdapat dalam bagian.

Pulang pergi

InlineImage[] — Gambar bagian.

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

`getListItems()`

Mengambil semua ListItems yang terdapat dalam bagian.

Pulang pergi

ListItem[] — Item daftar bagian.

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

`getMarginBottom()`

Mengambil margin bawah, dalam poin.

Pulang pergi

Number — Margin 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

`getMarginLeft()`

Mengambil margin kiri, dalam satuan poin.

Pulang pergi

Number — Margin 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

`getMarginRight()`

Mengambil margin kanan.

Pulang pergi

Number — Margin 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

`getMarginTop()`

Mengambil margin atas.

Pulang pergi

Number — Margin 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

`getNumChildren()`

Mengambil jumlah turunan.

var 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

`getPageHeight()`

Mengambil tinggi halaman, dalam poin.

Pulang pergi

Number — Tinggi halaman, 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

`getPageWidth()`

Mengambil lebar halaman, dalam poin.

Pulang pergi

Number — Lebar halaman, 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

`getParagraphs()`

Mengambil semua Paragraphs yang ada dalam bagian (termasuk ListItems).

Pulang pergi

Paragraph[] — Paragraf bagian.

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 — 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

`getTables()`

Mengambil semua Tables yang terdapat dalam bagian.

Pulang pergi

Table[] — Tabel bagian.

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 — jenis perataan teks, atau null jika teks berisi beberapa jenis teks {i>alignment<i} atau jika perataan teks belum pernah disetel

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 elemen yang tepat.

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

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

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

`insertHorizontalRule(childIndex)`

Membuat dan menyisipkan HorizontalRule baru pada indeks yang ditentukan.

HorizontalRule akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat menyisipkan elemen.

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 Google Cloud.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat menyisipkan elemen.
`image`	`BlobSource`	Data gambar.

Pulang pergi

InlineImage — Gambar inline 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 ditentukan pada indeks yang ditentukan.

Gambar akan dimuat di Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat menyisipkan elemen.
`image`	`InlineImage`	Gambar yang akan disisipkan.

Pulang pergi

InlineImage — Gambar inline 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 ditentukan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat disisipkan.
`listItem`	`ListItem`	Item daftar yang akan disisipkan.

Pulang pergi

ListItem — Item daftar 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, text)`

Membuat dan menyisipkan ListItem baru pada indeks yang ditentukan, yang berisi class yang ditentukan konten teks.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat disisipkan.
`text`	`String`	Konten teks item daftar.

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

`insertPageBreak(childIndex)`

Membuat dan menyisipkan PageBreak baru pada indeks yang ditentukan.

PageBreak akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat menyisipkan elemen.

Pulang pergi

PageBreak — Batas halaman 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

`insertPageBreak(childIndex, pageBreak)`

Menyisipkan PageBreak yang ditentukan pada indeks yang ditentukan.

PageBreak akan dimuat dalam Paragraph baru.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat menyisipkan elemen.
`pageBreak`	`PageBreak`	Batas halaman yang akan disisipkan.

Pulang pergi

PageBreak — Batas halaman 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, paragraph)`

Menyisipkan Paragraph yang ditentukan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat 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, yang berisi class yang ditentukan konten teks.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat disisipkan.
`text`	`String`	Konten teks paragraf.

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 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 tertentu, pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat disisipkan.
`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 ditentukan pada indeks yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`childIndex`	`Integer`	Indeks tempat 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

`removeChild(child)`

Menghapus elemen turunan yang ditentukan.

Parameter

Nama	Jenis	Deskripsi
`child`	`Element`	Elemen turunan yang akan dihapus.

Pulang pergi

Body — 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

`replaceText(searchPattern, replacement)`

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

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

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

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

var 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 untuk mencari
`replacement`	`String`	teks yang 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 di enumerasi DocumentApp.Attribute dan setiap nilai properti adalah nilai baru yang akan diterapkan.

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

Parameter

Nama	Jenis	Deskripsi
`attributes`	`Object`	Atribut elemen.

Pulang pergi

Body — 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

`setHeadingAttributes(paragraphHeading, attributes)`

Menetapkan atribut untuk ParagraphHeading yang disediakan.

Parameter

Nama	Jenis	Deskripsi
`paragraphHeading`	`ParagraphHeading`	Judul yang atributnya harus ditetapkan.
`attributes`	`Object`	Peta atribut dan nilai untuk menetapkannya.

Pulang pergi

Body — 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

`setMarginBottom(marginBottom)`

Menetapkan margin bawah, dalam poin.

Parameter

Nama	Jenis	Deskripsi
`marginBottom`	`Number`	Margin bawah, dalam poin.

Pulang pergi

Body — 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

`setMarginLeft(marginLeft)`

Menetapkan margin kiri, dalam poin.

Parameter

Nama	Jenis	Deskripsi
`marginLeft`	`Number`	Margin kiri, dalam poin.

Pulang pergi

Body — 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

`setMarginRight(marginRight)`

Menetapkan margin kanan, dalam poin.

Parameter

Nama	Jenis	Deskripsi
`marginRight`	`Number`	Margin kanan.

Pulang pergi

Body — 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

`setMarginTop(marginTop)`

Menetapkan margin atas.

Parameter

Nama	Jenis	Deskripsi
`marginTop`	`Number`	Margin atas, dalam poin.

Pulang pergi

Body — 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

`setPageHeight(pageHeight)`

Menetapkan tinggi halaman, dalam poin.

Parameter

Nama	Jenis	Deskripsi
`pageHeight`	`Number`	Tinggi halaman, dalam poin.

Pulang pergi

Body — 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

`setPageWidth(pageWidth)`

Menetapkan lebar halaman, dalam poin.

Parameter

Nama	Jenis	Deskripsi
`pageWidth`	`Number`	Lebar halaman, dalam poin.

Pulang pergi

Body — 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

Body — 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.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var 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

Body — 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

Metode yang tidak digunakan lagi

`getFootnotes()`

Tidak digunakan lagi. Elemen ini tidak boleh berisi Footnote.

Mengambil semua Footnotes yang terdapat dalam bagian.

Pulang pergi

Footnote[] — Catatan kaki bagian.

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()`

Tidak digunakan lagi. Alih-alih menerapkan link ke seluruh bagian, terapkan link ke elemen dalam bagian tersebut.

Mengambil URL link.

Pulang pergi

String — 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()`

Tidak digunakan lagi. Elemen ini tidak memiliki saudara.

Mengambil elemen yang seinduk berikutnya dari elemen.

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

Pulang pergi

Element — Elemen yang seinduk 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

`getPreviousSibling()`

Tidak digunakan lagi. Elemen ini tidak memiliki saudara.

Mengambil elemen yang seinduk sebelumnya dari elemen.

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

Pulang pergi

Element — Elemen yang seinduk 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

`isAtDocumentEnd()`

Tidak digunakan lagi. Metode ini tidak dapat diandalkan untuk HeaderSection.

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

`setLinkUrl(url)`

Tidak digunakan lagi. Alih-alih menerapkan link ke seluruh bagian, terapkan link ke elemen dalam bagian tersebut.

Menetapkan URL link.

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL link

Pulang pergi

Body — 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