Konten tab dalam dokumen Google Dokumen. Body dapat berisi elemen List, Paragraph, Table, dan Table. Untuk mengetahui informasi selengkapnya tentang
struktur dokumen, lihat panduan untuk
memperluas Google Dokumen.
Body biasanya berisi konten tab lengkap, kecuali Header, Footer, dan elemen Footnote.
const 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 |
|---|---|---|
append | Horizontal | Membuat dan menambahkan Horizontal baru. |
append | Inline | Membuat dan menambahkan Inline baru dari blob gambar yang ditentukan. |
append | Inline | Menambahkan Inline yang diberikan. |
append | List | Menambahkan List yang diberikan. |
append | List | Membuat dan menambahkan List baru yang berisi konten teks yang ditentukan. |
append | Page | Membuat dan menambahkan Page baru. |
append | Page | Menambahkan Page yang diberikan. |
append | Paragraph | Menambahkan Paragraph yang diberikan. |
append | Paragraph | Membuat dan menambahkan Paragraph baru yang berisi konten teks yang ditentukan. |
append | Table | Membuat dan menambahkan Table baru. |
append | Table | Menambahkan Table baru yang berisi Table untuk setiap nilai string yang ditentukan. |
append | Table | Menambahkan Table yang diberikan. |
clear() | Body | Menghapus konten elemen. |
copy() | Body | Menampilkan salinan mendalam yang terlepas dari elemen saat ini. |
edit | Text | Mendapatkan versi Text dari elemen saat ini, untuk pengeditan. |
find | Range | Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan. |
find | Range | Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari
Range yang ditentukan. |
find | Range | Menelusuri konten elemen untuk pola teks yang ditentukan menggunakan ekspresi reguler. |
find | Range | Menelusuri konten elemen untuk menemukan pola teks yang ditentukan, dimulai dari hasil penelusuran tertentu. |
get | Object | Mengambil atribut elemen. |
get | Element | Mengambil elemen turunan pada indeks turunan yang ditentukan. |
get | Integer | Mengambil indeks turunan untuk elemen turunan yang ditentukan. |
get | Object | Mengambil kumpulan atribut untuk Paragraph yang diberikan. |
get | Inline | Mengambil semua Inline yang ada di bagian. |
get | List | Mengambil semua List yang ada di bagian. |
get | Number|null | Mengambil margin bawah, dalam poin. |
get | Number|null | Mengambil margin kiri, dalam poin. |
get | Number|null | Mengambil margin kanan. |
get | Number|null | Mengambil margin atas. |
get | Integer | Mengambil jumlah turunan. |
get | Number|null | Mengambil tinggi halaman, dalam poin. |
get | Number|null | Mengambil lebar halaman, dalam poin. |
get | Paragraph[]|null | Mengambil semua Paragraphs yang ada dalam bagian (termasuk List). |
get | Container | Mengambil elemen induk elemen. |
get | Table[]|null | Mengambil semua Tables yang ada di bagian. |
get | String | Mengambil konten elemen sebagai string teks. |
get | Text | Mendapatkan perataan teks. |
get | Element | Mengambil Element elemen. |
insert | Horizontal | Membuat dan menyisipkan Horizontal baru pada indeks yang ditentukan. |
insert | Inline | Membuat dan menyisipkan Inline dari blob gambar yang ditentukan, pada indeks yang ditentukan. |
insert | Inline | Menyisipkan Inline yang diberikan pada indeks yang ditentukan. |
insert | List | Menyisipkan List yang diberikan pada indeks yang ditentukan. |
insert | List | Membuat dan menyisipkan List baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan. |
insert | Page | Membuat dan menyisipkan Page baru pada indeks yang ditentukan. |
insert | Page | Menyisipkan Page yang diberikan pada indeks yang ditentukan. |
insert | Paragraph | Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan. |
insert | Paragraph | Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan. |
insert | Table | Membuat dan menyisipkan Table baru pada indeks yang ditentukan. |
insert | Table | Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan. |
insert | Table | Menyisipkan Table yang diberikan pada indeks yang ditentukan. |
remove | Body | Menghapus elemen turunan yang ditentukan. |
replace | Element | Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler. |
set | Body | Menetapkan atribut elemen. |
set | Body | Menetapkan atribut untuk Paragraph yang diberikan. |
set | Body | Menetapkan margin bawah, dalam poin. |
set | Body | Menetapkan margin kiri, dalam poin. |
set | Body | Menetapkan margin kanan, dalam poin. |
set | Body | Menetapkan margin atas. |
set | Body | Menetapkan tinggi halaman, dalam poin. |
set | Body | Menetapkan lebar halaman, dalam poin. |
set | Body | Menetapkan konten sebagai teks biasa. |
set | Body | Menetapkan perataan teks. |
Dokumentasi mendetail
append Horizontal Rule()
Membuat dan menambahkan Horizontal baru.
Horizontal akan dimuat dalam Paragraph baru.
Pulang pergi
Horizontal — Penggaris 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
append Image(image)
Membuat dan menambahkan Inline baru dari blob gambar yang ditentukan.
Gambar akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
image | Blob | Data gambar. |
Pulang pergi
Inline — 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
append Image(image)
Menambahkan Inline yang diberikan.
Inline akan dimuat dalam Paragraph baru.
Gunakan versi append ini saat menambahkan salinan Inline yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
image | Inline | Data gambar. |
Pulang pergi
Inline — 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
append List Item(listItem)
Menambahkan List yang diberikan.
Gunakan versi append ini saat menambahkan salinan List yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
list | List | Item daftar yang akan ditambahkan. |
Pulang pergi
List — 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
append List Item(text)
Membuat dan menambahkan List 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
List — 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
append Page Break()
Membuat dan menambahkan Page baru.
Page akan dimuat dalam Paragraph baru.
Pulang pergi
Page — 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
append Page Break(pageBreak)
Menambahkan Page yang diberikan.
Page akan dimuat dalam Paragraph baru.
Gunakan versi append ini saat menambahkan salinan Page yang ada.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | Page | Pemisah halaman yang akan ditambahkan. |
Pulang pergi
Page — 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
append Paragraph(paragraph)
Menambahkan Paragraph yang diberikan.
Gunakan versi append 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
append Paragraph(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
append Table()
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
append Table(cells)
Menambahkan Table baru yang berisi Table 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
append Table(table)
Menambahkan Table yang diberikan.
Gunakan versi append 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()
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
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
edit As Text()
Mendapatkan versi Text dari elemen saat ini, untuk pengeditan.
Gunakan edit untuk memanipulasi konten elemen sebagai teks kaya. Mode edit mengabaikan elemen non-teks (seperti Inline dan Horizontal).
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
find Element(elementType)
Menelusuri konten elemen untuk menemukan turunan dari jenis yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
element | Element | Jenis elemen yang akan ditelusuri. |
Pulang pergi
Range — 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
find Element(elementType, from)
Menelusuri konten elemen untuk menemukan keturunan dari jenis yang ditentukan, dimulai dari
Range 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 |
|---|---|---|
element | Element | Jenis elemen yang akan ditelusuri. |
from | Range | Hasil penelusuran yang akan ditelusuri. |
Pulang pergi
Range — 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
find Text(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 |
|---|---|---|
search | String | pola yang akan ditelusuri |
Pulang pergi
Range — 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
find Text(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 |
|---|---|---|
search | String | pola yang akan ditelusuri |
from | Range | hasil penelusuran yang akan digunakan untuk memulai penelusuran |
Pulang pergi
Range — 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
get Attributes()
Mengambil atribut elemen.
Hasilnya adalah objek yang berisi properti untuk setiap atribut elemen yang valid, dengan setiap nama properti sesuai dengan item dalam enumerasi Document.
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
get Child(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 |
|---|---|---|
child | 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
get Child Index(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
get Heading Attributes(paragraphHeading)
Mengambil kumpulan atribut untuk Paragraph yang diberikan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
paragraph | Paragraph | Judul yang atributnya harus diambil. |
Pulang pergi
Object — Peta atribut dan nilai 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
get Images()
Mengambil semua Inline yang ada di bagian.
Pulang pergi
Inline — 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
get List Items()
Mengambil semua List yang ada di bagian.
Pulang pergi
List — 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
get Margin Bottom()
Mengambil margin bawah, dalam poin.
Pulang pergi
Number|null — 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
get Margin Left()
Mengambil margin kiri, dalam poin.
Pulang pergi
Number|null — 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
get Margin Right()
Mengambil margin kanan.
Pulang pergi
Number|null — 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
get Margin Top()
Mengambil margin atas.
Pulang pergi
Number|null — 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
get Num Children()
Mengambil jumlah turunan.
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
get Page Height()
Mengambil tinggi halaman, dalam poin.
Pulang pergi
Number|null — 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
get Page Width()
Mengambil lebar halaman, dalam poin.
Pulang pergi
Number|null — 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
get Paragraphs()
Mengambil semua Paragraphs yang ada dalam bagian (termasuk List).
Pulang pergi
Paragraph[]|null — 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
get Parent()
Mengambil elemen induk elemen.
Elemen induk berisi elemen saat ini.
Pulang pergi
Container — 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
get Tables()
get Text()
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
get Text Alignment()
Mendapatkan perataan teks. Jenis perataan yang tersedia adalah Document, Document, dan Document.
Pulang pergi
Text — 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
get Type()
Mengambil Element elemen.
Gunakan get 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
Element — 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
insert Horizontal Rule(childIndex)
Membuat dan menyisipkan Horizontal baru pada indeks yang ditentukan.
Horizontal akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
Pulang pergi
Horizontal — Penggaris 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
insert Image(childIndex, image)
Membuat dan menyisipkan Inline dari blob gambar yang ditentukan, pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
image | Blob | Data gambar. |
Pulang pergi
Inline — 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
insert Image(childIndex, image)
Menyisipkan Inline yang diberikan pada indeks yang ditentukan.
Gambar akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
image | Inline | Gambar yang akan disisipkan. |
Pulang pergi
Inline — 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
insert List Item(childIndex, listItem)
Menyisipkan List yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
list | List | Item daftar yang akan disisipkan. |
Pulang pergi
List — 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
insert List Item(childIndex, text)
Membuat dan menyisipkan List baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
text | String | Konten teks item daftar. |
Pulang pergi
List — 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
insert Page Break(childIndex)
Membuat dan menyisipkan Page baru pada indeks yang ditentukan.
Page akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
Pulang pergi
Page — 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
insert Page Break(childIndex, pageBreak)
Menyisipkan Page yang diberikan pada indeks yang ditentukan.
Page akan dimuat dalam Paragraph baru.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat menyisipkan elemen. |
page | Page | Pemisah halaman yang akan disisipkan. |
Pulang pergi
Page — 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
insert Paragraph(childIndex, paragraph)
Menyisipkan Paragraph yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
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
insert Paragraph(childIndex, text)
Membuat dan menyisipkan Paragraph baru pada indeks yang ditentukan, yang berisi konten
teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
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
insert Table(childIndex)
Membuat dan menyisipkan Table baru pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
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
insert Table(childIndex, cells)
Membuat dan menyisipkan Table baru yang berisi sel yang ditentukan, pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | 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
insert Table(childIndex, table)
Menyisipkan Table yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | Indeks tempat penyisipan. |
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
remove Child(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
replace Text(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 |
|---|---|---|
search | 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
set Attributes(attributes)
Menetapkan atribut elemen.
Parameter atribut yang ditentukan harus berupa objek dengan setiap nama properti adalah item dalam enumerasi Document 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
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
set Heading Attributes(paragraphHeading, attributes)
Menetapkan atribut untuk Paragraph yang diberikan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
paragraph | Paragraph | Judul yang atributnya harus ditetapkan. |
attributes | Object | Peta atribut dan nilai yang akan ditetapkan. |
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
set Margin Bottom(marginBottom)
Menetapkan margin bawah, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | 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
set Margin Left(marginLeft)
Menetapkan margin kiri, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | 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
set Margin Right(marginRight)
Menetapkan margin kanan, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | 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
set Margin Top(marginTop)
Menetapkan margin atas.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
margin | 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
set Page Height(pageHeight)
Menetapkan tinggi halaman, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | 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
set Page Width(pageWidth)
Menetapkan lebar halaman, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | 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
set Text(text)
Menetapkan konten sebagai teks biasa.
Catatan: konten yang ada akan dihapus.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | Isi 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
set Text Alignment(textAlignment)
Menetapkan perataan teks. Jenis perataan yang tersedia adalah Document, Document, dan Document.
// 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 |
|---|---|---|
text | Text | 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