Dokumen, yang berisi rich text dan elemen seperti tabel dan daftar.
Dokumen dapat dibuka atau dibuat menggunakan DocumentApp
.
// Open a document by ID. var doc = DocumentApp.openById("<my-id>"); // Create and open a document. doc = DocumentApp.create("Document Title");
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
addBookmark(position) | Bookmark | Menambahkan Bookmark pada Position yang ditentukan. |
addEditor(emailAddress) | Document | Menambahkan pengguna tertentu ke daftar editor untuk Document . |
addEditor(user) | Document | Menambahkan pengguna tertentu ke daftar editor untuk Document . |
addEditors(emailAddresses) | Document | Menambahkan array pengguna yang ditentukan ke daftar editor untuk Document . |
addFooter() | FooterSection | Menambahkan bagian footer dokumen, jika tidak ada. |
addHeader() | HeaderSection | Menambahkan bagian header dokumen, jika tidak ada. |
addNamedRange(name, range) | NamedRange | Menambahkan NamedRange , yang merupakan Range yang memiliki nama dan ID untuk digunakan
saat pengambilan nanti. |
addViewer(emailAddress) | Document | Menambahkan pengguna tertentu ke daftar audiens untuk Document . |
addViewer(user) | Document | Menambahkan pengguna tertentu ke daftar audiens untuk Document . |
addViewers(emailAddresses) | Document | Menambahkan array pengguna yang ditentukan ke daftar audiens untuk Document . |
getAs(contentType) | Blob | Mengambil konten Document saat ini sebagai blob dari jenis yang ditentukan. |
getBlob() | Blob | Mengambil konten Document saat ini sebagai blob. |
getBody() | Body | Mengambil Body dokumen aktif. |
getBookmark(id) | Bookmark | Mendapatkan Bookmark dengan ID yang diberikan. |
getBookmarks() | Bookmark[] | Mendapatkan semua objek Bookmark dalam dokumen. |
getCursor() | Position | Mendapatkan kursor pengguna di dokumen yang aktif. |
getEditors() | User[] | Mendapatkan daftar editor untuk Document ini. |
getFooter() | FooterSection | Mengambil bagian footer dokumen, jika ada. |
getFootnotes() | Footnote[] | Mengambil semua elemen Footnote dalam isi dokumen. |
getHeader() | HeaderSection | Mengambil bagian header dokumen, jika ada. |
getId() | String | Mengambil ID unik dokumen. |
getLanguage() | String | Mendapatkan kode bahasa dokumen. |
getName() | String | Mengambil judul dokumen. |
getNamedRangeById(id) | NamedRange | Mendapatkan NamedRange dengan ID yang diberikan. |
getNamedRanges() | NamedRange[] | Mendapatkan semua objek NamedRange dalam dokumen. |
getNamedRanges(name) | NamedRange[] | Mendapatkan semua objek NamedRange dalam dokumen dengan nama yang diberikan. |
getSelection() | Range | Mendapatkan pilihan pengguna di dokumen aktif. |
getSupportedLanguageCodes() | String[] | Mendapatkan semua kode bahasa yang didukung dalam file Google Dokumen. |
getUrl() | String | Mengambil URL untuk mengakses dokumen saat ini. |
getViewers() | User[] | Mendapatkan daftar pelihat dan pengomentar untuk Document ini. |
newPosition(element, offset) | Position | Membuat Position baru, yang merupakan referensi ke lokasi dalam dokumen, relatif terhadap elemen tertentu. |
newRange() | RangeBuilder | Membuat builder yang digunakan untuk membuat objek Range dari elemen dokumen. |
removeEditor(emailAddress) | Document | Menghapus pengguna yang ditentukan dari daftar editor untuk Document . |
removeEditor(user) | Document | Menghapus pengguna yang ditentukan dari daftar editor untuk Document . |
removeViewer(emailAddress) | Document | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Document . |
removeViewer(user) | Document | Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Document . |
saveAndClose() | void | Menyimpan Document saat ini. |
setCursor(position) | Document | Menetapkan kursor pengguna di dokumen yang aktif, dengan mempertimbangkan Position . |
setLanguage(languageCode) | Document | Menetapkan kode bahasa dokumen. |
setName(name) | Document | Menetapkan judul dokumen. |
setSelection(range) | Document | Menetapkan pilihan pengguna dalam dokumen aktif, dengan mempertimbangkan Range . |
Dokumentasi mendetail
addBookmark(position)
Menambahkan Bookmark
pada Position
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('abc123456'); // Gets the document body and adds a paragraph. const paragraph = doc.getBody().appendParagraph('My new paragraph.'); // Creates a position at the first character of the paragraph text. const position = doc.newPosition(paragraph.getChild(0), 0); // Adds a bookmark at the first character of the paragraph text. const bookmark = doc.addBookmark(position); // Logs the bookmark ID to the console. console.log(bookmark.getId()); }
Parameter
Nama | Type | Deskripsi |
---|---|---|
position | Position | Posisi bookmark baru. |
Return
Bookmark
— Bookmark 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
addEditor(emailAddress)
Menambahkan pengguna tertentu ke daftar editor untuk Document
. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya dari daftar pelihat.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
addEditor(user)
Menambahkan pengguna tertentu ke daftar editor untuk Document
. Jika pengguna sudah ada dalam daftar pelihat, metode ini akan mempromosikannya dari daftar pelihat.
Parameter
Nama | Type | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
addEditors(emailAddresses)
Menambahkan array pengguna yang ditentukan ke daftar editor untuk Document
. Jika ada
pengguna yang sudah ada di daftar audiens, metode ini akan mempromosikannya dari daftar
penonton.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
addHeader()
Menambahkan bagian header dokumen, jika tidak ada.
// 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('abc123456'); // Adds a header to the document. const header = doc.addHeader(); // Sets the header text to 'This is a header.' header.setText('This is a header');
Return
HeaderSection
— Header dokumen.
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
addNamedRange(name, range)
Menambahkan NamedRange
, yang merupakan Range
yang memiliki nama dan ID untuk digunakan
saat pengambilan nanti. Nama tidak harus unik; beberapa rentang yang berbeda dalam dokumen yang sama dapat memiliki nama yang sama, seperti class dalam HTML. Sebaliknya, ID bersifat unik dalam dokumen, seperti ID dalam HTML. Setelah menambahkan NamedRange
ke dokumen, Anda tidak dapat
mengubahnya, Anda hanya dapat menghapusnya.
Skrip apa pun yang mengakses dokumen dapat mengakses NamedRange
. Untuk menghindari konflik yang tidak diinginkan antar-skrip, sebaiknya beri awalan pada nama rentang dengan string unik.
// Creates a named range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.addNamedRange('Document tables', rangeBuilder.build());
Parameter
Nama | Type | Deskripsi |
---|---|---|
name | String | Nama untuk rentang, yang tidak harus unik; nama rentang harus antara 1-256 karakter. |
range | Range | Rentang elemen yang akan dikaitkan dengan nama; rentang dapat berupa pilihan aktif, hasil penelusuran, atau dibuat secara manual dengan newRange() . |
Return
NamedRange
— NamedRange
.
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
addViewer(emailAddress)
Menambahkan pengguna tertentu ke daftar audiens untuk Document
. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
addViewer(user)
Menambahkan pengguna tertentu ke daftar audiens untuk Document
. Jika pengguna sudah ada dalam daftar editor, metode ini tidak akan berpengaruh.
Parameter
Nama | Type | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
addViewers(emailAddresses)
Menambahkan array pengguna yang ditentukan ke daftar audiens untuk Document
. Jika ada
pengguna yang sudah ada di daftar editor, metode ini tidak akan berpengaruh bagi mereka.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddresses | String[] | Array alamat email pengguna yang akan ditambahkan. |
Return
Document
— Document
ini, untuk perantaian.
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
getAs(contentType)
Mengambil konten Document
saat ini sebagai blob dari jenis 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('abc123456'); // Gets the document as a PDF. const pdf = doc.getAs('application/pdf'); // Logs the name of the PDF to the console. console.log(pdf.getName());
Parameter
Nama | Type | Deskripsi |
---|---|---|
contentType | String | Jenis MIME yang akan dikonversi; saat ini hanya 'application/pdf' yang
didukung. |
Return
Blob
— Dokumen saat ini sebagai blob.
getBlob()
Mengambil konten Document
saat ini sebagai blob.
// 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('abc123456'); // Retrieves the current document's contents as a blob and logs it to the console. console.log(doc.getBlob().getContentType());
Return
Blob
— Dokumen saat ini sebagai blob.
getBody()
Mengambil Body
dokumen aktif.
Dokumen dapat berisi jenis bagian yang berbeda (misalnya HeaderSection
, FooterSection
). Bagian yang aktif untuk dokumen adalah Body
.
Metode elemen dalam Document
didelegasikan ke Body
aktif.
// 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('abc123456'); // Gets the document body. const body = doc.getBody(); // Gets the body text and logs it to the console. console.log(body.getText());
Return
Body
— Bagian isi dokumen yang aktif.
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
getBookmark(id)
Mendapatkan Bookmark
dengan ID yang diberikan. Metode ini akan menampilkan null
jika Bookmark
tersebut tidak ada.
// 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('abc123456'); // Gets the bookmark by its ID. const bookmark = doc.getBookmark('id.xyz654321'); // If the bookmark exists, logs the character offset of its position to the console. // otherwise, logs 'No bookmark exists with the given ID.' to the console. if (bookmark) { console.log(bookmark.getPosition().getOffset()); } else { console.log('No bookmark exists with the given ID.'); }
Parameter
Nama | Type | Deskripsi |
---|---|---|
id | String | ID untuk Bookmark . |
Return
Bookmark
— Bookmark
dengan ID yang diberikan, atau null
jika Bookmark
tersebut tidak ada.
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
getBookmarks()
Mendapatkan semua objek Bookmark
dalam dokumen.
// Opens the Docs file by its ID. If you created your script from within // a Google Docs file, you can use DocumentApp.getActiveDocument() instead. const doc = DocumentApp.openById('abc123456'); // Gets all of the bookmarks in the document. const bookmarks = doc.getBookmarks(); // Logs the number of bookmarks in the document to the console. console.log(bookmarks.length);
Return
Bookmark[]
— Array objek Bookmark
dalam dokumen.
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
getCursor()
Mendapatkan kursor pengguna di dokumen yang aktif. Skrip hanya dapat mengakses kursor dari pengguna yang menjalankan skrip, dan hanya jika skrip tersebut terikat dengan dokumen.
// Insert some text at the cursor position and make it bold. var cursor = DocumentApp.getActiveDocument().getCursor(); if (cursor) { // Attempt to insert text at the cursor position. If the insertion returns null, the cursor's // containing element doesn't allow insertions, so show the user an error message. var element = cursor.insertText('ಠ‿ಠ'); if (element) { element.setBold(true); } else { DocumentApp.getUi().alert('Cannot insert text here.'); } } else { DocumentApp.getUi().alert('Cannot find a cursor.'); }
Return
Position
— Representasi kursor pengguna, atau null
jika pengguna tidak memiliki kursor yang ditempatkan dalam dokumen atau jika skrip tidak terikat ke dokumen.
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
getEditors()
getFootnotes()
Mengambil semua elemen Footnote
dalam isi dokumen.
Panggilan ke getFootnotes
menyebabkan iterasi pada elemen dokumen. Untuk dokumen berukuran besar, hindari panggilan yang tidak perlu ke metode ini.
// 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('abc123456'); // Gets the first footnote. const footnote = doc.getFootnotes()[0]; // Logs footnote contents to the console. console.log(footnote.getFootnoteContents().getText());
Return
Footnote[]
— Catatan kaki dokumen.
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
getHeader()
Mengambil bagian header dokumen, jika ada.
// 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('abc123456'); // Gets the text of the document's header and logs it to the console. console.log(doc.getHeader().getText());
Return
HeaderSection
— Header dokumen.
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
getId()
Mengambil ID unik dokumen. ID dokumen digunakan dengan DocumentApp.openById()
untuk membuka instance dokumen tertentu.
Return
String
— ID dokumen
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
getLanguage()
Mendapatkan kode bahasa dokumen. Ini adalah bahasa yang ditampilkan di File > Language editor dokumen, yang mungkin bukan bahasa sebenarnya yang terdapat dalam dokumen.
Return
String
— Bahasa dokumen, atau null
jika tidak 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
getName()
Mengambil judul dokumen.
Return
String
— judul dokumen
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
getNamedRangeById(id)
Mendapatkan NamedRange
dengan ID yang diberikan. Metode ini akan menampilkan null
jika
NamedRange
tersebut tidak ada. Nama tidak harus unik; beberapa rentang yang berbeda dalam dokumen yang sama dapat memiliki nama yang sama, seperti class dalam HTML. Sebaliknya, ID bersifat unik dalam dokumen, seperti ID dalam HTML.
Parameter
Nama | Type | Deskripsi |
---|---|---|
id | String | ID rentang, yang unik dalam dokumen |
Return
NamedRange
— NamedRange
dengan ID yang diberikan, atau null
jika rentang tersebut tidak ada
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
getNamedRanges()
Mendapatkan semua objek NamedRange
dalam dokumen.
NamedRange
dapat diakses oleh skrip apa pun yang mengakses dokumen. Untuk menghindari
konflik yang tidak diinginkan antar-skrip, pertimbangkan untuk memberi awalan pada nama rentang dengan string unik.
Return
NamedRange[]
— array objek NamedRange
dalam dokumen, mungkin termasuk beberapa rentang dengan nama yang sama
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
getNamedRanges(name)
Mendapatkan semua objek NamedRange
dalam dokumen dengan nama yang diberikan. Nama tidak
harus unik; beberapa rentang yang berbeda dalam dokumen yang sama dapat memiliki nama yang sama, mirip
dengan class dalam HTML. Sebaliknya, ID bersifat unik dalam dokumen, seperti ID dalam HTML.
NamedRange
dapat diakses oleh skrip apa pun yang mengakses dokumen. Untuk menghindari
konflik yang tidak diinginkan antar-skrip, pertimbangkan untuk memberi awalan pada nama rentang dengan string unik.
Parameter
Nama | Type | Deskripsi |
---|---|---|
name | String | nama rentang, yang tidak harus unik |
Return
NamedRange[]
— array objek NamedRange
dalam dokumen dengan nama yang diberikan
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
getSelection()
Mendapatkan pilihan pengguna di dokumen aktif. Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke dokumen.
// Display a dialog box that tells the user how many elements are included in the selection. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); DocumentApp.getUi().alert('Number of selected elements: ' + elements.length); } else { DocumentApp.getUi().alert('Nothing is selected.'); }
Return
Range
— Representasi pilihan pengguna, atau null
jika pengguna tidak memilih apa pun dalam dokumen, jika hanya akhir paragraf yang dipilih, jika hanya akhir paragraf dan baris baru yang dipilih, atau jika skrip tidak terikat ke dokumen.
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
getSupportedLanguageCodes()
Mendapatkan semua kode bahasa yang didukung dalam file Google Dokumen.
Return
String[]
— Array kode bahasa.
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
getUrl()
Mengambil URL untuk mengakses dokumen saat ini.
var doc = DocumentApp.getActiveDocument(); // Send out the link to open the document. MailApp.sendEmail("<email-address>", doc.getName(), doc.getUrl());
Return
String
— URL untuk mengakses dokumen 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
getViewers()
Mendapatkan daftar pelihat dan pengomentar untuk Document
ini.
Return
User[]
— Array pengguna dengan izin lihat atau komentar.
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
newPosition(element, offset)
Membuat Position
baru, yang merupakan referensi ke lokasi dalam dokumen, relatif terhadap elemen tertentu. Kursor pengguna direpresentasikan sebagai Position
, di antara penggunaan lainnya.
// Append a paragraph, then place the user's cursor after the first word of the new paragraph. var doc = DocumentApp.getActiveDocument(); var paragraph = doc.getBody().appendParagraph('My new paragraph.'); var position = doc.newPosition(paragraph.getChild(0), 2); doc.setCursor(position);
Parameter
Nama | Type | Deskripsi |
---|---|---|
element | Element | elemen yang akan berisi Position baru; ini harus berupa elemen Text atau elemen penampung seperti Paragraph |
offset | Integer | untuk elemen Text , jumlah karakter sebelum Position ;
untuk elemen lainnya, jumlah elemen turunan sebelum Position dalam
elemen penampung yang sama |
Return
Position
— Position
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
newRange()
Membuat builder yang digunakan untuk membuat objek Range
dari elemen dokumen.
// Change the user's selection to a range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.setSelection(rangeBuilder.build());
Return
RangeBuilder
— builder 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
removeEditor(emailAddress)
Menghapus pengguna yang ditentukan dari daftar editor untuk Document
. Metode ini tidak
memblokir pengguna untuk mengakses Document
jika mereka termasuk dalam class pengguna yang memiliki
akses umum—misalnya, jika Document
dibagikan ke seluruh domain
pengguna, atau jika Document
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, pengguna juga akan dihapus dari daftar pelihat.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Return
Document
— Document
ini, untuk perantaian.
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
removeEditor(user)
Menghapus pengguna yang ditentukan dari daftar editor untuk Document
. Metode ini tidak
memblokir pengguna untuk mengakses Document
jika mereka termasuk dalam class pengguna yang memiliki
akses umum—misalnya, jika Document
dibagikan ke seluruh domain
pengguna, atau jika Document
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, pengguna juga akan dihapus dari daftar pelihat.
Parameter
Nama | Type | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Return
Document
— Document
ini, untuk perantaian.
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
removeViewer(emailAddress)
Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Document
. Metode
ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat atau pengomentar. Metode ini juga
tidak memblokir pengguna untuk mengakses Document
jika mereka termasuk dalam class pengguna yang
memiliki akses umum—misalnya, jika Document
dibagikan kepada seluruh
domain pengguna, atau jika Document
berada di drive bersama yang dapat diakses pengguna.
Untuk file Drive, pengguna juga akan dihapus dari daftar editor.
Parameter
Nama | Type | Deskripsi |
---|---|---|
emailAddress | String | Alamat email pengguna yang akan dihapus. |
Return
Document
— Document
ini untuk perantaian.
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
removeViewer(user)
Menghapus pengguna tertentu dari daftar pelihat dan pengomentar untuk Document
. Metode
ini tidak berpengaruh jika pengguna adalah editor, bukan pelihat. Metode ini juga tidak memblokir
pengguna untuk mengakses Document
jika mereka termasuk dalam class pengguna yang memiliki akses
umum—misalnya, jika Document
dibagikan kepada seluruh domain pengguna, atau
jika Document
berada dalam drive bersama yang dapat diakses pengguna.
Untuk file Drive, pengguna juga akan dihapus dari daftar editor.
Parameter
Nama | Type | Deskripsi |
---|---|---|
user | User | Representasi pengguna yang akan dihapus. |
Return
Document
— Document
ini untuk perantaian.
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
saveAndClose()
Menyimpan Document
saat ini. Menyebabkan update yang tertunda dihapus dan diterapkan.
Metode saveAndClose()
secara otomatis dipanggil di akhir eksekusi skrip
untuk setiap Document
terbuka yang dapat diedit.
Document
yang ditutup tidak dapat diedit. Gunakan DocumentApp.openById()
untuk membuka kembali dokumen tertentu untuk diedit.
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
setCursor(position)
Menetapkan kursor pengguna di dokumen yang aktif, dengan mempertimbangkan Position
. Skrip hanya dapat mengakses kursor pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke dokumen.
// Append a paragraph, then place the user's cursor after the first word of the new paragraph. var doc = DocumentApp.getActiveDocument(); var paragraph = doc.getBody().appendParagraph('My new paragraph.'); var position = doc.newPosition(paragraph.getChild(0), 2); doc.setCursor(position);
Parameter
Nama | Type | Deskripsi |
---|---|---|
position | Position | lokasi kursor baru |
Return
Document
— Document
ini, untuk rantai
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
setLanguage(languageCode)
Menetapkan kode bahasa dokumen. Ini adalah bahasa yang ditampilkan di File
> Language editor dokumen, yang mungkin bukan bahasa sebenarnya yang terdapat dalam dokumen. Gunakan getSupportedLanguageCodes()
untuk mendapatkan semua kode bahasa yang valid.
Parameter
Nama | Type | Deskripsi |
---|---|---|
languageCode | String | Kode bahasa. |
Return
Document
— Document
ini, untuk perantaian.
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
setName(name)
Menetapkan judul dokumen.
Parameter
Nama | Type | Deskripsi |
---|---|---|
name | String | judul dokumen baru |
Return
Document
— dokumen 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
setSelection(range)
Menetapkan pilihan pengguna dalam dokumen aktif, dengan mempertimbangkan Range
. Skrip hanya dapat mengakses pilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke dokumen.
// Change the user's selection to a range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.getBody().getTables(); for (var i = 0; i < tables.length; i++) { rangeBuilder.addElement(tables[i]); } doc.setSelection(rangeBuilder.build());
Parameter
Nama | Type | Deskripsi |
---|---|---|
range | Range | rentang elemen baru yang dapat dipilih |
Return
Document
— Document
ini, untuk rantai
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