Elemen yang merepresentasikan paragraf. Paragraph dapat berisi elemen Equation, Footnote, Horizontal, Inline, Inline, Page, dan Text. Untuk mengetahui informasi selengkapnya tentang struktur dokumen, lihat panduan untuk memperluas Google Dokumen.
Paragraphs tidak boleh berisi karakter baris baru. Karakter baris baru ("\n") dikonversi menjadi karakter jeda baris ("\r").
const body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a tab header paragraph. const header = body.appendParagraph('A Document'); header.setHeading(DocumentApp.ParagraphHeading.HEADING1); // Append a section header paragraph. const section = body.appendParagraph('Section 1'); section.setHeading(DocumentApp.ParagraphHeading.HEADING2); // Append a regular paragraph. body.appendParagraph('This is a typical paragraph.');
Metode
| Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
|---|---|---|
add | Positioned | Membuat dan menyisipkan Positioned baru dari blob gambar yang ditentukan. |
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 | Page | Membuat dan menambahkan Page baru. |
append | Page | Menambahkan Page yang diberikan. |
append | Text | Membuat dan menambahkan elemen Text baru dengan konten yang ditentukan. |
append | Text | Menambahkan elemen Text yang diberikan. |
clear() | Paragraph | Menghapus konten elemen. |
copy() | Paragraph | 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 | Horizontal | Mengambil Horizontal. |
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 | Paragraph | Mengambil Paragraph. |
get | Number|null | Mengambil indentasi akhir, dalam poin. |
get | Number|null | Mengambil indentasi baris pertama, dalam poin. |
get | Number|null | Mengambil indentasi awal. |
get | Number|null | Mengambil jarak antarbaris, dalam poin. |
get | String|null | Mengambil URL link. |
get | Element|null | Mengambil elemen pasangan berikutnya dari elemen. |
get | Integer | Mengambil jumlah turunan. |
get | Container | Mengambil elemen induk elemen. |
get | Positioned | Mendapatkan Positioned berdasarkan ID gambar. |
get | Positioned | Mendapatkan semua objek Positioned yang ditambatkan ke paragraf. |
get | Element|null | Mengambil elemen saudara sebelumnya dari elemen. |
get | Number|null | Mengambil jarak setelah elemen, dalam poin. |
get | Number|null | Mengambil spasi sebelum elemen, dalam poin. |
get | String | Mengambil konten elemen sebagai string teks. |
get | Text | Mendapatkan perataan teks. |
get | Element | Mengambil Element elemen. |
insert | Horizontal | Membuat dan menyisipkan Horizontal pada indeks yang ditentukan. |
insert | Inline | Membuat dan menyisipkan Inline baru dari blob gambar yang ditentukan, pada indeks yang ditentukan. |
insert | Inline | Menyisipkan Inline yang diberikan pada indeks yang ditentukan. |
insert | Page | Membuat dan menyisipkan Page baru pada indeks yang ditentukan. |
insert | Page | Menyisipkan Page yang diberikan pada indeks yang ditentukan. |
insert | Text | Membuat dan menyisipkan elemen teks baru pada indeks yang ditentukan. |
insert | Text | Menyisipkan elemen Text yang diberikan pada indeks yang ditentukan, dengan konten
teks yang ditentukan. |
is | Boolean | Menentukan apakah elemen berada di akhir Document. |
is | Boolean|null | Mengambil setelan kiri-ke-kanan. |
merge() | Paragraph|null | Menggabungkan elemen dengan elemen saudara sebelumnya dengan jenis yang sama. |
remove | Paragraph | Menghapus elemen turunan yang ditentukan. |
remove | Paragraph|null | Menghapus elemen dari induknya. |
remove | Boolean | Menghapus Positioned berdasarkan ID gambar. |
replace | Element | Mengganti semua kemunculan pola teks tertentu dengan string pengganti tertentu, menggunakan ekspresi reguler. |
set | Paragraph | Menetapkan Horizontal. |
set | Paragraph | Menetapkan atribut elemen. |
set | Paragraph | Menetapkan Paragraph. |
set | Paragraph | Menetapkan indentasi akhir, dalam poin. |
set | Paragraph | Menetapkan indentasi baris pertama, dalam poin. |
set | Paragraph | Menetapkan indentasi awal, dalam poin. |
set | Paragraph | Menetapkan setelan kiri-ke-kanan. |
set | Paragraph | Menetapkan jarak antar-baris, sebagai kuantitas yang menunjukkan jumlah baris yang akan digunakan untuk jarak. |
set | Paragraph | Menetapkan URL link. |
set | Paragraph | Menetapkan spasi setelah elemen, dalam poin. |
set | Paragraph | Menetapkan jarak sebelum elemen, dalam poin. |
set | void | Menetapkan konten paragraf sebagai teks. |
set | Paragraph | Menetapkan perataan teks. |
Dokumentasi mendetail
add Positioned Image(image)
Membuat dan menyisipkan Positioned baru dari blob gambar yang ditentukan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the specified image URL. const image = UrlFetchApp.fetch( 'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-24dp/logo_apps_script_color_1x_web_24dp.png', ); // Adds the image to the tab, anchored to the first paragraph. paragraph.addPositionedImage(image);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
image | Blob | Data gambar. |
Pulang pergi
Positioned — Gambar yang diposisikan 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 Horizontal Rule()
Membuat dan menambahkan Horizontal baru.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a horizontal line under the first paragraph. paragraph.appendHorizontalRule();
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 Inline Image(image)
Membuat dan menambahkan Inline baru dari blob gambar yang ditentukan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Fetches the image from the specified image URL. const image = UrlFetchApp.fetch( 'https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-96dp/logo_apps_script_color_1x_web_96dp.png', ); // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
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 Inline Image(image)
Menambahkan Inline yang diberikan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Makes a copy of the first image in the body. const image = body.getImages()[0].copy(); // Adds the image to the first paragraph. paragraph.appendInlineImage(image);
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 Page Break()
Membuat dan menambahkan Page baru.
Catatan: Page mungkin tidak ada dalam Table.
Jika elemen saat ini ada dalam sel tabel, pengecualian akan ditampilkan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. paragraph.appendPageBreak();
Pulang pergi
Page — Elemen 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.
Catatan: Page tidak dapat berada dalam Table.
Jika elemen saat ini ada di sel tabel, skrip akan menampilkan pengecualian.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a page break after the first paragraph. const pageBreak = paragraph.appendPageBreak(); // Makes a copy of the page break. const newPageBreak = pageBreak.copy(); // Adds the copied page break to the paragraph. paragraph.appendPageBreak(newPageBreak);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
page | Page | Pemisah halaman yang akan ditambahkan. |
Pulang pergi
Page — Elemen jeda 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 Text(text)
Membuat dan menambahkan elemen Text baru dengan konten yang ditentukan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Adds a string to the paragraph. paragraph.appendText('This is a new sentence.');
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | Isi teks. |
Pulang pergi
Text — Elemen teks 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 Text(text)
Menambahkan elemen Text yang diberikan.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the text from the first paragraph in the body. const paragraph1 = body.getParagraphs()[0]; const text = paragraph1.getText(); // Gets the third paragraph in the body. const paragraph3 = body.getParagraphs()[2]; // Adds the text from the first paragraph to the third paragraph. paragraph3.appendText(text);
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | Text | Elemen teks yang akan ditambahkan. |
Pulang pergi
Text — Elemen teks 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
Paragraph — 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 Alignment()
Mengambil Horizontal.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Gets the first paragraph from the body. const paragraph = body.getParagraphs()[0]; // Sets the horizontal alignment to left for the first paragraph. paragraph.setAlignment(DocumentApp.HorizontalAlignment.LEFT); // Gets the horizontal alignment of the first paragraph and logs it to the // console. console.log(paragraph.getAlignment().toString());
Pulang pergi
Horizontal — Penyelarasan.
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()
Mengambil Paragraph.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. // TODO(developer): Replace the ID with your own. const doc = DocumentApp.openById('123abc'); // Gets the body contents of the tab by its ID. // TODO(developer): Replace the ID with your own. const body = doc.getTab('123abc').asDocumentTab().getBody(); // Adds a paragraph to the body. const paragraph = body.appendParagraph('Title heading'); // Sets the paragraph heading style to 'Title.' paragraph.setHeading(DocumentApp.ParagraphHeading.TITLE); // Gets the heading style and logs it to the console. console.log(paragraph.getHeading().toString());
Pulang pergi
Paragraph — Judul.
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 Indent End()
Mengambil indentasi akhir, dalam poin.
Pulang pergi
Number|null — indentasi akhir, 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 Indent First Line()
Mengambil indentasi baris pertama, dalam poin.
Pulang pergi
Number|null — indentasi baris pertama, 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 Indent Start()
Mengambil indentasi awal.
Pulang pergi
Number|null — indentasi awal
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 Line Spacing()
Mengambil jarak antarbaris, dalam poin.
Pulang pergi
Number|null — jarak antarbaris, 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 Link Url()
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
get Next Sibling()
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
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 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 Positioned Image(id)
Mendapatkan Positioned berdasarkan ID gambar.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
id | String | ID gambar |
Pulang pergi
Positioned — gambar yang diposisikan
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 Positioned Images()
Mendapatkan semua objek Positioned yang ditambatkan ke paragraf.
Pulang pergi
Positioned — daftar gambar yang diposisikan
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 Previous Sibling()
Mengambil elemen saudara sebelumnya dari elemen.
Pasangan 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
get Spacing After()
Mengambil jarak setelah elemen, dalam poin.
Pulang pergi
Number|null — spasi setelah elemen, 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 Spacing Before()
Mengambil spasi sebelum elemen, dalam poin.
Pulang pergi
Number|null — spasi sebelum elemen, 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 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 pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
Pulang pergi
Horizontal — elemen 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
insert Inline Image(childIndex, image)
Membuat dan menyisipkan Inline baru dari blob gambar yang ditentukan, pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
image | Blob | data gambar |
Pulang pergi
Inline — elemen 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 Inline Image(childIndex, image)
Menyisipkan Inline yang diberikan pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
image | Inline | data gambar |
Pulang pergi
Inline — elemen 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 Page Break(childIndex)
Membuat dan menyisipkan Page baru pada indeks yang ditentukan.
Catatan: Page mungkin tidak ada dalam Table.
Jika elemen saat ini ada dalam sel tabel, pengecualian akan ditampilkan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
Pulang pergi
Page — elemen jeda 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.
Catatan: Page mungkin tidak ada dalam Table.
Jika elemen saat ini ada dalam sel tabel, pengecualian akan ditampilkan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
page | Page | batas halaman yang akan disisipkan |
Pulang pergi
Page — elemen jeda 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 Text(childIndex, text)
Membuat dan menyisipkan elemen teks baru pada indeks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
text | String | isi teks |
Pulang pergi
Text — elemen teks 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 Text(childIndex, text)
Menyisipkan elemen Text yang diberikan pada indeks yang ditentukan, dengan konten
teks yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Integer | indeks tempat elemen akan disisipkan |
text | Text | elemen teks yang akan disisipkan |
Pulang pergi
Text — elemen teks 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
is At Document End()
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
is Left To Right()
Mengambil setelan kiri-ke-kanan.
Pulang pergi
Boolean|null — setelan kiri ke kanan
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 Element yang sama yang dapat digabungkan. Elemen turunan apa pun yang ada dalam
elemen saat ini dipindahkan ke elemen saudara sebelumnya.
Elemen saat ini akan 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
Paragraph|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
remove Child(child)
Menghapus elemen turunan yang ditentukan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
child | Element | elemen turunan yang akan dihapus |
Pulang pergi
Paragraph — 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
remove From Parent()
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
Paragraph|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
remove Positioned Image(id)
Menghapus Positioned berdasarkan ID gambar.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
id | String | ID gambar |
Pulang pergi
Boolean — apakah gambar yang ditentukan dihapus atau tidak
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 Alignment(alignment)
Menetapkan Horizontal.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
alignment | Horizontal | perataan horizontal |
Pulang pergi
Paragraph — 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
Paragraph — 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(heading)
Menetapkan Paragraph.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
heading | Paragraph | judul |
Pulang pergi
Paragraph — 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 Indent End(indentEnd)
Menetapkan indentasi akhir, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
indent | Number | indentasi akhir, dalam poin |
Pulang pergi
Paragraph — 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 Indent First Line(indentFirstLine)
Menetapkan indentasi baris pertama, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
indent | Number | indentasi baris pertama, dalam poin |
Pulang pergi
Paragraph — 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 Indent Start(indentStart)
Menetapkan indentasi awal, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
indent | Number | indentasi awal, dalam poin |
Pulang pergi
Paragraph — 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 Left To Right(leftToRight)
Menetapkan setelan kiri-ke-kanan.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
left | Boolean | setelan kiri ke kanan |
Pulang pergi
Paragraph — 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 Line Spacing(multiplier)
Menetapkan jarak antar-baris, sebagai kuantitas yang menunjukkan jumlah baris yang akan digunakan untuk jarak.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
multiplier | Number | jumlah baris |
Pulang pergi
Paragraph — 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 Link Url(url)
Menetapkan URL link.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
url | String | URL link |
Pulang pergi
Paragraph — 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 Spacing After(spacingAfter)
Menetapkan spasi setelah elemen, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
spacing | Number | spasi setelah elemen, dalam poin |
Pulang pergi
Paragraph — 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 Spacing Before(spacingBefore)
Menetapkan jarak sebelum elemen, dalam poin.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
spacing | Number | spasi sebelum elemen, dalam poin |
Pulang pergi
Paragraph — 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 paragraf sebagai teks.
Catatan: konten yang ada akan dihapus.
Parameter
| Nama | Jenis | Deskripsi |
|---|---|---|
text | String | isi teks 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
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
Paragraph — 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